Google Sheets onEdit脚本如何实现多范围复选框单选效果

原有脚本局限 #

原有onEdit触发器仅支持绑定名为RadioButton1的单个连续命名范围，仅能实现单组连续排布复选框的单选互斥效果，原代码如下：

function onEdit(e) {
  var editRange = e.range;
  var rb1 = SpreadsheetApp.getActiveSpreadsheet().getRangeByName("RadioButton1");

  // 编辑位置不在目标工作表直接退出
  if (editRange.getSheet().getSheetName() != rb1.getSheet().getSheetName()) return;

  var radioRange = { // RadioButton1范围边界
    top : rb1.getRow(),
    bottom : rb1.getLastRow(),
    left : rb1.getColumn(),
    right : rb1.getLastColumn()
  };

  var thisRow = editRange.getRow();
  if (thisRow < radioRange.top || thisRow > radioRange.bottom) return;

  var thisCol = editRange.getColumn();
  if (thisCol < radioRange.left || thisCol > radioRange.right) return;

  // 实现范围内单选逻辑
  var numRows = rb1.getNumRows();
  var numCols = rb1.getNumColumns();
  var writeValues = []
  for (var i = 1; i <= numRows; i++) {
    var row = []
    for (var j = 1; j <= numCols; j++) {
      var currentRange = rb1.getCell(i,j);
      var radioValue;
      if ( currentRange.getA1Notation() == editRange.getA1Notation() ) {
        radioValue = true;  
      } else {
        radioValue = false; 
      }
      row.push(radioValue)
    }
    writeValues.push(row)
  }
  rb1.setValues(writeValues)
}

原有脚本无法适配非连续分布的多组复选框场景，且依赖命名范围识别，调整位置时操作繁琐。

升级后实现效果 #

• 支持任意数量独立复选框组的单选互斥逻辑，复选框可非连续分布、可跨工作表排布
• 无需创建命名范围，直接在脚本配置区指定每个单选组包含的单元格地址，后续调整复选框位置仅需修改配置即可生效

升级后完整代码 #

// -------------------------- 配置区：仅需修改此处即可 --------------------------
const radioGroups = [
  // 第一组单选复选框：按「工作表名!单元格地址」格式填写，支持非连续、跨表
  ["工作表1!A2", "工作表1!A5", "工作表1!B3", "工作表1!C7"],
  // 第二组单选复选框：不同组之间逻辑完全独立
  ["工作表2!B2", "工作表2!D4", "工作表2!F6"],
  // 新增组直接按照上面格式追加即可
]
// -----------------------------------------------------------------------------

function onEdit(e) {
  const editedRange = e.range;
  const editedSheetName = editedRange.getSheet().getSheetName();
  const editedA1 = `${editedSheetName}!${editedRange.getA1Notation()}`;
  const editedValue = e.value;

  // 遍历所有单选组，匹配当前编辑单元格所属组
  let targetGroup = null;
  for (const group of radioGroups) {
    if (group.includes(editedA1)) {
      targetGroup = group;
      break;
    }
  }
  // 编辑位置不属于任何单选组直接退出
  if (!targetGroup) return;
  // 如果是取消勾选操作，不做互斥处理；若需要强制必须选中一项可删除下面这行判断
  if (editedValue !== "TRUE") return;

  // 筛选出同组内除当前编辑单元格外的所有单元格，批量设为false
  const otherCells = targetGroup.filter(cellA1 => cellA1 !== editedA1);
  if (otherCells.length > 0) {
    const ss = SpreadsheetApp.getActiveSpreadsheet();
    ss.getRangeList(otherCells).setValue(false);
  }
}

使用方法 #

• 打开目标Google表格，点击顶部菜单栏「扩展程序」→「Apps 脚本」进入脚本编辑器
• 删除编辑器内原有旧代码，粘贴上面的升级后完整代码
• 修改代码开头配置区的radioGroups内容，替换为自己实际使用的复选框单元格地址，同一组内的复选框会实现单选互斥
• 点击脚本编辑器顶部的保存按钮，授权后回到表格即可生效
• 后续如果调整复选框位置，只需要修改配置区对应的单元格地址，不需要改动其他逻辑代码

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