# ArkTS语法使用常见问题 ## ArkUI如何通过代码动态创建组件(API 9) **解决措施** ArkUI使用ArkTS声明式开发范式,开发者无法持有组件实例,在声明时通过渲染控制语法以及动态构建UI元素的方式,控制组件的创建。 **代码示例** ``` // 条件渲染语句创建组件 if(this.isTrue) { Text("创建文本组件").fontSize(30) } // 循环渲染语句创建组件 ForEach(this.nums,(item) => { Text(item + '').fontSize(30) },item => JSON.stringify(item)) ``` **参考链接** [渲染控制语法](../quick-start/arkts-rendering-control-overview.md) ## 使用\@Builder装饰器包含自定义组件的方法与普通方法的区别是什么(API 9) **解决措施** \@Builder装饰的方法中使用了自定义组件,那么该方法每次被调用时,对应的自定义组件均会重新创建,普通方法中不使用\@builder装饰,无法容纳自定义组件。 **参考链接** [@BuilderParam](../quick-start/arkts-builderparam.md) ## 如何使用\@BuilderParam装饰器进行组件传参(API 9) **解决措施** - 不带参数 对\@BuilderParam修饰的属性进行赋值时不带参数(如:content: this.specificParam),则此属性的类型需定义成无返回值的函数(如:\@BuilderParam content: () => void)。 - 带参数 对\@BuilderParam修饰的属性进行赋值时带参数(如:callContent: this.specificParam1("111")),则此属性的类型需定义成any(如:\@BuilderParam callContent: any)。 **参考链接** [@BuilderParam](../quick-start/arkts-builderparam.md) ## 如何监听数组内对象属性变化(API 9) **问题现象** 数组内存储对象示例,需要对对象的属性变化进行监听。 **解决措施** 通过\@Observed配合\@ObjectLink装饰符实现。\@Observed用于类,\@ObjectLink用于变量。 **代码示例** 1. 在类上使用\@Observed。 ``` @Observed class ClassA { public name: string public c: number public id: number constructor(c: number, name: string = 'OK') { this.name = name this.c = c } } ``` 2. 在组件变量使用\@ObjectLink。 ``` @Component struct ViewA { label: string = 'ViewA1' @ObjectLink a: ClassA build() { Row() { Button(`ViewA [${this.label}] this.a.c= ${this.a.c} +1`) .onClick(() => { this.a.c += 1 }) }.margin({ top: 10 }) } } ``` **参考链接** [Observed和ObjectLink数据管理](../quick-start/arkts-observed-and-objectlink.md) ## 子组件使用\@Link修饰成员变量时,如何通过父组件传值(API 9) **解决措施** 子组件使用\@Link接受父组件的值时,需要使用'$'建立变量之间的引用关系。才能实现同步。 **代码示例** \@Link语义是从'$'操作符引出,即$isPlaying是this.isPlaying内部状态的双向数据绑定。当单击子组件PlayButton中的按钮时,\@Link变量更改,PlayButton与父组件中的Text和Button将同时进行刷新,同样地,当点击父组件中的Button修改this.isPlaying时,子组件PlayButton与父组件中的Text和Button也将同时刷新。 1. 在父组件使用\@State装饰器,传递数据使用$符创建引用。 ``` @Entry @Component struct Player { @State isPlaying: boolean = false build() { Column() { PlayButton({ buttonPlaying: $isPlaying }) Text(`Player is ${this.isPlaying ? '' : 'not'} playing`).fontSize(18) Button('Parent:' + this.isPlaying) .margin(15) .onClick(() => { this.isPlaying = !this.isPlaying }) } } } ``` 2. 在子组件使用\@Link接受数据。 ``` @Component struct PlayButton { @Link buttonPlaying: boolean build() { Column() { Button(this.buttonPlaying ? 'pause' : 'play') .margin(20) .onClick(() => { this.buttonPlaying = !this.buttonPlaying }) } } } ``` **参考链接** [@Link](../quick-start/arkts-link.md) ## 父组件如何与孙子组件进行状态同步(API 9) **解决措施** - 方式一(推荐):使用\@Provide和\@Consume装饰器。在父组件使用\@Provide,在孙子组件使用\@Consume,可以实现父组件和孙子组件进行双向数据绑定。 - 方式二:使用\@State和\@Link装饰器。在父组件使用\@State,在每一层子组件(子组件和孙子组件)都使用\@Link。 **代码示例一** 1. 父组件中使用子组件,通过Provide提供reviewVote参数,供跨级传递给孙子组件。 ``` @Entry @Component struct Father{ @Provide("reviewVote") reviewVotes: number = 0; build() { Column() { Son() Button(`Father: ${this.reviewVotes}`) ... } } } ``` 2. 子组件中使用孙组件。 ``` @Component struct Son{ build() { Column() { GrandSon() } } } ``` 3. 孙子组件中使用Consume来接受reviewVote的参数。 ``` @Component struct GrandSon{ @Consume("reviewVote") reviewVotes: number build() { Column() { Button(`GrandSon: ${this.reviewVotes}`) ... }.width('100%') } } ``` **代码示例二** 1. 父组件Father使用\@State绑定数据reviewVote。 ``` @Entry @Component struct Father { @State reviewVotes: number = 0; build() { Column() { Son({reviewVotes:$reviewVotes}) Button(`Father: ${this.reviewVotes}`) ... } } } ``` 2. 子组件Son中使用\@Link接受由父组件Father传递的参数reviewVote。 ``` @Component struct Son{ @Link reviewVotes: number; build() { Column() { Grandson({reviewVotes:$reviewVotes}) } } } ``` 3. 孙子组件GrandSon使用\@Link接受由Son组件传递的参数reviewVote。 ``` @Component struct Grandson{ @Link reviewVotes: number; build() { Column() { Button(`Grandson: ${this.reviewVotes}`) ... }.width('100%') } } ``` ## Js如何定义callback函数(API 9) **解决措施** 定义个callback函数的样例,**示例如下:** 1. 定义回调函数 ``` // 页面中定义个2个参数,空返回的callback函数 myCallback: (a:number,b:string) => void ``` 2. 在使用时进行初始化赋值 ``` aboutToAppear() { // callback函数初始化 this.myCallback= (a,b)=>{ console.info(`handle myCallback a=${a},b=${b}`) }} ``` ## 组件需要多次更新时如何优化性能(API 9) **解决措施** 使用状态管理模块,目前已经支持最小化更新,当数据依赖变化时,不再是重新刷新整个自定义组件,而是只更新依赖数据的视图内容。 ## 对象中函数的this如何指向外层(API 9) **解决措施** 通过箭头函数实现。 **代码示例** ``` const obj = { start:() => { return this.num } } ``` ## 如何实现页面加载前从接口获取数据(API 9) **问题现象** 页面生命周期相关问题,在页面渲染前从接口获取数据,渲染时将数据渲染到页面上。 **解决措施** 在声明周期函数aboutToAppear中使用异步接口获取页面数据,数据变量使用\@State修饰,数据获取完成后根据变量自动刷新页面。 **代码示例** ``` @Entry @Component struct Test6Page { // 数据获取成功,会自动刷新页面 @State message: string = 'loading.....' aboutToAppear(){ // 模拟异步接口获取数据 setTimeout(()=>{ this.message = 'new msg' },3000) } build() { Row() { Column() { Text(this.message) .fontSize(50) .fontWeight(FontWeight.Bold) } .width('100%') } .height('100%') } } ``` ## 如何将传感器的数据实时显示在UI的Text中(API 9) **解决措施** 传感器返回数据类型为double,可将double转为string,再显示在text中。 ## 如何监听屏幕旋转(API 9) **解决措施** 屏幕旋转可使用媒体查询接口进行监听。 ``` import mediaquery from '@ohos.mediaquery' let listener = mediaquery.matchMediaSync('(orientation: landscape)'); //监听横屏事件 function onPortrait(mediaQueryResult) { if (mediaQueryResult.matches) { // do something here } else { // do something here } } listener.on('change', onPortrait) // 注册回调 listener.off('change', onPortrait) // 去注册回调 ``` **参考链接** [媒体查询](../reference/apis-arkui/js-apis-mediaquery.md) ## 创建的单例换了页面后不生效问题(API 9) **问题现象** 单例只有在同一个流程中才有效,换了页面后之前的实例都全是undefined。 **解决措施** 对于每个Page都会生成一个js文件,定义的单例会在每个js中都生成一份,所以单例的作用范围只是Page的范围。 如果想共享一个实例,创建范围需要提升至UIAbility或者App级别。 ## 如何将时间格式的字符串string转换为Date对象(API 9) **解决措施** 如果字符string满足格式“yyyy-MM-dd”格式,则可直接使用函数new Date("yyyy-MM-dd")来获取对应的Date对象。 ``` new Date("2021-05-23"); new Date("2020/2/29"); new Date("2020-14-03"); new Date("14-02-2021"); ``` 其他格式字符串可使用new Date(year:number,month:number,day?:number,hour?:number,mintue?:number,second?:number,ms?:number)方法来获取Date对象。 ``` // 根据参数创建日期的语法: new Date(yearValue, IndexOfMonth, dayValue, hours, minutes, seconds) ``` 其中每一个参数换算为对应时间参数传入即可。 - yearValue:应符合 ISO 8061 YYYY 格式。例如 2021。如果我们以 YY 格式指定一个值,它将会被错误地接受。例如,仅将 2021 提到 21 会被认为是 1921 年而不是 2021 年。 - IndexOfMonth:从索引 0 开始。因此,从 Month 值中减去 1。例如,对于 3 月,该值为 3,但 monthIndex 将为 2(即 3-1 = 2)。本月指数通常应在 0-11 范围内 - dayValue:表示一个月中的某天。它应在 1-31 范围内,具体取决于一个月中的天数。例如:对于 21-05-2021,日期值为 21 - hours:一天中的小时。例如 10 点。 - minutes:过去一个小时的分钟数 - seconds:保留超过一分钟的秒数。 ## ArkTS如何把string转为byte数组(API 9) **解决措施** 参考如下代码实现,示例: ``` stringToArray(str:string) { var arr = []; for(var i = 0,j = str.length;i { /* 原数据,GBK编码 xxxxx xxxx xxxx xxxx xxxx 1 For Outsourcing Staff/xxxx xxxx xxxx */ let src = 'PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iR0JLIj8+CjxkYXRhPgo8YXNzZXRfbm8+eHh4eHg8L2Fzc2V0X25vPgo8bWFjaGluZV9zbj54eHh4PC9tYWNoaW5lX3NuPgo8Ymlvc19pZD54eHh4PC9iaW9zX2lkPgo8cmVzcG9uc2libGVfZW1wX25hbWU+PCFbQ0RBVEFbeHh4eF1dPjwvcmVzcG9uc2libGVfZW1wX25hbWU+CjxyZXNwb25zaWJsZV9hY2NvdW50PjwhW0NEQVRBW3h4eHggeHh4eF1dPjwvcmVzcG9uc2libGVfYWNjb3VudD4KPHJlc3BvbnNpYmxlX2VtcF9ubz54eHh4PC9yZXNwb25zaWJsZV9lbXBfbm8+CjxyZXNwb25zaWJsZV9kZXB0PjwhW0NEQVRBW3h4eHhdXT48L3Jlc3BvbnNpYmxlX2RlcHQ+Cjx1c2VyX2RlcHQ+PCFbQ0RBVEFbeHh4eF1dPjwvdXNlcl9kZXB0Pgo8dXNlcl9uYW1lPjwhW0NEQVRBW3h4eF1dPjwvdXNlcl9uYW1lPgo8Y3VyX2RvbWFpbl9hY2NvdW50Pnh4eHg8L2N1cl9kb21haW5fYWNjb3VudD4KPGFzc2V0X2xvYz48IVtDREFUQVstLV1dPjwvYXNzZXRfbG9jPgo8YXNzZXRfbG9jX2N1cj48IVtDREFUQVtdXT48L2Fzc2V0X2xvY19jdXI+Cjxhc3NldF90eXBlPjE8L2Fzc2V0X3R5cGU+Cjxhc3NldF91c2U+Rm9yIE91dHNvdXJjaW5nIFN0YWZmL3h4eHg8L2Fzc2V0X3VzZT4KPG92ZXJkdWVfZGF0ZT48L292ZXJkdWVfZGF0ZT4KPGFzc2V0X3N0YXR1cz54eHh4PC9hc3NldF9zdGF0dXM+Cjxhc3NldF9wZXJpb2Q+eHh4eDwvYXNzZXRfcGVyaW9kPgo8bGljZW5zZT48L2xpY2Vuc2U+CjwvZGF0YT4=' let base64 = new util.Base64Helper(); // base解码 let src_uint8Array = base64.decodeSync(src); // 解码为utf-8的字符串 let textDecoder = util.TextDecoder.create("utf-8",{ignoreBOM: true}) let src_str = textDecoder.decodeWithStream(src_uint8Array) //替换encoding字段 src_str = src_str.replace("GBK","utf-8") console.log('Test src_str: ' + JSON.stringify(src_str)); // 转换 xml-> json let conv = new convertxml.ConvertXML(); let options = {trim : false, declarationKey:"_declaration", instructionKey : "_instruction", attributesKey : "_attributes", textKey : "_text", cdataKey:"_cdata", doctypeKey : "_doctype", commentKey : "_comment", parentKey : "_parent", typeKey : "_type", nameKey : "_name", elementsKey : "_elements"} let src_json = JSON.stringify(conv.convertToJSObject(src_str, options)); console.log('Test json: ' + JSON.stringify(src_json)); }) } .width('100%') } .height('100%') } } ``` ## 在生成器函数中编译TS语言有哪些使用限制(API 9) **解决措施** TS语言的使用在生成器函数中存在以下限制: - 表达式仅允许在字符串(${expression})、if条件、ForEach的参数和组件的参数中使用。 - 这些表达式中的任何一个都不能导致任何应用程序状态变量(\@State、\@Link、\@Prop)的改变,否则会导致未定义和潜在不稳定的框架行为。 - 生成器函数内部不能有局部变量。 上述限制都不适用于事件处理函数(例如onClick)的匿名函数实现。 ## 如何设置一张图片上面四个角都分别有一个角标(API 9) **问题现象** 应用需求,在一张图片上面四个角分别设置一个角标。 **解决措施** 可以使用绝对定位,设置元素锚点相对于父容器顶部起点的偏移位置。在布局容器中,设置该属性不影响父容器布局。 示例: ``` @Entry @Component struct PositionExample2 { build() { Column({ space: 20 }) { Stack({ alignContent: Alignment.TopStart }) { Row() .size({ width: '100', height: '100' }) .backgroundColor(0xdeb887) Image($r('app.media.app_icon')) .size({ width: 25, height: 25 }) .markAnchor({ x: 0, y: 0 }) Image($r('app.media.app_icon')) .size({ width: 25, height: 25 }) .markAnchor({ x: 25, y: 25 }) .position({ x: '100%', y: '100%' }) }.margin({ top: 25 }).width('100').height('100') } .width('100%').margin({ top: 25 }) } } ``` ## util.generateRandomUUID参数问题(API 9) **解决措施** generateRandomUUID底层使用Node.js crypto.randomUUID()接口,传递参数为false时会生成uuid,并缓存到系统里,参数为true时使用系统已缓存的UUID。 **参考链接** 参考文档:[util.generateRandomUUID](../reference/apis-arkts/js-apis-util.md#utilgeneraterandomuuid9) ## worker线程与主线程是否运行在相同的全局上下文中(API 9) **解决措施** worker线程与主线程不在同一个上下文中,它们使用数据通信的方式交互。 **参考链接** worker:[启动一个Worker](../reference/apis-arkts/js-apis-worker.md) ## 应用图标一多设置(API 9) **问题现象** 希望可以按照设备的不同类型,显示相应的应用图标 **解决措施** 借助资源限定词能力,可以实现应用图标的一多配置 **示例代码** 1.创建资源目录,并在资源目录中添加资源文件,以Tablet为例,在src/main/resources下创建tablet资源目录,在tablet目录下创建media资源文件夹 ``` ├─base │ ├─element │ ├─media │ └─profile ├─rawfile ├─tablet │ ├─element │ └─media ``` 2.在1中创建的media文件夹下添加设备类型为tablet时希望显示的图标文件,在UI界面进行引用 ``` @Entry @Component struct Index { build() { Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) { Text($r("app.string.my_string")) .fontSize($r("app.float.my_float")) .fontColor($r("app.color.my_color")) Image($r("app.media.my_image")) .width(100) .height(100) } .width('100%') .height('100%') } } ``` **参考链接** [资源使用](../key-features/multi-device-app-dev/resource-usage.md) ## 调用方法的时候,如何解决方法内部的this变成undefined(API 9) **问题现象** ArkTS里的this指向 **解决措施** 方式一:在调用方法的时候加上.bind(this); 方式二:使用箭头函数。 ## systemTime.getCurrentTime()接口和JS的new Date().getTime()有区别吗(API 9) **解决措施** systemTime.getCurrentTime(false)和new Date().getTime()一样,都是返回1970年1月1日至今的毫秒数;systemTime.getCurrentTime(true)返回1970年1月1日至今的纳秒数。两种方式都是系统时间。 ## 如何实现类似js中的slot插槽功能(API 9) **解决措施** 该功能在ArkTS中使用\@Build和\@BuilderParam方式来实现。 **参考链接** [@BuilderParam装饰器:引用@Builder函数](../quick-start/arkts-builderparam.md) ## 加上lineHeight,Text垂直不居中的原因(API 9) **原因分析** Text组件不用设置lineHeight属性,默认就是居中的。绘制文本是从底部开始绘制的,设置合适的lineHeight可以让文本有居中效果,但如果lineHeight设置的过高,文本就会显得偏下一些,一般lineHeight属性用来联合padding属性调整Text内的上下行间距。 **参考链接** [Text](../reference/apis-arkui/arkui-ts/ts-basic-components-text.md#示例1) ## 使用什么接口进行url编码(API 9) **解决措施** 使用全局函数encodeURI进行编码,使用decodeURI进行解码。例如空格字符““,编码后为%20。 ``` let a = encodeURI(" ") console.log(a) // %20 ``` ## 如何解析xml(API 9) **解决措施** 使用ConvertXML的convert接口可以将xml文本解析为JavaScript对象。 **参考链接** [转换xml](../reference/apis-arkts/js-apis-convertxml.md) ## 使用Styles装饰器,编译报错.stateStyles doesn't conform standard(API 9) **原因分析** Styles装饰器内部只支持通用属性,使用了非通用属性作为Style的代码 **解决措施** 去掉非通用属性,或者使用Builder来提取公共组件。 ## Radio组件$$双向绑定(API 9) **解决措施** Radio组件使用$$绑定的变量变更时,仅渲染当前组件,提高渲染速度。 当Radio组件的状态发生改变时,不会自动修改绑定的变量。 **参考链接** [内置组件双向同步](../quick-start/arkts-two-way-sync.md) ## ForEach组件在真机上无法执行(API 9) **问题现象** ForEach组件预览器可以正常执行,但在真机上无法执行。 **原因分析** 真机上系统版本大于等于3.2beta5版本,真机会默认开启最小化更新策略。 旧版IDE默认没有开启最小化更新,导致组件运行异常。 **解决措施** module.json5添加"metadata"配置项: ``` { "module": { "metadata": [ { "name": "ArkTSPartialUpdate", "value": "true" } ] } } ``` ## AppStorage是不是不支持线程间共享对象,为什么,推荐替代方案是什么(API 10) **解决措施** AppStorage是应用全局的UI状态存储,是和应用的进程绑定的,由UI框架在应用程序启动时创建,为应用程序UI状态属性提供中央存储。 AppStorage支持应用的主线程内多个UIAbility实例间的状态共享。 AppStorage是UI相关的数据,需要运行在UI线程,无法将对象共享到其他线程。目前暂无替代方案。 **参考链接** [AppStorage:应用全局的UI状态存储](../quick-start/arkts-appstorage.md) ## 自定义字体的注册方式有哪些,推荐的字体资源存放路径是哪里,如何从资源存放路径中取出字体资源(API 10) **解决措施** 在工程中存放开发者自定义字体资源文件,代码中通过registerFont接口进行自定义字体注册,便可以在文本组件中使用fontFamily属性使用。 推荐使用$rawfile方式引用自定义字体资源,资源可放在resources/rawfile目录下。 **参考链接** [@ohos.font (注册自定义字体)](../reference/apis-arkui/js-apis-font.md) ## Text组件如何加载Unicode字符(API 10) **解决措施** 在Text组件入参content中使用字符串,在字符串中转义Unicode编码,示例代码如下: ```ts @Entry @Component struct text {   build() {   Column(){     Text("\u{1F468}\u200D\u{1F468}\u200D\u{1F467}\u200D\u{1F466}")       .width(100)       .height(100)       .fontSize(50)   }   } } ``` ## 类似js中的slot插槽功能在ArkTS中如何实现(API 10) **解决措施** ArkUI还提供了一种更轻量的UI元素复用机制@Builder,@Builder所装饰的函数遵循build()函数语法规则,开发者可以将重复使用的UI元素抽象成一个方法,在build方法里调用; 另外,ArkUI引入了@BuilderParam装饰器,@BuilderParam用来装饰指向@Builder方法的变量,开发者可在初始化自定义组件时对此属性进行赋值,为自定义组件增加特定的功能。该装饰器用于声明任意UI描述的一个元素,类似slot占位符。 参考@Builder 和@BuilderParam。 **参考链接** 1. [@Builder装饰器:自定义构建函数](../quick-start/arkts-builder.md) 2. [@BuilderParam装饰器:引用@Builder函数](../quick-start/arkts-builderparam.md)