温馨提示×

温馨提示×

您好,登录后才能下订单哦!

密码登录×
登录注册×
其他方式登录
点击 登录注册 即表示同意《亿速云用户服务条款》

OpenHarmony ListView如何监听

发布时间:2026-11-01 01:06:48 来源:亿速云 阅读:90 作者:小樊 栏目:软件技术

在 OpenHarmony(ArkUI) 中,并没有传统 Android 里的 ListView 控件,而是使用 List + ForEach / LazyForEach 来实现列表。
“监听 ListView”通常指:监听列表滚动、item 点击、数据变化 等。下面分别说明。


一、监听 List 滚动(Scroll 监听)

使用 List 的 onScroll、onScrollIndex、onReachStart、onReachEnd

List() {
  ForEach(this.data, (item) => {
    ListItem() {
      Text(item)
    }
  })
}
.onScroll((scrollOffset: number, scrollState: ScrollState) => {
  console.info('滚动偏移:', scrollOffset)
})
.onScrollIndex((start: number, end: number) => {
  console.info('可见区域:', start, end)
})
.onReachStart(() => {
  console.info('滚动到顶部')
})
.onReachEnd(() => {
  console.info('滚动到底部')
})

二、监听 Item 点击事件

在 ListItem 中使用 .onClick()

List() {
  ForEach(this.data, (item, index) => {
    ListItem() {
      Text(item)
        .fontSize(18)
    }
    .onClick(() => {
      console.info('点击了第', index, '项:', item)
    })
  })
}

三、监听列表数据变化(响应式)

OpenHarmony 使用 状态管理 来监听数据变化:

1️⃣ 使用 @State

@Entry
@Component
struct ListViewPage {
  @State data: string[] = ['A', 'B', 'C']

  build() {
    List() {
      ForEach(this.data, (item) => {
        ListItem() {
          Text(item)
        }
      })
    }
  }
}

当 this.data 改变时,List 会自动刷新。


2️⃣ 使用 @Observed + @ObjectLink(复杂对象)

@Observed
class Item {
  name: string
  constructor(name: string) {
    this.name = name
  }
}
@State items: Item[] = [new Item('A'), new Item('B')]

四、长列表监听(性能优化)

如果是大数据量,使用 LazyForEach

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

LazyForEach 会监听数据源变化并增量渲染。


五、常见监听总结

需求 方法
滚动监听 onScroll
滚动到头/尾 onReachStart / onReachEnd
Item 点击 onClick
数据变化 @State / @Observed
长列表性能 LazyForEach

如果你指的是 某个具体版本(API 9 / 10 / 11) 或 eTS / JS 开发方式,可以告诉我,我可以给你更精确的示例。

向AI问一下细节

免责声明:本站发布的内容(图片、视频和文字)以原创、转载和分享为主,文章观点不代表本网站立场,如果涉及侵权请联系站长邮箱:is@yisu.com进行举报,并提供相关证据,一经查实,将立刻删除涉嫌侵权内容。

AI
助
手