Páginas de diapositivas y elementos

ISlidePage

ISlidePage describe un único objeto similar a una página en Univer Slides. Las diapositivas, patrones, diseños, patrones de folletos y patrones de notas normales utilizan esta estructura y se diferencian por pageType y su bloque de propiedades opcional.

Propiedades de página

PropiedadTipoDescripción
idstringIdentificación de página única.
pageTypePageTypeTipo de página, como SLIDE, MASTER o LAYOUT.
zIndexnumberOrden de representación de la página.
titlestringTítulo de la página.
descriptionstringDescripción de la página.
pageBackgroundFillIColorStyleRelleno del fondo de la página.
colorScheme?ThemeColorTypeEsquema de colores del tema utilizado por la página.
pageElements{ [elementId: string]: IPageElement }Elementos de esta página, codificados por ID de elemento.
slideProperties?ISlidePropertiesPropiedades para páginas de diapositivas normales.
layoutProperties?ILayoutPropertiesPropiedades para páginas de diseño.
masterProperties?IMasterPropertiesPropiedades para páginas maestras.

IPageElement

IPageElement es el contenedor de elementos común. Cada elemento tiene campos de transformación como left, top, width, height, angle, scaleX, scaleY, flipX y flipY, más una carga útil de contenido seleccionada por type.

Tipo de elementoCarga útilDescripción
PageElementType.SHAPEshapeForma preestablecida o personalizada, incluido texto de forma y propiedades de forma.
PageElementType.IMAGEimagePropiedades de imagen y metadatos de marcador de posición/vínculo opcionales.
PageElementType.TEXTrichTextElemento de texto enriquecido. El campo rich puede almacenar IDocumentData.
PageElementType.SPREADSHEETspreadsheetCarga útil de hoja de trabajo incrustada en desuso.
PageElementType.DOCUMENTdocumentCarga útil de documento incrustado en desuso.
PageElementType.SLIDEslideCarga útil de diapositivas incrustada en desuso.

Ejemplo

TypeScript
const page: ISlidePage = {  id: 'slide-1',  pageType: PageType.SLIDE,  zIndex: 10,  title: 'Agenda',  description: '',  pageBackgroundFill: { rgb: 'rgb(255,255,255)' },  pageElements: {    title: {      id: 'title',      zIndex: 1,      left: 72,      top: 64,      width: 600,      height: 80,      title: 'Title',      description: '',      type: PageElementType.TEXT,      richText: {        text: 'Quarterly Review',      },    },  },}

Notas

  • pageOrder controla el orden de las diapositivas visibles; zIndex controla el orden de dibujo.
  • Los elementos de texto pueden almacenar text datos de documentos simples o más completos a través de richText.rich.
  • Utilice customBlock para cargas útiles de elementos propiedad del complemento en lugar de sobrecargar cargas útiles incrustadas obsoletas.

¿Cómo es esta guía?

© 2026 DreamNum Co., Ltd.