鸿蒙开发:组件样式的复用

简介: 如果要实现多页面之间的组件属性样式复用,建议使用AttributeModifier,如果是单页面,通用属性可以使用@Styles,组件自有属性可以使用@Extend。

前言


我们先看一段简单的代码,可以看看发现有什么问题。


@Entry
@Component
struct Index {
  build() {
    Column() {
      Text("1")
        .width(50)
        .height(50)
        .backgroundColor(Color.Red)
        .margin({ top: 10 })
      Text("2")
        .width(50)
        .height(50)
        .backgroundColor(Color.Red)
        .margin({ top: 10 })
      Text("3")
        .width(50)
        .height(50)
        .backgroundColor(Color.Red)
        .margin({ top: 10 })
      Text("4")
        .width(50)
        .height(50)
        .backgroundColor(Color.Red)
        .margin({ top: 10 })
    }
  }
}


从以上的代码中,很明显的就能看出来,每个Text组件除了内容不一样之外,其它的样式属性都是重复存在的,此等案例,在实际的开发中,肯定会多次出现,虽然说,并不影响功能,但是,大量重复的样式代码,已经失去了代码的简洁性,也极大的增加了后续的代码维护,为了解决这一问题,还是建议大家能够把重复出现的样式,可以抽取出公共的样式。


@Styles装饰器


通过@Styles装饰器,我们可以把重复的样式,抽取成一个方法,供组件进行调用,还是以上的代码,我能使用@Styles装饰器进行抽取一下。


@Entry
@Component
struct Index {
  build() {
    Column() {
      Text("1").textStyle()
      Text("2").textStyle()
      Text("3").textStyle()
      Text("4").textStyle()
    }
  }
  @Styles
  textStyle() {
    .width(50)
    .height(50)
    .backgroundColor(Color.Red)
    .margin({ top: 10 })
  }
}


当然了,除了在页面或者组件内使用,你也可以放到全局,其效果是一样的。

@Styles
function textStyle() {
  .width(50)
  .height(50)
  .backgroundColor(Color.Red)
  .margin({ top: 10 })
}
@Entry
@Component
struct Index {
  build() {
    Column() {
      Text("1").textStyle()
      Text("2").textStyle()
      Text("3").textStyle()
      Text("4").textStyle()
    }
  }
}

和前言中的代码,我们对比一下,同样的功能,哪一个代码更清晰简洁,相信我们一目了然。

@Styles装饰器有一个阻碍性问题,我们需要知道,那就是只能在当前文件内使用,不支持export,而且只只支持通用属性和通用事件,比如,同样是Text组件,宽高等通用属性,我们可以使用@Styles装饰器,但是其它的,比如颜色,文字大小等自身属性,却使用不了,如何解决这个问题,可以使用@Extend装饰器。

@Extend装饰器


我们把上面的案例,简单修改一下,都设置成当前组件的自有属性,显然这种情况下,是无法使用@Styles装饰器的。

@Entry
@Component
struct Index {
  build() {
    Column() {
      Text("1")
        .fontColor(Color.Red)
        .fontSize(18)
        .fontWeight(FontWeight.Bold)
      Text("2")
        .fontColor(Color.Red)
        .fontSize(18)
        .fontWeight(FontWeight.Bold)
      Text("3")
        .fontColor(Color.Red)
        .fontSize(18)
        .fontWeight(FontWeight.Bold)
      Text("4").fontColor(Color.Red)
        .fontSize(18)
        .fontWeight(FontWeight.Bold)
    }
  }
}


我们使用@Extend装饰器改造一下:

@Extend(Text)
function textStyle() {
  .fontColor(Color.Red)
  .fontSize(18)
  .fontWeight(FontWeight.Bold)
}
@Entry
@Component
struct Index {
  build() {
    Column() {
      Text("1").textStyle()
      Text("2").textStyle()
      Text("3").textStyle()
      Text("4").textStyle()
    }
  }
}

@Extend装饰器,还可以复用已有的样式。

@Extend(Text)
function textStyle() {
  .fontColor(Color.Red)
  .fontSize(18)
  .fontWeight(FontWeight.Bold)
}
@Extend(Text)
function textChildStyle() {
  .textStyle()//复用之前定义的
  .fontStyle(FontStyle.Italic)
}

我们写项目,肯定有很多个页面,也肯定会有多个页面共用组件的场景,这种情况下,显然无论是@Styles装饰器,还是@Extend装饰器,都是无法满足的,如何做到整个项目之间的复用呢?这个问题,官方也给我们提供了AttributeModifier对象来解决。

AttributeModifier

@Styles和@Extend,虽然可以解决组件样式重复的问题,单也仅仅是页面或者组件之内,无法满足多个页面或多个组件共用的场景,而且两者内部也无法进行业务逻辑编写,无法动态的设置某一个属性,基于这个问题,AttributeModifier便应运而生。与@Styles和@Extend相比,AttributeModifier提供了更强的能力和灵活性,且在持续完善全量的属性和事件设置能力,因此推荐优先使用AttributeModifier。

目前方法有多个,可以满足不同的业务场景:

applyNormalAttribute(instance: T) : void//组件普通状态时的样式。
applyPressedAttribute(instance: T) : void//组件按压状态的样式。
applyFocusedAttribute(instance: T) : void//组件获焦状态的样式。
applyDisabledAttribute(instance: T) : void//组件禁用状态的样式。
applySelectedAttribute(instance: T) : void//组件选中状态的样式

自定义一个类实现AttributeModifier接口,你要实现那个组件的属性复用,泛型就设置对应的组件属性即可,目前,基本上大部分组件属性都有。

class MyTextModifier implements AttributeModifier<TextAttribute> {
  textHeight?: Length
  //组件普通状态时的样式。
  applyNormalAttribute(instance: TextAttribute): void {
    instance.fontColor(Color.Red)
    .fontSize(18)
    .fontWeight(FontWeight.Bold)
    if (this.textHeight != undefined) {
      //不为空,设置height属性
      instance.height(this.textHeight)
    }
  }
}


定义好了之后,你就可以在各个页面或自定义组件内进行使用,真正做到了,样式的复用,和属性的动态设置。


//定义变量
@State modifier: MyTextModifier = new MyTextModifier()
//组件使用
Text("文本描述")
  .attributeModifier(this.modifier)


相关总结


如果要实现多页面之间的组件属性样式复用,建议使用AttributeModifier,如果是单页面,通用属性可以使用@Styles,组件自有属性可以使用@Extend。

相关文章
|
17天前
|
存储 人工智能 JavaScript
Harmony OS开发-ArkTS语言速成二
本文介绍了ArkTS基础语法,包括三种基本数据类型(string、number、boolean)和变量的使用。重点讲解了let、const和var的区别,涵盖作用域、变量提升、重新赋值及初始化等方面。期待与你共同进步!
80 47
Harmony OS开发-ArkTS语言速成二
|
18天前
|
前端开发 API 数据库
鸿蒙开发:异步并发操作
在结合async/await进行使用的时候,有一点需要注意,await关键字必须结合async,这两个是搭配使用的,缺一不可,同步风格在使用的时候,如何获取到错误呢,毕竟没有catch方法,其实,我们可以自己创建try/catch来捕获异常。
鸿蒙开发:异步并发操作
|
18天前
|
API
鸿蒙开发:实现popup弹窗
目前提供了两种方式实现popup弹窗,主推系统实现的方式,几乎能满足我们常见的所有场景,当然了,文章毕竟有限,尽量还是以官网为主。
鸿蒙开发:实现popup弹窗
|
9天前
|
存储 JSON 区块链
【HarmonyOS NEXT开发——ArkTS语言】购物商城的实现【合集】
HarmonyOS应用开发使用@Component装饰器将Home结构体标记为一个组件,意味着它可以在界面构建中被当作一个独立的UI单元来使用,并且按照其内部定义的build方法来渲染具体的界面内容。txt:string定义了一个名为Data的接口,用于规范表示产品数据的结构。src:类型为,推测是用于引用资源(可能是图片资源等)的一种特定类型,用于指定产品对应的图片资源。txt:字符串类型,用于存放产品的文字描述,比如产品名称等相关信息。price:数值类型,用于表示产品的价格信息。
34 5
|
9天前
|
开发工具 开发者 容器
【HarmonyOS NEXT开发——ArkTS语言】欢迎界面(启动加载页)的实现【合集】
从ArkTS代码架构层面而言,@Entry指明入口、@Component助力复用、@Preview便于预览,只是初窥门径,为开发流程带来些许便利。尤其动画回调与Blank组件,细节粗糙,后续定当潜心钻研,力求精进。”,字体颜色为白色,字体大小等设置与之前类似,不过动画配置有所不同,时长为。,不过这里没有看到额外的动画效果添加到这个特定的图片元素上(与前面带动画的元素对比而言)。这是一个显示文本的视图,文本内容为“奇怪的知识”,设置了字体颜色为灰色(的结构体,它代表了整个界面组件的逻辑和视图结构。
29 1
|
18天前
|
开发框架 物联网 API
HarmonyOS开发:串行通信开发详解
在电子设备和智能系统的设计中,数据通信是连接各个组件和设备的核心,串行通信作为一种基础且广泛应用的数据传输方式,因其简单、高效和成本效益高而被广泛采用。HarmonyOS作为一个全场景智能终端操作系统,不仅支持多种设备和场景,还提供了强大的开发框架和API,使得开发者能够轻松实现串行通信功能。随着技术的不断进步,串行通信技术也在不断发展。在HarmonyOS中,串行通信的开发不仅涉及到基本的数据发送和接收,还包括设备配置、错误处理和性能优化等多个方面。那么本文就来深入探讨在HarmonyOS中如何开发串行通信应用,包括串行通信的基础知识、HarmonyOS提供的API、开发步骤和实际代码示例
36 2
|
18天前
鸿蒙语言开发 几十套鸿蒙ArkTs app毕业设计及课程作业
鸿蒙语言开发 几十套鸿蒙ArkTs app毕业设计及课程作业
26 1
|
19天前
|
API 索引
鸿蒙开发:实现一个超简单的网格拖拽
实现拖拽,最重要的三个方法就是,打开编辑状态editMode,实现onItemDragStart和onItemDrop,设置拖拽移动动画和交换数据,如果想到开启补位动画,还需要实现supportAnimation方法。
75 13
鸿蒙开发:实现一个超简单的网格拖拽
|
18天前
|
索引 API
鸿蒙开发:自定义一个股票代码选择键盘
金融类的软件,特别是股票基金类的应用,在查找股票的时候,都会有一个区别于正常键盘的键盘,也就是股票代码键盘,和普通键盘的区别就是,除了常见的数字之外,也有一些常见的股票代码前缀按钮,方便在查找股票的时候,更加方便的进行检索。
鸿蒙开发:自定义一个股票代码选择键盘
|
18天前
|
API
鸿蒙开发:自定义一个英文键盘
实现方式呢,有很多种,目前采用了比较简单的一种,如果大家采用网格Grid组件实现方式,也是可以的,但是需要考虑每行的边距以及数据,还有最后两行的格子占位问题。
鸿蒙开发:自定义一个英文键盘

热门文章

最新文章