Сноски и концевые сноски

Добавляйте сноски в традиционные документы с разбивкой на страницы. Обычная сноска размещается на странице ссылки, концевая — согласно настройкам документа. API не поддерживает современные документы.

Установка

Добавьте плагины в редактор Docs с настроенной лицензией. Подключите стили и ресурсы языка редактора.

UniverDocsAdvancedPreset уже включает оба плагина. При использовании этого preset не регистрируйте их повторно.

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/ru-RU'import { LocaleType } from '@univerjs/core'import '@univerjs-pro/docs-reference/facade'import '@univerjs-pro/docs-reference-ui/lib/index.css'univerAPI.loadLocales(LocaleType.RU_RU, ReferenceLocale)univer.registerPlugin(UniverDocsReferencePlugin)univer.registerPlugin(UniverDocsReferenceUIPlugin)

Вставка и управление сносками

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

Смещение — позиция UTF-16 в основном тексте, включая структурные токены. Неверная позиция или содержимое, отсутствие прав либо современный документ приводят к результату null. При успехе возвращается стабильный ID сноски. Ссылка и содержимое участвуют в одной mutation отмены и совместного редактирования.

Читайте сноски через getFootnotes() / getEndnotes() и удаляйте через deleteFootnote(noteId) / deleteEndnote(noteId). setFootnoteSettings() и setEndnoteSettings() задают нумерацию и размещение; null сбрасывает явные настройки. Сохраните возвращённый ID для обращения к содержимому: отображаемый номер может измениться после переразбивки страниц.