脚注と文末脚注

Headless 対応

従来型のページ分割ドキュメントに脚注と文末脚注を追加します。脚注は参照元のページに配置され、文末脚注はドキュメント設定に従って配置されます。この API はモダンドキュメントには対応していません。

プラグインモード

インストール

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

使い方

ライセンスを設定済みの Docs エディターに次のプラグインを追加し、UI スタイルとエディターの言語リソースを読み込みます。

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

プリセットモード

インストール

Shell
pnpm add @univerjs/presets @univerjs/preset-docs-core @univerjs/preset-docs-drawing @univerjs/preset-docs-advanced

使い方

UniverDocsAdvancedPreset には両方のプラグインが含まれています。この preset を使う場合、再登録は不要です。

コア、描画、拡張プリセットを組み合わせ、各プリセットの言語リソースをマージします。クライアントのライセンス設定はライセンスの使用を参照してください。

TypeScript
import { UniverDocsAdvancedPreset } from '@univerjs/preset-docs-advanced'import AdvancedLocale from '@univerjs/preset-docs-advanced/locales/ja-JP'import { UniverDocsCorePreset } from '@univerjs/preset-docs-core'import CoreLocale from '@univerjs/preset-docs-core/locales/ja-JP'import { UniverDocsDrawingPreset } from '@univerjs/preset-docs-drawing'import DrawingLocale from '@univerjs/preset-docs-drawing/locales/ja-JP'import { createUniver, LocaleType, mergeLocales } from '@univerjs/presets'import '@univerjs/preset-docs-core/lib/index.css'import '@univerjs/preset-docs-drawing/lib/index.css'import '@univerjs/preset-docs-advanced/lib/index.css'const { univerAPI } = createUniver({  locale: LocaleType.JA_JP,  locales: {    [LocaleType.JA_JP]: mergeLocales(CoreLocale, DrawingLocale, AdvancedLocale),  },  presets: [    UniverDocsCorePreset({ container: 'app' }),    UniverDocsDrawingPreset(),    UniverDocsAdvancedPreset(),  ],})

脚注の挿入と管理

TypeScript
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 を使ってください。表示番号は再ページ分割によって変わることがあります。

このガイドはいかがですか？

© 2026 DreamNum Co., Ltd.