Google Workspace 中的自定义菜单

脚本可以通过添加用户界面元素来扩展某些 Google 产品,这些元素在被点击时会执行 Apps 脚本函数。最常见的示例是 在 Google 文档、表格、幻灯片 或表单,但也可以通过点击图片和表单来触发脚本函数, Google 表格中的绘图。

Google 文档、表格、幻灯片或表单中的自定义菜单

Apps 脚本可以在 Google 文档、表格、幻灯片、 或表单 将每个菜单项与脚本中的某个函数相关联。(在 Google 表单中,只有打开表单进行修改的编辑者才能看到自定义菜单,而打开表单进行回复的用户则看不到。)

只有在满足以下条件时,脚本才能创建菜单: 绑定到文档、电子表格或表单。 要在用户打开文件时显示菜单,请在 onOpen() 函数。

以下示例展示了如何添加 menu 后跟一个 视觉分隔符,然后添加一个 子菜单,其中包含 另一个项目。(请注意,在 Google 表格中,除非您使用的是新版本,否则必须改用 addMenu() 语法,并且无法使用子菜单。)如果用户选择 相应的函数会打开一个 alert 对话框。有关 您可以打开哪些类型的对话框,请参阅 对话框和边栏指南

function onOpen() {
  var ui = SpreadsheetApp.getUi();
  // Or DocumentApp, SlidesApp or FormApp.
  ui.createMenu('Custom Menu')
      .addItem('First item', 'menuItem1')
      .addSeparator()
      .addSubMenu(ui.createMenu('Sub-menu')
          .addItem('Second item', 'menuItem2'))
      .addToUi();
}

function menuItem1() {
  SpreadsheetApp.getUi() // Or DocumentApp, SlidesApp or FormApp.
     .alert('You clicked the first menu item!');
}

function menuItem2() {
  SpreadsheetApp.getUi() // Or DocumentApp, SlidesApp or FormApp.
     .alert('You clicked the second menu item!');
}

文档、电子表格、演示文稿或表单只能包含一个带有 。如果同一个脚本或其他脚本 名称,新菜单将替换旧菜单。文件时,无法移除菜单 处于打开状态,但您可以编写 onOpen() 函数来跳过 如果设置了某个属性,则会发生以下情况。

Google 表格中可点击的图片和绘图

您还可以为 Google 表格中的图片或绘图分配 Apps 脚本函数, 但前提是此脚本已绑定到 电子表格。以下示例展示了如何进行此设置。

  1. 在 Google 表格中,依次选择扩展程序 > Apps 脚本,创建绑定到电子表格的脚本。
  2. 删除脚本编辑器中的所有代码,然后粘贴以下代码。

      function showMessageBox() {
        Browser.msgBox('You clicked it!');
      }
    
  3. 返回 Google 表格,然后选择插入图片或绘图 插入 >图片插入 >绘图

  4. 插入图片或绘图后,点击相应图片或绘图。一个小型下拉菜单 选择器。点击并选择 分配脚本

  5. 在显示的对话框中,输入 Apps 脚本函数的名称。 不带括号(在本示例中为 showMessageBox)。 点击确定

  6. 再次点击该图片或绘图。现在,该函数即会执行。