OpenHarmony列表组件支持啥

在 OpenHarmony（ArkUI）里，“列表组件”通常指 List / Grid / WaterFlow 这一族滚动容器。下面按“支持什么能力”来梳理（基于 ArkTS / ArkUI，HarmonyOS NEXT 与 OpenHarmony 通用思路基本一致）。

一、核心列表组件

1. List（线性列表）

最常用的纵向/横向列表。

支持：

• 纵向 / 横向滚动（ListDirection）
• 分组列表（ListItemGroup）
• 多种布局：
  • 单列
  • 多列（lanes）
• 滚动控制：
  • scrollToIndex()
  • scrollTo()
  • scrollBy()
• 滚动事件：
  • onScroll
  • onScrollIndex
  • onReachStart / onReachEnd
• 编辑能力：
  • 侧滑删除
  • 拖拽排序（需配合手势）
• 性能优化：
  • 按需创建（懒加载）
  • cachedCount 控制缓存数量

典型场景：

• 消息列表
• 设置页
• 通讯录

2. Grid（网格列表）

二维网格布局。

支持：

• 行 / 列定义（GridItem + columnsTemplate）
• 横向 / 纵向滚动
• 跨行跨列（rowStart / columnStart）
• 滚动控制（同 List）
• 编辑、拖拽
• 懒加载

典型场景：

• 应用中心
• 图片墙
• 功能入口

3. WaterFlow（瀑布流）

OpenHarmony 较新支持的组件。

支持：

• 不等高 item
• 多列自适应
• 懒加载
• 滚动监听

典型场景：

• 电商商品流
• 图片社区

二、列表通用能力支持

1. 数据驱动

• 支持 ForEach
• 推荐 LazyForEach（大数据量）

List() {
  LazyForEach(dataSource, item => {
    ListItem() {
      Text(item.title)
    }
  })
}

2. 交互能力

• 点击 onClick
• 长按
• 滑动（Swipe）
• 拖拽排序
• 下拉刷新（需自定义或封装）

3. 样式与布局

• 分割线
• 内边距 / 外边距
• 圆角 / 阴影
• 固定头部（sticky）
• 分组标题

4. 性能支持

• 节点复用
• 懒加载
• 可视区域渲染
• 缓存控制

三、不支持或需注意的点

• ❌ 不内置“下拉刷新 / 上拉加载更多”组件（需自己写）
• ❌ 不像 Flutter 有完整 ListView.builder 封装（要配合 LazyForEach）
• ⚠️ 大数据量必须懒加载，否则卡顿

四、简单示例

List({ space: 10 }) {
  LazyForEach(this.data, (item) => {
    ListItem() {
      Text(item)
        .fontSize(16)
    }
  }, item => item)
}
.width('100%')
.height('100%')

如果你是想问：

• “OpenHarmony 支持哪些列表组件？”
• “和传统 Android RecyclerView 比支持啥？”
• “具体某个版本（如 3.2 / 4.0 / NEXT）支持情况”

可以告诉我，我可以直接按你用的版本和语言（ArkTS / JS）细讲。