wordpress建站视屏,asp网站后台密码破解,宿州产品网站建设,建设网站需申请什么一、创建自定义组件 在ArkUI中#xff0c;UI显示的内容均为组件#xff0c;由框架直接提供的称为系统组件#xff0c;由开发者定义的称为自定义组件。在进行 UI 界面开发时#xff0c;通常不是简单的将系统组件进行组合使用#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!;})}}
}HelloComponent可以在其他自定义组件中的build()函数中多次创建实现自定义组件的重用。 class HelloComponentParam {message: string
}Entry
Component
struct ParentComponent {param: HelloComponentParam {message: Hello, World!}build() {Column() {Text(ArkUI message)HelloComponent(param);Divider()HelloComponent(param);}}
}要完全理解上面的示例需要了解自定义组件的以下概念定义本文将在后面的小节中介绍 自定义组件的基本结构成员函数/变量自定义组件的参数规定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卡片中使用。 从API version 10开始Entry可以接受一个可选的LocalStorage的参数或者一个可选的EntryOptions参数。 Entry
Component
struct MyComponent {
}EntryOptions10命名路由跳转选项。 名称 类型 必填 说明 routeName string 否 表示作为命名路由页面的名字。 storage LocalStorage 否 页面级的UI状态存储。 Entry({ routeName : myPage })
Component
struct MyComponent {
}ReusableReusable装饰的自定义组件具备可复用能力 说明 从API version 10开始该装饰器支持在ArkTS卡片中使用。 Reusable
Component
struct MyComponent {
}成员函数/变量 自定义组件除了必须要实现build()函数外还可以实现其他成员函数成员函数具有以下约束 不支持静态函数。成员函数的访问始终是私有的。 自定义组件可以包含成员变量成员变量具有以下约束 不支持静态成员变量。所有成员变量都是私有的变量的访问规则与成员函数的访问规则相同。自定义组件的成员变量本地初始化有些是可选的有些是必选的。具体是否需要本地初始化是否需要从父组件通过参数传递初始化子组件的成员变量请参考状态管理。 自定义组件的参数规定 从上文的示例中我们已经了解到可以在build方法或者Builder装饰的函数里创建自定义组件在创建的过程中参数可以被提供给组件。 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所处的开发者不可见的容器组件上。 二、页面和自定义组件生命周期 在开始之前我们先明确自定义组件和页面的关系 自定义组件Component装饰的UI单元可以组合多个系统组件实现UI的复用。页面即应用的UI页面。可以由一个或者多个自定义组件组成Entry装饰的自定义组件为页面的入口组件即页面的根节点一个页面有且仅能有一个Entry。只有被Entry装饰的组件才可以调用页面的生命周期。 页面生命周期即被Entry装饰的组件生命周期提供以下生命周期接口 onPageShow页面每次显示时触发。onPageHide页面每次隐藏时触发一次。onBackPress当用户点击返回按钮时触发。 组件生命周期即一般用Component装饰的自定义组件的生命周期提供以下生命周期接口 aboutToAppear组件即将出现时回调该接口具体时机为在创建自定义组件的新实例后在执行其build()函数之前执行。aboutToDisappear在自定义组件即将析构销毁时执行。 生命周期流程如下图所示下图展示的是被Entry装饰的组件首页生命周期。 根据上面的流程图我们从自定义组件的初始创建、重新渲染和删除来详细解释。 自定义组件的创建和渲染流程 自定义组件的创建自定义组件的实例由ArkUI框架创建。初始化自定义组件的成员变量通过本地默认值或者构造方法传递参数来初始化自定义组件的成员变量初始化顺序为成员变量的定义顺序。如果开发者定义了aboutToAppear则执行aboutToAppear方法。在首次渲染的时候执行build方法渲染系统组件如果有自定义子组件则创建自定义组件的实例。在执行build()函数的过程中框架会观察每个状态变量的读取状态将保存两个map 状态变量 - UI组件包括ForEach和if。UI组件 - 此组件的更新函数即一个lambda方法作为build()函数的子集创建对应的UI组件并执行其属性方法示意如下。 build() {...this.observeComponentCreation(() {Button.create();})this.observeComponentCreation(() {Text.create();})...
}当应用在后台启动时此时应用进程并没有销毁所以仅需要执行onPageShow。 自定义组件重新渲染 当事件句柄被触发比如设置了点击事件即触发点击事件改变了状态变量时或者LocalStorage / AppStorage中的属性更改并导致绑定的状态变量更改其值时 框架观察到了变化将启动重新渲染。根据框架持有的两个map自定义组件的创建和渲染流程中第4步框架可以知道该状态变量管理了哪些UI组件以及这些UI组件对应的更新函数。执行这些UI组件的更新函数实现最小化更新。 自定义组件的删除 如果if组件的分支改变或者ForEach循环渲染中数组的个数改变组件将被删除 在删除组件之前将调用其aboutToDisappear生命周期函数标记着该节点将要被销毁。ArkUI的节点删除机制是后端节点直接从组件树上摘下后端节点被销毁对前端节点解引用当前端节点已经没有引用时将被JS虚拟机垃圾回收。自定义组件和它的变量将被删除如果其有同步的变量比如Link、Prop、StorageLink将从同步源上取消注册。 不建议在生命周期aboutToDisappear内使用async await如果在生命周期的aboutToDisappear使用异步操作Promise或者回调方法自定义组件将被保留在Promise的闭包中直到回调方法被执行完这个行为阻止了自定义组件的垃圾回收。 以下示例展示了生命周期的调用时机 // Index.ets
import router from ohos.router;Entry
Component
struct MyComponent {State showChild: boolean true;// 只有被Entry装饰的组件才可以调用页面的生命周期onPageShow() {console.info(Index onPageShow);}// 只有被Entry装饰的组件才可以调用页面的生命周期onPageHide() {console.info(Index onPageHide);}// 只有被Entry装饰的组件才可以调用页面的生命周期onBackPress() {console.info(Index onBackPress);}// 组件生命周期aboutToAppear() {console.info(MyComponent aboutToAppear);}// 组件生命周期aboutToDisappear() {console.info(MyComponent aboutToDisappear);}build() {Column() {// this.showChild为true创建Child子组件执行Child aboutToAppearif (this.showChild) {Child()}// this.showChild为false删除Child子组件执行Child aboutToDisappearButton(delete Child).onClick(() {this.showChild false;})// push到Page2页面执行onPageHideButton(push to next page).onClick(() {router.pushUrl({ url: pages/Page2 });})}}
}Component
struct Child {State title: string Hello World;// 组件生命周期aboutToDisappear() {console.info([lifeCycle] Child aboutToDisappear)}// 组件生命周期aboutToAppear() {console.info([lifeCycle] Child aboutToAppear)}build() {Text(this.title).fontSize(50).onClick(() {this.title Hello ArkUI;})}
}以上示例中Index页面包含两个自定义组件一个是被Entry装饰的MyComponent也是页面的入口组件即页面的根节点一个是Child是MyComponent的子组件。只有Entry装饰的节点才可以生效页面的生命周期方法所以MyComponent中声明了当前Index页面的页面生命周期函数。MyComponent和其子组件Child也同时声明了组件的生命周期函数。 应用冷启动的初始化流程为MyComponent aboutToAppear -- MyComponent build -- Child aboutToAppear -- Child build -- Child build执行完毕 -- MyComponent build执行完毕 -- Index onPageShow。点击“delete Child”if绑定的this.showChild变成false删除Child组件会执行Child aboutToDisappear方法。点击“push to next page”调用router.pushUrl接口跳转到另外一个页面当前Index页面隐藏执行页面生命周期Index onPageHide。此处调用的是router.pushUrl接口Index页面被隐藏并没有销毁所以只调用onPageHide。跳转到新页面后执行初始化新页面的生命周期的流程。如果调用的是router.replaceUrl则当前Index页面被销毁执行的生命周期流程将变为Index onPageHide -- MyComponent aboutToDisappear -- Child aboutToDisappear。上文已经提到组件的销毁是从组件树上直接摘下子树所以先调用父组件的aboutToDisappear再调用子组件的aboutToDisappear然后执行初始化新页面的生命周期流程。点击返回按钮触发页面生命周期Index onBackPress且触发返回一个页面后会导致当前Index页面被销毁。最小化应用或者应用进入后台触发Index onPageHide。当前Index页面没有被销毁所以并不会执行组件的aboutToDisappear。应用回到前台执行Index onPageShow。退出应用执行Index onPageHide -- MyComponent aboutToDisappear -- Child aboutToDisappear。
