滑动刷新界面模式完全在 SwipeRefreshLayout
widget 中实现,该 widget 可以检测垂直滑动,显示独特的进度条,并在应用中触发回调方法。要启用此行为,请将 widget 作为 ListView
或 GridView
的父级添加到布局文件中,并实现在用户滑动时调用的刷新行为。
本页介绍了如何将该 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
添加为单个 ListView
或 GridView
的父项。SwipeRefreshLayout
仅支持单个 ListView
或 GridView
子级。
以下示例演示了如何将 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
视图结构。如果您想使用默认视图结构,请替换部分 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>