如何通过Google Apps Script实现点击按钮跳转并高亮书签文本？

解决方案思路 #

要实现需求，需要完成两个核心操作：定位书签位置并跳转、高亮书签关联的文本。Google Apps Script中可以通过DocumentApp的书签API结合文本样式方法实现，以下是具体步骤和代码。

具体实现代码 #

1. 核心功能函数 #

这个函数负责查找指定名称的书签，跳转至对应位置，并尝试高亮关联文本：

function jumpAndHighlightBookmark(bookmarkName) {
  const doc = DocumentApp.getActiveDocument();
  const bookmarks = doc.getBookmarks();
  
  // 遍历查找目标书签
  let targetBookmark = null;
  for (const bookmark of bookmarks) {
    if (bookmark.getName() === bookmarkName) {
      targetBookmark = bookmark;
      break;
    }
  }
  
  if (!targetBookmark) {
    DocumentApp.getUi().alert(`未找到书签：${bookmarkName}`);
    return;
  }
  
  // 跳转至书签位置（光标定位到书签处）
  doc.setCursor(targetBookmark.getPosition());
  
  // 高亮关联文本（仅对选中文本创建的书签生效）
  try {
    const textRange = targetBookmark.getRange().editAsText();
    // 自定义样式：加粗 + 黄色背景
    textRange.setBold(true);
    textRange.setBackgroundColor("#ffff00");
  } catch (error) {
    DocumentApp.getUi().alert("该书签仅标记位置，无关联文本可高亮");
  }
}

2. 按钮触发函数 #

因为Google Docs的按钮无法直接传递参数，所以需要写一个固定目标书签的函数，绑定到按钮上：

function jumpToB123() {
  // 替换为你的书签名称
  jumpAndHighlightBookmark("B_123");
}

绑定按钮到函数 #

1. 在Google Docs中点击「插入」→「绘图」→「新建」，绘制一个按钮样式的图形（比如矩形+文字）。
2. 绘制完成后点击「保存并关闭」，选中插入的图形，点击右上角的三个点→「分配脚本」。
3. 在弹窗中输入函数名jumpToB123，点击确定。

注意事项 #

• 书签区分名称大小写，确保函数中填写的书签名称与Docs中定义的完全一致。
• 如果书签是仅标记位置（未选中文本创建），则无法高亮文本，函数会弹出提示。
• 第一次运行函数时需要授权，按照提示完成权限验证即可。
• 可根据需求修改样式：比如移除加粗只保留背景色，或者修改字体颜色，示例中的setBold、setBackgroundColor方法可替换为setItalic、setFontColor等。

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