高职院校高水平专业建设网站,wordpress 地图相册,网站建设的市场需求,网址之家在ArkUI中#xff0c;UI显示的内容均为组件#xff0c;由框架直接提供的称为系统组件#xff0c;由开发者定义的称为自定义组件。在进行 UI 界面开发时#xff0c;通常不是简单的将系统组件进行组合使用#xff0c;而是需要考虑代码可复用性、业务逻辑与UI分离#xff0c…在ArkUI中UI显示的内容均为组件由框架直接提供的称为系统组件由开发者定义的称为自定义组件。在进行 UI 界面开发时通常不是简单的将系统组件进行组合使用而是需要考虑代码可复用性、业务逻辑与UI分离后续版本演进等因素。因此将UI和部分业务逻辑封装成自定义组件是不可或缺的能力。
自定义组件具有以下特点
可组合允许开发者组合使用系统组件、及其属性和方法。可重用自定义组件可以被其他组件重用并作为不同的实例在不同的父组件或容器中使用。数据驱动UI更新通过状态变量的改变来驱动UI的刷新。
自定义组件的基本用法
以下示例展示了自定义组件的基本用法。
Component
struct HelloComponent {State message: string Hello, World!;build() {// HelloComponent自定义组件组合系统组件Row和TextRow() {Text(this.message).onClick(() {// 状态变量message的改变驱动UI刷新UI从Hello, World!刷新为Hello, ArkUI!this.message Hello, ArkUI!;})}}
} 说明 如果在另外的文件中引用该自定义组件需要使用export关键字导出并在使用的页面import该自定义组件。
HelloComponent可以在其他自定义组件中的build()函数中多次创建实现自定义组件的重用。
Entry
Component
struct ParentComponent {build() {Column() {Text(ArkUI message)HelloComponent({ message: Hello, World! });Divider()HelloComponent({ message: 你好! });}}
} 要完全理解上面的示例需要了解自定义组件的以下概念定义本文将在后面的小节中介绍
自定义组件的基本结构 成员函数/变量 自定义组件的参数规定 build()函数 自定义组件通用样式
自定义组件的基本结构
struct自定义组件基于struct实现struct 自定义组件名 {...}的组合构成自定义组件不能有继承关系。对于struct的实例化可以省略new。 说明 自定义组件名、类名、函数名不能和系统组件名相同。 ComponentComponent装饰器仅能装饰struct关键字声明的数据结构。struct被Component装饰后具备组件化的能力需要实现build方法描述UI一个struct只能被一个Component装饰。 说明 从API version 9开始该装饰器支持在ArkTS卡片中使用。
Component
struct MyComponent {
} build()函数build()函数用于定义自定义组件的声明式UI描述自定义组件必须定义build()函数。
Component
struct MyComponent {build() {}
} EntryEntry装饰的自定义组件将作为UI页面的入口。在单个UI页面中最多可以使用Entry装饰一个自定义组件。Entry可以接受一个可选的LocalStorage的参数。 说明 从API version 9开始该装饰器支持在ArkTS卡片中使用。
Entry
Component
struct MyComponent {
}
成员函数/变量
自定义组件除了必须要实现build()函数外还可以实现其他成员函数成员函数具有以下约束
自定义组件的成员函数为私有的且不建议声明成静态函数
自定义组件可以包含成员变量成员变量具有以下约束
自定义组件的成员变量为私有的且不建议声明成静态变量。自定义组件的成员变量本地初始化有些是可选的有些是必选的。具体是否需要本地初始化是否需要从父组件通过参数传递初始化子组件的成员变量请参考状态管理。
自定义组件的参数规定
从上文的示例中我们已经了解到可以在build方法里创建自定义组件在创建自定义组件的过程中根据装饰器的规则来初始化自定义组件的参数。
Component
struct MyComponent {private countDownFrom: number 0;private color: Color Color.Blue;build() {}
}Entry
Component
struct ParentComponent {private someColor: Color Color.Pink;build() {Column() {// 创建MyComponent实例并将创建MyComponent成员变量countDownFrom初始化为10将成员变量color初始化为this.someColorMyComponent({ countDownFrom: 10, color: this.someColor })}}
}
build()函数
所有声明在build()函数的语言我们统称为UI描述UI描述需要遵循以下规则
Entry装饰的自定义组件其build()函数下的根节点唯一且必要且必须为容器组件其中ForEach禁止作为根节点。 Component装饰的自定义组件其build()函数下的根节点唯一且必要可以为非容器组件其中ForEach禁止作为根节点。
Entry
Component
struct MyComponent {build() {// 根节点唯一且必要必须为容器组件Row() {ChildComponent() }}
}Component
struct ChildComponent {build() {// 根节点唯一且必要可为非容器组件Image(test.jpg)}
}
不允许声明本地变量反例如下。
build() {// 反例不允许声明本地变量let a: number 1;
}
不允许在UI描述里直接使用console.info但允许在方法或者函数里使用反例如下。
build() {// 反例不允许console.infoconsole.info(print debug log);
}
不允许创建本地的作用域反例如下。
build() {// 反例不允许本地作用域{...}
} 不允许调用没有用Builder装饰的方法允许系统组件的参数是TS方法的返回值。
Component
struct ParentComponent {doSomeCalculations() {}calcTextValue(): string {return Hello World;}Builder doSomeRender() {Text(Hello World)}build() {Column() {// 反例不能调用没有用Builder装饰的方法this.doSomeCalculations();// 正例可以调用this.doSomeRender();// 正例参数可以为调用TS方法的返回值Text(this.calcTextValue())}}
} 不允许switch语法如果需要使用条件判断请使用if。反例如下。
build() {Column() {// 反例不允许使用switch语法switch (expression) {case 1:Text(...)break;case 2:Image(...)break;default:Text(...)break;}}
} 不允许使用表达式反例如下。
build() {Column() {// 反例不允许使用表达式(this.aVar 10) ? Text(...) : Image(...)}
}
自定义组件通用样式
自定义组件通过“.”链式调用的形式设置通用样式。
Component
struct MyComponent2 {build() {Button(Hello World)}
}Entry
Component
struct MyComponent {build() {Row() {MyComponent2().width(200).height(300).backgroundColor(Color.Red)}}
}
说明
ArkUI给自定义组件设置样式时相当于给MyComponent2套了一个不可见的容器组件而这些样式是设置在容器组件上的而非直接设置给MyComponent2的Button组件。通过渲染结果我们可以很清楚的看到背景颜色红色并没有直接生效在Button上而是生效在Button所处的开发者不可见的容器组件上。
