【HarmonyOS Next之旅】ArkTS语法(三) -> 渲染控制

举报
枫叶丹 发表于 2025/05/24 20:39:21 2025/05/24
【摘要】 ArkTS也提供了渲染控制的能力。条件渲染可根据应用的不同状态,渲染对应状态下的UI内容。循环渲染可从数据源中迭代获取数据,并在每次迭代过程中创建相应的组件。


目录

1 -> 条件渲染

2 -> 循环渲染

3 -> 数据懒加载

ArkTS也提供了渲染控制的能力。条件渲染可根据应用的不同状态,渲染对应状态下的UI内容。循环渲染可从数据源中迭代获取数据,并在每次迭代过程中创建相应的组件。

1 -> 条件渲染
使用if/else进行条件渲染。

说明

Column() {
if (this.count < 0) {
Text(‘count is negative’).fontSize(14)
} else if (this.count % 2 === 0) {
Text(‘count is even’).fontSize(14)
} else {
Text(‘count is odd’).fontSize(14)
}
}
2 -> 循环渲染
通过循环渲染(ForEach)从数组中获取数据,并为每个数据项创建相应的组件,可减少代码复杂度。

ForEach(
arr: any[],
itemGenerator: (item: any, index?: number) => void,
keyGenerator?: (item: any, index?: number) => string
)
参数名 参数类型 必填 参数描述
arr any[] 是 必须是数组,允许设置为空数组,空数组场景下将不会创建子组件。同时允许设置返回值为数组类型的函数,例如arr.slice(1, 3),设置的函数不得改变包括数组本身在内的任何状态变量,如Array.splice、Array.sort或Array.reverse这些改变原数组的函数。
itemGenerator (item:any, index?: number) => void 是 生成子组件的lambda函数,为数组中的每一个数据项创建一个或多个子组件,单个子组件或子组件列表必须包括在大括号“{…}”中。
keyGenerator (item:any, index?: number) => string 否 匿名函数,用于给数组中的每一个数据项生成唯一且固定的键值。当数据项在数组中的位置更改时,其键值不得更改,当数组中的数据项被新项替换时,被替换项的键值和新项的键值必须不同。键值生成器的功能是可选的,但是,为了使开发框架能够更好地识别数组更改,提高性能,建议提供。如将数组反向时,如果没有提供键值生成器,则ForEach中的所有节点都将重建。
说明

// test.ets
@Entry
@Component
struct MyComponent {
@State arr: number[] = [10, 20, 30]

build() {
Column({ space: 5 }) {
Button(‘Reverse Array’)
.onClick(() => {
this.arr.reverse()
})

  ForEach(this.arr, (item: number) => {
    Text(`item value: ${item}`).fontSize(18)
    Divider().strokeWidth(2)
  }, (item: number) => item.toString())
}

}
}

3 -> 数据懒加载
通过数据懒加载(LazyForEach)从提供的数据源中按需迭代数据,并在每次迭代过程中创建相应的组件。

LazyForEach(
dataSource: IDataSource,
itemGenerator: (item: any) => void,
keyGenerator?: (item: any) => string
): void

interface IDataSource {
totalCount(): number;
getData(index: number): any;
registerDataChangeListener(listener: DataChangeListener): void;
unregisterDataChangeListener(listener: DataChangeListener): void;
}

interface DataChangeListener {
onDataReloaded(): void;
onDataAdd(index: number): void;
onDataMove(from: number, to: number): void;
onDataDelete(index: number): void;
onDataChange(index: number): void;
}
参数名 参数类型 必填 参数描述
dataSource IDataSource 是 实现IDataSource接口的对象,需要开发者实现相关接口。
itemGenerator (item: any) => void 是 生成子组件的lambda函数,为数组中的每一个数据项创建一个或多个子组件,单个子组件或子组件列表必须包括在大括号“{…}”中。
keyGenerator (item: any) => string 否 匿名函数,用于给数组中的每一个数据项生成唯一且固定的键值。当数据项在数组中的位置更改时,其键值不得更改,当数组中的数据项被新项替换时,被替换项的键值和新项的键值必须不同。键值生成器的功能是可选的,但是,为了使开发框架能够更好地识别数组更改,提高性能,建议提供。如将数组反向时,如果没有提供键值生成器,则LazyForEach中的所有节点都将重建。
3.1 -> IDataSource类型说明
名称 描述
totalCount(): number
获取数据总数

getData(index: number): any 获取索引值index对应的数据
registerDataChangeListener(listener: DataChangeListener): void 注册数据改变的监听器
unregisterDataChangeListener(listener: DataChangeListener): void 注销数据改变的监听器
3.2 -> DataChangeListener类型说明
名称 描述
onDataReloaded(): void 重新加载所有数据
onDataAdded(index: number): void (deprecated) 通知组件index的位置有数据添加
onDataMoved(from: number, to: number): void (deprecated) 通知组件数据从from的位置移到to的位置
onDataDeleted(index: number): void (deprecated) 通知组件index的位置有数据删除
onDataChanged(index: number): void (deprecated) 通知组件index的位置有数据变化
onDataAdd(index: number): void 8+ 通知组件index的位置有数据添加
onDataMove(from: number, to: number): void 8+ 通知组件数据从from的位置移到to的位置
onDataDelete(index: number): void 8+ 通知组件index的位置有数据删除
onDataChange(index: number): void 8+ 通知组件index的位置有数据变化
// test2.ets
class BasicDataSource implements IDataSource {
private listeners: DataChangeListener[] = []

public totalCount(): number {
return 0
}

public getData(index: number): any {
return undefined
}

registerDataChangeListener(listener: DataChangeListener): void {
if (this.listeners.indexOf(listener) < 0) {
console. info(‘add listener’)
this.listeners.push(listener)
}
}

unregisterDataChangeListener(listener: DataChangeListener): void {
const pos = this.listeners.indexOf(listener);
if (pos >= 0) {
console. info(‘remove listener’)
this.listeners.splice(pos, 1)
}
}

notifyDataReload(): void {
this.listeners.forEach(listener => {
listener.onDataReloaded()
})
}

notifyDataAdd(index: number): void {
this.listeners.forEach(listener => {
listener.onDataAdd(index)
})
}

notifyDataChange(index: number): void {
this.listeners.forEach(listener => {
listener.onDataChange(index)
})
}

notifyDataDelete(index: number): void {
this.listeners.forEach(listener => {
listener.onDataDelete(index)
})
}

notifyDataMove(from: number, to: number): void {
this.listeners.forEach(listener => {
listener.onDataMove(from, to)
})
}
}

class MyDataSource extends BasicDataSource {
// 初始化数据列表
private dataArray: string[] = [’/path/image0.png’, ‘/path/image1.png’, ‘/path/image2.png’, ‘/path/image3.png’]

public totalCount(): number {
return this.dataArray.length
}

public getData(index: number): any {
return this.dataArray[index]
}

public addData(index: number, data: string): void {
this.dataArray.splice(index, 0, data)
this.notifyDataAdd(index)
}

public pushData(data: string): void {
this.dataArray.push(data)
this.notifyDataAdd(this.dataArray.length - 1)
}
}

@Entry
@Component
struct MyComponent {
private data: MyDataSource = new MyDataSource()

build() {
List({ space: 3 }) {
LazyForEach(this.data, (item: string) => {
ListItem() {
Row() {
Image(item).width(50).height(50)
Text(item).fontSize(20).margin({ left: 10 })
}.margin({ left: 10, right: 10 })
}
.onClick(() => {
// 每点击一次列表项,数据增加一项
this.data.pushData(’/path/image’ + this.data.totalCount() + ‘.png’)
})
}, item => item)
}
}
}
说明

感谢各位大佬支持!!!

互三啦!!!

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。