Google Apps Script实现按钮触发清空当前工作表指定范围

核心问题定位 #

之前三次实现的共性问题是硬编码了目标工作表名称，要么固定写死操作tester表，要么批量遍历配置表执行清空，没有识别用户当前正在操作的激活标签页，因此无法实现「点哪个页的按钮就清哪个页」的效果。

已尝试方案的现存问题 #

• 第一次实现：硬编码读取tester表，绑定按钮后仅能操作固定名称的工作表，无法适配其他同类型标签页

function ClearCells() {  
  var sheet = SpreadsheetApp.getActive().getSheetByName('tester'); 
  sheet.getRangeList(['A6:B21' , 'D6:e13']).clearContent();
}

• 第二次实现：新增了自定义菜单入口，但核心清空逻辑还是硬编码绑定tester表，依然只能操作单个固定页

function onOpen() {
     var ss = SpreadsheetApp.getActiveSpreadsheet();
     var menubuttons = [ {name: "Clear Sheet", functionName: "clear"},]
     ss.addMenu("Clear Sheet", (menubuttons)) ; }  function clear() {    var sheet = SpreadsheetApp.getActive().getSheetByName('tester');  
 sheet.getRange('A6:a21').clearContent(); 
}

• 第三次实现：通过配置表批量遍历执行清空，触发后会同时清空所有配置页的内容，不符合「单次仅清空单个目标页」的需求

function onOpen() {   
  SpreadsheetApp.getUi()
   .createMenu('Reset sheet')
   .addItem('clearAll', 'clear')
   .addToUi(); 
}
 
function clear() {
     [{
         sheetName: "tester",
         range: "A5:A30"
     }, {
         sheetName: "tester2",
         range: "A5:A30"
     }].map(obj => clearTable(obj)) 
}
 
function clearTable(obj) {
     SpreadsheetApp.getActive().getSheetByName(obj.sheetName).getRange(obj.range)
     .clearContent(); 
}

正确实现代码 #

核心逻辑是用getActiveSheet()获取用户当前所在的激活工作表，不需要硬编码表名，同一个函数可以绑定到所有标签页的按钮上，点击时自动识别当前页执行清空：

/**
 * 清空当前标签页指定范围内容，所有标签页的按钮统一绑定该函数即可
 */
function clearCurrentSheetRanges() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  // 直接获取当前用户正在操作的标签页，无需写死表名
  const currentSheet = ss.getActiveSheet();
  // 统一配置需要清空的范围，支持多范围RangeList格式
  const clearTargets = ['A6:B21', 'D6:E13'];
  // 执行当前页的内容清空
  currentSheet.getRangeList(clearTargets).clearContent();
}

/**
 * 可选：添加自定义菜单入口，不需要可以直接删除
 */
function onOpen() {
  SpreadsheetApp.getUi()
    .createMenu('工作表重置')
    .addItem('清空当前页指定范围', 'clearCurrentSheetRanges')
    .addToUi();
}

适配不同标签页不同清空范围的场景 #

如果每个标签页需要清空的范围不一致，可以在函数内加表名判断匹配对应范围即可：

function clearCurrentSheetRanges() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const currentSheet = ss.getActiveSheet();
  const currentSheetName = currentSheet.getName();
  let clearTargets = [];

  // 按表名匹配对应的清空范围
  switch(currentSheetName) {
    case 'tester':
      clearTargets = ['A6:B21', 'D6:E13'];
      break;
    case 'tester 2':
      clearTargets = ['A5:A30'];
      break;
    case 'tester 3':
      clearTargets = ['C2:C100', 'F2:F50'];
      break;
    default:
      // 未配置的表不执行任何操作
      return;
  }

  currentSheet.getRangeList(clearTargets).clearContent();
}

使用说明 #

• 保存脚本后回到表格界面，给每个需要该功能的标签页插入按钮，统一绑定clearCurrentSheetRanges函数
• 点击任意标签页的按钮时，仅会清空当前标签页的预设范围，不会影响其他标签页的内容

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