能否通过Google Apps Script获取/设置文档左、中、右制表位位置？

你说得没错，目前Google Apps Script的Document Service（也就是我们常用的DocumentApp类）确实没有提供类似getIndentFirstLine()那样直接获取左、中、右制表位位置的方法——这确实是个挺让人头疼的痛点，尤其是当需要批量处理文档格式的时候。

不过别担心，我们可以借助Advanced Drive Service结合Google Docs的原生API结构来实现这个需求，下面我给你详细说怎么做：

一、启用所需的高级服务 #

首先得在你的脚本编辑器里开启两个关键服务：

• 打开脚本编辑器，点击顶部菜单栏的「资源」→「高级Google服务」
• 在弹出的窗口里找到「Drive API」和「Docs API」，把它们的开关都打开，然后点击「确定」

二、获取段落的制表位位置 #

通过Advanced Drive Service，我们可以获取到文档的完整JSON结构，里面包含了所有段落的制表位细节。下面是一段可直接运行的示例代码：

function getTabStops() {
  const docId = DocumentApp.getActiveDocument().getId();
  // 获取文档的完整原生结构
  const doc = Drive.Files.get(docId, { alt: 'json' });
  
  // 遍历文档中的每个内容元素
  doc.body.content.forEach(element => {
    if (element.paragraph) {
      const paragraph = element.paragraph;
      // 检查段落是否设置了制表位
      if (paragraph.paragraphStyle?.tabStops) {
        const tabStops = paragraph.paragraphStyle.tabStops;
        console.log("当前段落的制表位信息：");
        tabStops.forEach(tabStop => {
          // 制表位类型对应LEFT/CENTER/RIGHT，offset是位置（单位：磅pt）
          console.log(`类型：${tabStop.alignment}，位置：${tabStop.offset}pt`);
        });
      }
    }
  });
}

运行这段代码后，你就能在控制台看到每个段落的制表位类型和具体位置了，这里的offset数值和你在文档手动设置的数值是完全对应的（1英寸=72磅）。

三、设置段落的制表位位置 #

如果要批量设置制表位，我们可以用Docs API的批量更新功能来实现，示例代码如下：

function setTabStops() {
  const docId = DocumentApp.getActiveDocument().getId();
  // 构造更新请求
  const requests = [
    {
      updateParagraphStyle: {
        paragraphStyle: {
          tabStops: [
            { alignment: "LEFT", offset: 72 },    // 1英寸位置的左制表位
            { alignment: "CENTER", offset: 144 }, // 2英寸位置的中制表位
            { alignment: "RIGHT", offset: 216 }   // 3英寸位置的右制表位
          ]
        },
        fields: "tabStops", // 指定要更新的字段为制表位
        // 指定要修改的段落范围，这里以第一个段落为例（索引从1开始）
        range: {
          startIndex: 1,
          endIndex: 2
        }
      }
    }
  ];
  
  // 发送更新请求到Docs API
  Docs.Documents.batchUpdate({ requests }, docId);
}

你可以根据自己的需求调整range里的索引范围，或者添加多个updateParagraphStyle请求来批量修改多个段落的制表位。

小提示 #

如果你需要和DocumentApp里的段落操作结合使用，可以先通过DocumentApp获取段落的getStartOffset()和getEndOffsetInclusive()来确定range的索引值，这样就能精准定位到你想要修改的段落了。

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