A custom menu in an instance of the user interface for a Google App. A script can only interact with the UI for the current instance of an open document or form, and only if the script is container-bound to the document or form. For more information, see the guide to menus.
// Add a custom menu to the active spreadsheet, including a separator and a // sub-menu. function onOpen(e) { SpreadsheetApp.getUi() .createMenu('My Menu') .addItem('My Menu Item', 'myFunction') .addSeparator() .addSubMenu( SpreadsheetApp.getUi() .createMenu('My Submenu') .addItem('One Submenu Item', 'mySecondFunction') .addItem('Another Submenu Item', 'myThirdFunction'), ) .addToUi(); }
Methods
Method | Return type | Brief description |
---|---|---|
addItem(caption, functionName) | Menu | Adds an item to the menu. |
addSeparator() | Menu | Adds a visual separator to the menu. |
addSubMenu(menu) | Menu | Adds a sub-menu to the menu. |
addToUi() | void | Inserts the menu into the instance of the editor's user interface. |
Detailed documentation
addItem(caption, functionName)
Adds an item to the menu. The label for a menu item should be in sentence case (only the first word capitalized).
Parameters
Name | Type | Description |
---|---|---|
caption | String | The label for the menu item, with only the first word capitalized. |
functionName | String | The name of the function to invoke when the user selects the item. You can
use functions from included libraries, such as Library.libFunction1 . |
Return
addSubMenu(menu)
addToUi()
Inserts the menu into the instance of the editor's user interface.