スナックバー付きの通知を作成する

スナックバー コンポーネントは、画面の下部に表示される簡単な通知として機能します。ユーザー エクスペリエンスを中断することなく、オペレーションやアクションに関するフィードバックを提供する。スナックバーは数秒後に消えます。ユーザーは、ボタンをタップするなどのアクションで非表示にすることもできます。

スナックバーを使用する 3 つのユースケースについて考えてみましょう。

  • 操作の確認: ユーザーがメールやメッセージを削除すると、スナックバーが表示され、操作が確認され、[元に戻す] オプションが表示されます。
  • ネットワーク ステータス: アプリがインターネット接続を失うと、オフラインになったことを示すスナックバーがポップアップ表示されます。
  • データの送信: フォームの送信や設定の更新が正常に完了すると、変更が正常に保存されたことを示すスナックバーが表示されます。

バージョンの互換性

この実装では、プロジェクトの minSDK を API レベル 21 以上に設定する必要があります。

依存関係

基本的なスナックバーを作成する

スナックバーを実装するには、まず SnackbarHost を作成します。これには SnackbarHostState プロパティが含まれます。SnackbarHostState は、スナックバーの表示に使用できる showSnackbar() 関数へのアクセスを提供します。

この suspend 関数は CoroutineScope を必要とし(たとえば rememberCoroutineScope を使用)、UI イベントに応じて呼び出され、Scaffold 内に Snackbar を表示します。

アクション付きのスナックバーを作成する

任意のアクションを指定し、Snackbar の継続時間を調整できます。snackbarHostState.showSnackbar() 関数は追加の actionLabel パラメータと duration パラメータを受け入れ、SnackbarResult を返します。

snackbarHost パラメータでカスタムの Snackbar を指定できます。詳細については、SnackbarHost API リファレンス ドキュメントをご覧ください。

結果

図 1. アクション付きの Snackbar 通知。

このガイドを含むコレクション

このガイドは、Android 開発の幅広い目標を網羅する、厳選されたクイックガイド コレクションの一部です。

コンポーズ可能な関数を使用して、マテリアル デザインのデザイン システムに基づいて美しい UI コンポーネントを簡単に作成する方法を学びます。

ご質問やフィードバックがある場合

よくある質問のページでクイックガイドをご覧になるか、お問い合わせフォームからご意見をお寄せください。