Spire.OfficeJS 是一套支持私有化部署的在线 Office 文档编辑套件,也是一款可嵌入网页的在线 Office 编辑器,面向需要将文档编辑能力集成到自有 Web 应用中的开发者与企业。用户可以在浏览器中打开、查看、编辑和保存 Word、Excel 和 PowerPoint 文档,并以只读方式预览 PDF。客户端无需安装 Microsoft Office、WPS 或浏览器插件。
它提供的不是碎片化的底层 API,而是可直接嵌入业务页面的 JavaScript Office 编辑器:业务页面加载 SpireCloudEditor.js,准备容器元素并传入配置,编辑器即以 iframe 形式加载对应界面。文档的解析、排版、渲染和编辑默认由浏览器内的 WebAssembly 文档引擎完成。但这并不意味着无需部署:SpireCloudEditor.js、编辑器界面、WebAssembly 引擎和字体等资源仍需部署在浏览器可访问的资源服务上,完整的产品组成与运行架构见 产品组成与运行架构。
核心功能
- 在线编辑:支持 Word、Excel、PPT 在线编辑,在浏览器中打开、查看、编辑和保存文档,并支持“下载为”导出。
- PDF 预览:在同一套界面中只读预览 PDF。
- 协作与审阅:支持协同编辑、评论、修订和文档历史。
- 界面定制:支持菜单栏、工具栏、界面语言和多种布局等外观配置项,便于灵活控制界面效果。
产品组成
Spire.OfficeJS 的产品包包含三个编辑器模块,以及 PDF 预览能力,它们共享同一套编辑器入口和运行时:
| 文档类型 | 编辑器模块 | 文档引擎 | 主要能力 |
|---|---|---|---|
| Word 文档 | web/editors/spiredocument |
Spire.Doc WebAssembly |
打开、查看、编辑、保存和“下载为” |
| Excel 表格 | web/editors/spirespreadsheet |
Spire.Xls WebAssembly |
打开、查看、编辑、保存和“下载为” |
| PowerPoint 演示文稿 | web/editors/spirepresentation |
Spire.Presentation WebAssembly |
打开、查看、编辑、保存和“下载为” |
| PDF 文档 | —(由 spiredocument 提供) |
Spire.Pdf WebAssembly |
只读预览 |
每个编辑器模块都提供 desktop、mobile 和 embed 三种界面布局。完整的格式支持清单请参阅 支持的文件格式。
典型应用场景
| 场景 | 典型需求 | Spire.OfficeJS 的作用 |
|---|---|---|
| 文档管理系统 | 在线预览、编辑和保存 Office 文件 | 在文件列表旁直接打开编辑器,减少下载和上传环节 |
| OA、审批与合同系统 | 批注、修订、权限控制和留痕 | 按角色控制编辑、评论和下载权限,支持审阅与历史记录 |
| 企业网盘与 SaaS 平台 | 将文档能力嵌入自有产品 | 通过配置和界面定制融入现有品牌与工作流 |
| 在线教育与培训 | 作业批改、课件预览、多人讨论 | 在线编辑与评论,配合只读模式展示资料 |
| 档案与知识库 | 统一预览多种格式 | Word、Excel、PPT 和 PDF 在同一套界面中打开 |
与自研及公有云方案的区别
在业务系统中集成文档能力,常见做法各有代价:一是下载、编辑、再上传的流程割裂;二是自行研发浏览器端渲染与编辑的成本高;三是依赖服务端转换带来的压力;四是使用公有云办公套件时,界面、权限与数据存储难以完全贴合业务系统。Spire.OfficeJS 将文档处理放在浏览器内完成,以同一套入口覆盖 Word、Excel、PPT 和 PDF,部署资源与文档数据都留在业务系统一侧,实现私有化部署,适合对数据位置、界面品牌和部署方式有要求的场景。
授权
Spire.OfficeJS 是商业组件,授权文件路径通过产品包中的配置文件指定,具体放置和激活方式可参考文档 Spire.OfficeJS License 配置。







