Listes avancées

Informations sur les plugins

La fonctionnalité de listes avancées enrichit Univer Docs avec des listes imbriquées, des symboles personnalisés et des outils souples pour manipuler les listes.

Introduction

Dans Univer Docs, les listes avancées vous permettent de :

  • Créer des listes imbriquées : construisez des hiérarchies de listes à plusieurs niveaux.
  • Personnaliser les symboles : utilisez différents types de puces et de numérotation.
  • Modifier la structure des listes : augmentez ou diminuez le niveau des éléments et réorganisez-les.

Mode plugin

Installation

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

Utilisation

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)

Si vous disposez d’une licence commerciale Univer, consultez la page Utiliser une licence côté client pour connaître la procédure de configuration.

Prise en charge mobile

Configurez d’abord l’éditeur mobile. Dans l’initialisation en mode plugin de cette page, remplacez les inscriptions de bureau ci-dessous par les exports mobiles des mêmes paquets avant d’ouvrir un document. Conservez modèles, styles, traductions et imports Facade ; n’enregistrez pas les deux variantes.

PaquetInscription de bureauInscription mobile
@univerjs-pro/docs-list-uiUniverDocsListUIPluginUniverDocsListMobileUIPlugin

API Facade

Veillez à importer la facade avant d’utiliser l’API :

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

Insérer une liste

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

Obtenir toutes les listes

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

Définir le type de symbole d’une liste

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

Définir le niveau d’une liste

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

Que pensez-vous de ce guide ?

© 2026 DreamNum Co., Ltd.