1.0.12 • Published 4 years ago

vo-pages v1.0.12

Weekly downloads
148
License
MIT
Repository
-
Last release
4 years ago

在线体验与源码

易用?高可定制?

  • 易用: 基础使用只需要列表数据、上拉事件、下拉事件就完成了翻页、刷新功能的开发
  • 高可定制: 提供了各种配置项,用于提示语配置、样式修改、上拉下拉事件切换等等功能

使用

  • npm i vo-pages --save
  • vo-pages组件父元素必须设置固定高度并填写属性overflow: hidden;如:
height: 100vh;
overflow: hidden;

全局引入

// mian.js
import VoPages from "vo-pages";
import "vo-pages/lib/vo-pages.css";
Vue.component('VoPages', VoPages)

局部引入

import VoPages from 'vo-pages';
import "vo-pages/lib/vo-pages.css";
components: {
  VoPages
}

常规使用

<vo-pages :data="list" @pullingUp="pullingUp" @pullingDown="pullingDown" :loadedAll="loadedAll">
  <ul class="article-list">
    <li class="article" v-for="article in list" :key="article.id">
      <slot></slot>
      <div class="left">
        <img :src="article.image_uri" alt="thumb" />
      </div>
      <div class="right">
        <p>{{ article.title }}</p>
        <p>{{ article.author }}</p>
      </div>
    </li>
  </ul>
</vo-pages>

更多案例参考:vo-pages/examples

API

参数说明类型默认值
data数据列表array必填
click是否可响应用户点击事件booleantrue
loadedAll是否已加载所有数据booleanfalse
pullUpHandle是否开启上拉事件,如果不需要上拉事件,必须设置为falseobject | booleantrue
pullDownHandle是否开启下拉事件,如果不需要下拉事件,必须设置为falseobject | boolean{threshold: 50,stop: 30}
pullDownToLoadmore是否下拉加载更多booleanfalse
noDataHint初始化/无数据时是否提示booleantrue
config自定义设置object{}

点击pullUpHandlepullDownHandle查看详细介绍

config配置项

管道符后面的值是pullDownToLoadmore为ture时(下拉加载更多)的默认值

参数说明类型默认值
pullDownMsgDelay下拉提示语展示时长(ms)number800
loading加载中……
refresh刷新中…… |加载中……
refreshed刷新成功 | 已加载
loadedAllMsg已加载全部
pullUpMsg上拉加载更多
pullDownMsg下拉刷新 | 下拉加载更多
touchLeaveMsg释放立即刷新 | 释放加载更多
noData暂无数据
pullDownStyle下拉提示样式{}
pullUpStyle上拉提示样式{}
endLineStyle底线样式{}

Events

  • pullingUp:上拉超过pullUpHandlethreshold触发
  • pullingDown: 下拉超过pullDownHandlethreshold触发

Slot

只有一个默认插槽,用来展示用户数据

注意

  • 数据不足一屏时且有下一页时会自动请求下一页数据

TODO

  • 下拉图标(掘金下拉效果)
  • css自动加载

如果各位大佬使用中遇到bug或不爽的点,还希望可以给提issue,您的反馈使我进步,非常感谢。

再次奉上项目源码