为应用添加滑动刷新功能

试试 Compose 方式

Jetpack Compose 是推荐用于 Android 的界面工具包。了解如何在 Compose 中下拉刷新。

在 Compose 中实现“拉动即可刷新”功能 →

滑动刷新界面模式完全在 SwipeRefreshLayout 微件中实现，该微件可以检测纵向滑动，显示一个独特的进度条，并在您的应用中触发回调方法。如需启用此行为，请将该微件作为 ListView 或 GridView 的父级添加到布局文件中，并实现在用户滑动时调用的刷新行为。

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

添加 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 微件

如需向现有应用添加滑动刷新微件，请将 SwipeRefreshLayout 添加为单个 ListView 或 GridView 的父级。SwipeRefreshLayout 仅支持单个 ListView 或 GridView 子级。

以下示例展示了如何将 SwipeRefreshLayout 微件添加到包含 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 视图结构。如果您想使用默认视图结构，请替换部分 SwipeRefreshLayout 和 ListFragment 行为。

将刷新操作添加到操作栏

将刷新操作添加到应用的操作栏，以便无法执行滑动手势的用户可以触发手动更新。例如，如果用户需要使用无障碍功能，可以使用外部设备（如键盘和方向键）触发操作栏操作。

通过设置 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>