Spire.OfficeJS 支持 Word、Excel、PowerPoint 和 PDF 四类文档:前三类可以打开和编辑,PDF 仅用于预览。新建和长期存储建议使用 DOCX、XLSX、PPTX,与 WPS Office 互通使用 WPS、ET、DPS 等格式,对外分发和归档使用 PDF。
支持的格式
| 文档类型 | 编辑器模块 | 支持方式 | 格式 |
|---|---|---|---|
| Word 文档 | spiredocument |
打开与编辑 | DOCX、DOCM、DOC、DOTX、DOTM、DOT、ODT、FODT、OTT、TXT、WPS、WPT |
| Excel 表格 | spirespreadsheet |
打开与编辑 | XLSX、XLSM、XLS、XLTX、XLTM、XLT、CSV、ET、ETT |
| PowerPoint 演示文稿 | spirepresentation |
打开与编辑 | PPTX、PPTM、PPT、PPSX、PPSM、PPS、POTX、POTM、POT、DPS、DPT |
| PDF 文档 | spiredocument |
仅预览 | PDF、XPS |
- 旧格式(DOC、XLS、PPT)可打开和编辑,建议另存为 DOCX、XLSX、PPTX。
- RTF、HTML、HTM、MHT 不在 Word 打开列表中,需先转换为 DOCX。
- 缺少文档使用的字体会导致换行和分页变化,请参考 字体管理 配置。
- PDF 仅支持预览,不提供编辑入口。
保存与导出
保存时通常沿用原格式,可通过 fileAttrs.callbackUrl 或 editorAttrs.events.onSave 将文件数据交给业务系统。下载入口为“文件 → 下载为…”,下表为该菜单中的格式清单,实际可选项可能因版本或运行模式而异:
| 文档类型 | 下载格式 |
|---|---|
| Word | DOCX、DOC、DOCM、DOTX、DOTM、DOT、PDF、RTF、TXT、HTML、XPS、EPUB、WordXML(Word 2003 XML) |
| Excel | XLSX、XLS、XLSM、XLSB、XLTX、XLTM、XLT、CSV、ODS、ET、ETT、PDF、XPS |
| PowerPoint | PPTX、PPT、PPTM、PPSX、PPS、POTX、POTM、DPS、DPT、PDF、XPS、PS(PostScript) |
| 按原文件下载,不提供格式转换 |
通过 downloadAs 调用时,支持范围小于上表,具体取值和示例见 转换和下载。
在 WebAssembly(serverless)模式下,下载由浏览器内的引擎完成,无需另设转换服务。跨格式导出会重新排版,特殊字体和复杂版式可能存在差异,建议导出后逐页检查。







