跳到主要内容

PullRefresh 下拉刷新 ​

WebH5

下拉刷新。容器在顶部时下拉内容跟手下移(阻尼 0.5),超过阈值松手触发 refresh 并停在刷新位显示旋转圈。

何时使用 ​

移动端信息流、消息列表等需要下拉加载最新数据的页面。

何时不使用 ​

桌面端列表用显式的刷新按钮;无限滚动加载用 IntersectionObserver 类方案。

Props ​

名称类型默认值说明
modelValuebooleanfalse刷新中状态(v-model);调用方刷新完成后置 false,列表弹回
thresholdnumber60触发刷新的下拉距离(px)
disabledbooleanfalse禁用下拉刷新

Events ​

名称载荷说明
update:modelValueboolean进入刷新态时发出 true
refreshvoid下拉超过阈值松手时触发,调用方在此发起数据加载

Slots ​

名称说明
default列表内容
pulling下拉未达阈值时的自定义提示,scope { distance, status };缺省显示默认文案(取 locale pullrefresh.pulling)
loosing下拉超过阈值即将松手时的自定义提示,scope { distance, status };缺省显示默认文案(取 locale pullrefresh.loosing)
refreshing刷新中的自定义指示(如 Lottie 动画),scope { distance, status };缺省显示旋转圈 + 刷新中文案

示例 ​

基础用法(订单列表刷新) ​

示例加载中…

自定义触发阈值 ​

示例加载中…

禁用下拉刷新 ​

示例加载中…

模拟异步刷新 ​

示例加载中…

Playground ​

加载中…

跨端版本 ​

该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 PullRefresh 文档(含手机预览)。