Web SDK

拡張リスト

プラグイン情報

拡張リスト機能は、Univer Docs に高度なリスト機能を提供します。ネストされたリスト、カスタム記号、柔軟なリスト操作が可能です。

はじめに

Univer Docs では、拡張リストを使用して以下ができます：

  • ネストされたリストを作成：多階層のリスト階層構造を構築します。
  • 記号をカスタマイズ：異なる箇条書き記号や番号スタイルを使用します。
  • リスト構造を操作：リスト項目の昇格、降格、並べ替えを行います。

プラグインモード

インストール

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

使用法

TypeScript
import { UniverDocsListPlugin } from '@univerjs-pro/docs-list'import { UniverDocsListUIPlugin } from '@univerjs-pro/docs-list-ui'import DocsListUIJaJP from '@univerjs-pro/docs-list-ui/locale/ja-JP'import { LocaleType, mergeLocales, Univer } from '@univerjs/core'import '@univerjs-pro/docs-list-ui/lib/index.css'const univer = new Univer({  locale: LocaleType.JA_JP,  locales: {    [LocaleType.JA_JP]: mergeLocales(      DocsListUIJaJP,     ),  },})univer.registerPlugin(UniverDocsListPlugin)univer.registerPlugin(UniverDocsListUIPlugin)

Univer の商用ライセンスをお持ちの場合は、クライアントでのライセンス使用を参照してください。

モバイル対応

まずモバイルエディターを設定します。このページのプラグインモードの初期化コードで、以下のデスクトップ登録を同じパッケージのモバイル版に置き換え、文書を開く前に完了してください。モデル、スタイル、言語ファイル、Facade は維持し、両方を同時に登録しないでください。

パッケージデスクトップの登録モバイルの登録
@univerjs-pro/docs-list-uiUniverDocsListUIPluginUniverDocsListMobileUIPlugin

Facade API

API を使用する前に facade をインポートしてください：

TypeScript
import '@univerjs-pro/docs-list/facade'

リストを挿入

TypeScript
import { PresetListType } from '@univerjs/core'const doc = univerAPI.getActiveDocument()doc?.insertList({  startOffset: 0,  endOffset: 10,  listType: PresetListType.BULLET_LIST,})

すべてのリストを取得

TypeScript
const doc = univerAPI.getActiveDocument()const lists = doc?.getLists() ?? []

リスト記号タイプを設定

TypeScript
const doc = univerAPI.getActiveDocument()doc?.setListGlyphType(0, ListGlyphType.DECIMAL)

リストレベルを設定

TypeScript
const doc = univerAPI.getActiveDocument()doc?.setListLevel(0, 1)

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

© 2026 DreamNum Co., Ltd.