在 OpenHarmony(ArkUI) 中,并没有传统 Android 里的 ListView 控件,而是使用 List + ForEach / LazyForEach 来实现列表。
“监听 ListView”通常指:监听列表滚动、item 点击、数据变化 等。下面分别说明。
使用 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('滚动到底部')
})
在 ListItem 中使用 .onClick()
List() {
ForEach(this.data, (item, index) => {
ListItem() {
Text(item)
.fontSize(18)
}
.onClick(() => {
console.info('点击了第', index, '项:', item)
})
})
}
OpenHarmony 使用 状态管理 来监听数据变化:
@State@Entry
@Component
struct ListViewPage {
@State data: string[] = ['A', 'B', 'C']
build() {
List() {
ForEach(this.data, (item) => {
ListItem() {
Text(item)
}
})
}
}
}
当 this.data 改变时,List 会自动刷新。
@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 开发方式,可以告诉我,我可以给你更精确的示例。
免责声明:本站发布的内容(图片、视频和文字)以原创、转载和分享为主,文章观点不代表本网站立场,如果涉及侵权请联系站长邮箱:is@yisu.com进行举报,并提供相关证据,一经查实,将立刻删除涉嫌侵权内容。