为应用添加滑动刷新功能

滑动刷新界面模式完全在 SwipeRefreshLayout widget 中实现,该 widget 可以检测垂直滑动,显示独特的进度条,并在应用中触发回调方法。要启用此行为,请将 widget 作为 ListViewGridView 的父级添加到布局文件中,并实现在用户滑动时调用的刷新行为。

本页介绍了如何将该 widget 添加到现有布局。此外,还介绍了如何向操作栏溢出区域添加刷新操作,以便无法使用滑动手势的用户可以使用外部设备触发手动更新。

添加 SwipeRefreshLayout 依赖项

如需在应用中使用 SwipeRefreshLayout,请将以下依赖项添加到 build.gradle 文件中:

Groovy

dependencies {
    implementation "androidx.swiperefreshlayout:swiperefreshlayout:1.2.0-alpha01"
}

Kotlin

dependencies {
    implementation("androidx.swiperefreshlayout:swiperefreshlayout:1.2.0-alpha01")
}

添加 SwipeRefreshLayout 微件

如需向现有应用添加滑动刷新 widget,请将 SwipeRefreshLayout 添加为单个 ListViewGridView 的父项。SwipeRefreshLayout 仅支持单个 ListViewGridView 子级。

以下示例演示了如何将 SwipeRefreshLayout widget 添加到包含 ListView 的现有布局文件中:

<androidx.swiperefreshlayout.widget.SwipeRefreshLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/swiperefresh"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <ListView
        android:id="@android:id/list"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />

</androidx.swiperefreshlayout.widget.SwipeRefreshLayout>

您还可以将 SwipeRefreshLayout widget 与 ListFragment 搭配使用。如果布局包含 ID 为 "@android:id/list"ListView,系统会自动支持滑动刷新功能。不过,以这种方式明确声明 ListView 会取代默认的 ListFragment 视图结构。如果您想使用默认视图结构,请替换部分 SwipeRefreshLayoutListFragment 行为。

为操作栏添加刷新操作

向应用的操作栏添加刷新操作,以便无法执行滑动手势的用户可以触发手动更新。例如,有无障碍需求的用户可以使用外部设备(如键盘和方向键)触发操作栏操作。

通过设置 android:showAsAction=never 属性,将刷新操作添加为菜单项(而不是按钮)。如果您将操作显示为按钮,用户可能会认为刷新按钮操作与滑动刷新操作不同。让刷新操作在操作栏中不那么显眼,可鼓励用户通过滑动手势执行手动更新,同时保留可供用户通过方向键查找的无障碍选项。

以下代码演示了如何将滑动刷新操作添加到溢出区域:

<menu xmlns:android="http://schemas.android.com/apk/res/android" >
    <item
        android:id="@+id/menu_refresh"
        android:showAsAction="never"
        android:title="@string/menu_refresh"/>
</menu>