PullRefresh 下拉刷新
WebH5
下拉刷新。容器在顶部时下拉内容跟手下移(阻尼 0.5),超过阈值松手触发 refresh 并停在刷新位显示旋转圈。
何时使用
移动端信息流、消息列表等需要下拉加载最新数据的页面。
何时不使用
桌面端列表用显式的刷新按钮;无限滚动加载用 IntersectionObserver 类方案。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | boolean | false | 刷新中状态(v-model);调用方刷新完成后置 false,列表弹回 |
threshold | number | 60 | 触发刷新的下拉距离(px) |
disabled | boolean | false | 禁用下拉刷新 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | boolean | 进入刷新态时发出 true |
refresh | void | 下拉超过阈值松手时触发,调用方在此发起数据加载 |
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 文档(含手机预览)。