核心功能

插件信息

Univer PDFs 核心功能包括正式的 PDF Unit、持久化编辑层和浏览器工作台。导入的 PDF 内容保留为源基线,已接受的修改则存储在 Unit 快照中,并渲染为当前文档。

功能

  • PDF Unit 模型:在 IPdfUnitData 中存储源文档、页面结构、资源和持久化编辑意图。
  • 页面与元素操作:支持页面导航和插入,以及可编辑的文本、列表、表格、图像、分隔线和批注。
  • 浏览器工作台:提供 PDF 页面渲染、缩略图、选择、编辑控件、剪贴板行为和检查器界面。
  • 命令管线:通过持久化命令和变更批次应用已接受的修改,使保存、撤销和重做共享同一模型。
  • Facade API:通过 PDF、页面、元素和原生文本对象创建、查找、编辑和保存 PDF Unit。

预设模式

Univer PDFs 当前没有提供预设包。请使用插件模式创建 PDF 应用。

插件模式

安装

Shell
pnpm add @univerjs/core @univerjs/design @univerjs/ui @univerjs-pro/license @univerjs-pro/pdfs @univerjs-pro/pdfs-ui

使用

TypeScript
import { UniverLicensePlugin } from '@univerjs-pro/license'import { UniverPdfsPlugin } from '@univerjs-pro/pdfs'import { UniverPdfsUIPlugin } from '@univerjs-pro/pdfs-ui'import PdfsUIEnUS from '@univerjs-pro/pdfs-ui/locale/en-US'import { LocaleType, mergeLocales, Univer } from '@univerjs/core'import { FUniver } from '@univerjs/core/facade'import DesignEnUS from '@univerjs/design/locale/en-US'import { UniverUIPlugin } from '@univerjs/ui'import UIEnUS from '@univerjs/ui/locale/en-US'import '@univerjs-pro/pdfs/facade'import '@univerjs/design/lib/index.css'import '@univerjs/ui/lib/index.css'import '@univerjs-pro/pdfs-ui/lib/index.css'const univer = new Univer({  locale: LocaleType.EN_US,  locales: {    [LocaleType.EN_US]: mergeLocales(DesignEnUS, UIEnUS, PdfsUIEnUS),  },})univer.registerPlugin(UniverUIPlugin, { container: 'app' })univer.registerPlugin(UniverLicensePlugin, {  license: process.env.CLIENT_LICENSE_TEXT,})univer.registerPlugin(UniverPdfsPlugin)univer.registerPlugin(UniverPdfsUIPlugin)const univerAPI = FUniver.newAPI(univer)const pdf = univerAPI.createPdf({ name: 'Untitled PDF' })

UniverPdfsPlugin 负责 PDF Unit 和持久化命令,UniverPdfsUIPlugin 负责浏览器查看器及其编辑控件。仅需查看界面时,请用 { editor: { enabled: false } } 注册 UniverPdfsUIPlugin。基于协作的应用可以另外安装 @univerjs-pro/pdfs-editor,并同时注册它依赖的协作插件。

你觉得这篇文档如何?

© 2026 DreamNum Co., Ltd.