Google Script设置选中文字背景色问题：整段高亮而非选中区域

我尝试在Google文档中仅为选中的文字修改背景色，以下代码大多参考自某技术回答，但当前运行后会高亮整个段落而非选中的文字区域，请问需要修改代码的哪部分？

function highlightSelected() {
  // 尝试获取文档当前选中内容，若失败（如未选中任何内容）则弹出提示并退出函数
  var selection = DocumentApp.getActiveDocument().getSelection();
  if (!selection) {
    DocumentApp.getUi().alert('Cannot find a selection in the document.');
    return;
  }
  var selectedElements = selection.getSelectedElements();
  for (var i = 0; i < selectedElements.length; ++i) {
    var selectedElement = selectedElements[i];
    // 仅修改可编辑为文本的元素，跳过图片等非文本元素
    var text = selectedElement.getElement().editAsText();
    text.setBackgroundColor('#00FFFF');
  }
}

问题出在你没区分「整个文本元素被选中」和「文本元素的一部分被选中」的情况！当前代码直接给整个文本元素（比如整段）设置背景色，自然会高亮整段。我们可以利用Google Apps Script的选中范围判断来修正：

核心修改点 #

1. 用 selectedElement.isPartial() 判断当前选中的是元素的一部分还是全部
2. 如果是部分选中，通过 getStartOffset() 和 getEndOffsetInclusive() 获取选中文字的起始/结束索引，只给这个范围内的文字设置背景色
3. 如果是整个元素选中，再给整个元素设置背景色

修改后的完整代码 #

function highlightSelected() {
  var selection = DocumentApp.getActiveDocument().getSelection();
  if (!selection) {
    DocumentApp.getUi().alert('Cannot find a selection in the document.');
    return;
  }
  var selectedElements = selection.getSelectedElements();
  for (var i = 0; i < selectedElements.length; ++i) {
    var selectedElement = selectedElements[i];
    // 跳过非文本类型元素，避免报错
    if (selectedElement.getElement().getType() !== DocumentApp.ElementType.TEXT) {
      continue;
    }
    var text = selectedElement.getElement().editAsText();
    var highlightColor = '#00FFFF';
    
    if (selectedElement.isPartial()) {
      // 获取选中文字的索引范围
      var startOffset = selectedElement.getStartOffset();
      var endOffset = selectedElement.getEndOffsetInclusive();
      // 仅给选中区域设置背景色
      text.setBackgroundColor(startOffset, endOffset, highlightColor);
    } else {
      // 整个元素被选中时，设置全部文本背景色
      text.setBackgroundColor(highlightColor);
    }
  }
}

额外优化说明 #

我还加了非文本元素的判断，跳过图片、表格这类无法设置文字背景的元素，让代码更健壮。现在运行这个函数，就能精准高亮你选中的文字区域啦！

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