Univer PDFs

Что такое Univer PDFs

Univer PDFs — это продукт Univer Office SDK для работы с PDF. Он представляет PDF как полноценный модуль UNIVER_PDF, сохраняет импортированный исходный документ и записывает принятые правки в отдельный сохраняемый слой. Браузерный интерфейс отображает оба слоя как один непрерывный документ.

Univer Office SDK включает Web SDK для встроенных редакторов и обработки контента без интерфейса, Server SDK для совместной работы и импорта и экспорта файлов, а также AI SDK для рабочих процессов агентов.

Используйте Univer PDFs, если приложению нужно создавать или открывать PDF, добавлять редактируемое содержимое, сохранять точность импортированного PDF, совместно вносить изменения, экспортировать результат или передавать активный документ в браузерный процесс печати.

Совместимость с браузерами

Web SDK компилируется для Chrome 88, но это не означает полной поддержки всех распространённых сред. Мы стремимся обеспечить стабильную работу Web SDK в следующих браузерах и средах Node.js:

Если возникли проблемы с совместимостью, сначала попробуйте устранить их с помощью подходящих полифилов. Если проблема сохраняется, создайте issue.

Совместимость с Node.js

Web SDK может работать в среде Node.js и поддерживает версии v18.17.0 и выше.

Основные возможности

• Модель PDF Unit: хранит исходный документ, структуру страниц, ресурсы и постоянные правки в IPdfUnitData.
• Операции со страницами и элементами: поддерживает навигацию и вставку страниц, а также редактируемый текст, списки, таблицы, изображения, разделители и аннотации.
• Браузерная рабочая область: отображает страницы PDF и миниатюры, предоставляет выделение, элементы редактирования, буфер обмена и инспектор.
• Конвейер команд: применяет принятые изменения через постоянные команды и пакеты мутаций, чтобы сохранение, отмена и повтор использовали одну модель.
• Facade API: создаёт, находит, изменяет и сохраняет PDF Unit через объекты PDF, страниц, элементов и исходного текста.

Как читать документацию

Слева на экране находится панель навигации по документации. Страницы расположены последовательно — от базовых тем к более сложным, поэтому при создании приложения их можно изучать шаг за шагом. При этом вы можете читать их в любом порядке или сразу переходить к тем страницам, которые относятся к вашему сценарию. В верхней части боковой панели также можно выбрать Univer PDFs.

Справа на экране находится оглавление, с помощью которого удобно переходить между разделами страницы. Чтобы быстро найти нужную страницу, воспользуйтесь строкой поиска вверху или сочетанием клавиш для поиска (Ctrl+K или Cmd+K).

Для начала ознакомьтесь с руководством «Быстрый старт».

Необходимые знания

Хотя наша документация рассчитана на начинающих, для её ясности и сосредоточенности на Web SDK мы предполагаем некоторый базовый уровень знаний.

Чтобы получить от документации максимум пользы, рекомендуем знать основы JavaScript и его экосистемы.

Если вы хотите запускать Web SDK в Node.js, также потребуется базовое понимание Node.js.

Для совместного редактирования, общей истории или комментариев и преобразования файлов подключите нужные модули Univer Server SDK к своему backend. Приложение отвечает за аутентификацию, права, хранение и развёртывание. Для редактирования только в браузере эти сервисы не нужны.

Расширение Univer PDFs

Web SDK обладает широкими возможностями расширения, поэтому его можно адаптировать под свои задачи.