Class Browser

ブラウザ

このクラスを使用すると、Google スプレッドシート固有のダイアログ ボックスにアクセスできます。

このクラスのメソッドは、Google スプレッドシートのコンテキストでのみ使用できます。 代わりに Google Workspace ダイアログを使用してください。

関連情報

プロパティ

プロパティタイプ説明
ButtonsButtonSet

メソッド

メソッド戻り値の型概要
inputBox(prompt)Stringユーザーのブラウザに、テキスト入力ボックスのあるダイアログ ボックスをポップアップ表示します。
inputBox(prompt, buttons)Stringユーザーのブラウザに、テキスト入力ボックスのあるダイアログ ボックスをポップアップ表示します。
inputBox(title, prompt, buttons)Stringユーザーのブラウザに、テキスト入力ボックスのあるダイアログ ボックスをポップアップ表示します。
msgBox(prompt)String指定されたメッセージと OK ボタンを含むダイアログ ボックスをユーザーのブラウザにポップアップ表示します。
msgBox(prompt, buttons)String指定されたメッセージと指定されたボタンを含むダイアログ ボックスをユーザーのブラウザにポップアップ表示します。
msgBox(title, prompt, buttons)String指定されたタイトル、メッセージ、指定されたボタンを含むダイアログ ボックスをユーザーのブラウザにポップアップ表示します。

詳細なドキュメント

inputBox(prompt)

ユーザーのブラウザに、テキスト入力ボックスのあるダイアログ ボックスをポップアップ表示します。

inputBox メソッドは、指定されたプロンプトを できます。この関数により、サーバー側のスクリプトが一時停止することに注意してください。再開: ユーザーがダイアログをクリアすると自動的に表示されますが、JDBC 接続はインスタンス間では 停止します。

// The code below sets the value of name to the name input by the user, or 'cancel'.
var name = Browser.inputBox('Enter your name');
この方法はおすすめしません。代わりに、UI プロンプトを使用します。

パラメータ

名前説明
promptStringダイアログ ボックスに表示されるテキスト。

戻る

String - ユーザーが入力したテキスト(キャンセルまたは閉じたダイアログの場合は「cancel」)。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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

inputBox(prompt, buttons)

ユーザーのブラウザに、テキスト入力ボックスのあるダイアログ ボックスをポップアップ表示します。

inputBox メソッドは、指定されたプロンプトを 表示するボタンの選択肢を提示します。なお、この関数は サーバーサイド スクリプトが一時停止されます。ユーザーがダイアログをクリアすると、自動的に再開されます。 JDBC 接続は停止中も保持されません。

// The code below sets the value of name to the name input by the user, or 'cancel'.
var name = Browser.inputBox('Enter your name', Browser.Buttons.OK_CANCEL);
この方法はおすすめしません。代わりに、UI プロンプトを使用します。

パラメータ

名前説明
promptStringダイアログ ボックスに表示されるテキスト。
buttonsButtonSet使用するボタンセットのタイプ。

戻る

String - ユーザーが入力したテキスト(キャンセルまたは閉じたダイアログの場合は「cancel」)。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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

inputBox(title, prompt, buttons)

ユーザーのブラウザに、テキスト入力ボックスのあるダイアログ ボックスをポップアップ表示します。

inputBox メソッドにより、指定されたタイトルのクライアントサイド入力ボックスが表示されます。 プロンプトをユーザーに表示し、表示するボタンの選択肢を提示します。なお、 関数によってサーバー側スクリプトが一時停止します。ユーザーが一時停止すると、 ダイアログがクリアされますが、JDBC 接続は停止時は維持されません。

// The code below sets the value of name to the name input by the user, or 'cancel'.
var name = Browser.inputBox('ID Check', 'Enter your name', Browser.Buttons.OK_CANCEL);
この方法はおすすめしません。代わりに、UI プロンプトを使用します。

パラメータ

名前説明
titleStringダイアログ ボックスのタイトル。
promptStringダイアログ ボックスに表示されるテキスト。
buttonsButtonSet使用するボタンセットのタイプ。

戻る

String - ユーザーが入力したテキスト(キャンセルまたは閉じたダイアログの場合は「cancel」)。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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

msgBox(prompt)

指定されたメッセージと OK ボタンを含むダイアログ ボックスをユーザーのブラウザにポップアップ表示します。

msgBox メソッドは、指定されたメッセージをクライアントに表示します。 できます。この方法では、サーバー側のスクリプトが一時停止します。再開: ユーザーがダイアログをクリアすると自動的に表示されますが、JDBC 接続はインスタンス間では 停止します。

// The code below displays "hello world" in a dialog box with an OK button
Browser.msgBox('hello world');
この方法はおすすめしません。代わりに、UI アラート ダイアログを使用してください。

パラメータ

名前説明
promptStringダイアログ ボックスに表示されるテキスト。

戻る

String - ユーザーがクリックしたボタンの小文字のテキスト( 閉じたダイアログ)。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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

msgBox(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);
この方法はおすすめしません。代わりに、UI アラート ダイアログを使用してください。

パラメータ

名前説明
promptStringダイアログ ボックスに表示されるテキスト。
buttonsButtonSet使用するボタンセットのタイプ。

戻る

String - ユーザーがクリックしたボタンの小文字のテキスト( 閉じたダイアログ)。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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

msgBox(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);
この方法はおすすめしません。代わりに、UI アラート ダイアログを使用してください。

パラメータ

名前説明
titleStringダイアログ ボックスのタイトル。
promptStringダイアログ ボックスに表示されるテキスト。
buttonsButtonSet使用するボタンセットのタイプ。

戻る

String - ユーザーがクリックしたボタンの小文字のテキスト( 閉じたダイアログ)。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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