Bloc de citation

Informations sur les plugins

La fonctionnalité de bloc de citation permet d’insérer et de mettre en forme du texte cité dans un document, avec un style visuel qui le distingue du contenu ordinaire.

Introduction

Dans Univer Docs, les blocs de citation vous permettent de :

  • Mettre en forme du texte cité : appliquez un style distinctif aux citations.
  • Imbriquer du contenu : incluez du contenu enrichi dans les blocs de citation.
  • Quitter facilement le bloc : désactivez rapidement la mise en forme de citation depuis un paragraphe vide.

Mode plugin

Installation

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

Utilisation

TypeScript
import { UniverDocsQuotePlugin } from '@univerjs-pro/docs-quote'import { UniverDocsQuoteUIPlugin } from '@univerjs-pro/docs-quote-ui'import DocsQuoteUIEnUS from '@univerjs-pro/docs-quote-ui/locale/en-US'import { LocaleType, mergeLocales, Univer } from '@univerjs/core'import '@univerjs-pro/docs-quote-ui/lib/index.css'const univer = new Univer({  locale: LocaleType.EN_US,  locales: {    [LocaleType.EN_US]: mergeLocales(      DocsQuoteUIEnUS,     ),  },})univer.registerPlugin(UniverDocsQuotePlugin)univer.registerPlugin(UniverDocsQuoteUIPlugin)

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

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-quote-uiUniverDocsQuoteUIPluginUniverDocsQuoteMobileUIPlugin

API Facade

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

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

Obtenir tous les blocs de citation

TypeScript
const doc = univerAPI.getActiveDocument()const quotes = doc?.getQuotes() ?? []

Insérer un bloc de citation

TypeScript
const doc = univerAPI.getActiveDocument()const quote = doc?.insertQuote({  startOffset: 12,  endOffset: 35,})

Définir la couleur du trait de citation

TypeScript
const quote = univerAPI.getActiveDocument()?.getQuote('quote-block-id')quote?.setLineColor('#5B5FC7')

Définir la couleur du texte de citation

TypeScript
const quote = univerAPI.getActiveDocument()?.getQuote('quote-block-id')quote?.setTextColor('#242424')

Que pensez-vous de ce guide ?

© 2026 DreamNum Co., Ltd.