鸿蒙Next声明式UI描述

一、引言

在鸿蒙Next开发中,ArkTS以声明方式组合和扩展组件来描述应用程序的UI,为开发者提供了高效、灵活的方式来构建用户界面。本文将详细介绍鸿蒙Next中声明式UI的相关内容,包括组件创建、属性配置、事件配置以及子组件配置等方面,帮助开发者更好地理解和运用这一技术。

二、创建组件

(一)无参数创建

如果组件的接口定义没有包含必选构造参数,则组件后面的“()”不需要配置任何内容。例如,Divider组件不包含构造参数,可按如下方式创建:

Column() {
  Text('item 1')
  Divider()
  Text('item 2')
}

(二)有参数创建

若组件的接口定义包含构造参数,则在组件后面的“()”需要配置相应参数。如Image组件的必选参数src,以及Text组件的非必选参数content(有多种赋值方式):

  1. 直接赋值字符串
    • Image('https://xyz/test.jpg')
    • Text('test')
  2. 使用$r形式引入应用资源(适用于多语言场景)
    • Text($r('app.string.title_value'))
  3. 无参数形式
    • Text()
  4. 使用变量或表达式赋值
    • 变量赋值:Image(this.imagePath)
    • 表达式赋值:Image('https://' + this.imageUrl)Text(count: ${this.count})

三、配置属性

属性方法以“.”链式调用的方式配置系统组件的样式和其他属性,建议每个属性方法单独写一行。

  1. 配置单个属性
    • 配置Text组件字体大小:Text('test').fontSize(12)
  2. 配置多个属性
    • Image('test.jpg').alt('error.jpg').width(100).height(100)
  3. 使用变量或表达式配置属性
    • Text('hello').fontSize(this.size)
    • Image('test.jpg').width(this.count % 2 === 0? 100 : 200).height(this.offset + 100)
  4. 使用枚举类型配置属性(针对系统组件)
    • 配置Text组件颜色和字体样式:Text('hello').fontSize(20).fontColor(Color.Red).fontWeight(FontWeight.Bold)

四、配置事件

事件方法以“.”链式调用的方式配置系统组件支持的事件,建议每个事件方法单独写一行。

  1. 使用箭头函数配置事件方法
    • Button('Click me').onClick(() => {this.myText = 'ArkUI';})
  2. 使用箭头函数表达式配置事件方法
    • Button('add counter').onClick(() => {this.counter += 2;})
  3. 使用组件的成员函数配置事件方法(需bind this,不推荐)
    • 定义成员函数:
      myClickHandler(): void {
        this.counter += 2;
      }
      
    • 绑定事件:Button('add counter').onClick(this.myClickHandler.bind(this))
  4. 使用声明的箭头函数配置事件方法(可直接调用,不需要bind this)
    • 声明箭头函数:
      fn = () => {
        console.info(`counter: ${this.counter}`)
        this.counter++
      }
      
    • 绑定事件:Button('add counter').onClick(this.fn)

注意:箭头函数内部的this是词法作用域,由上下文确定。匿名函数可能会有this指向不明确问题,在ArkTS中不允许使用。

五、配置子组件

如果组件支持子组件配置,则需在尾随闭包"{...}"中为组件添加子组件的UI描述。Column、Row、Stack、Grid、List等组件都是容器组件。

  1. 简单Column组件配置子组件示例
    Column() {
      Text('Hello')
       .fontSize(100)
      Divider()
      Text(this.myText)
       .fontSize(100)
       .fontColor(Color.Red)
    }
    
  2. 容器组件多级嵌套示例
    Column() {
      Row() {
        Image('test1.jpg')
         .width(100)
         .height(100)
        Button('click +1')
         .onClick(() => {
            console.info('+1 clicked!');
          })
      }
    }
    

通过以上对鸿蒙Next声明式UI描述中组件创建、属性配置、事件配置和子组件配置的介绍,开发者可以更加熟练地运用这些技术构建出功能丰富、交互性强的用户界面,为用户提供优质的应用体验。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 213,047评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,807评论 3 386
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 158,501评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,839评论 1 285
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,951评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,117评论 1 291
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,188评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,929评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,372评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,679评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,837评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,536评论 4 335
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,168评论 3 317
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,886评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,129评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,665评论 2 362
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,739评论 2 351

推荐阅读更多精彩内容