ダイアログボックスの表示

2021年7月2日 2022年3月22日 5分10秒

1 ダイアログボックスの表示
2 参考
3 関連記事

ダイアログボックスの表示

Google App Script(GAS)では、ダイアログボックスを表示するのに、「ui.alert」と、「browser.msgBox」の２種類があります。

「ui.alert」は、Googleアプリで使用可能。
「browser.msgBox」は、Googleスプレッドシートで使用可能。

と覚えておくと良いと思います。

ちなみに、公式では、Uiの方を使用することを勧めています。

今回は、「browser.msgBox」でブラウザにダイアログボックスを表示する構文です。

構文

Browser.msgBox(prompt)

Browser.msgBox(prompt, buttons)

Browser.msgBox(title, prompt, buttons)

引数

引数	型	説明
title	String	タイトル
prompt	String	表示するテキスト
buttons	ButtonSet	ボタンのタイプ

ボタンのタイプ

プロパティ	型	説明
Browser.Buttons.OK	Enum	「OK」ボタンのみ
Browser.Buttons.OK_CANCEL	Enum	「OK」ボタンと「キャンセル」ボタン
Browser.Buttons.YES_NO	Enum	「はい」ボタンと「いいえ」ボタン
Browser.Buttons.YES_NO_CANCEL	Enum	「はい」ボタンと「いいえ」ボタンと「キャンセル」ボタン

戻り値

String - クリックしたボタンの小文字の文字列

詳細は、以下の記事を参照

サンプル

function sample() {

  // ① テキストのみ
  const res1 = Browser.msgBox("サンプル");
  Logger.log(res1);

  // ②「OK」のみ
  const res2 = Browser.msgBox("「OK」のみ", Browser.Buttons.OK);
  Logger.log(res2);

  // ③「OK」と「キャンセル」
  const res3 = Browser.msgBox("「OK」と「キャンセル」", Browser.Buttons.OK_CANCEL);
  Logger.log(res3);

  // ④「はい」と「いいえ」
  const res4 = Browser.msgBox("「はい」と「いいえ」", Browser.Buttons.YES_NO);
  Logger.log(res4);

  // ⑤「はい」と「いいえ」と「キャンセル」
  const res5 = Browser.msgBox("「はい」と「いいえ」と「キャンセル」", Browser.Buttons.YES_NO_CANCEL);
  Logger.log(res5);

  // ⑥ タイトルあり
  const res6 = Browser.msgBox("タイトル", "タイトル付き", Browser.Buttons.OK_CANCEL);
  Logger.log(res6);

  // ⑦ 表示するテキストに改行を入れる場合
  const res7 = Browser.msgBox("サンプル\nテスト");
  Logger.log(res7);
}