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

简介: 如果要实现多页面之间的组件属性样式复用,建议使用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。

相关文章
|
2月前
|
开发者 容器
鸿蒙应用开发从入门到实战(十四):ArkUI组件Column&Row&线性布局
ArkUI提供了丰富的系统组件,用于制作鸿蒙原生应用APP的UI,本文主要讲解Column和Row组件的使用以及线性布局的方法。
244 12
|
2月前
|
API 数据处理
鸿蒙应用开发从入门到实战(十三):ArkUI组件Slider&Progress
ArkUI提供了丰富的系统组件,用于制作鸿蒙原生应用APP的UI,本文主要讲解滑块Slider和进度条Progress组件的使用。
136 1
|
21天前
|
移动开发 JavaScript 应用服务中间件
【06】优化完善落地页样式内容-精度优化-vue加vite开发实战-做一个非常漂亮的APP下载落地页-支持PC和H5自适应提供安卓苹果鸿蒙下载和网页端访问-优雅草卓伊凡
【06】优化完善落地页样式内容-精度优化-vue加vite开发实战-做一个非常漂亮的APP下载落地页-支持PC和H5自适应提供安卓苹果鸿蒙下载和网页端访问-优雅草卓伊凡
145 5
【06】优化完善落地页样式内容-精度优化-vue加vite开发实战-做一个非常漂亮的APP下载落地页-支持PC和H5自适应提供安卓苹果鸿蒙下载和网页端访问-优雅草卓伊凡
|
27天前
|
移动开发 前端开发 Android开发
【02】建立各项目录和页面标准化产品-vue+vite开发实战-做一个非常漂亮的APP下载落地页-支持PC和H5自适应提供安卓苹果鸿蒙下载和网页端访问-优雅草卓伊凡
【02】建立各项目录和页面标准化产品-vue+vite开发实战-做一个非常漂亮的APP下载落地页-支持PC和H5自适应提供安卓苹果鸿蒙下载和网页端访问-优雅草卓伊凡
212 12
【02】建立各项目录和页面标准化产品-vue+vite开发实战-做一个非常漂亮的APP下载落地页-支持PC和H5自适应提供安卓苹果鸿蒙下载和网页端访问-优雅草卓伊凡
|
29天前
|
移动开发 Rust JavaScript
【01】首页建立-vue+vite开发实战-做一个非常漂亮的APP下载落地页-支持PC和H5自适应提供安卓苹果鸿蒙下载和网页端访问-优雅草卓伊凡
【01】首页建立-vue+vite开发实战-做一个非常漂亮的APP下载落地页-支持PC和H5自适应提供安卓苹果鸿蒙下载和网页端访问-优雅草卓伊凡
450 3
【01】首页建立-vue+vite开发实战-做一个非常漂亮的APP下载落地页-支持PC和H5自适应提供安卓苹果鸿蒙下载和网页端访问-优雅草卓伊凡
|
26天前
|
移动开发 Android开发
【03】建立隐私关于等相关页面和内容-vue+vite开发实战-做一个非常漂亮的APP下载落地页-支持PC和H5自适应提供安卓苹果鸿蒙下载和网页端访问-优雅草卓伊凡
【03】建立隐私关于等相关页面和内容-vue+vite开发实战-做一个非常漂亮的APP下载落地页-支持PC和H5自适应提供安卓苹果鸿蒙下载和网页端访问-优雅草卓伊凡
92 0
|
2月前
|
API 数据处理
鸿蒙应用开发从入门到实战(十三):ArkUI组件Slider&Progress
ArkUI提供滑块Slider与进度条Progress组件,用于鸿蒙原生APP开发。Slider支持拖动调节音量、亮度等,可设步长、方向及提示气泡;Progress支持线性、环形等多种样式,可自定义颜色、宽度与刻度,实时显示任务进度。
196 2
|
2月前
|
传感器 监控 安全
HarmonyOS NEXT 5.0 的星闪(NearLink)开发应用案例
V哥分享HarmonyOS NEXT 5.0星闪开发实战,涵盖智能车钥匙无感解锁与工业传感器监控。低延迟、高可靠,代码完整,速来学习!
404 0
|
移动开发 Ubuntu 网络协议
嵌入式linux/鸿蒙开发板(IMX6ULL)开发 (二)Ubuntu操作入门与Linux常用命令(中)
嵌入式linux/鸿蒙开发板(IMX6ULL)开发 (二)Ubuntu操作入门与Linux常用命令
348 1
嵌入式linux/鸿蒙开发板(IMX6ULL)开发 (二)Ubuntu操作入门与Linux常用命令(中)
|
XML Web App开发 开发框架
鸿蒙开发入门 | 开发第一个鸿蒙应用+页面跳转
准备好鸿蒙开发环境后,接下来就需要创建鸿蒙项目,掌握项目的创建过程以及配置。项目创建好后,需要把项目运行在模拟器上,鸿蒙的模拟和安卓模拟器有些不同,鸿蒙提供远程模拟器和本地模拟器,通过登录华为账号登录在线模拟器,使用DevEco Studio可将项目部署到远程模拟器中。
1665 1
鸿蒙开发入门 | 开发第一个鸿蒙应用+页面跳转

热门文章

最新文章