PullRefresh 下拉刷新
uni-appH5微信小程序App
跨端下拉刷新容器,达到阈值后触发 refresh,完成后将 v-model 设为 false。
何时使用
移动端信息流、消息列表等需要下拉加载最新数据的页面。
何时不使用
桌面端列表用显式的刷新按钮;无限滚动加载用 IntersectionObserver 类方案。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | boolean | false | 刷新中状态(v-model);调用方刷新完成后置 false,列表弹回 |
threshold | number | 60 | 触发刷新的下拉距离(px) |
disabled | boolean | false | 禁用下拉刷新 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | boolean | 进入刷新态时发出 true |
refresh | void | 下拉超过阈值松手时触发,调用方在此发起数据加载 |
Slots
| 名称 | 说明 |
|---|---|
default | 可刷新的内容 |
示例
下拉刷新
vue
<PullRefresh v-model="loading" @refresh="loading = false">
<CellGroup>
<Cell title="订单 A" value="已完成" />
<Cell title="订单 B" value="配送中" />
<Cell title="订单 C" value="待支付" />
</CellGroup>
</PullRefresh>结合骨架屏
vue
<PullRefresh v-model="loading" @refresh="loading = false">
<Skeleton :rows="3" avatar />
</PullRefresh>禁用刷新
vue
<PullRefresh v-model="loading" disabled>
<CellGroup>
<Cell title="禁用下拉" value="不可刷新" />
</CellGroup>
</PullRefresh>