~楓花雪岳~: [GAS] 自訂選單

星期六, 8月 30, 2025

[GAS] 自訂選單

看見範例在 Sheets 內自訂選單來觸發 apps script，閱讀官方文件 - Google Workspace 中的自訂選單發現 Docs、Sheets、Slides、Forms 都可以自訂選單，該筆記會以 Sheets 為目標，在於 Sheets 相對於其他服務，還可以使用圖片或繪圖來觸發 apps script

.gs Code

自訂選單必須寫在 onOpen() 內，把選項加入 UI 並設定觸發 apps script 函數

function onOpen() {
  let ui = SpreadsheetApp.getUi();
  
  ui.createMenu('自定義功能-第一層')
      .addItem('選項一', 'menuItem1')
      .addSeparator()
      .addSubMenu(ui.createMenu('自定義功能-第二層')
          .addItem('選項二', 'menuItem2'))
      .addToUi();
}

function menuItem1() {
  SpreadsheetApp.getUi().alert('點選選項一：使用 alert 顯示訊息');
}

function menuItem2() {

  html = HtmlService
    .createHtmlOutput('點選選項二：使用 <span style="background-color:green">HtmlService.createHtmlOutput</span> 來顯示訊息')
    .setWidth(300)
    .setHeight(100);

  SpreadsheetApp.getActive().show(html);  
}

function showMessageBox() {
    Browser.msgBox('圖片或繪圖：Browser.msgBox 顯示訊息');
  }

開啟 Sheets 會自動出現自訂選項