Univer PDFs API

Создавайте, находите, сохраняйте, открывайте и выгружайте модули PDF через PDF Facade API.

PDF Facade добавляет в FUniver модули PDF и точки входа страниц. Импортируйте точку входа с побочным эффектом до создания объекта API.

Подключение PDF Facade

TypeScript
import { FUniver } from '@univerjs/core/facade'import '@univerjs-pro/pdfs/facade'const univerAPI = FUniver.newAPI(univer)

Зарегистрируйте UniverPdfsPlugin в экземпляре Univer, чтобы приложение могло размещать модули PDF.

Создание, поиск и сохранение модулей PDF

Если document не указан, createPdf() создаёт модуль с одной пустой страницей A4. Передайте снимок, ранее возвращённый save(), чтобы восстановить модуль.

TypeScript
const pdf = univerAPI.createPdf({  id: 'project-brief',  name: 'Project brief',})const activePdf = univerAPI.getActivePdf()const samePdf = univerAPI.getPdf(pdf.getId())const snapshot = pdf.save()

Обновляйте работающий PDF методами Facade или командами. Сохранённый снимок следует считать отдельными данными для постоянного хранения.

Вход на страницу

FPdfPage — общая точка входа к редактируемым наложениям и импортированному нативному тексту страницы:

TypeScript
const firstPage = pdf.getPageByIndex(0) ?? pdf.insertPage()const elements = firstPage.getElements()const nativeText = firstPage.getTextSpans()

Для отдельных операций перейдите к разделам Страницы и элементы, Текст и списки, Таблицы, Изображения и разделители, Аннотации и нативный текст.

Выгрузка модуля PDF

Выгрузите ненужный модуль PDF по его идентификатору. Корневой экземпляр univer следует освобождать только при уничтожении всего приложения.

TypeScript
const pdf = univerAPI.getActivePdf()if (pdf) {  univerAPI.disposeUnit(pdf.getId())}

Точные сигнатуры и типы возвращаемых значений приведены в справочнике PDF Facade.

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

© 2026 DreamNum Co., Ltd.