API 更新汇总:ONLYOFFICE 文档 9.2 和协作空间 3.6

2025年12月17日作者:Selie

年关将至,ONLYOFFICE 给开发者送来“大礼包”: ONLYOFFICE 文档9.2版本正式发布。此次更新显著扩展了 Office JavaScript API 功能,为插件和宏程序注入全新能力,并实现了文档功能的全面优化。

对基于 ONLYOFFICE 进行开发的开发者而言,本次更新提供了对文档元素的精细化控制、增强的表单操作功能以及更完善的集成工具。无论您是自动化文档创建、构建复杂插件还是集成 ONLYOFFICE 协作空间,本次版本都有适合您的功能。接下来,让我们深入探讨技术细节。

ONLYOFFICE API updates: What’s new in December 2025

Office JavaScript API:扩展控制功能

Office JavaScript API 在整个办公套件中都新增了大量的控制方法。

增强的表单操作功能

程序化处理表单的功能现已更加强大。我们引入了全新方法,可精确处理表单元素。

复选框表单方法。您现在可在表单 API 和文本文档 API 中动态管理复选框标签:

  • ApiCheckBoxForm/GetLabel
  • ApiCheckBoxForm/SetLabel

生命周期与 ID 管理。我们规范了与表单对象的交互方式。在表单 API 和文本文档 API 中,几乎所有表单类型都新增了 Delete 和 GetInternalId 方法,包括:

  • ApiCheckBoxForm
  • ApiComboBoxForm
  • ApiComplexForm
  • ApiDateForm
  • ApiFormBase
  • ApiPictureForm
  • ApiTextForm

这种精细控制使动态表单管理时代码更简洁,可通过程序化方式移除元素或通过内部 ID 引用它们。

用于演示文稿和电子表格 API 的段落方法

本次更新最重要的功能之一是将 ApiParagraph 方法扩展至演示文稿和电子表格 API 。此前,深度段落操作主要由文本文档 API 实现。现在,您可在幻灯片和工作表中直接应用富文本格式和结构调整。

  • 结构类方法: InsertParagraph、Push、Last、GetLastRunWithText
  • 格式设置: SetBold、SetItalic、SetUnderline、SetStrikeout、SetDoubleStrikeout、SetCaps、SetSmallCaps
  • 样式设置: SetColor、SetFontSize、SetFontFamily、SetSpacing
  • 属性设置: GetFontNames、SetTextPr
  • 数据处理: ToJSON、GetInternalId

这统一了跨编辑器的开发者体验,无论您是在文档中生成报告还是在幻灯片中格式化文本框,都能提升代码复用性。

单位转换辅助工具

处理 Office Open XML中的度量单位时,常需在英制单位(EMUs)与标准单位间转换。我们为演示文稿、电子表格和文本文档 API 新增了辅助方法简化此操作:

  • Api/EmusToMillimeters
  • Api/MillimetersToEmus

导航与内容访问

针对文本文档 API ,我们优化了光标移动与内容插入功能,这对自动化输入或编辑的宏至关重要:

  • ApiDocument/MoveCursorDown, MoveCursorLeft, MoveCursorRight, MoveCursorUp
  • ApiDocument/EnterText
  • ApiDocument/InsertParagraphBreak

此外,通过新增的 ApiDocumentContent 方法,如: GetAllParagraphs, GetCurrentParagraph,和 GetText 可更便捷地访问演示文稿和电子表格中的内容。

查看新增方法的完整列表

文档插件:优化开发体验

构建插件不仅关乎代码本身,更涉及开发者体验与最终用户界面。

调试教程

我们在网页版桌面版编辑器的教程中新增了调试子章节。这些指南将帮助您更快更高效地排查插件故障。

界面一致性

  • 图标:我们更新了插件图标页面并添加最佳实践指南。添加图标虽是小步骤,却能显著提升可用性,使界面更直观。
  • 主题适配:新增“主题定制指南”详解插件如何检测编辑器当前主题并动态响应,确保无论用户处于深色模式或浅色模式,插件界面均能实现原生适配。

本地化故障排除

我们在本地化页面新增故障排除专区,助您解决面向全球用户进行插件翻译时的常见问题。

协作空间 SDK 更新

针对集成基于房间的协作平台—— ONLYOFFICE 协作空间的开发者, JavaScript SDK 已完成更新。文档结构经重构后,现通过直接调用协作空间文件自动生成,确保您查阅的参考资料始终与实际代码保持同步。

API 文档站点优化

我们正持续改进 API 文档站点,使其运行更快速、使用更便捷。

  • 引擎:文档生成框架 Docusaurus 已升级至 3.9.2 版本。
  • 系统主题模式:文档站点现支持系统主题检测,自动适配您操作系统的深色/浅色模式偏好。
  • 可用性与本地化:我们重新设计了文档首页,并优化了中文文档内容,其中桌面编辑器章节已实现全文翻译。

创建免费的 ONLYOFFICE 账户

在线查看并协作编辑文本文档、电子表格、幻灯片、表单和 PDF 文件。