HarmonyOS中ArkUi框架中常用的装饰器

目录

1.装饰器

1)@Component

1--装饰内容

2)@Entry

1--装饰内容

2--使用说明

3)@Preview

1--装饰内容

2--使用说明

4)@CustomDialog

1--装饰内容

2--使用说明

5)@Observed

1--装饰内容

2--使用说明

6)@ObjectLink

1--装饰内容

2--使用说明

7)@Builder

1--装饰内容

2--使用说明

8)@Extend

1--装饰内容

2--使用说明

9)@Style

1--装饰内容

2--使用说明

10)@Prop

1--装饰内容

2--使用说明

11)@State

1--装饰内容

2--使用说明

12)@Link

1--装饰内容

2--使用说明

13)@Provide

1--装饰内容

2--使用说明

14)@Consume

1--装饰内容

2--使用说明

15)@Watch

1--装饰内容

2--使用说明

2:案例:自定义组件

3.案例:自定义组件的使用

4.组件预览

5.案例:样式复用


1.装饰器

1)@Component

1--装饰内容

struct

2--使用说明

@Component用于定义一个UI组件类。这个装饰器可以指定组件的一些属性,如模板文件、样式文件

2)@Entry

1--装饰内容

struct

2--使用说明

被装饰的组件会被作为页面的入口组件,页面加载时渲染显示

3)@Preview

1--装饰内容

struct

2--使用说明

自定义组件被@Preview 修饰后可以在DevEco的预览器里面看到自定义组件的样子

4)@CustomDialog

1--装饰内容

struct

2--使用说明

用于装饰自定义弹窗.通过这个装饰器,开发者可以定义一个具有特定UI和行为的对话框。

5)@Observed

1--装饰内容

class

2--使用说明

@Observed标记的属性会触发观察者模式,当该属性发生变化时,系统会自动更新相关的UI元素。

1--装饰内容

class

2--使用说明

被装饰的对象,父组件改变对象的属性或者子组件改变对象数据时,与该对象关联的组件都会被更新。

7)@Builder

1--装饰内容

方法

2--使用说明

允许将重复使用的 UI 代码抽象成方法,并可以在 build 方法中调用。被 @Builder 装饰的方法只能在 build 方法内部或其他 @Builder 方法中调用

8)@Extend

1--装饰内容

方法

2--使用说明

允许一个组件继承另一个组件的样式,从而可以复用已有的样式定义。

9)@Style

1--装饰内容

方法

2--使用说明

提供了一种方式来集中管理样式规则,减少样式的重复定义,提高代码的可维护性。类less和sass中的"混入"(Mixin)

10)@Prop

1--装饰内容

基本数据类型

2--使用说明

用于定义从父组件传递到子组件的属性。这些属性可以用来配置子组件的行为或外观。

11)@State

1--装饰内容

基本数据类型,类,数组

2--使用说明

用于声明组件的状态变量。状态变量的变化会触发 UI 的重新渲染。

1--装饰内容

基本数据类型,类,数组

2--使用说明

用于创建两个状态之间的链接。当一个状态发生变化时,另一个状态也会相应地更新。类似vue中的v-model指令,两个不同的组件绑定同一个变量,一个组件使这个变量改变,另外一个也会跟着改变。

13)@Provide

1--装饰内容

基本数据类型,类,数组

2--使用说明

装饰的数据作为数据的提供方,可以更新其子孙节点的数据,会刷新绑定该数据的组件。类似安卓中内容提供者,不同的应用的程序调用向外暴漏的数据。

14)@Consume

1--装饰内容

基本数据类型,类,数组

2--使用说明

装饰的数据感知到@provide装饰的变量更新后,会重新渲染该组件。这个类似安卓中的内容观察者,检测到数据变化后会做出相应的操作.

15)@Watch

1--装饰内容

状态变量(被@State,@Prop,@Link,@ObjectLink,@Provide,@Cunsume,@StorageProp,@StorageLink修饰的变量)

2--使用说明

监听状态的变化量

2:案例:自定义组件

@Component

struct 组件名字{

build(){

//这里写的是组件内容

}

}

复制代码
//自定义组件
@Component
struct myTextShow{
  build() {
    Text("你们好啊")  //字体组件
      
      .id('HelloWorld')
      
      .fontSize(50)
      .fontWeight(FontWeight.Bold)  //加粗


      .fontColor($r('app.color.start_window_background'))//文字颜色
      .width('50%')  //宽度
      .height('65%')

      .backgroundImage($rawfile('boy.png')) //背景图片

      .alignRules({
        center: { anchor: '__container__', align: VerticalAlign.Center },
        middle: { anchor: '__container__', align: HorizontalAlign.Center }
      })

  }
}

3.案例:自定义组件的使用

复制代码
import myTextShow from './MyDiv';  //导入组件
@Entry
@Component
struct Index {
  @State message: string = 'Hello World';


  build() {
    RelativeContainer() {
      //这是我们自定义的那个组件
      myTextShow()
    
    }

  }



}

4.组件预览

复制代码
//自定义组件
@Component
@Preview //组件预览
export default struct myTextShow{
  build() {
    Text("这是预览组件")  //字体组件

      .id('HelloWorld')

      .fontSize(50)
      .fontWeight(FontWeight.Bold)  //加粗


      .fontColor($r('app.color.start_window_background'))//文字颜色
      .width('50%')  //宽度
      .height('65%')

      .backgroundImage($rawfile('boy.png')) //背景图片

      .alignRules({
        center: { anchor: '__container__', align: VerticalAlign.Center },
        middle: { anchor: '__container__', align: HorizontalAlign.Center }
      })

  }
}

//export default 把该组件导出去,供别人使用

5.案例:样式复用

javascript 复制代码
@Entry
@Component
struct Index {
  @State message: string = 'Hello World';

  //导入组件


  build() {
    RelativeContainer() {

    Column(){
      Button("黄色按钮")
        .width(200)
        .height(100)
        .fontColor($r("app.color.my_red"))
        .myStyle()



      Button("默认按钮")
        .myStyle2()
        .width(200)
        .height(100)


      Button("按钮4")
        .myStyle3()
        .width(200)
        .height(100)

      Button("按钮5")
        .myStyle4()
        .width(200)
        .height(100)
    }
    .padding(20)
      




    }

  }



}
@Styles
function myStyle() {
  .backgroundColor($r("app.color.my_yellow"))
}

@Styles
function myStyle2() {
  .backgroundColor($r("app.color.my_red"))
}
@Styles
function myStyle3() {
  .backgroundColor($r("app.color.my_green"))
}
@Styles
function myStyle4() {
  .backgroundColor($r("app.color.start_window_background"))
}
相关推荐
Tony Bai3 分钟前
Cloudflare 2025 年度报告发布——Go 语言再次“屠榜”API 领域,AI 流量激增!
开发语言·人工智能·后端·golang
ID_180079054733 分钟前
有没有其他语言实现淘宝商品详情API接口采集的方案?
开发语言
清水白石0086 分钟前
《Python 责任链模式实战指南:从设计思想到工程落地》
开发语言·python·责任链模式
远山无期7 分钟前
解决Tailwind任意值滥用:规范化CSS开发体验
前端·css·eslint
love is sour14 分钟前
深入浅出 jmap:Java 内存分析的“显微镜“
java·开发语言·测试工具·性能优化
用户542778485154015 分钟前
Vue 3 中开发高阶组件(HOC)与 Renderless 组件
前端
json{shen:"jing"}18 分钟前
2-C语言的运算符和表达式
c语言·开发语言
AI视觉网奇24 分钟前
ue 虚幻引擎学习笔记
开发语言·虚幻引擎
HIT_Weston29 分钟前
67、【Ubuntu】【Hugo】搭建私人博客(一)
前端·ubuntu·hugo
ghie909038 分钟前
使用MATLAB的k-Wave工具箱进行超声CT成像
开发语言·matlab