Android 11 开发者预览版现已推出;快来测试并分享您的反馈吧

构建并显示弹出消息

您可以使用 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。

图 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);
    
view
Snackbar 附加到的视图。该方法实际上会从传递的视图中往上搜索视图层次结构,直到到达 CoordinatorLayout 或窗口装饰的内容视图。通常,仅传递封装您的内容的 CoordinatorLayout 最为简单。
stringId
您想要显示的消息的资源 ID。它可以是设置了格式的文本,也可以是无格式文本。
duration
显示消息的时长。它可以是 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();