# List 列表

该组件为高性能列表组件

# 平台差异说明

App(vue) App(nvue) H5 小程序

# 基本使用

  • 配合组件zx-list-item嵌套使用
  • 参数show-scrollbar是否出现滚动条仅在nvue中有效
  • 事件@scrolltolower滚动到底部触发事件
<template>
	<view class="zx-page">
		<zx-list
			@scrolltolower="scrolltolower"
		>
			<zx-list-item
				v-for="(item, index) in indexList"
				:key="index"
			>
				<zx-cell
					:title="`列表长度-${index + 1}`"
				>
					<zx-avatar
						slot="icon"
						shape="square"
						size="35"
						:src="item.url"
						customStyle="margin: -3px 5px -3px 0"
					></zx-avatar>
				</zx-cell>
			</zx-list-item>
		</zx-list>
	</view>
</template>

<script>
	export default {
		data() {
			return {
				indexList: [],
				urls: [
					'https://app.zxui.org/album/1.jpg',
					'https://app.zxui.org/album/2.jpg',
					'https://app.zxui.org/album/3.jpg',
					'https://app.zxui.org/album/4.jpg',
					'https://app.zxui.org/album/5.jpg',
					'https://app.zxui.org/album/6.jpg',
					'https://app.zxui.org/album/7.jpg',
					'https://app.zxui.org/album/8.jpg',
					'https://app.zxui.org/album/9.jpg',
					'https://app.zxui.org/album/10.jpg'
				]
			}
		},
		onLoad() {
			this.loadmore()
		},
		methods: {
			scrolltolower() {
				this.loadmore()
			},
			loadmore() {
				for (let i = 0; i < 30; i++) {
					this.indexList.push({
						url: this.urls[uni.$u.random(0, this.urls.length - 1)]
					})
				}
			}
		},
	}
</script>

# API

# List Props

参数 说明 类型 默认值 可选值
showScrollbar 控制是否出现滚动条,仅nvue有效 Boolean false true
lowerThreshold 距底部多少时触发scrolltolower事件 String | Number 50 -
upperThreshold 距顶部多少时触发scrolltoupper事件,非nvue有效 String | Number 0 -
scrollTop 设置竖向滚动条位置 String | Number 0 -
offsetAccuracy 控制 onscroll 事件触发的频率,仅nvue有效 String | Number 10 -
enableFlex 启用 flexbox 布局。开启后,当前节点声明了display: flex就会成为flex container,并作用于其孩子节点,仅微信小程序有效 Boolean false -
pagingEnabled 是否按分页模式显示List,默认值false Boolean false -
scrollable 是否允许List滚动 Boolean true -
scrollIntoView 值应为某子元素id(id不能以数字开头) String - -
scrollWithAnimation 在设置滚动条位置时使用动画过渡 Boolean false -
enableBackToTop iOS点击顶部状态栏、安卓双击标题栏时,滚动条返回顶部,只对微信小程序有效 Boolean false -
height 列表的高度 String | Number 0 -
width 列表宽度 String | Number 0 -
preLoadScreen 列表前后预渲染的屏数,1代表一个屏幕的高度,1.5代表1个半屏幕高度 String | Number 1 -

# List Events

事件名 说明 回调参数
scroll 滚动条滚动触发事件 scrollTop: 滚动条位置
scrolltolower 滚动到底部触发事件 -

# ListItem Props

参数 说明 类型 默认值 可选值
anchor 用于滚动到指定item String | Number - -