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 SDK 模組,並自行接入身分驗證、權限、儲存及部署。僅使用瀏覽器編輯功能時,無需建立這些服務。

擴充 Univer PDFs

在設計之初,Web SDK 就被設計為高度可擴充的,因此你可以根據自己的需求來客製化它。

你覺得這篇文檔如何?

© 2026 DreamNum Co., Ltd.