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

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

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

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 版本。
• 系统主题模式：文档站点现支持系统主题检测，自动适配您操作系统的深色/浅色模式偏好。
• 可用性与本地化：我们重新设计了文档首页，并优化了中文文档内容，其中桌面编辑器章节已实现全文翻译。