#list
高性能列表组件,适用于渲染大量数据,支持垂直滚动和按需渲染。
#扫码预览
#Props
| 属性名 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| bounces | boolean | true | 否 | 是否启用弹性效果(iOS 回弹效果) |
| children | ReactNode | - | 否 | 子元素 |
| className | string | - | 否 | 组件类名 |
| enableNestedScroll | boolean | false | 否 | 是否支持嵌套滚动 |
| enableScroll | boolean | true | 否 | 是否允许滚动 |
| experimentalRecycleStickyItem | boolean | - | 否 | 是否回收吸顶元素 |
| id | string | - | 否 | 元素的唯一标识 |
| initialScrollIndex | number | 0 | 否 | 列表渲染后自动滚动到的节点位置 |
| itemSnap | ListItemSnapAlignment | - | 否 | 启用分页效果 |
| key | string | number | null | - | 否 | React key 属性 |
| layoutId | number | -1 | 否 | 数据源更新的唯一标识,会在 layoutcomplete 事件中返回 |
| listType | "single" | "flow" | "waterfall" | 'single' | 否 | 列表的布局类型 |
| lowerThresholdItemCount | number | 0 | 否 | 触发滚动到底部的剩余子节点数量阈值 |
| needLayoutCompleteInfo | boolean | false | 否 | layoutcomplete 事件是否包含布局信息 |
| needVisibleItemInfo | boolean | false | 否 | 是否在滚动事件回调参数中包含当前渲染节点的位置信息 |
| onLayoutComplete | (event: ListLayoutCompleteEvent) => void | - | 否 | 首屏渲染完成时触发 |
| onScroll | (event: ListScrollEvent) => void | - | 否 | 滚动事件 |
| onScrollStateChange | (event: ListScrollStateChangeEvent) => void | - | 否 | 滚动状态变化时触发 |
| onScrollToLower | (event: ListScrollToLowerEvent) => void | - | 否 | 滚动到底部时触发 |
| onScrollToUpper | (event: ListScrollToUpperEvent) => void | - | 否 | 滚动到顶部时触发 |
| onSnap | (event: ListSnapEvent) => void | - | 否 | 分页滚动回调 |
| preloadBufferCount | number | 0 | 否 | 列表外预加载的节点数量 |
| ref | Ref<NodesRef> | - | 否 | 用于获取组件实例的 ref |
| scrollBarEnable | boolean | - | 否 | 是否显示滚动条 |
| scrollEventThrottle | number | 200 | 否 | 滚动事件的回调频率(ms) |
| scrollOrientation | "horizontal" | "vertical" | 'vertical' | 否 | 滚动方向和布局方向 |
| spanCount | number | 1 | 否 | 列表的列数或行数,仅当 listType 为 'flow' 或 'waterfall' 时有效 |
| sticky | boolean | false | 否 | 是否允许列表整体吸顶或吸底 |
| stickyOffset | number | 0 | 否 | 吸顶或吸底时的偏移距离(px) |
| style | CSSProperties | - | 否 | 组件样式 |
| upperThresholdItemCount | number | 0 | 否 | 触发滚动到顶部的剩余子节点数量阈值 |