Обзор интерфейса
Настройте холст PDF, элементы редактирования, локаль и воркер миниатюр.
@univerjs-pro/pdfs-ui монтирует PDF-юниты в стандартной рабочей области Univer и лицензируется в составе Univer Office SDK.
Ответственность пакетов
| Пакет | Ответственность |
|---|---|
@univerjs-pro/pdfs | Регистрирует юнит UNIVER_PDF, модель документа и сохраняемые PDF-команды. |
@univerjs-pro/pdfs-ui | Монтирует браузерный холст, панель миниатюр и нижнюю панель. Локальные средства редактирования включены по умолчанию. |
@univerjs-pro/pdfs-editor | Объявляет зависимости редактора для совместной работы. Он не монтирует интерфейс PDF и не управляет editor.enabled. |
UniverPdfsUIPlugin зависит от UniverLicensePlugin и UniverPdfsPlugin. Сначала завершите лицензированную базовую настройку PDF, затем зарегистрируйте UI-плагин.
Регистрация UI-плагина
import { UniverPdfsUIPlugin } from '@univerjs-pro/pdfs-ui'import PdfsUIRuRU from '@univerjs-pro/pdfs-ui/locale/ru-RU'import '@univerjs-pro/pdfs-ui/lib/index.css'univer.registerPlugin(UniverPdfsUIPlugin)Добавьте PdfsUIRuRU к локалям, передаваемым в new Univer(...). Этот пакет локализует ленту PDF, инспектор, контекстные меню и панель страниц.
Режимы просмотра и редактирования
Плагин всегда монтирует панель миниатюр страниц, холст PDF и нижнюю панель. Редактирование включено по умолчанию и дополнительно регистрирует ленту, контекстные меню, инспектор, буфер обмена, команды вставки, действия и контроллеры редактирования.
Если приложение не должно показывать элементы редактирования, включите режим только для просмотра:
univer.registerPlugin(UniverPdfsUIPlugin, { editor: { enabled: false },})Параметр меняет только смонтированный интерфейс, а также контроллеры и службы, предназначенные для редактирования. Это не политика доступа, и он не изменяет сохранённый снимок PDF.
Воркер миниатюр
thumbnailWorkerURL принимает строку, URL или существующий Worker. Указанный модуль должен запустить экспортируемую среду воркера:
import { startPdfPageThumbnailWorker } from '@univerjs-pro/pdfs-ui'startPdfPageThumbnailWorker()univer.registerPlugin(UniverPdfsUIPlugin, { thumbnailWorkerURL: new URL('./pdf-thumbnail-worker.js', import.meta.url),})Воркер должен работать в выделенной области Worker. Если он не настроен, в браузере нет необходимых API или страница требует ресурс только главного потока, миниатюры отрисовываются в главном потоке.
Граница публичного API
Интерфейс вызывает PDF-команды и службы внутри пакета. Наличие кнопки на ленте не означает существование одноимённого публичного метода. Для поддерживаемого программного редактирования используйте руководство по PDF Facade, для преобразования — Импорт и экспорт, а для печати из браузера — Печать.
Порядок меню и сеточная раскладка
order, gridLayout и updateMenuConfig() задают порядок вкладок, групп и пунктов, положение в сетке и обновление во время работы. В руководстве также есть ссылки на параметры Facade для своих меню.
Насколько полезно это руководство?