Блок цитаты
Блоки цитат позволяют вставлять и форматировать цитаты в документе, визуально отделяя их от обычного содержимого.
Введение
В Univer Docs с помощью блоков цитат можно:
- Форматировать цитаты: применять к ним особое оформление.
- Вкладывать содержимое: размещать внутри блоков цитат форматированный контент.
- Легко выходить из блока: быстро отключать формат цитаты в пустом абзаце.
Режим плагинов
Установка
Shell
pnpm add @univerjs-pro/docs-quote @univerjs-pro/docs-quote-uiShell
npm install @univerjs-pro/docs-quote @univerjs-pro/docs-quote-uiShell
yarn add @univerjs-pro/docs-quote @univerjs-pro/docs-quote-uiShell
bun add @univerjs-pro/docs-quote @univerjs-pro/docs-quote-uiИспользование
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)Если у вас есть коммерческая лицензия Univer, ознакомьтесь с разделом Использование лицензии в клиенте.
Поддержка мобильных устройств
Сначала настройте мобильный редактор. В коде инициализации режима плагинов на этой странице замените указанные настольные регистрации мобильными экспортами тех же пакетов до открытия документа. Сохраните модели, стили, локализации и импорты Facade; не регистрируйте оба варианта.
| Пакет | Настольная регистрация | Мобильная регистрация |
|---|---|---|
@univerjs-pro/docs-quote-ui | UniverDocsQuoteUIPlugin | UniverDocsQuoteMobileUIPlugin |
Facade API
Перед использованием API обязательно импортируйте facade:
TypeScript
import '@univerjs-pro/docs-quote/facade'Получение всех блоков цитат
TypeScript
const doc = univerAPI.getActiveDocument()const quotes = doc?.getQuotes() ?? []Вставка блока цитаты
TypeScript
const doc = univerAPI.getActiveDocument()const quote = doc?.insertQuote({ startOffset: 12, endOffset: 35,})Цвет линии цитаты
TypeScript
const quote = univerAPI.getActiveDocument()?.getQuote('quote-block-id')quote?.setLineColor('#5B5FC7')Цвет текста цитаты
TypeScript
const quote = univerAPI.getActiveDocument()?.getQuote('quote-block-id')quote?.setTextColor('#242424')Насколько полезно это руководство?