1.1.0 • Published 4 years ago

vue-virtual-listview v1.1.0

Weekly downloads
10
License
ISC
Repository
github
Last release
4 years ago

vue-virtual-listview

一个基于Vue2.6+的虚拟列表组件,可同时加载大量数据,并支持动态高度。

注意: 由于在 iOS UIWebviews 中,scroll 事件是在滚动停止之后触发的,所以不兼容iOS UIWebviews。了解更多

安装

通过 npm:

// npm
npm install vue-virtual-listview --save

基本使用

<template>
    <VirtualList
        :list-data="data"
        :estimated-item-size="100"
        v-slot="slotProps"
    >
        <div class="context">
            {{ slotProps.item.value }}
        </div>
    </VirtualList>
</template>
import VirtualList from 'vue-virtual-listview'

export default{
    data(){
        return [
            {
                value:'This is one demo~'
            },
            {
                value:'This is tow demo~'
            }
            //.....
        ]
    },
    component:{
        VirtualList
    }
}

npm.io

下拉刷新

<template>
    <VirtualList
        ref="vlist"
        :list-data="data"
        :estimated-item-size="100"
        :top-load-more="true"
        :top-method="update"
        v-slot="slotProps"
    >
        <div class="context">
            {{ slotProps.item.value }}
        </div>
    </VirtualList>
</template>
import VirtualList from 'vue-virtual-listview'

export default{
    data(){
        return [
            {
                value:'This is one demo~'
            },
            {
                value:'This is tow demo~'
            }
            //.....
        ]
    },
    methods:{
        update(){
            let data = [
                {
                    value:'This is one demo~'
                },
                {
                    value:'This is tow demo~'
                }
                //.....
            ];
            this.data = data;
            this.$refs.vlist.onBottomLoaded();
        },
    },
    component:{
        VirtualList
    }
}

npm.io

属性

参数类型默认值是否必填说明
listDataArray列表所需要的数据
heightString100%包裹元素的高度。
columnNumber1列数
bufferScaleNumber1在可见区域之外的上/下方预渲染比例,避免快速滑动时出现闪烁
estimatedItemSizeNumber150列表项的预估高度,用于预先计算可视区域的显示项数
topLoadMoreBooleanfalse是否启用下拉刷新
topMethodFunction刷新时调用的回调函数
topDistanceNumber70触发 topMethod 的下拉距离阈值(像素)
maxDistanceNumber0组件可移动的最大距离(像素),若为 0 则不限制
distanceScaleNumber2手指移动与组件移动距离的比值
topTextColorString#000000刷新区域的文本颜色
topPullTextString上拉刷新刷新状态为pull时提示区的文字
topDropTextString释放更新刷新状态为drop时提示区的文字
topLoadingTextString加载中...刷新状态为loading时提示区的文字

事件

事件名称回调参数说明
top-status-change顶部刷新区域状态变更时触发提示区域状态

提示区状态说明

状态说明
pull开始拖拽,距离未达到topDistance
drop距离达到 topDistance 释放触发 topMethod
loading已被释放,topMethod 已经执行
none刷新完成或未触发刷新动作

插槽

名称说明插槽Prop
default默认插槽item:列表项当前数据row:当前项在整体中的行数col:当前项在当前行中的列数
top顶部提示区插槽dargState:顶部刷新提示区的状态dargDistance:顶部刷新提示区的距离
1.1.0

4 years ago

1.0.3

5 years ago

1.0.2

5 years ago

1.0.1

5 years ago

1.0.0

5 years ago