Notas al pie y notas al final

Añade notas a documentos tradicionales paginados. Las notas al pie se colocan en la página de su referencia y las notas al final siguen la configuración del documento. Esta API no admite documentos modernos.

Instalación

Añade estos plugins a un editor Docs con la licencia configurada. Carga los estilos y los recursos del idioma del editor.

UniverDocsAdvancedPreset ya incluye ambos plugins. Si utilizas ese preset, no los registres de nuevo.

pnpm add @univerjs-pro/docs-reference @univerjs-pro/docs-reference-ui

npm install @univerjs-pro/docs-reference @univerjs-pro/docs-reference-ui

yarn add @univerjs-pro/docs-reference @univerjs-pro/docs-reference-ui

bun add @univerjs-pro/docs-reference @univerjs-pro/docs-reference-ui

import { UniverDocsReferencePlugin } from '@univerjs-pro/docs-reference'import { UniverDocsReferenceUIPlugin } from '@univerjs-pro/docs-reference-ui'import ReferenceLocale from '@univerjs-pro/docs-reference-ui/locale/es-ES'import { LocaleType } from '@univerjs/core'import '@univerjs-pro/docs-reference/facade'import '@univerjs-pro/docs-reference-ui/lib/index.css'univerAPI.loadLocales(LocaleType.ES_ES, ReferenceLocale)univer.registerPlugin(UniverDocsReferencePlugin)univer.registerPlugin(UniverDocsReferenceUIPlugin)

Insertar y gestionar notas

const document = univerAPI.getActiveDocument()if (document) {  const noteId = document.insertFootnote(0)  if (noteId) console.log(document.getParagraphs(noteId))  console.log(document.getFootnotes(), document.getEndnotes())}

El desplazamiento es una posición UTF-16 del cuerpo principal, incluidos los tokens estructurales. La inserción devuelve null si la posición o el contenido no son válidos, faltan permisos o el documento es moderno. Si tiene éxito, devuelve un ID estable. La referencia y el contenido forman parte de la misma mutación de deshacer y colaboración.

Lee las notas con getFootnotes() / getEndnotes() y elimínalas con deleteFootnote(noteId) / deleteEndnote(noteId). setFootnoteSettings() y setEndnoteSettings() configuran la numeración y ubicación; null restablece la configuración explícita. Conserva el ID devuelto para acceder al contenido: el número visible puede cambiar tras paginar de nuevo.