Instancja środowiska interfejsu użytkownika aplikacji Google, która pozwala na dodawanie skryptu takie jak menu, okna i paski boczne. Skrypt może wchodzić w interakcje z interfejsem tylko w przypadku bieżącej instancji otwartego edytora i tylko wtedy, gdy skrypt jest powiązany z kontenerem.
// Display a dialog box with a title, message, input field, and "Yes" and "No" buttons. The // user can also close the dialog by clicking the close button in its title bar. var ui = SpreadsheetApp.getUi(); var response = ui.prompt('Getting to know you', 'May I know your name?', ui.ButtonSet.YES_NO); // Process the user's response. if (response.getSelectedButton() == ui.Button.YES) { Logger.log('The user\'s name is %s.', response.getResponseText()); } else if (response.getSelectedButton() == ui.Button.NO) { Logger.log('The user didn\'t want to provide a name.'); } else { Logger.log('The user clicked the close button in the dialog\'s title bar.'); }
Właściwości
Właściwość | Typ | Opis |
---|---|---|
Button | Button | Enum reprezentujące wstępnie określone, zlokalizowane przyciski okien zwrócone przez alert lub PromptResponse.getSelectedButton() w celu wskazania
który przycisk w oknie dialogowym kliknął użytkownik. |
ButtonSet | ButtonSet | Wyliczenie reprezentujące wstępnie określone, zlokalizowane zestawy jednego lub większej liczby przycisków dialogowych, które można została dodana do alertu lub potwierdzenia. |
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
alert(prompt) | Button | Otwiera w edytorze użytkownika okno z podanym komunikatem i przyciskiem „OK”. Przycisk |
alert(prompt, buttons) | Button | Otwiera w edytorze użytkownika okno z podaną wiadomością i zestawem przycisków. |
alert(title, prompt, buttons) | Button | Otwiera w edytorze użytkownika okno dialogowe z podanym tytułem, komunikatem i zestawem przycisków. |
createAddonMenu() | Menu | Tworzy kreator, za pomocą którego można wstawić menu podrzędne do menu Rozszerzenia edytora. |
createMenu(caption) | Menu | Tworzy kreator, za pomocą którego można dodać menu do interfejsu użytkownika edytora. |
prompt(prompt) | PromptResponse | Otwiera w edytorze użytkownika okno do wprowadzania danych z podanym komunikatem i przyciskiem „OK”. Przycisk |
prompt(prompt, buttons) | PromptResponse | Otwiera w edytorze użytkownika okno do wprowadzania danych z podaną wiadomością i zestawem przycisków. |
prompt(title, prompt, buttons) | PromptResponse | Otwiera w edytorze użytkownika okno do wprowadzania danych, zawierające dany tytuł, komunikat i zestaw przyciskami. |
showModalDialog(userInterface, title) | void | Otwiera w edytorze użytkownika okno modalne z niestandardową zawartością po stronie klienta. |
showModelessDialog(userInterface, title) | void | Otwiera bezmoderowane okno dialogowe edytora użytkownika z niestandardową zawartością po stronie klienta. |
showSidebar(userInterface) | void | Otwiera pasek boczny w edytorze użytkownika z niestandardową zawartością po stronie klienta. |
Szczegółowa dokumentacja
alert(prompt)
Otwiera w edytorze użytkownika okno z podanym komunikatem i przyciskiem „OK”. Przycisk Ta metoda
zawiesza skrypt po stronie serwera na czas otwierania okna. Skrypt zostanie wznowiony, gdy użytkownik
zamyka okno, ale Jdbc
połączeń i LockService
zamków nie działa
przez cały okres zawieszenia. Więcej informacji znajdziesz w przewodniku po oknach i paskach bocznych.
// Display "Hello, world" in a dialog box with an "OK" button. The user can also close the // dialog by clicking the close button in its title bar. SpreadsheetApp.getUi().alert('Hello, world');
Parametry
Nazwa | Typ | Opis |
---|---|---|
prompt | String | Komunikat wyświetlany w oknie dialogowym. |
Powrót
Button
– przycisk, który kliknął użytkownik.
alert(prompt, buttons)
Otwiera w edytorze użytkownika okno z podaną wiadomością i zestawem przycisków. Ta metoda
zawiesza skrypt po stronie serwera na czas otwierania okna. Skrypt zostanie wznowiony, gdy użytkownik
zamyka okno, ale Jdbc
połączeń i LockService
zamków nie działa
przez cały okres zawieszenia. Więcej informacji znajdziesz w przewodniku po oknach i paskach bocznych.
// Display a dialog box with a message and "Yes" and "No" buttons. The user can also close the // dialog by clicking the close button in its title bar. var ui = SpreadsheetApp.getUi(); var response = ui.alert('Are you sure you want to continue?', ui.ButtonSet.YES_NO); // Process the user's response. if (response == ui.Button.YES) { Logger.log('The user clicked "Yes."'); } else { Logger.log('The user clicked "No" or the close button in the dialog\'s title bar.'); }
Parametry
Nazwa | Typ | Opis |
---|---|---|
prompt | String | Komunikat wyświetlany w oknie dialogowym. |
buttons | ButtonSet | Przycisk wyświetlany w oknie dialogowym. |
Powrót
Button
– przycisk, który kliknął użytkownik.
alert(title, prompt, buttons)
Otwiera w edytorze użytkownika okno dialogowe z podanym tytułem, komunikatem i zestawem przycisków. Ten
zawiesza skrypt po stronie serwera na czas otwierania okna. Skrypt zostaje wznowiony po
użytkownik zamyka okno, ale Jdbc
połączeń i LockService
zamków nie działa
przez cały okres zawieszenia. Więcej informacji znajdziesz w przewodniku po oknach i paskach bocznych.
// Display a dialog box with a title, message, and "Yes" and "No" buttons. The user can also // close the dialog by clicking the close button in its title bar. var ui = SpreadsheetApp.getUi(); var response = ui.alert('Confirm', 'Are you sure you want to continue?', ui.ButtonSet.YES_NO); // Process the user's response. if (response == ui.Button.YES) { Logger.log('The user clicked "Yes."'); } else { Logger.log('The user clicked "No" or the close button in the dialog\'s title bar.'); }
Parametry
Nazwa | Typ | Opis |
---|---|---|
title | String | Tytuł wyświetlany nad oknem dialogowym. |
prompt | String | Komunikat wyświetlany w oknie dialogowym. |
buttons | ButtonSet | Przycisk wyświetlany w oknie dialogowym. |
Powrót
Button
– przycisk, który kliknął użytkownik.
createAddonMenu()
Tworzy kreator, za pomocą którego można wstawić menu podrzędne do menu Rozszerzenia edytora.
menu nie zostanie zaktualizowane, dopóki nie zostanie wywołana funkcja Menu.addToUi()
. Jeśli skrypt jest uruchomiony
jako dodatek, nazwa menu podrzędnego jest zgodna z nazwą dodatku w sklepie internetowym; jeśli skrypt jest powiązany bezpośrednio z dokumentem, nazwa menu podrzędnego
pasuje do nazwy skryptu. Więcej informacji znajdziesz w przewodniku po menu.
// Add an item to the Add-on menu, under a sub-menu whose name is set automatically. function onOpen(e) { SpreadsheetApp.getUi() .createAddonMenu() .addItem('Show', 'showSidebar') .addToUi(); }
Powrót
Menu
– nowy kreator menu.
createMenu(caption)
Tworzy kreator, za pomocą którego można dodać menu do interfejsu użytkownika edytora. Menu nie jest
danych można dodawać do czasu wywołania funkcji Menu.addToUi()
. Więcej informacji znajdziesz w przewodniku po menu. Menu najwyższego poziomu powinno mieć taką etykietę
z wielkich liter (wszystkie główne słowa są pisane wielkimi literami), choć etykieta menu podrzędnego powinna zawierać
Jak w zdaniu (tylko pierwszy wyraz pisany wielkimi literami). Jeśli skrypt został opublikowany jako dodatek, parametr caption
jest ignorowany, a parametry
zostanie dodane jako podmenu w menu Rozszerzenia, co odpowiada createAddonMenu()
.
// Add a custom menu to the active document, 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 sub-menu') .addItem('One sub-menu item', 'mySecondFunction') .addItem('Another sub-menu item', 'myThirdFunction')) .addToUi(); }
Parametry
Nazwa | Typ | Opis |
---|---|---|
caption | String | Etykieta menu najwyższego poziomu, w której wszystkie najważniejsze słowa są pisane wielkimi literami lub tylko pierwsze słowo pisane wielką literą w menu podrzędnym. |
Powrót
Menu
– nowy kreator menu.
prompt(prompt)
Otwiera w edytorze użytkownika okno do wprowadzania danych z podanym komunikatem i przyciskiem „OK”. Przycisk Ten
zawiesza skrypt po stronie serwera na czas otwierania okna. Skrypt zostaje wznowiony po
użytkownik zamyka okno, ale Jdbc
połączeń i LockService
zamków nie działa
przez cały okres zawieszenia. Więcej informacji znajdziesz w przewodniku po oknach i paskach bocznych.
// Display a dialog box with a message, input field, and an "OK" button. The user can also // close the dialog by clicking the close button in its title bar. var ui = SpreadsheetApp.getUi(); var response = ui.prompt('Enter your name:'); // Process the user's response. if (response.getSelectedButton() == ui.Button.OK) { Logger.log('The user\'s name is %s.', response.getResponseText()); } else { Logger.log('The user clicked the close button in the dialog\'s title bar.'); }
Parametry
Nazwa | Typ | Opis |
---|---|---|
prompt | String | Komunikat wyświetlany w oknie dialogowym. |
Powrót
PromptResponse
– reprezentacja odpowiedzi użytkownika.
prompt(prompt, buttons)
Otwiera w edytorze użytkownika okno do wprowadzania danych z podaną wiadomością i zestawem przycisków. Ten
zawiesza skrypt po stronie serwera na czas otwierania okna. Skrypt zostaje wznowiony po
użytkownik zamyka okno, ale Jdbc
połączeń i LockService
zamków nie działa
przez cały okres zawieszenia. Więcej informacji znajdziesz w przewodniku po oknach i paskach bocznych.
// Display a dialog box with a message, input field, and "Yes" and "No" buttons. The user can // also close the dialog by clicking the close button in its title bar. var ui = SpreadsheetApp.getUi(); var response = ui.prompt('May I know your name?', ui.ButtonSet.YES_NO); // Process the user's response. if (response.getSelectedButton() == ui.Button.YES) { Logger.log('The user\'s name is %s.', response.getResponseText()); } else if (response.getSelectedButton() == ui.Button.NO) { Logger.log('The user didn\'t want to provide a name.'); } else { Logger.log('The user clicked the close button in the dialog\'s title bar.'); }
Parametry
Nazwa | Typ | Opis |
---|---|---|
prompt | String | Komunikat wyświetlany w oknie dialogowym. |
buttons | ButtonSet | Przycisk wyświetlany w oknie dialogowym. |
Powrót
PromptResponse
– reprezentacja odpowiedzi użytkownika.
prompt(title, prompt, buttons)
Otwiera w edytorze użytkownika okno do wprowadzania danych, zawierające dany tytuł, komunikat i zestaw
przyciskami. Ta metoda zawiesza skrypt po stronie serwera na czas otwierania okna. Skrypt
jest wznawiane po zamknięciu okna przez użytkownika, ale połączenia Jdbc
i blokady LockService
nie są zachowywane
zawieszenia konta. Więcej informacji znajdziesz w przewodniku
w oknach dialogowych i na paskach bocznych.
// Display a dialog box with a title, message, input field, and "Yes" and "No" buttons. The // user can also close the dialog by clicking the close button in its title bar. var ui = SpreadsheetApp.getUi(); var response = ui.prompt('Getting to know you', 'May I know your name?', ui.ButtonSet.YES_NO); // Process the user's response. if (response.getSelectedButton() == ui.Button.YES) { Logger.log('The user\'s name is %s.', response.getResponseText()); } else if (response.getSelectedButton() == ui.Button.NO) { Logger.log('The user didn\'t want to provide a name.'); } else { Logger.log('The user clicked the close button in the dialog\'s title bar.'); }
Parametry
Nazwa | Typ | Opis |
---|---|---|
title | String | Tytuł wyświetlany nad oknem dialogowym. |
prompt | String | Komunikat wyświetlany w oknie dialogowym. |
buttons | ButtonSet | Przycisk wyświetlany w oknie dialogowym. |
Powrót
PromptResponse
– reprezentacja odpowiedzi użytkownika.
showModalDialog(userInterface, title)
Otwiera w edytorze użytkownika okno modalne z niestandardową zawartością po stronie klienta. Ta metoda
nie zawieszaj skryptu po stronie serwera w czasie, gdy okno jest otwarte. Aby komunikować się z
skryptu po stronie serwera, komponent po stronie klienta musi wykonywać asynchroniczne wywołania zwrotne za pomocą interfejsu API google.script
dla HtmlService
. Aby zamknąć okno
automatycznie, wywołaj
google.script.host.close()
po stronie klienta w sieci HtmlService
. Więcej informacji znajdziesz w przewodniku po oknach i
Okna modalne uniemożliwiają użytkownikowi interakcję z treściami innymi niż okno dialogowe. Według kontrast, bezmodalne okna dialogowe i paski boczne umożliwiają użytkownikowi interakcję z edytorem. Niemal we wszystkich przypadkach okno modalne lub pasek boczny jest lepszym wyborem niż niemodalne okno dialogowe.
// Display a modal dialog box with custom HtmlService content. var htmlOutput = HtmlService .createHtmlOutput('<p>A change of speed, a change of style...</p>') .setWidth(250) .setHeight(300); SpreadsheetApp.getUi().showModalDialog(htmlOutput, 'My add-on');
Parametry
Nazwa | Typ | Opis |
---|---|---|
userInterface | Object | HtmlOutput
reprezentujący interfejs do wyświetlenia. |
title | String | Tytuł okna; zastępuje dowolny tytuł ustawiony przez wywołanie funkcji setTitle() w dniu
obiekt userInterface . |
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/script.container.ui
showModelessDialog(userInterface, title)
Otwiera bezmoderowane okno dialogowe edytora użytkownika z niestandardową zawartością po stronie klienta. Ta metoda
nie zawiesza skryptu po stronie serwera, gdy okno jest otwarte. Aby komunikować się z
skryptu po stronie serwera, komponent po stronie klienta musi wykonywać asynchroniczne wywołania zwrotne za pomocą interfejsu API google.script
dla HtmlService
. Aby zamknąć okno
automatycznie, wywołaj
google.script.host.close()
po stronie klienta w sieci HtmlService
. Więcej informacji znajdziesz w przewodniku po oknach i
Bezmoderowane okna dialogowe umożliwiają użytkownikowi interakcję z edytorem za oknem. Z kolei okna modalne. Prawie we wszystkich przypadkach okno dialogowe lub pasek boczny jest lepszym rozwiązaniem niż niemodalne okno dialogowe.
// Display a modeless dialog box with custom HtmlService content. var htmlOutput = HtmlService .createHtmlOutput('<p>A change of speed, a change of style...</p>') .setWidth(250) .setHeight(300); SpreadsheetApp.getUi().showModelessDialog(htmlOutput, 'My add-on');
Parametry
Nazwa | Typ | Opis |
---|---|---|
userInterface | Object | HtmlOutput
reprezentujący interfejs do wyświetlenia. |
title | String | Tytuł okna; zastępuje dowolny tytuł ustawiony przez wywołanie funkcji setTitle() w dniu
obiekt userInterface . |
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/script.container.ui
showSidebar(userInterface)
Otwiera pasek boczny w edytorze użytkownika z niestandardową zawartością po stronie klienta. Ta metoda
nie zawieszaj skryptu po stronie serwera, gdy pasek boczny jest otwarty. Aby komunikować się z
skryptu po stronie serwera, komponent po stronie klienta musi wykonywać asynchroniczne wywołania zwrotne za pomocą interfejsu API google.script
dla HtmlService
. Zamykanie paska bocznego
automatycznie, wywołaj
google.script.host.close()
po stronie klienta w sieci HtmlService
. Więcej informacji znajdziesz w przewodniku po oknach i
Pasek boczny jest wyświetlany po prawej stronie edytora w przypadku użytkowników, których środowiska używają języka od lewej do prawej oraz po lewej stronie edytora dla języków pisanych od prawej do lewej. Wszystkie paski boczne wyświetlane przez skrypty mają szerokość 300 pikseli.
// Display a sidebar with custom HtmlService content. var htmlOutput = HtmlService .createHtmlOutput('<p>A change of speed, a change of style...</p>') .setTitle('My add-on'); SpreadsheetApp.getUi().showSidebar(htmlOutput);
Parametry
Nazwa | Typ | Opis |
---|---|---|
userInterface | Object | HtmlOutput
reprezentujący interfejs do wyświetlenia. |
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/script.container.ui