Estructura de datos del documento

IDocumentData

IDocumentData es el formato de instantánea utilizado por Univer Docs.

Describe una unidad de documento completa, incluido el cuerpo del texto, el estilo a nivel de documento, los encabezados y pies de página, los dibujos, las listas, las tablas y los recursos de complementos.

Propiedades

PropiedadTipoDescripción
idstringID único de unidad de documento.
rev?numberRevisión del documento, usado mediante edición colaborativa.
locale?LocaleTypeConfiguración regional del documento.
title?stringTítulo del documento.
body?IDocumentBodyCuerpo principal de texto enriquecido. Detalles
documentStyleIDocumentStyleConfiguración de página a nivel de documento, diseño, encabezado/pie de página y estilo de texto predeterminado.
settings?IDocumentSettingsConfiguraciones de tiempo de ejecución como zoomRatio.
resources?IResourcesRecursos de complementos.
disabled?booleanSi el documento está deshabilitado.
headers?IHeadersCuerpos de encabezado codificados por ID de encabezado.
footers?IFootersCuerpos de pie de página codificados por ID de pie de página.
lists?IListsEnumerar definiciones utilizadas por párrafo viñetas.
drawings?IDrawingsObjetos de dibujo como imágenes.
drawingsOrder?string[]Orden de representación de los dibujos.
tableSource?ITablesDefiniciones de tablas a las que hace referencia el cuerpo del documento.

Ejemplo

TypeScript
const documentData: IDocumentData = {  id: 'doc-1',  title: 'Demo Document',  locale: LocaleType.EN_US,  body: {    dataStream: 'Hello Univer\r\n',    textRuns: [      {        st: 0,        ed: 12,        ts: { fs: 14 },      },    ],    paragraphs: [      {        startIndex: 12,        paragraphId: 'paragraph-1',      },    ],  },  documentStyle: {    pageSize: { width: 595, height: 842 },    marginTop: 72,    marginBottom: 72,    marginLeft: 72,    marginRight: 72,  },}

Uso

IDocumentData se utiliza principalmente para:

  1. Crear un Univer Docs document
  2. Guardar una instantánea de Univer Docs
  3. Importar o exportar .docx files
  4. Almacenar texto enriquecido dentro de celdas de Hojas de cálculo a través de ICellData.p

Una instantánea es una estructura de datos persistentes. No lo mute directamente después de que se ejecute un documento. Utilice comandos o API de Facade para modificar el contenido del documento.

¿Cómo es esta guía?

© 2026 DreamNum Co., Ltd.