Web SDK

Формулы LaTeX

Сведения о плагинах

Функция формул LaTeX позволяет хранить в модели документа редактируемый исходный код формулы и отображать её в браузерном редакторе Docs.

Режим плагинов

Установка

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

Использование

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

Если у вас есть коммерческая лицензия Univer, инструкции по настройке см. в разделе Использование лицензии на клиенте.

Поддержка мобильных устройств

Сначала настройте мобильный редактор. В коде инициализации режима плагинов на этой странице замените указанные настольные регистрации мобильными экспортами тех же пакетов до открытия документа. Сохраните модели, стили, локализации и импорты Facade; не регистрируйте оба варианта.

ПакетНастольная регистрацияМобильная регистрация
@univerjs-pro/docs-latex-uiUniverDocsLatexUIPluginUniverDocsLatexMobileUIPlugin

Facade API

Перед вызовом API LaTeX импортируйте точку входа facade:

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

Вставьте формулу в активный документ:

TypeScript
const doc = univerAPI.getActiveDocument()const formula = doc?.insertLatexFormula({  latex: 'E=mc^2',  index: 12,})

Получите и измените формулы:

TypeScript
const formulas = doc?.getLatexFormulas() ?? []const firstFormula = doc?.findLatexFormulaByText('mc')firstFormula?.update({  latex: '\\frac{a}{b}',})

Формулы также можно искать по идентификатору диапазона или смещению в потоке данных документа:

TypeScript
const byId = doc?.getLatexFormula('formula-range-id')const atOffset = doc?.getLatexFormulaAt(42)console.log(byId?.describe(), atOffset?.getLatex())

Насколько полезно это руководство?

© 2026 DreamNum Co., Ltd.