如何使用Google Apps Script在选中文本段末尾追加文本？

需求说明 #

已实现从光标位置输出文本，现需升级功能：用户选中文本后，将该文本用于程序处理，同时在选中文本段的末尾追加内容。当前仅能从光标位置输出，无法针对选中区域操作。

解决方案 #

核心思路：定位选中文本的末尾位置，而非依赖光标位置，在该位置插入内容。以下是修改后的完整代码：

function appendTextToSelectedParagraph() {
  const doc = DocumentApp.getActiveDocument();
  const selection = doc.getSelection();
  if (!selection) {
    throw new Error('请选中一段文本');
  }

  const elements = selection.getSelectedElements();
  const lastElement = elements[elements.length - 1];
  let textElement, endOffset;

  // 判断选中的是文本片段还是完整元素，确定插入位置
  if (lastElement.isPartial()) {
    textElement = lastElement.getElement().asText();
    endOffset = lastElement.getEndOffsetInclusive() + 1;
  } else {
    textElement = lastElement.getElement().asText();
    endOffset = textElement.getText().length;
  }

  // 获取选中的文本用于程序处理
  const selectedText = getSelectedText().join(' ');
  // 示例处理逻辑：将选中文本转为大写
  const processedText = selectedText.toUpperCase();

  // 在选中文本末尾追加内容（可替换为自定义内容）
  textElement.insertText(endOffset, ` [处理后: ${processedText}]`);
}

// 保留原有的选中文本获取函数
function getSelectedText() {
  const selection = DocumentApp.getActiveDocument().getSelection();
  const text = [];
  if (selection) {
    const elements = selection.getSelectedElements();
    for (let i = 0; i < elements.length; ++i) {
      if (elements[i].isPartial()) {
        const element = elements[i].getElement().asText();
        const startIndex = elements[i].getStartOffset();
        const endIndex = elements[i].getEndOffsetInclusive();

        text.push(element.getText().substring(startIndex, endIndex + 1));
      } else {
        const element = elements[i].getElement();
        if (element.editAsText) {
          const elementText = element.asText().getText();
          if (elementText) {
            text.push(elementText);
          }
        }
      }
    }
  }
  if (!text.length) throw new Error('Please select some text.');
  return text;
}

关键逻辑说明 #

1. 定位插入位置：通过选中元素的最后一项，判断是部分选中还是完整选中，计算出选中文本的末尾偏移量endOffset
2. 处理选中文本：调用原getSelectedText函数获取选中内容，执行自定义处理逻辑（示例为转大写）
3. 追加内容：使用insertText方法在计算好的偏移位置插入内容，确保内容追加在选中文本的末尾

原方案无效原因 #

• 移动光标到未选中区域：无法关联选中文本的末尾位置，操作逻辑与需求不匹配
• 从光标位置输出：选中文本时光标处于选中状态，位置不确定，无法精准追加到选中文本末尾

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