跳到主要内容

PullRefresh 下拉刷新 ​

uni-appH5微信小程序App

跨端下拉刷新容器,达到阈值后触发 refresh,完成后将 v-model 设为 false。

何时使用 ​

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

何时不使用 ​

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

本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。

9:41
PullRefresh 下拉刷新 · uni-app H5 实时运行 新窗口打开

Props ​

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

Events ​

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

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>