介紹

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

引入

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

Vue.use(PullRefresh);

基礎(chǔ)用法

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

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

import { Toast } from 'vant';

export default {
  data() {
    return {
      count: 0,
      isLoading: false,
    };
  },
  methods: {
    onRefresh() {
      setTimeout(() => {
        Toast('刷新成功');
        this.isLoading = false;
        this.count++;
      }, 1000);
    },
  },
};

成功提示

通過(guò) success-text 可以設(shè)置刷新成功后的頂部提示文案。

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

自定義提示

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

<van-pull-refresh v-model="isLoading" :head-height="80" @refresh="onRefresh">
  <!-- 下拉提示，通過(guò) scale 實(shí)現(xiàn)一個(gè)縮放效果 -->
  <template #pulling="props">
    <img
      class="doge"
      src="https://img01.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://img01.yzcdn.cn/vant/doge.png" rel="external nofollow"  rel="external nofollow"  />
  </template>

  <!-- 加載提示 -->
  <template #loading>
    <img class="doge" src="https://img01.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>

Props

Events

Slots

樣式變量

組件提供了下列 Less 變量，可用于自定義樣式，使用方法請(qǐng)參考主題定制。

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

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

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

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

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

• 如果最近一個(gè)可滾動(dòng)的父級(jí)元素是 window，則要求 window.pageYOffset === 0。
• 如果最近一個(gè)可滾動(dòng)的父級(jí)元素是 Element，則要求 Element.scrollTop === 0。

在桌面端無(wú)法操作組件？

參見(jiàn)桌面端適配。