Расширенные списки
Функция расширенных списков предоставляет дополнительные возможности для работы со списками в Univer Docs: вложенные списки, настраиваемые маркеры и гибкое изменение структуры.
Введение
Расширенные списки в Univer Docs позволяют:
- Создавать вложенные списки: формировать многоуровневую иерархию списков.
- Настраивать маркеры: использовать разные символы и стили нумерации.
- Изменять структуру списка: повышать и понижать уровень элементов, а также менять их порядок.
Режим плагинов
Установка
Shell
pnpm add @univerjs-pro/docs-list @univerjs-pro/docs-list-uiShell
npm install @univerjs-pro/docs-list @univerjs-pro/docs-list-uiShell
yarn add @univerjs-pro/docs-list @univerjs-pro/docs-list-uiShell
bun 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 DocsListUIEnUS from '@univerjs-pro/docs-list-ui/locale/en-US'import { LocaleType, mergeLocales, Univer } from '@univerjs/core'import '@univerjs-pro/docs-list-ui/lib/index.css'const univer = new Univer({ locale: LocaleType.EN_US, locales: { [LocaleType.EN_US]: mergeLocales( DocsListUIEnUS, ), },})univer.registerPlugin(UniverDocsListPlugin)univer.registerPlugin(UniverDocsListUIPlugin)Если у вас есть коммерческая лицензия Univer, сведения о настройке см. в разделе «Использование лицензии в клиенте».
Поддержка мобильных устройств
Сначала настройте мобильный редактор. В коде инициализации режима плагинов на этой странице замените указанные настольные регистрации мобильными экспортами тех же пакетов до открытия документа. Сохраните модели, стили, локализации и импорты Facade; не регистрируйте оба варианта.
| Пакет | Настольная регистрация | Мобильная регистрация |
|---|---|---|
@univerjs-pro/docs-list-ui | UniverDocsListUIPlugin | UniverDocsListMobileUIPlugin |
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)Насколько полезно это руководство?