Skrypty mogą rozszerzać niektóre usługi Google przez dodawanie elementów interfejsu użytkownika, które po kliknięciu uruchamiają funkcję Apps Script. Najczęstszym przykładem jest uruchamianie skryptu z niestandardowego elementu menu w Dokumentach, Arkuszach, Prezentacjach lub Formularzach Google. Funkcje skryptu można też wywoływać, klikając obrazy lub rysunki w Arkuszach Google.
Menu niestandardowe w Dokumentach, Arkuszach, Prezentacjach i Formularzach Google
Apps Script umożliwia dodawanie nowych menu w Dokumentach, Arkuszach, Prezentacjach i Formularzach Google, przy czym każda pozycja menu jest powiązana z funkcją w skrypcie. W Formularzach Google menu niestandardowe są widoczne tylko dla osób edytujących formularz, który go otworzył, a nie dla użytkowników, którzy otwierają formularz, aby go zmodyfikować.
Skrypt może tworzyć menu tylko wtedy, gdy jest powiązany z dokumentem, arkuszem kalkulacyjnym lub formularzem.
Aby wyświetlić menu, gdy użytkownik otworzy plik, wpisz jego kod w funkcji onOpen()
.
Poniższy przykład pokazuje, jak dodać menu z jednym elementem, separator wizualny i menu podrzędne zawierające inny element. (Jeśli nie używasz nowej wersji Arkuszy Google, musisz użyć składni addMenu()
– menu podrzędne nie jest możliwe). Gdy użytkownik wybierze którąś z pozycji menu, odpowiednia funkcja otworzy okno alertu. Więcej informacji o typach okien, które możesz otwierać, znajdziesz w przewodniku po oknach i paskach bocznych.
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!');
}
Dokument, arkusz kalkulacyjny, prezentacja lub formularz mogą zawierać tylko jedno menu o podanej nazwie. Jeśli ten sam skrypt lub inny skrypt doda menu o tej samej nazwie, nowe menu zastąpi stare. Nie można usuwać menu, gdy plik jest otwarty, ale możesz utworzyć funkcję onOpen()
, aby w przyszłości pomijać menu, jeśli skonfigurowana jest konkretna właściwość.
Klikalne obrazy i rysunki w Arkuszach Google
Funkcję Apps Script możesz też przypisać do obrazu lub rysunku w Arkuszach Google, o ile skrypt jest powiązany z arkuszem kalkulacyjnym. Przykład poniżej pokazuje, jak to skonfigurować.
- W Arkuszach Google wybierz pozycję Rozszerzenia > Apps Script, aby utworzyć skrypt powiązany z arkuszem kalkulacyjnym.
Usuń cały kod z edytora skryptów i wklej go poniżej.
function showMessageBox() { Browser.msgBox('You clicked it!'); }
Wróć do Arkuszy i wstaw obraz lub rysunek, wybierając Wstaw > Obraz lub Wstaw > Rysunek.
Po wstawieniu obrazu lub rysunku kliknij go. W prawym górnym rogu pojawi się mały selektor menu. Kliknij ją i wybierz Przypisz skrypt.
W wyświetlonym oknie wpisz nazwę funkcji Apps Script, którą chcesz uruchomić (bez nawiasów), w tym przypadku
showMessageBox
. Kliknij OK.Ponownie kliknij obraz lub rysunek. Funkcja jest teraz wykonywana.