Univer Slides 簡介
Univer Slides 提供 Univer Office SDK 中的簡報編輯產品能力。
Univer Slides 是什麼
Univer Slides 是 Univer Office SDK 中的簡報產品能力。它用來建構投影片編輯器、播放檢視、匯入匯出流程,以及基於 Web SDK runtime 的服務端投影片處理能力。
Univer Office SDK 包含三個 SDK:Web SDK 提供嵌入式編輯器和無頭內容處理能力,Server SDK 提供協同與檔案匯入匯出能力,AI SDK 提供 Agent 工作流程能力。
Slides 是獨立的 Web SDK unit type。執行時需要建立 UniverInstanceType.UNIVER_SLIDE unit,然後依需求註冊 側的模型、UI 和可選功能外掛。
Univer Slides 位於 @univerjs-pro 套件範圍內。需要授權的功能請設定用戶端授權;需要協同或檔案轉換時,再按需接入 Univer Server SDK。
瀏覽器相容性
Web SDK 的編譯目標是 Chrome 88,但這並不意味著 Web SDK 能夠完全支援所有主流環境。我們會盡力確保 Web SDK 在以下瀏覽器和 Node.js 環境中能夠正常運行:
| Edge | Firefox | Chrome | Safari | Electron |
|---|---|---|---|---|
| >=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 及之後的版本。
主要功能
- 簡報模型:管理簡報識別、頁面尺寸、投影片順序、投影片、母片頁、版面配置頁、主題、轉場效果和資源。
- 算繪與編輯:提供投影片畫布、縮圖、選取、剪貼簿、文字與圖形編輯、對齊參考線和播放功能。
- 命令管線:透過命令和變更套用頁面與元素更新,使模型、算繪以及復原和重做保持同步。
- Facade API:透過面向應用程式的物件建立和尋找簡報、儲存快照,並操作投影片和元素。
- 外掛程式架構:表格、圖表、列印和匯入匯出等選用功能與核心外掛程式堆疊相互獨立。
如何使用這些文件
在螢幕的左側是文件導航欄。文件頁面按從基礎到高階的順序組織,你可以按照這個順序循序漸進地瞭解 Web SDK,或者跳到你感興趣的章節。你還可以在側邊欄的頂部切換 Univer Slides 的文件。
螢幕的右側是當前頁面的大綱。如果你需要快速找到頁面,可以使用頂部的搜尋欄或搜尋快捷鍵(Ctrl+K 或 Cmd+K)。
我們推薦從 快速開始 出發瞭解 Web SDK。
前置知識
儘管我們已經盡力使得文件對新手也易於理解,但是我們必須假設你在開始閱讀之前已經瞭解了一些基礎知識,以便我們的文件可以專注於 Web SDK。
為了充分利用我們的文件,建議你對 JavaScript 及其生態系統有基本的瞭解。
如果你有興趣在 Node.js 上執行 Web SDK,你還應該對 Node.js 有基本的瞭解。
需要協同編輯、共享歷史或評論、檔案轉換時,請在業務後端按需組合 Univer Server SDK 模組,並自行接入身分驗證、權限、儲存及部署。僅使用瀏覽器編輯功能時,無需建立這些服務。
擴充 Univer Slides
在設計之初,Web SDK 就被設計為高度可擴充的,因此你可以根據自己的需求來客製化它。
你覺得這篇文檔如何?