# Обзор интерфейса

> Настройте холст PDF, элементы редактирования, локаль и воркер миниатюр.

- Human documentation: [https://docs.univer.ai/ru-RU/guides/pdfs/ui/overview](https://docs.univer.ai/ru-RU/guides/pdfs/ui/overview)

- Agent Markdown: [https://docs.univer.ai/ru-RU/guides/pdfs/ui/overview.md](https://docs.univer.ai/ru-RU/guides/pdfs/ui/overview.md)

- Requested language: `ru-RU`

- Content language: `ru-RU`

- Documentation version: `1.2.0`

- Source: [pdfs/ui/overview.ru-RU.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/pdfs/ui/overview.ru-RU.mdx)

---

`@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-плагина

```ts
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 и нижнюю панель. Редактирование включено по умолчанию и дополнительно регистрирует ленту, контекстные меню, инспектор, буфер обмена, команды вставки, действия и контроллеры редактирования.

Если приложение не должно показывать элементы редактирования, включите режим только для просмотра:

```ts
univer.registerPlugin(UniverPdfsUIPlugin, {
  editor: { enabled: false },
})
```

Параметр меняет только смонтированный интерфейс, а также контроллеры и службы, предназначенные для редактирования. Это не политика доступа, и он не изменяет сохранённый снимок PDF.

## Воркер миниатюр

`thumbnailWorkerURL` принимает строку, `URL` или существующий `Worker`. Указанный модуль должен запустить экспортируемую среду воркера:

```ts title="pdf-thumbnail-worker.ts"
import { startPdfPageThumbnailWorker } from '@univerjs-pro/pdfs-ui'

startPdfPageThumbnailWorker()
```

```ts
univer.registerPlugin(UniverPdfsUIPlugin, {
  thumbnailWorkerURL: new URL('./pdf-thumbnail-worker.js', import.meta.url),
})
```

Воркер должен работать в выделенной области Worker. Если он не настроен, в браузере нет необходимых API или страница требует ресурс только главного потока, миниатюры отрисовываются в главном потоке.

## Граница публичного API

Интерфейс вызывает PDF-команды и службы внутри пакета. Наличие кнопки на ленте не означает существование одноимённого публичного метода. Для поддерживаемого программного редактирования используйте [руководство по PDF Facade](https://docs.univer.ai/ru-RU/guides/pdfs/getting-started/facade.md), для преобразования — [Импорт и экспорт](https://docs.univer.ai/ru-RU/guides/pdfs/features/import-export.md), а для печати из браузера — [Печать](https://docs.univer.ai/ru-RU/guides/pdfs/features/print.md).

## Порядок меню и сеточная раскладка

[`order`, `gridLayout` и `updateMenuConfig()`](https://docs.univer.ai/ru-RU/guides/pdfs/features/core.md#menu-order-and-grid-layout) задают порядок вкладок, групп и пунктов, положение в сетке и обновление во время работы. В руководстве также есть ссылки на параметры Facade для своих меню.