匯入匯出
使用下方瀏覽器 API 前，請先完成匯入匯出整合。應用程式需要實作與用戶端匹配的上傳、轉換、任務查詢和受權限保護的下載契約。快照 API 仍需要轉換後端，只是不要求持久化協同 Unit。Exchange 範例示範 Sheets；其他產品和格式需核對目標版本的支援範圍。
支援的格式
下表列出本頁前端 API 支援的格式。Office 檔案轉換還需要後端支援對應的文件類型和格式。
| 匯入 | 匯出 |
|---|---|
.doc, .docx | .docx |
Facade API
匯入
外掛模式提示
僅外掛模式需要手動引入 Facade 套件。預設模式已內建對應的 Facade 套件，無需額外引入。
import '@univerjs-pro/exchange-client/facade'import '@univerjs-pro/docs-exchange-client/facade'匯入 .docx
匯入 .docx 檔案並獲取 unitId
注意事項
此方法依賴協同服務：匯入後會在服務端建立文件並回傳 unitId。若未啟用協同，請使用快照匯入。
在啟用協同編輯的時候，每個文件都有一個唯一的 unitId。使用 univerAPI.importDocToUnitIdAsync 傳入 file 參數會返回 unitId，可以透過 unitId 來訪問文件。 file 參數可以是一個 File 物件，也可以是遠端檔案的 URL。
import '@univerjs-pro/collaboration-client/facade'const unitId = await univerAPI.importDocToUnitIdAsync(file)if (unitId) { await univerAPI.getCollaboration().loadDocAsync(unitId)}匯入 .docx 檔案並獲取 IDocumentData
使用 univerAPI.importDocToSnapshotAsync 匯入 .docx 檔案，會返回 IDocumentData 格式的文件資料。
// 接受 File 物件const snapshot = await univerAPI.importDocToSnapshotAsync(file)// 或者接受遠端檔案的 URL// const snapshot = await univerAPI.importDocToSnapshotAsync('https://example.com/filename.docx');// 透過快照建立一個新的文件if (snapshot) univerAPI.createDocument(snapshot)匯出 .docx
透過 unitId 匯出 .docx 檔案
注意事項
unitId 匯出依賴協同服務。若未啟用協同，請使用快照匯出。
在啟用協同編輯的時候，每個文件都有一個唯一的 unitId。使用 univerAPI.exportDocByUnitIdAsync 傳入 unitId 參數會返回 File 物件。
const fDocument = univerAPI.getActiveDocument()const unitId = fDocument.getId()const file = await univerAPI.exportDocByUnitIdAsync(unitId)// 透過 Facade API 下載檔案if (file) univerAPI.downloadFile(file, 'univer', 'docx')透過 IDocumentData 匯出 .docx 檔案
使用 univerAPI.exportDocBySnapshotAsync 傳入 IDocumentData 會返回 File 物件。
const fDocument = univerAPI.getActiveDocument()const snapshot = fDocument.save()const file = await univerAPI.exportDocBySnapshotAsync(snapshot)// 透過 Facade API 下載檔案if (file) univerAPI.downloadFile(file, 'univer', 'docx')移除內建匯入匯出選單和 UI 互動
Univer 移除了內建的匯入匯出選單和 UI 互動，底層服務及 Facade API 繼續保留。
如果你的應用程式需要保留原有的匯入匯出選單和 UI 互動，可以參考內建匯入匯出選單和 UI 互動遷移方案，透過自訂外掛完成遷移。範例提供完整原始碼，支援線上檢視和下載。
你覺得這篇文檔如何？