您可以使用 Snackbar
向用户显示简短消息。与通知不同,消息会在短时间后自动消失。Snackbar
非常适合用户不需要执行操作的简短消息。例如,电子邮件应用可以使用 Snackbar
来告知用户该应用已成功发送电子邮件。
使用 CoordinatorLayout
Snackbar
已附加到视图中。如果 Snackbar
附加到派生自 View
类的任何对象(例如,任何常见的布局对象),则可提供基本功能。不过,如果 Snackbar
附加到 CoordinatorLayout
,Snackbar
会获得额外的功能:
- 用户可以通过滑动将
Snackbar
关闭。 - 布局会在
Snackbar
出现时移动其他界面元素。例如,如果布局具有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();