Word JS：如何通过段落文本起止索引获取Range对象？

核心问题解答 #

当前Word JavaScript API 完全支持通过段落内的起止字符索引创建Range对象，这能彻底解决文本搜索带来的假阳性匹配问题，实现精准高亮。该功能在Word API 1.3及以上版本就已支持，目前主流Office 365环境均满足要求。

具体实现方法 #

针对单个段落，可直接调用paragraph.getRange(startIndex, endIndex)方法创建指定范围的Range：

• startIndex：段落内文本的起始字符索引（从0开始，包含该位置字符）
• endIndex：段落内文本的结束字符索引（不包含该位置字符，即实际选中到endIndex-1位置）

修改后的代码示例 #

假设你的textAPI已返回正确的索引数组（如[[5,15], [19,38], [56,57]]，对应原示例中目标文本的字符范围），修改代码如下：

async function run() {
  Word.run(async (context) => {
    const color = Office.context.document.settings.get("parentheticalColor");
    const paragraphs = context.document.body.paragraphs;
    paragraphs.load("items");
    await context.sync();

    for (let i = 0; i < paragraphs.items.length; i++) {
      const paragraph = paragraphs.items[i];
      // 加载段落文本，确保与textAPI使用的文本一致
      paragraph.load("text");
      await context.sync();
      
      const text = paragraph.text;
      const response = await textAPI(text);
      const indexPairs = response.parentheticals; // 格式：[[start, end], [start, end], ...]

      // 批量创建Range并设置格式
      for (const [start, end] of indexPairs) {
        const range = paragraph.getRange(start, end);
        range.font.color = color;
      }
    }

    await context.sync();
  }).catch(function (error) {
    console.log("Error: " + JSON.stringify(error));
  });
}

关键注意事项 #

• 确保textAPI返回的索引是基于段落纯文本的相对索引（与paragraph.text的字符位置完全对应），不要使用整个文档的全局索引
• 处理段落时，避免在获取文本后修改段落内容，否则索引会失效
• 若需处理引号、非嵌套括号等不同类型的高亮，可让textAPI返回带类型的索引数据，再分别设置不同颜色

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