-
Support fixed height
-
Support variable height
-
Support two column waterfall flow layout
-
Support DOM multi screen configuration
-
Support status selection
-
Support data dynamic appending
-
Support dynamic deletion of data
npm install lite-virtual-list
import liteVirtualList from "lite-virtual-list"
Vue.use(liteVirtualList)
<template>
<lite-virtual-list type="fixed" :size="80" :remain="8" :data="items">
<div slot-scope="{ item }" style="height: 80px">{{ item.value }}</div>
</lite-virtual-list>
</template>
<script>
let items = []
let count = 1000
for (let i = 0; i < count; i ) {
items.push({ id: i, value: i })
}
export default {
data() {
return { items }
}
}
</script>
Props | Type | Default | Required | Description |
---|---|---|---|---|
data | Array | [ ] | ✓ | Data source: each item in the data source must be an object, and each item must pass in a unique ID value {ID: number | string} . When the type iswaterfall , each item passes in the height field {height: number | string} , that is, the height of each item |
type | String | ✓ | Type: three types can be specified: fixed ,variable , waterfall . Fixed: the height of the item is a fixed value. Variable: the height of the item supports the waterfall layout according to the content |
|
remain | Number | String | ✓ | Number of visible data per screen | |
size | Number | String | Size is the height of each item. When type is fixed or variable , size is required. When type is variable , size will be used as the default height of each item. After DOM rendering, the default height will be replaced by the real height |
||
screen | Array | [ 1 , 1 ] | The number of screens rendered before and after the viewable area. The default value is [1,1] , rendering one screen before and one screen after the viewable area. Example: screen = [2,3] means that two screens are rendered in front of the viewable area and three screens are rendered behind the viewable area. |
|
distance | Number | String | 50 | The distance to trigger the loadmore callback when the page scrolls. The default is 50 |
|
interval | Number | String | 0 | Scroll event trigger interval, default is 0 |
|
virtualHieght | String | 100% | The height of the virtual list is' 100% 'by default. When the type is fixed , the height will be calculated dynamically according to the size and remain attributes. This value is not required to be passed in. When the type is variable or waterfall , if this property is not passed in, the external container must declare a height value. |
|
unit | String | px | Unit, default is PX |
|
deleteId | Number | String | When dynamically deleting an item, the ID value of the current item needs to be passed in. When the type is fixed , the deletion ID is not passed in, and the current item is deleted directly this.data.splice (index, 1) delete is OK. At this time, the high value will be calculated dynamically |
||
marginBottom | Number | String | 0 | The distance between items. This property is provided only when type is waterfall . It is invalid when type is fixed or variable |
<lite-virtual-list >
<!-- The default slot can get the data of each item-->
<template slot="default" slot-scope="{ item }" >
<div>{{item.id}}</div>
</template>
<!-- bottom -->
<template slot="bottom">
<div>Loading...</div>
</template>
</lite-virtual-list>
Triggered when page scrolls
The callback returns an object
When the type is fixed
or variable
, the object contains the following properties:
-
scrollTop
: How far the page scrolls -
renderScrollTop
: Distance between the render area and the page scroll -
renderData
: Data rendered while scrolling
When the type is waterfall
, the object contains the following properties:
scrollTop
: How far the page scrollsrenderLeftScrollTop
: Distance between the data rendering area in the left column and the page scrollingrenderRightScrollTop
: Distance between the right column data rendering area and the page scrollingrenderLeftData
: Left column scrolls the rendered datarenderLeftData
: Right column scrolls the rendered data
Trigger after DOM rendering to page
When the type is fixed
or variable
, the callback will return
renderData
: Data rendered to the page
When the type is variable
, the callback will return an object containing the following properties:
renderLeftData
: Left column scrolls the rendered datarenderLeftData
: Right column scrolls the rendered data
This callback is triggered when the page scrolls to the bottom. You can configure how far it is from the bottom in combination with the 'distance' property. The default value is 50
Dynamic deletion of an item will be triggered after success, and the callback will return the data of the currently deleted item