建立和顯示彈出式視窗訊息

嘗試 Compose 方法
Jetpack Compose 是 Android 推薦的 UI 工具包。瞭解如何在 Compose 中新增通知。

您可以使用 Snackbar 向使用者顯示簡短訊息。與通知不同,訊息會在短時間後自動消失。Snackbar 最適合用於簡短的使用者不需要採取行動的訊息。舉例來說,電子郵件應用程式可以使用 Snackbar 告知使用者應用程式已成功傳送電子郵件。

使用 CoordinatorLayout

Snackbar 已附加至檢視區塊。如果 Snackbar 附加至任何衍生自 View 類別的物件 (例如任何常見的版面配置物件),就會提供基本功能。不過,如果 Snackbar 附加至 CoordinatorLayoutSnackbar 可使用額外功能:

  • 使用者只要滑開即可關閉 Snackbar
  • 版面配置會在 Snackbar 顯示時移動其他 UI 元素。舉例來說,如果版面配置有 FloatingActionButton,版面配置會在顯示 Snackbar 時移動按鈕,而不是在按鈕上方繪製 Snackbar。如圖 1 所示。

CoordinatorLayout 類別提供 FrameLayout 功能的超集。如果您的應用程式已使用 FrameLayout,您可以將該版面配置替換成 CoordinatorLayout,啟用完整的 Snackbar 功能。如果您的應用程式使用其他版面配置物件,請將現有的版面配置元素納入 CoordinatorLayout 中,如以下範例所示:

<android.support.design.widget.CoordinatorLayout
    android:id="@+id/myCoordinatorLayout"
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <!-- Here are the existing layout elements, now wrapped in
         a CoordinatorLayout. -->
    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:orientation="vertical">

        <!-- ...Toolbar, other layouts, other elements... -->

    </LinearLayout>

</android.support.design.widget.CoordinatorLayout>

CoordinatorLayout 設定 android:id 標記。您在顯示訊息時需要版面配置 ID。

圖 1 Snackbar 出現時,CoordinatorLayout 會將 FloatingActionButton 向上移動。

顯示訊息

顯示訊息需要兩個步驟。首先,請建立包含訊息文字的 Snackbar 物件。然後,您可以呼叫該物件的 show() 方法,向使用者顯示訊息。

建立 Snackbar 物件

呼叫靜態 Snackbar.make() 方法來建立 Snackbar 物件。建立 Snackbar 時,請指定要顯示的訊息,以及顯示訊息的時間長度:

Kotlin

val mySnackbar = Snackbar.make(view, stringId, duration)

Java

Snackbar mySnackbar = Snackbar.make(view, stringId, duration);
查看
要附加 Snackbar 的檢視畫面。此方法會從傳遞的檢視區塊中搜尋檢視區塊階層,直到到達 CoordinatorLayout 或視窗裝飾的內容檢視區塊為止。一般而言,傳遞包含內容的 CoordinatorLayout 較為簡單。
stringId
您所要顯示訊息的資源 ID。這可以是格式化或未設定格式的文字。
時間長度
顯示訊息的時間長度。可以是 LENGTH_SHORTLENGTH_LONG

向使用者顯示訊息

建立 Snackbar 後,請呼叫其 show() 方法,向使用者顯示 Snackbar

Kotlin

mySnackbar.show()

Java

mySnackbar.show();

系統不會同時顯示多個 Snackbar 物件,因此如果檢視畫面目前顯示其他 Snackbar,系統會將 Snackbar 排入佇列,並在目前的 Snackbar 到期或遭到關閉後顯示該物件。

如要向使用者顯示訊息,且不需要呼叫任何 Snackbar 物件的公用程式方法,則在呼叫 show() 後,您不需要保留對 Snackbar 的參照。因此,我們經常使用方法鏈結,在一個陳述式中建立並顯示 Snackbar

Kotlin

Snackbar.make(
        findViewById(R.id.myCoordinatorLayout),
        R.string.email_sent,
        Snackbar.LENGTH_SHORT
).show()

Java

Snackbar.make(findViewById(R.id.myCoordinatorLayout), R.string.email_sent,
                        Snackbar.LENGTH_SHORT)
        .show();