Class Browser

Браузер

Этот класс предоставляет доступ к диалоговым окнам, специфичным для Google Таблиц.

Методы этого класса доступны только для использования в контексте электронных таблиц Google. Пожалуйста, используйте диалоговые окна Google Workspace .

См. также

Характеристики

Свойство Тип Описание
Buttons Button Set

Методы

Метод Тип возвращаемого значения Краткое описание
input Box(prompt) String|null Открывает в браузере пользователя диалоговое окно с текстовым полем ввода.
input Box(prompt, buttons) String|null Открывает в браузере пользователя диалоговое окно с текстовым полем ввода.
input Box(title, prompt, buttons) String|null Открывает в браузере пользователя диалоговое окно с текстовым полем ввода.
msg Box(prompt) String|null Отображает в браузере пользователя диалоговое окно с указанным сообщением и кнопкой «ОК».
msg Box(prompt, buttons) String|null Отображает в браузере пользователя диалоговое окно с заданным сообщением и указанными кнопками.
msg Box(title, prompt, buttons) String|null Отображает в браузере пользователя диалоговое окно с заданным заголовком, сообщением и указанными кнопками.

Подробная документация

input Box(prompt)

Открывает в браузере пользователя диалоговое окно с текстовым полем ввода.

Метод inputBox вызывает на стороне клиента поле ввода, которое отображает пользователю заданный запрос. Обратите внимание, что эта функция приостанавливает выполнение серверного скрипта. Он автоматически возобновляется после того, как пользователь закроет диалоговое окно, но JDBC-соединения не сохраняются после приостановки.

// The code below sets the value of name to the name input by the user, or
// 'cancel'.
const name = Browser.inputBox('Enter your name');
Этот метод не рекомендуется. Вместо этого используйте подсказку в пользовательском интерфейсе .

Параметры

Имя Тип Описание
prompt String Текст, который будет отображаться в диалоговом окне.

Возвращаться

String|null — Текст, введенный пользователем (или 'cancel' для отмененного или закрытого диалогового окна).

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

input Box(prompt, buttons)

Открывает в браузере пользователя диалоговое окно с текстовым полем ввода.

Метод inputBox создает на стороне клиента поле ввода, которое отображает пользователю заданный запрос и предлагает на выбор несколько кнопок для отображения. Обратите внимание, что эта функция приостанавливает выполнение серверного скрипта. Он автоматически возобновляется после того, как пользователь закроет диалоговое окно, но JDBC-соединения не сохраняются после приостановки.

// 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);
Этот метод не рекомендуется. Вместо этого используйте подсказку в пользовательском интерфейсе .

Параметры

Имя Тип Описание
prompt String Текст, который будет отображаться в диалоговом окне.
buttons Button Set Тип используемого набора кнопок.

Возвращаться

String|null — Текст, введенный пользователем (или 'cancel' для отмененного или закрытого диалогового окна).

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

input Box(title, prompt, buttons)

Открывает в браузере пользователя диалоговое окно с текстовым полем ввода.

Метод inputBox создает на стороне клиента поле ввода с заданным заголовком, которое отображает пользователю заданный запрос и предлагает на выбор несколько кнопок для отображения. Обратите внимание, что эта функция приостанавливает выполнение скрипта на стороне сервера. Он автоматически возобновляется после того, как пользователь закроет диалоговое окно, но JDBC-соединения не сохраняются после приостановки.

// 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,
);
Этот метод не рекомендуется. Вместо этого используйте подсказку в пользовательском интерфейсе .

Параметры

Имя Тип Описание
title String Заголовок диалогового окна.
prompt String Текст, который будет отображаться в диалоговом окне.
buttons Button Set Тип используемого набора кнопок.

Возвращаться

String|null — Текст, введенный пользователем (или 'cancel' для отмененного или закрытого диалогового окна).

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

msg Box(prompt)

Отображает в браузере пользователя диалоговое окно с указанным сообщением и кнопкой «ОК».

Метод `msgBox` вызывает диалоговое окно на стороне клиента, отображающее заданное сообщение пользователю. Обратите внимание, что этот метод приводит к приостановке выполнения скрипта на стороне сервера. Он автоматически возобновляется после того, как пользователь закроет диалоговое окно, но JDBC-соединения не сохраняются после приостановки.

// The code below displays "hello world" in a dialog box with an OK button
Browser.msgBox('hello world');
Этот метод не рекомендуется. Вместо этого используйте диалоговое окно с всплывающим сообщением .

Параметры

Имя Тип Описание
prompt String Текст, который будет отображаться в диалоговом окне.

Возвращаться

String|null — Текст кнопки, нажатой пользователем (строчными буквами, или 'cancel' для закрытого диалогового окна).

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

msg Box(prompt, buttons)

Отображает в браузере пользователя диалоговое окно с заданным сообщением и указанными кнопками.

Метод `msgBox` вызывает диалоговое окно на стороне клиента, которое отображает заданное сообщение пользователю и предлагает на выбор несколько кнопок для отображения. Обратите внимание, что этот метод приводит к приостановке выполнения скрипта на стороне сервера. Он автоматически возобновляется после того, как пользователь закроет диалоговое окно, но JDBC-соединения не сохраняются после приостановки.

// The code below displays "hello world" in a dialog box with OK and Cancel
// buttons.
Browser.msgBox('hello world', Browser.Buttons.OK_CANCEL);
Этот метод не рекомендуется. Вместо этого используйте диалоговое окно с всплывающим сообщением .

Параметры

Имя Тип Описание
prompt String Текст, который будет отображаться в диалоговом окне.
buttons Button Set Тип используемого набора кнопок.

Возвращаться

String|null — Текст кнопки, нажатой пользователем (строчными буквами, или 'cancel' для закрытого диалогового окна).

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

msg Box(title, prompt, buttons)

Отображает в браузере пользователя диалоговое окно с заданным заголовком, сообщением и указанными кнопками.

Метод `msgBox` вызывает диалоговое окно на стороне клиента с заданным заголовком, которое отображает пользователю заданное сообщение и предлагает на выбор несколько кнопок для отображения. Обратите внимание, что этот метод приводит к приостановке выполнения скрипта на стороне сервера. Он автоматически возобновляется после того, как пользователь закроет диалоговое окно, но JDBC-соединения не сохраняются после приостановки.

// 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);
Этот метод не рекомендуется. Вместо этого используйте диалоговое окно с всплывающим сообщением .

Параметры

Имя Тип Описание
title String Заголовок диалогового окна.
prompt String Текст, который будет отображаться в диалоговом окне.
buttons Button Set Тип используемого набора кнопок.

Возвращаться

String|null — Текст кнопки, нажатой пользователем (строчными буквами, или 'cancel' для закрытого диалогового окна).

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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