如何使用Google Apps Script在Google Sheets中添加复选框

嘿，我完全懂你想要用脚本批量生成复选框的需求——确实，这个功能刚推出的时候官方文档更新有点跟不上，手动一个个加太费时间了。其实复选框本质是通过数据验证规则实现的，咱们可以用Apps Script的DataValidation类来搞定，下面给你几个实用的实现方案：

1. 给单个单元格添加复选框 #

这个脚本会在指定单元格（比如A1）创建一个默认的复选框：

function addSingleCheckbox() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  const cell = sheet.getRange("A1");
  
  // 创建复选框数据验证规则
  const checkboxRule = SpreadsheetApp.newDataValidation()
    .requireCheckbox() // 指定为复选框类型
    .build();
  
  // 给单元格应用规则
  cell.setDataValidation(checkboxRule);
}

2. 批量给指定范围添加复选框 #

如果需要给整列、整行或者一片区域批量加复选框，用这个脚本更高效：

function addBatchCheckboxes() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  // 这里可以改成你需要的范围，比如"B2:B100"代表B列第2到100行
  const range = sheet.getRange("B2:B100");
  
  const checkboxRule = SpreadsheetApp.newDataValidation()
    .requireCheckbox()
    .build();
  
  // 给整个范围应用规则
  range.setDataValidation(checkboxRule);
}

3. 自定义复选框的关联值（可选） #

默认情况下，勾选复选框会显示TRUE，不勾选是FALSE。如果想要自定义显示的内容（比如勾选时显示"完成"，不勾选显示"待办"），可以这样修改规则：

function addCustomValueCheckbox() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  const cell = sheet.getRange("C1");
  
  const checkboxRule = SpreadsheetApp.newDataValidation()
    .requireCheckbox()
    .setAllowInvalid(false) // 禁止输入其他值
    .setHelpText("勾选标记完成") // 可选：添加提示文本
    .setShowCustomCellValue(true) // 启用自定义值
    .setCustomValueForTrue("完成") // 勾选时显示的内容
    .setCustomValueForFalse("待办") // 未勾选时显示的内容
    .build();
  
  cell.setDataValidation(checkboxRule);
}

怎么运行这些脚本？ #

1. 打开你的Google Sheets文档
2. 点击顶部菜单栏的「扩展程序」→「Apps Script」
3. 在脚本编辑器里粘贴上面的代码
4. 点击运行按钮（▶️），第一次运行需要授权，按照提示完成即可

这样就能自动生成复选框啦，比手动操作快太多！

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