求助：基于Google Apps Script实现谷歌表格必填字段验证

需求背景与验证逻辑 #

• 有多工作表谷歌表格用于需求收集，由利益相关者填写各表数据
• 需实现关键必填字段的高亮及验证，具体逻辑：
  1. 利益相关者填写完成后点击按钮触发验证
  2. 检查所有必填字段是否填写
  3. 若存在空单元格：弹出toast提示需填写的字段名称，对应单元格背景标红
  4. 补填后再次验证，若所有字段已填写：恢复单元格背景为白色，弹出成功提示

当前表格结构 #

表格中必填字段对应单元格为B2、B5、B8，左侧A列对应字段名称（如A2为第一个字段名，A5为第二个，A8为第三个）

现有脚本问题 #

作为Google Apps Script新手，编写的初始脚本存在逻辑缺陷：仅判断三个字段全空的情况，部分字段为空时无法正确提示和标红；同时未处理补填后恢复单元格背景色的逻辑。现有代码如下：

function toastMessageTitle() {
  var sheet = SpreadsheetApp.getActive();
  var rg1= sheet.getRange('B2');
  var rg1_lbl = sheet.getRange('A2').getValue();
  var rg2 = sheet.getRange('B5')
  var rg2_lbl = sheet.getRange('A5').getValue();
  var rg3 = sheet.getRange('B8')
  var rg3_lbl = sheet.getRange('A8').getValue();
  if (rg1.isBlank() && rg2.isBlank() && rg3.isBlank())
  { SpreadsheetApp.getActive().toast("Please fill - " + rg1_lbl+ ", " + rg2_lbl + ", " + rg3_lbl , "⚠️ Unfilled data",10);
    rg1.setBackgroundColor("red");
    rg2.setBackgroundColor("red");
    rg3.setBackgroundColor("red");
  }
  else
 { SpreadsheetApp.getActive().toast("All filled", "Thank you",10);
  
  }
}

优化后的脚本 #

以下是修复逻辑后的完整脚本，解决了上述问题：

function validateRequiredFields() {
  // 获取当前活动工作表
  var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  
  // 定义必填字段数组：统一管理字段位置与对应标签，后续修改只需更新此数组
  var requiredFields = [
    { cellRange: 'B2', labelRange: 'A2' },
    { cellRange: 'B5', labelRange: 'A5' },
    { cellRange: 'B8', labelRange: 'A8' }
  ];
  
  var emptyFields = [];
  
  // 遍历检查每个必填字段
  requiredFields.forEach(function(field) {
    var cell = sheet.getRange(field.cellRange);
    var label = sheet.getRange(field.labelRange).getValue();
    
    if (cell.isBlank()) {
      // 空单元格设为浅红色背景
      cell.setBackground('#ffcccc');
      emptyFields.push(label);
    } else {
      // 已填写单元格恢复白色背景
      cell.setBackground('#ffffff');
    }
  });
  
  // 根据检查结果弹出对应提示
  if (emptyFields.length > 0) {
    SpreadsheetApp.getActiveSpreadsheet().toast(
      '请填写以下字段：' + emptyFields.join('、'), 
      '⚠️ 存在未填必填项', 
      10
    );
  } else {
    SpreadsheetApp.getActiveSpreadsheet().toast(
      '所有必填字段已填写完成！', 
      '✅ 验证通过', 
      10
    );
  }
}

优化说明 #

• 用数组统一管理必填字段，后续新增/修改字段无需改动核心逻辑，维护更便捷
• 逐个检查字段，单独处理空字段标红和已填字段背景恢复
• 收集所有空字段标签统一提示，覆盖部分为空的场景
• 提示信息改为中文，贴合使用场景

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