鸿蒙next开发：定义扩展组件样式规范-@Extend

最新推荐文章于 2024-09-27 17:46:44 发布

代码中的爱马仕

最新推荐文章于 2024-09-27 17:46:44 发布

阅读量1.1k

点赞数 22

分类专栏： OpenHarmony HarmonyOS 鸿蒙文章标签：前端开发语言 harmonyos 华为 windows 鸿蒙鸿蒙系统

本文链接：https://blog.csdn.net/DMZDAMS/article/details/140671711

版权

可以使用@Styles用于样式的扩展，在@Styles的基础上，我们提供了@Extend，用于扩展原生组件样式。

说明

从API version 9开始，该装饰器支持在ArkTS卡片中使用。

从API version 11开始，该装饰器支持在元服务中使用。

装饰器使用说明

语法

@Extend(UIComponentName) function functionName { ... }

使用规则

和@Styles不同，@Extend仅支持在全局定义，不支持在组件内部定义。

说明

只能在当前文件内使用，不支持export

和@Styles不同，@Extend支持封装指定组件的私有属性、私有事件和自身定义的全局方法。

// @Extend(Text)可以支持Text的私有属性fontColor
@Extend(Text) function fancy () {
  .fontColor(Color.Red)
}
// superFancyText可以调用预定义的fancy
@Extend(Text) function superFancyText(size:number) {
    .fontSize(size)
    .fancy()
}

和@Styles不同，@Extend装饰的方法支持参数，开发者可以在调用时传递参数，调用遵循TS方法传值调用。

// xxx.ets
@Extend(Text) function fancy (fontSize: number) {
  .fontColor(Color.Red)
  .fontSize(fontSize)
}

@Entry
@Component
struct FancyUse {
  build() {
    Row({ space: 10 }) {
      Text('Fancy')
        .fancy(16)
      Text('Fancy')
        .fancy(24)
    }
  }
}