Vant3 PullRefresh 下拉刷新

介紹

用于提供下拉刷新的交互操作。

實例演示

引入

通過以下方式來全局注冊組件，更多注冊方式請參考組件注冊。

import { createApp } from 'vue';
import { PullRefresh } from 'vant';

const app = createApp();
app.use(PullRefresh);

代碼演示

基礎用法

下拉刷新時會觸發(fā) refresh 事件，在事件的回調(diào)函數(shù)中可以進行同步或異步操作，操作完成后將 v-model 設置為 false，表示加載完成。

<van-pull-refresh v-model="state.loading" @refresh="onRefresh">
  <p>刷新次數(shù): {{ state.count }}</p>
</van-pull-refresh>

import { reactive } from 'vue';
import { Toast } from 'vant';

export default {
  setup() {
    const state = reactive({
      count: 0,
      loading: false,
    });
    const onRefresh = () => {
      setTimeout(() => {
        Toast('刷新成功');
        state.loading = false;
        state.count++;
      }, 1000);
    };

    return {
      state,
      onRefresh,
    };
  },
};

成功提示

通過 success-text 可以設置刷新成功后的頂部提示文案。

<van-pull-refresh
  v-model="isLoading"
  success-text="刷新成功"
  @refresh="onRefresh"
>
  <p>刷新次數(shù): {{ count }}</p>
</van-pull-refresh>

自定義提示

通過插槽可以自定義下拉刷新過程中的提示內(nèi)容。

<van-pull-refresh v-model="isLoading" :head-height="80" @refresh="onRefresh">
  <!-- 下拉提示，通過 scale 實現(xiàn)一個縮放效果 -->
  <template #pulling="props">
    <img
      class="doge"
      src="https://img.yzcdn.cn/vant/doge.png" rel="external nofollow"  rel="external nofollow" 
      :style="{ transform: `scale(${props.distance / 80})` }"
    />
  </template>

  <!-- 釋放提示 -->
  <template #loosing>
    <img class="doge" src="https://img.yzcdn.cn/vant/doge.png" rel="external nofollow"  rel="external nofollow"  />
  </template>

  <!-- 加載提示 -->
  <template #loading>
    <img class="doge" src="https://img.yzcdn.cn/vant/doge-fire.jpg" rel="external nofollow"  />
  </template>
  <p>刷新次數(shù): {{ count }}</p>
</van-pull-refresh>

<style>
  .doge {
    width: 140px;
    height: 72px;
    margin-top: 8px;
    border-radius: 4px;
  }
</style>

API

Props

Events

Slots

樣式變量

組件提供了下列 CSS 變量，可用于自定義樣式，使用方法請參考 ConfigProvider 組件。

常見問題

PullRefresh 的內(nèi)容未填滿屏幕時，只有一部分區(qū)域可以下拉？

默認情況下，下拉區(qū)域的高度是和內(nèi)容高度保持一致的，如果需要讓下拉區(qū)域始終為全屏，可以給 PullRefresh 設置一個與屏幕大小相等的最小高度：

<van-pull-refresh style="min-height: 100vh;" />

PullRefresh 的觸發(fā)條件是？

PullRefresh 的觸發(fā)條件是「父級滾動元素的滾動條在頂部位置」。

• 如果最近一個可滾動的父級元素是 window，則要求 window.pageYOffset === 0。
• 如果最近一個可滾動的父級元素是 Element，則要求 Element.scrollTop === 0。

在桌面端無法操作組件？

參見桌面端適配。