【GAS】スプレッドシートのトーストメッセージ機能まとめ【サンプルソース付】

快速ワーク
スポンサーリンク

GAS開発者向けにスプレッドシートのトーストメッセージ機能をすべてまとめました。

スプレッドシートを扱ってる時、ポップアップウィンドウでちょっとしたメッセージを表示したい時はきっとあります。

なぜ「トースト」か。食パンが焼きあがったようにポンっと出てくるトースターが由来らしいです。なんかかわいいですね。

表示時間指定もできます。何か大切なことを通知する場合など、使いどころをイメージしてぜひ使ってみてください。

トーストメッセージに関するメソッドをすべて載せてます。少しでも参考になれば幸いです。


スポンサーリンク

Google Apps Script スプレッドシート 基礎 リファレンス

当ページは、GAS公式リファレンスを元にスプレッドシートの機能毎にまとめた基礎的な内容となっております。

若干、文言がおかしい可能性がありますが、あらかじめご了承ください。

 

GAS基本メソッドまとめ一覧はコチラ↓↓↓です。スプレッドシートの基本的な機能をまとめてますので、ぜひご活用ください。

【GAS】スプレッドシート基本メソッドまとめ一覧【初心者入門】
GAS開発者向けにスプレッドシートの基本的なメソッドを一覧にまとめました。各機能ごとのクラス、メソッドごとのサンプルソース付ページへリンクする一覧です。初心者にとって、スプレッドシートの基本的な操作・機能単位のメソッドを知...

 

まずは実際に動かしてみることをオススメします。マクロの登録方法は以下を参照いただければと思います。

【GAS】Googleスプレッドシートでマクロの使い方入門【動画付】
Googleの「Google Apps Script」通称GAS。GoogleマップやGメールなど、いろんなGoogle関連のサービスと自由に連携できたり、独自のWebアプリを開発することもできる、いろんな可能性を秘めたワクワクの...

 

GASの本はまだまだ少ないですね。基礎レベルであれば、以下の参考書が初心者にはベストの本です。

基本的な仕様やよく使われる機能の設定方法がまとまっています。

※JavaScriptの知識が既にある程度ある人にとっては冗長かもしれません。


スプレッドシートクラス[Spreadsheet]のトースト(ポップアップ)メッセージ

スプレッドシートのトーストメッセージメソッドです。

トーストメッセージ表示1[toast(メッセージ)]

toast(msg)
スプレッドシートの右下隅に、指定されたメッセージを含むポップアップウィンドウを表示します。

function toast1Sample() {
  // 「Task started」というメッセージでポップアップを表示します。
  SpreadsheetApp.getActiveSpreadsheet().toast('Task started');
}
Parameters
名前タイプ説明
msgStringトーストに表示されるメッセージ。

参照:Google Apps Script | REFERENCE | SpreadSheet | Class Spreadsheet | Methods | toast(msg)

トーストメッセージ表示2[toast(メッセージ, タイトル)]

toast(msg, title)
スプレッドシートの右下隅に、指定されたメッセージとタイトルを含むポップアップウィンドウを表示します。

function toast2Sample() {
  // タイトルが "Status"、メッセージが "Task started"のポップアップを表示します。
  SpreadsheetApp.getActiveSpreadsheet().toast('Task started', 'Status');
}
Parameters
名前タイプ説明
msgStringトーストに表示されるメッセージ。
titleStringトーストのオプションのタイトル。

参照:Google Apps Script | REFERENCE | SpreadSheet | Class Spreadsheet | Methods | toast(msg, title)

トーストメッセージ表示3[toast(メッセージ, タイトル, タイムアウト秒)]

toast(msg, title, timeoutSeconds)
スプレッドシートの右下隅に、指定されたタイトルとメッセージを含むポップアップウィンドウを表示します。このウィンドウは一定期間表示されたままになります。

function toast3Sample() {
  // タイトルが "Status"、メッセージが "Task started"の3秒間のポップアップを表示します。
  SpreadsheetApp.getActiveSpreadsheet().toast('Task started', 'Status', 3);
}
Parameters
名前タイプ説明
msgStringトーストに表示されるメッセージ。
titleStringトーストのオプションのタイトル。
timeoutSecondsNumber秒単位のタイムアウト。 nullの場合、トーストのデフォルトは5秒です。マイナス秒を指定した場合はユーザが閉じるまで表示されます。

参照:Google Apps Script | REFERENCE | SpreadSheet | Class Spreadsheet | Methods | toast(msg, title, timeoutSeconds)


最後に

GASトーストメッセージ機能のまとめをご紹介させていただきました。

必要に応じて、有益な情報でさらに更新していきたいと思います。

プログラミングスキルを向上させるためには、本を読むだけでは脳にインプットされませんね。

実際に手を動かしてアウトプットしまくるのが一番の近道だと思います。

実際にサンプルソースをコピーして実行した結果がどうなるかを体験してみてください。

自分なりのアレンジを加えたり、なぜエラーになるのかを考え、何度も試行錯誤して問題を解決しまくり、着実に理解しながらスキルを向上させていきましょう。

GASはExcelVBAとはかなり違いますが、ベースとなっているJavaScriptは覚えて損はないプログラミング言語なのでショートカットキーなどと組み合わせてぜひ活用してみてください。

Googleスプレッドシート全ショートカットキー一覧はこちら↓↓↓

Googleスプレッドシートの使い方や機能がわかるショートカットキー全まとめ一覧【初心者こそ必見】
表計算ソフトとして、まだまだExcelのシェア率は高いですが、GoogleスプレッドシートにはExcelにはない超強力な関数があったり、Excelとは違って常に最新版を無料で使用できます。なにより、インターネットを使ったオンライン...

ショートカットキー一覧にもGASメソッドを載せています。どの操作からどのメソッドが呼ばれるのかイメージしてください。




コメント

//▼2023/04/08追加 //https://lovagelab.com/posts/3406/ //▲2023/04/08追加