← 返回 Android 词条

下拉刷新

Android原生支持

在 Android 上叫Pull to Refresh

Compose Material 3: PullToRefreshBox

适用范围:Android 手机 / 平板;Material 3 Compose

Material 3 提供下拉刷新容器和指示器,刷新状态由应用控制,并在任务完成后关闭。

它让用户在列表顶部继续向下拖动,通过松手触发内容重新加载。

  • 把页面往下拽一下就重新加载
  • 拉到最上面再往下扯会转圈
  • 手指往下拖页面让内容变新的动作
  • 下拉刷新
  • 下拉更新
  • 拉动刷新
  • 刷新手势

其他平台的相似实现

Web需自己实现
该平台没有原生实现

桌面网页没有通用的下拉刷新交互,移动浏览器又可能把这个手势用于刷新整个页面。

看 Web 视角 →
iOS原生支持
Refresh Control异名

刷新控件附着在可滚动内容上,只在用户到达顶部后继续下拉时出现,并在异步刷新完成后结束加载状态。

看 iOS 视角 →

使用规范

什么时候用

  • 可滚动列表中的内容会随时间更新,用户可能主动查看最新结果
  • 列表已经滚到顶部,继续下拉不会和正常浏览内容冲突
  • 刷新动作安全、可重复执行,并能明确展示进行中和完成状态

什么时候别用

  • 把它作为唯一刷新方式 → 隐藏手势不容易被所有用户发现
  • 内容不会变化或刷新代价很高
  • 桌面网页或复杂嵌套滚动区域中,手势容易与浏览器和页面滚动冲突

Android 出处

查看 Web / iOS / Android 完整对照 →概念页上还有可交互示例。