Lines Matching refs:List
1 # List chapter
11 > - List组件[通用属性clip](ts-universal-attributes-sharp-clipping.md)的默认值为true。
13 > - 要使List处于可编辑模式需配合onItemDelete事件和ListItem的editable属性，即可编辑模式实现删除列表项功能，需满足以下条件（该功能从API9开始废弃）：
34 > List的子组件的索引值计算规则：
46 > List子组件visibility属性设置为Hidden或None依然会计算索引值。
48 > List子组件的visibility属性设置为None时不显示，但该子组件上下的space还会生效。
53 List(value?:{space?: number | string, initialIndex?: number, scroller?: Scroller})
65 | initialIndex | number | 否 | 设置当前List初次加载时显示区域起始位置的item索引值。<br/>默认值：0<br/>**说明：** <br/>设置为负数或超过了当前…
66 …>默认值：0<br/>参数类型为number时单位为vp。<br/>**说明：** <br/>设置为负数或者大于等于List内容区长度时，按默认值显示。<br/>space参数值小于List分割线…
77 设置List组件排列方向。
101 List的分割线画在主轴方向两个子组件之间，第一个子组件上方和最后一个子组件下方不会绘制分割线。
103 多列模式下，ListItem与ListItem之间的分割线起始边距从每一列的交叉轴方向起始边开始计算，其他情况从List交叉轴方向起始边开始计算。
141 设置列表中ListItem/ListItemGroup的预加载数量，懒加载场景只会预加载List显示区域外cachedCount的内容，非懒加载场景会全部加载。懒加载、非懒加载都只布局List显示区…
143 List设置cachedCount后，显示区域外上下各会预加载并布局cachedCount行ListItem。计算ListItem行数时，会计算ListItemGroup内部的ListItem行数。…
145 List下嵌套使用LazyForEach，并且LazyForEach下嵌套使用ListItemGroup时，LazyForEach会在List显示区域外上下各会创建cachedCount个ListI…
165 List设置cachedCount后，显示区域外上下各会预加载并布局cachedCount行ListItem。计算ListItem行数时，会计算ListItemGroup内部的ListItem行数。…
184 设置当前List组件是否处于可编辑模式。可参考[示例3](#示例3设置编辑模式)实现删除选中的list项。
194 | value | boolean | 是 | 当前List组件是否处于可编辑模式。<br/>默认值：false |
212 | value | [EdgeEffect](ts-appendix-enums.md#edgeeffect) | 是 | List…
219 设置当前List是否启用链式联动动效，开启后列表滑动以及顶部和底部拖拽时会有链式联动的效果。
221 链式联动效果：List内的ListItem间隔一定距离，该距离可以通过List组件space参数设置，默认为20vp。在手指划动过程中，手指拖动的ListItem是主动对象，相邻的ListItem为…
223 链式动效生效后，List的分割线不显示。
227 1、List边缘效果为Spring类型。
229 2、List没有启用多列模式。
265 设置List组件的布局列数或行数。gutter为列间距，当列数大于1时生效。
269 - lanes为指定的数量时，根据指定的数量与List组件的交叉轴尺寸除以列数作为列的宽度。
270 - lanes设置了{minLength，maxLength}时，根据List组件的宽度自适应决定lanes数量（即列数），保证缩放过程中lane的宽度符合{minLength，maxLength}…
272 - ListItemGroup在多列模式下也是独占一行，ListItemGroup中的ListItem按照List组件的lanes属性设置值来布局。
273 …xLength}时，计算列数会按照ListItemGroup的交叉轴尺寸计算。当ListItemGroup交叉轴尺寸与List交叉轴尺寸不一致时ListItemGroup中的列数与List中的列数…
285 …umber \| [LengthConstrain](ts-types.md#lengthconstrain) | 是 | List组件的布局列数或行数。<br/>默认值：…
292 设置List交叉轴方向宽度大于ListItem交叉轴宽度 * lanes时，ListItem在List交叉轴方向的布局方式。
314 > 由于浮点数计算精度，设置sticky后，在List滑动过程中小概率产生缝隙，可以通过[pixelRound](ts-universal-attributes-pixelRound.md#pixe…
336 触控板和鼠标滑动List结束后不支持对齐效果。
432 设置List组件的子组件在主轴方向的大小信息。
442 …List组件准确提供所有子组件在主轴方向的大小信息，能够使List组件在子组件的主轴大小不一致、增删子组件、使用[scrollToIndex](ts-container-scroll.md#scr…
475 | Start | 0 | ListItem在List中，交叉轴方向首部对齐。 |
476 | Center | 1 | ListItem在List中，交叉轴方向居中对齐。 |
477 | End | 2 | ListItem在List中，交叉轴方向尾部对齐。 |
531 当List组件在编辑模式时，点击ListItem右边出现的删除按钮时触发。
553 有子组件划入或划出List显示区域时触发。计算索引值时，ListItemGroup作为一个整体占一个索引值，不计算ListItemGroup内部ListItem的索引值。
555 List的边缘效果为弹簧效果时，在List划动到边缘继续划动和松手回弹过程不会触发onScrollIndex事件。
557 触发该事件的条件：列表初始化时会触发一次，List显示区域内第一个子组件的索引值或最后一个子组件的索引值有变化时会触发。
559 从API version 10开始，List显示区域中间位置子组件变化时也会触发该事件。
571 | start | number | 是 | List显示区域内第一个子组件的索引值 |
572 | end | number | 是 | List显示区域内最后一个子组件的索引值。 |
573 | center<sup>10+</sup> | number | 是 | List显示区域内中间位置子组件的索引值。 |
581 List初始化时如果initialIndex为0会触发一次，List滚动到起始位置时触发一次。List边缘效果为弹簧效果时，划动经过起始位置时触发一次，回弹回起始位置时再触发一次。
595 List边缘效果为弹簧效果时，划动经过末尾位置时触发一次，回弹回末尾位置时再触发一次。
611 触发该事件的条件：手指拖动List、List惯性划动时每帧开始时触发；List超出边缘回弹、使用滚动控制器和拖动滚动条的滚动不会触发。
753 跨List拖拽时，当拖拽释放的位置绑定了onItemDrop时会返回true，否则为false。List内部拖拽时，isSuccess为onItemMove事件的返回值。
785 | scrollOffset | number | 是 | 每帧滚动的偏移量，List的内容向上滚动时偏移量为正，向下滚动时偏移量为负。<br/>单位vp。 |
791 有子组件划入或划出List显示区域时触发。计算触发条件时，每一个ListItem、ListItemGroup中的header或footer都算一个子组件。
793 List的边缘效果为弹簧效果时，在List划动到边缘继续划动和松手回弹过程不会触发onScrollVisibleContentChange事件。
795 触发该事件的条件：列表初始化时会触发一次，List显示区域内第一个子组件的索引值或最后一个子组件的索引值有变化时会触发。
818 | Scroll | 1 | 滚动状态。手指拖动List，拖动滚动条和滚动鼠标滚轮时触发。|
824 List组件的滚动控制器，通过它控制List组件的滚动，仅支持一对一绑定到List组件。
843 获取[ListItemGroup](ts-container-listitemgroup.md)中的[ListItem](ts-container-listitem.md)的大小和相对于List的位…
853 | index | number | 是 | ListItemGroup在List中的索引值。 |
867 | [RectResult](ts-types.md#rectresult10) | ListItemGroup中的ListItem的大小和相对于List的位置。<br/>单位：vp。 |
971 > - ListScroller必须绑定到List组件上。
977 有子组件划入或划出List显示区域时触发。
996 | index | number | 是 | List显示区域内ListItem或ListItemGroup的索引值。 |
1026 List({ space: 20, initialIndex: 0 }) {
1070 该示例展示了不同ListItemAlign枚举值下，List组件交叉轴方向子元素对齐效果。
1082 List({ space: 20, initialIndex: 0 }) {
1122 该示例展示了如何设置当前List组件是否处于可编辑模式。
1135 List({ space: 20, initialIndex: 0 }) {
1180 该示例展示了List组件设置居中限位的实现效果。
1198 List({ space: 20, initialIndex: 3, scroller: this.scrollerForList }) {
1232 该示例通过设置childrenMainSize属性，实现了List在子组件高度不一致时调用scrollTo接口也可以跳转准确。
1234 如果配合状态管理V2使用，详情见：[List与makeObserved](../../../quick-start/arkts-v1-v2-migration.md#list)。
1249 // 前5个item的主轴大小不是默认大小100，因此需要通过ChildrenMainSize通知List。
1254 List({ space: this.listSpace, initialIndex: 4, scroller: this.scroller }) {
1283 // 310: 跳转到item 1顶部与List顶部平齐的位置。
1297 该示例展示了含有group时，获得List组件的Item索引相关信息。
1345 List({ space: 20, scroller: this.scroller}) {
1406 该示例实现了List组件开启边缘渐隐效果并设置边缘渐隐长度。
1418 List({ space: 20, initialIndex: 0, scroller: this.scrollerForList }) {