迁移旧版Office加载项至2016/365：咨询office-js对各类域的支持范围

Hi Hari, 我刚好之前做过类似的Office加载项迁移工作，针对你提到的几个域的支持情况，整理了以下细节，希望能帮到你：

表单域 #

• Office 2016 for Windows：对传统表单域（如文本框、复选框、下拉框这类旧版控件）有部分支持，可通过VBA或早期COM接口访问；用office.js的话仅能有限读取部分属性，部分交互功能会受限。
• Office 365（Windows客户端）：更偏向支持新的内容控件（Content Controls），传统表单域的支持被大幅削减，程序化访问的兼容性很差。
• Office 365 Web版/Mac版：完全不支持传统表单域的程序化访问，若你的用户群体覆盖这些平台，建议尽快切换到内容控件方案。

书签域 #

• Office 2016 for Windows：可通过VBA或COM接口访问书签的位置与关联内容，但office.js本身没有直接暴露书签域的API。
• Office 365全平台：office.js同样无直接访问书签的接口，官方推荐用内容控件的Tag属性模拟书签功能，实现内容定位与标识。

邮件合并域 #

• Office 2016 for Windows：传统邮件合并域可通过VBA访问，但office.js无对应API支持；你可通过读取文档中的合并域标记文本（如<<FirstName>>格式）间接提取数据。
• Office 365全平台：office.js无原生邮件合并域API，且Web版Office的邮件合并功能本身限制较多；建议优先将合并域转换为内容控件，或通过正则表达式匹配标记文本实现数据提取。

目前office.js的API设计更偏向现代内容控件与文档对象模型，对旧版域支持非常有限：

• 表单域：仅Excel中有部分针对表单控件的API（如Excel.FormControl），Word中无专门针对传统表单域的API；官方推荐用Word.ContentControl替代旧表单域，它在全平台Office 365和Office 2016+中都有稳定支持。
• 书签域：无直接操作书签的API，建议用内容控件的tag或title属性标识需定位的内容区域，以此替代书签功能。
• 邮件合并域：无原生API支持，可通过Word.Range遍历文档内容，用正则表达式匹配合并域标记格式（如<<.+?>>）提取元数据；或在文档预处理阶段将合并域转换为内容控件，通过office.js轻松访问。

1. 若需兼容多平台，优先将所有旧版域替换为内容控件，这是office.js支持最好的方案，能在全平台Office 365和Office 2016+稳定运行。
2. 若必须保留旧版表单域（如用户仍用Office 2016 Windows），可考虑混合开发：用office.js处理跨平台逻辑，Windows客户端中通过Office.context.document.settings调用VBA代码访问旧表单域数据，但会增加开发复杂度。
3. 若无法将邮件合并域转换为内容控件，可通过读取文档OXML（Word.document.getOXmlAsync）解析合并域结构，但需熟悉Word的OXML格式，开发成本较高。

内容的提问来源于stack exchange，提问作者Hari