vue移动端下拉刷新和上拉加载组件,体积小运行快

听过千百首歌
English

下面介绍一款vue移动端下拉刷新和上拉加载组件,体积小运行快,使用起来很简单。

一个Vue.js 的下拉刷新和上拉加载组件。

通过提供简单的api易于使用。与其他组件库不同,它使用浏览器本身而不是js来作滚动容器,因此它的代码量更小,但不损失用户体验。

中文 | English

预览

在线demo

也可以扫描以下二维码访问演示:

<img src="https://user-images.githubusercontent.com/20060839/145163261-02025f86-ac87-4016-859f-15677a6d3cf7.png" width="220" height="220" >

安装 & 使用

安装 npm 包

# npm
npm install vuejs-loadmore --save

全局导入

import Vue from 'vue';
import VueLoadmore from 'vuejs-loadmore';

Vue.use(VueLoadmore);

国际化支持

支持中文 zh-CN 和英文 en-US, 默认为 zh-CN。

import VueLoadmore from 'vuejs-loadmore';

Vue.use(VueLoadmore, {
  lang: 'en-US'
})

你也可以使用 locale.use() 指定语言。

import VueLoadmore, { locale } from 'vuejs-loadmore';

Vue.use(VueLoadmore);
locale.use('en-US');

用法

基础用法

<vue-loadmore 
  :on-refresh="onRefresh" 
  :on-loadmore="onLoad"
  :finished="finished">
  <div v-for="(item, i) of list" :key="i"></div>
</vue-loadmore>

on-refreshon-loadmore 会在下拉刷新或滚动到底部时触发,需要在处理完数据请求后执行回调函数 done()

如果你不需要刷新,只需要不绑定on-refresh

当数据请求完成后,你可以将finished的数据改为true,这样就会显示没有更多了

export default {
  data() {
    return {
      list: [],
      page: 1,
      pageSize: 10,
      finished: false
    };
  },
  mounted() {
    this.fetch();
  },
  methods: {
    onRefresh(done) {
      this.list = [];
      this.page = 1;
      this.finished = false;
      this.fetch();

      done();
    },

    onLoad(done) {
      if (this.page <= 10) {
        this.fetch();
      } else {
        // all data loaded
        this.finished = true;
      }
      done();
    },

    fetch() {
      for (let i = 0; i < this.pageSize; i++) {
        this.list.push(this.list.length + 1);
      }
      this.page++;
    }
  },
}

错误提示

<vue-loadmore 
  :on-loadmore="onLoad"
  :finished="finished"
  :error.sync="error">
  <div v-for="(item, i) of list" :key="i"></div>
</vue-loadmore>
export default {
  data() {
    return {
      list: [],
      finished: false,
      error: false,
    };
  },
  methods: {
    onLoad() {
      fetchSomeThing().catch(() => {
        this.error = true;
      });
    },
  },
};

API

Props

AttributeDescriptionTypeDefault
on-refresh顶部下拉触发function-
pulling-text下拉显示文本string下拉刷新
loosing-text释放显示文本string释放刷新
loading-text正在刷新显示文本string正在刷新
success-text刷新完成显示文本string刷新完成
show-success-text是否显示success-textbooleantrue
pull-distance触发正在刷新状态的距离_number \string_50
head-height正在刷新显示区域的高度_number \string_50
animation-duration下拉刷新动画持续时间_number \string_200
on-loadmore滚动到底部触发function-
immediate-check是否在mounted之后立即检查booleantrue
load-offset当滚动条到底部的距离小于 load-offset 时,会发出 on-loadmore_number \string_50
finished数据是否加载完毕,改变为true,则会显示finished-textbooleanfalse
error数据是否加载错误,on-loadmore只有在点击错误文本时才会触发,需要sync修饰符booleanfalse
loading-text滚动到底部正在加载显示文本string正在加载
finished-text滚动到底部加载完毕的显示文本string没有更多了
error-text加载错误显示文本string请求失败,点击重新加载

方法

使用 ref 获取 List 实例并调用实例方法。

NameDescription
checkScroll检查当前的滚动位置,若已滚动至底部,则会触发 on-loadmore

例子

查看demo以快速了解如何使用此包。

git clone git@github.com:staticdeng/vuejs-loadmore.git
yarn install
yarn example:dev
阅读 1.1k

前端进阶
前端进阶必备
419 声望
11 粉丝
0 条评论
419 声望
11 粉丝
文章目录
宣传栏