← 返回 iOS 词条

下拉刷新

iOS原生支持

在 iOS 上叫Refresh Control

也叫 Pull to Refresh

SwiftUI: .refreshable|UIKit: UIRefreshControl

适用范围:iOS / iPadOS 的可滚动内容

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

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

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

其他平台的相似实现

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

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

看 Web 视角 →
Android原生支持
Pull to Refresh异名

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

看 Android 视角 →

使用规范

什么时候用

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

什么时候别用

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

iOS 出处

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