Class Browser

Przeglądarka

Ta klasa zapewnia dostęp do okien dialogowych specyficznych dla Arkuszy Google.

Metody w tej klasie są dostępne tylko w kontekście arkusza kalkulacyjnego Google. Zamiast tego używaj okien Google Workspace.

Zobacz też

• ButtonSet

Właściwości

Właściwość	Typ	Opis
Buttons	ButtonSet

Metody

Metoda	Zwracany typ	Krótki opis
inputBox(prompt)	String|null	Wyświetla w przeglądarce użytkownika okno dialogowe z oknem do wprowadzania danych.
inputBox(prompt, buttons)	String|null	Wyświetla w przeglądarce użytkownika okno dialogowe z oknem do wprowadzania danych.
inputBox(title, prompt, buttons)	String|null	Wyświetla w przeglądarce użytkownika okno dialogowe z oknem do wprowadzania danych.
msgBox(prompt)	String|null	Wyświetla w przeglądarce użytkownika okno z podanym komunikatem i przyciskiem OK.
msgBox(prompt, buttons)	String|null	Wyświetla w przeglądarce użytkownika okno z podanym komunikatem i określonymi przyciskami.
msgBox(title, prompt, buttons)	String|null	Wyświetla w przeglądarce użytkownika okno z podanym tytułem, komunikatem i określonymi przyciskami.

Szczegółowa dokumentacja

inputBox(prompt)

Wyświetla w przeglądarce użytkownika okno dialogowe z oknem do wprowadzania danych.

Metoda inputBox wyświetla po stronie klienta okno do wprowadzania danych, w którym użytkownikowi wyświetla się podany prompt. Pamiętaj, że ta funkcja powoduje zawieszenie skryptu po stronie serwera. Wznawia się automatycznie po zamknięciu okna przez użytkownika, ale połączenia JDBC nie są zachowywane podczas zawieszenia.

// The code below sets the value of name to the name input by the user, or
// 'cancel'.
const name = Browser.inputBox('Enter your name');

Nie zalecamy tej metody. Zamiast tego użyj promptu interfejsu.

Parametry

Nazwa	Typ	Opis
prompt	String	Tekst, który ma być wyświetlany w oknie dialogowym.

Powrót

String|null – tekst wpisany przez użytkownika (lub „anuluj” w przypadku anulowanego lub zamkniętego okna).

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

inputBox(prompt, buttons)

Wyświetla w przeglądarce użytkownika okno dialogowe z oknem do wprowadzania danych.

Metoda inputBox wyświetla po stronie klienta okno do wprowadzania danych, w którym użytkownikowi wyświetlany jest podany prompt, oraz oferuje wybór przycisków do wyświetlenia. Pamiętaj, że ta funkcja powoduje zawieszenie skryptu po stronie serwera. Wznawia się automatycznie po zamknięciu okna przez użytkownika, ale połączenia JDBC nie są zachowywane podczas zawieszenia.

// The code below sets the value of name to the name input by the user, or
// 'cancel'.
const name = Browser.inputBox('Enter your name', Browser.Buttons.OK_CANCEL);

Nie zalecamy tej metody. Zamiast tego użyj promptu interfejsu.

Parametry

Nazwa	Typ	Opis
prompt	String	Tekst, który ma być wyświetlany w oknie dialogowym.
buttons	ButtonSet	Typ zestawu przycisków, który ma być używany.

Powrót

String|null – tekst wpisany przez użytkownika (lub „anuluj” w przypadku anulowanego lub zamkniętego okna).

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

inputBox(title, prompt, buttons)

Wyświetla w przeglądarce użytkownika okno dialogowe z oknem do wprowadzania danych.

Metoda inputBox wyświetla po stronie klienta okno do wprowadzania danych z podanym tytułem, które wyświetla użytkownikowi podany prompt i oferuje wybór przycisków do wyświetlenia. Pamiętaj, że ta funkcja powoduje zawieszenie skryptu po stronie serwera. Po zamknięciu okna przez użytkownika wznawia się automatycznie, ale połączenia JDBC nie są zachowywane podczas zawieszenia.

// The code below sets the value of name to the name input by the user, or
// 'cancel'.
const name = Browser.inputBox(
    'ID Check',
    'Enter your name',
    Browser.Buttons.OK_CANCEL,
);

Nie zalecamy tej metody. Zamiast tego użyj promptu interfejsu.

Parametry

Nazwa	Typ	Opis
title	String	Tytuł okna.
prompt	String	Tekst, który ma być wyświetlany w oknie dialogowym.
buttons	ButtonSet	Typ zestawu przycisków, który ma być używany.

Powrót

String|null – tekst wpisany przez użytkownika (lub „anuluj” w przypadku anulowanego lub zamkniętego okna).

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

msgBox(prompt)

Wyświetla w przeglądarce użytkownika okno z podanym komunikatem i przyciskiem OK.

Metoda msgBox wyświetla po stronie klienta okno komunikatu z podaną wiadomością. Pamiętaj, że ta metoda powoduje zawieszenie skryptu po stronie serwera. Wznawia się automatycznie po zamknięciu okna przez użytkownika, ale połączenia JDBC nie są zachowywane podczas zawieszenia.

// The code below displays "hello world" in a dialog box with an OK button
Browser.msgBox('hello world');

Nie zalecamy tej metody. Zamiast tego użyj okna alertu interfejsu.

Parametry

Nazwa	Typ	Opis
prompt	String	Tekst, który ma być wyświetlany w oknie dialogowym.

Powrót

String|null – tekst przycisku w małych literach, który został kliknięty przez użytkownika (lub „cancel” w przypadku zamknięcia okna).

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

msgBox(prompt, buttons)

Wyświetla w przeglądarce użytkownika okno z podanym komunikatem i określonymi przyciskami.

Metoda msgBox wyświetla po stronie klienta okno komunikatu, które zawiera podaną wiadomość i oferuje użytkownikowi wybór przycisków. Pamiętaj, że ta metoda powoduje zawieszenie skryptu po stronie serwera. Wznawia się automatycznie po zamknięciu okna przez użytkownika, ale połączenia JDBC nie są zachowywane podczas zawieszenia.

// The code below displays "hello world" in a dialog box with OK and Cancel
// buttons.
Browser.msgBox('hello world', Browser.Buttons.OK_CANCEL);

Nie zalecamy tej metody. Zamiast tego użyj okna alertu interfejsu.

Parametry

Nazwa	Typ	Opis
prompt	String	Tekst, który ma być wyświetlany w oknie dialogowym.
buttons	ButtonSet	Typ zestawu przycisków, który ma być używany.

Powrót

String|null – tekst przycisku w małych literach, który został kliknięty przez użytkownika (lub „cancel” w przypadku zamknięcia okna).

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

msgBox(title, prompt, buttons)

Wyświetla w przeglądarce użytkownika okno z podanym tytułem, komunikatem i określonymi przyciskami.

Metoda msgBox wyświetla po stronie klienta okno komunikatu o podanym tytule, które zawiera podaną wiadomość dla użytkownika i oferuje wybór przycisków do wyświetlenia. Pamiętaj, że ta metoda powoduje zawieszenie skryptu po stronie serwera. Po zamknięciu okna przez użytkownika wznawia się automatycznie, ale połączenia JDBC nie są zachowywane podczas zawieszenia.

// The code below displays "hello world" in a dialog box with a custom title and
// Yes and No buttons
Browser.msgBox('Greetings', 'hello world', Browser.Buttons.YES_NO);

Nie zalecamy tej metody. Zamiast tego użyj okna alertu interfejsu.

Parametry

Nazwa	Typ	Opis
title	String	Tytuł okna.
prompt	String	Tekst, który ma być wyświetlany w oknie dialogowym.
buttons	ButtonSet	Typ zestawu przycisków, który ma być używany.

Powrót

String|null – tekst przycisku w małych literach, który został kliknięty przez użytkownika (lub „cancel” w przypadku zamknięcia okna).

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets