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 DocsListUIZhTW from '@univerjs-pro/docs-list-ui/locale/zh-TW'import { LocaleType, mergeLocales, Univer } from '@univerjs/core'import '@univerjs-pro/docs-list-ui/lib/index.css'const univer = new Univer({  locale: LocaleType.ZH_TW,  locales: {    [LocaleType.ZH_TW]: mergeLocales(      DocsListUIZhTW,     ),  },})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.