如何用Google Apps Script为Google Sheets单元格添加下拉列表（含指定范围与选项）

1. 给单个单元格添加下拉列表 #

假设你要给指定工作表的单个单元格（比如Sheet1的B5单元格）添加下拉列表，可通过DataValidation类实现：

function addSingleCellDropdown() {
  // 获取目标工作表
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Sheet1");
  // 定义下拉选项
  const dropdownOptions = ["选项1", "选项2", "选项3"];
  
  // 创建数据验证规则
  const validationRule = SpreadsheetApp.newDataValidation()
    .requireValueInList(dropdownOptions, true) // true允许输入列表外的值，false则禁止
    .setAllowInvalid(false) // 设置为false时，输入非列表值会触发警告
    .setHelpText("请从下拉列表中选择选项") // 可选：添加提示文本
    .build();
  
  // 将规则应用到单个单元格（这里是B5）
  const targetCell = sheet.getRange("B5");
  targetCell.setDataValidation(validationRule);
}

2. 给A2:A11区域添加指定选项的下拉列表 #

要给A2:A11区域添加包含["Item1", "Item2", "Item3"]的下拉列表，只需调整目标范围即可：

function addRangeDropdown() {
  // 获取目标工作表
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Sheet1");
  // 定义要求的下拉选项
  const dropdownOptions = ["Item1", "Item2", "Item3"];
  
  // 创建数据验证规则
  const validationRule = SpreadsheetApp.newDataValidation()
    .requireValueInList(dropdownOptions, false) // false禁止输入列表外的值
    .setAllowInvalid(false)
    .setHelpText("请选择Item1/Item2/Item3")
    .build();
  
  // 将规则应用到A2:A11区域
  const targetRange = sheet.getRange("A2:A11");
  targetRange.setDataValidation(validationRule);
}

关键代码说明 #

• SpreadsheetApp.newDataValidation()：创建数据验证构建器实例
• requireValueInList(options, showCustomUi)：设置下拉列表的选项数组，第二个参数控制是否允许自定义输入
• setAllowInvalid(boolean)：设置是否接受不符合规则的输入，false时会阻止输入并提示
• setDataValidation(rule)：将验证规则应用到目标单元格/范围

内容的提问来源于stack exchange，提问作者Juuso Nykänen