Univer PDFs 简介

Univer PDFs 提供浏览器端 PDF 查看器与编辑器,支持持久化文档数据、Facade API、导入导出、协作和打印。

Univer PDFs 是什么

Univer PDFs 是 Univer Office SDK 中的 PDF 产品。它将 PDF 表示为正式的 UNIVER_PDF 单元,保留导入的源文档,并将已接受的编辑存储在独立的持久化编辑层中。浏览器 UI 会将这两层渲染为一份连续文档。

Univer Office SDK 包含三个 SDK:Web SDK 提供嵌入式编辑器和无头内容处理能力,Server SDK 提供协同与文件导入导出能力,AI SDK 提供 Agent 工作流能力。

当应用需要创建或打开 PDF、添加可编辑内容、保持导入 PDF 的保真度、协同修改、导出结果,或将当前文档交给浏览器打印流程时,可以使用 Univer PDFs。

仅支持插件模式

PDF 目前没有预设包。请显式注册 PDF 模型、UI 以及可选的功能插件。

浏览器兼容性

Web SDK 的编译目标是 Chrome 88,但这并不意味着 Web SDK 能够完全支持所有主流环境。我们会尽力确保 Web SDK 在以下浏览器和 Node.js 环境中能够正常运行:

EdgeFirefoxChromeSafariElectron
>=88>=90>=88>=14.1>=12

Web SDK 依赖 Intl.Segmenter,如果你的浏览器或运行时环境暂不支持它,请先补充对应的 polyfill。我们推荐使用 @formatjs/intl-segmenter

如果遇到无法兼容的情况,请先借助对应的 polyfill 来解决,如果仍然无法解决,请提交 issue

Node.js 兼容性

以下仅适用于在 Node.js 环境中运行 Web SDK 的情况,并不适用于那些基于 Node.js 使用构建工具在浏览器中运行 Web SDK 的情况。

Web SDK 可以在 Node.js 环境中运行,支持的版本为 v18.17.0 及之后的版本。

主要功能

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

如何使用这些文档

在屏幕的左侧是文档导航栏。文档页面按从基础到高级的顺序组织,你可以按照这个顺序循序渐进地了解 Web SDK,或者跳到你感兴趣的章节。你还可以在侧边栏的顶部切换 Univer PDFs 的文档。

屏幕的右侧是当前页面的大纲。如果你需要快速找到页面,可以使用顶部的搜索栏或搜索快捷键(Ctrl+K 或 Cmd+K)。

我们推荐从 快速开始 出发了解 Web SDK。

前置知识

尽管我们已经尽力使得文档对新手也易于理解,但是我们必须假设你在开始阅读之前已经了解了一些基础知识,以便我们的文档可以专注于 Web SDK。

为了充分利用我们的文档,建议你对 JavaScript 及其生态系统有基本的了解。

如果你有兴趣在 Node.js 上运行 Web SDK,你还应该对 Node.js 有基本的了解。

如果你想尝试高级功能并部署 Univer Server,我们建议你对 Linux、Docker 和 Docker Compose(或 Kubernetes)有基本的了解。

扩展 Univer PDFs

在设计之初,Web SDK 就被设计为高度可扩展的,因此你可以根据自己的需求来定制它。

你觉得这篇文档如何?

© 2026 DreamNum Co., Ltd.