年关将至，ONLYOFFICE 给开发者送来“大礼包”：ONLYOFFICE文档9.2版本正式发布。此次更新显著扩展了 Office JavaScript API 功能，为插件和宏程序注入全新能力，并实现了文档功能的全面优化。
对于基于 ONLYOFFICE 进行开发的开发者而言，本次更新提供了对文档元素的精细化控制、增强的表单操作功能以及更完善的集成工具。无论您是自动化文档创建、构建复杂插件还是集成ONLYOFFICE协作空间，本次版本都有适合您的功能。接下来，让我们深入探讨技术细节。
关于 ONLYOFFICE
ONLYOFFICE 是一个开源项目，专注于高级和安全的文档处理和协作。全球超过 1500 万用户，是在线办公领域的创新者。
ONLYOFFICE 文档提供文本文档、电子表格、幻灯片、表单和 PDF 编辑器，高度兼容微软 Office 格式，并提供数百种格式化和样式工具，以及多种协作功能，包括实时和段落锁定两种共同编辑模式、评论和审阅、内置聊天、版本历史等。该套件可在 Windows、Linux、Android 和 iOS上使用，包括网页、电脑桌面和手机/平板等移动设备。
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 版本。
- 系统主题模式：文档站点现支持系统主题检测，自动适配您操作系统的深色/浅色模式偏好。
- 可用性与本地化：我们重新设计了文档首页，并优化了中文文档内容，其中桌面编辑器章节已实现全文翻译。
如果想要了解更多，可访问API 更新日志查看详情。
