list

概述

列表视图容器

子组件

仅支持<list-item>

属性

支持通用属性

名称类型默认值必填描述
scrollpagebooleanfalse是否将 list 顶部页面中非 list 部分随 list 一起滑出可视区域,开启该属性会降低 list 渲染性能

样式

支持通用样式

名称类型默认值必填描述
flex-directioncolumn | row | column-reverse 1040+ | row-reverse 1040+column设置列表的滚动以及子元素的排列方向
columnsnumber1list 显示列数

事件

名称参数描述
scroll{scrollX:scrollXValue, scrollY:scrollYValue, scrollState:stateValue 1010+}列表滑动stateValue 说明:0: list 停止滑动1: list 正在通过用户的手势滑动2: list 正在滑动,用户已松手
scrollbottom-列表滑动到底部
scrolltop-列表滑动到顶部
scrollend 1040+-列表滑动结束
scrolltouchup 1040+-列表滑动过程中手指抬起

方法

名称参数描述
scrollTo{index: number(指定位置)}list 滚动到指定 item 位置

list 示例代码

查看示例代码

延伸阅读

正确使用和优化组件 list,参见list 教程