您可以使用 Snackbar
向使用者顯示簡短訊息。與通知不同,訊息會在短時間後自動消失。Snackbar
最適合用於簡短的使用者不需要採取行動的訊息。舉例來說,電子郵件應用程式可以使用 Snackbar
告知使用者應用程式已成功傳送電子郵件。
使用 CoordinatorLayout
Snackbar
已附加至檢視區塊。如果 Snackbar
附加至任何衍生自 View
類別的物件 (例如任何常見的版面配置物件),就會提供基本功能。不過,如果 Snackbar
附加至 CoordinatorLayout
,Snackbar
可使用額外功能:
- 使用者只要滑開即可關閉
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。
顯示訊息
顯示訊息需要兩個步驟。首先,請建立包含訊息文字的 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_SHORT
或LENGTH_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();