文档开发者中心
我的
|

DevEco Studio

初学者小白,不是很懂这几个语法,求大佬讲解!!

已解决

@State,@Builder,@Extend 。这三个是什么区别?

private,这个又是什么,感觉每次看到课堂说的时候可以明白,到自己写的时候,用法就很迷惑。。。

点赞
收藏
回复
16
分享
举报
浏览215 发布于2025-08-11 07:03福建
全部评论
最多点赞
最新发布
最早发布
|
采纳答复
装饰器 核心作用 场景举例 本质
@State 管理响应式状态,驱动 UI 刷新 计数器、开关按钮的状态变化 状态 → UI 联动
@Builder 封装复用 UI 片段 重复出现的布局(如列表项、图标组) UI 模板
@Extend 扩展组件样式 / 行为 统一按钮、文本的样式 组件增强补丁

private:访问修饰符(控制类成员的访问范围)

private 是面向对象中的访问修饰符,用于限制类中成员(属性或方法)的访问权限:

  • 被 private 修饰的成员,只能在当前类内部访问,类的外部(包括实例)、子类都不能直接访问。
  • 作用:封装类的内部实现,避免外部随意修改,保证代码的安全性和可维护性。
  • 当需要 “状态变化驱动 UI 更新” 时,用 @State;
  • 当需要 “复用一段 UI 结构” 时,用 @Builder;
  • 当需要 “统一扩展组件样式” 时,用 @Extend;
  • 当需要 “隐藏类的内部细节,不让外部乱改” 时,用 private。

 

2
4楼回复于2025-08-11 14:16 来自广东
  • SMING
    感谢大佬解答!!
    2025-08-12 01:51 来自福建
  • SMING
    大佬可以帮忙看看 我下面发的那个评论吗 ?感谢~
    2025-08-12 01:59 来自福建

背景知识:

@State :被装饰的变量与ui进行绑定,值变化ui同步更新。

@Builder:提供轻量的UI元素复用机制,也就是说可以将相同的ui写在一个方法里面,该方法可以传递参数来对不同ui展示进去区别。

@Extend :是将相同的样式放入一个方法中。类比于h5的style或者andorid里面的style样式。

访问权限:private、public、protected

以上三个是控制访问权限,可以放在方法和变量上面,其区别在于:

private 修饰的只能哎类中访问,任何类外不访问不到

public 修饰的是公开的,任何类都可以访问

protected 修饰的是继承的子类是公开的,其他非继承的类无法访问

问题解决:

收起
自动换行
深色代码主题
复制
//Extend修饰的需要放入类外,不能放入在类内部
@Extend(Text)
function textStyle() {
    .fontSize(18)
    .fontColor(Color.Blue)
    .fontWeight(FontWeight.Regular)
}

@Entry
@Component
struct ContinuePage {
    @State message: string = '测试数据';

    //没有被 State修饰的点击无法修改
    message2: string = '测试数据';

    build() {
        Column() {
            Text(this.message)
                .fontSize(18)
                .fontColor($r("app.color.primary_color"))
                .fontWeight(FontWeight.Bold)
                .textAlign(TextAlign.Center)
                .onClick(() => {
                    this.message = "点击修改了";
                })

            //可以根据参数来显示不同的ui
            this.Text2(1)
        }
        .height('100%')
        .width('100%')
    }

    //提取相同的ui
    @Builder
    Text2(index:number) {
        if(index==1){
            Text("index==1 "+this.message2)
                .textStyle()
                .onClick(()=>{
                    this.message2 = "没有变化";
                })
        }else{
            Text("index!=1 "+this.message2)
                .textStyle()
                .onClick(()=>{
                    this.message2 = "没有变化";
                })
        }

    }
}

动图示例:
cke_67216.gif

展开全部
8楼回复于2025-08-12 02:50 来自广东

@State(状态管理)

通过装饰器拦截变量的getter/setter,建立状态与UI的绑定关系。当变量值变化时,自动触发关联UI更新

@State count: number = 0//必须本地初始化且只能组件内部访问

@Builder(UI构造器)

相当于UI构造函数,用于生成具体的UI节点。通过参数传递可实现动态渲染

@Builder

myButton(text: string) {

  Button(text).width(100)

}

必须按引用传递单个对象字面量,内部禁止修改入参

 @Extend(样式扩展)

基于原型链继承扩展组件样式属性,本质上是对组件样式的二次封装

@Extend(Text)

function textStyle(size: number) {

  .fontColor(Color.Red)

  .fontSize(size)

}

不支持组件内部定义,无状态管理能力 

private关键字

限制变量/方法仅在当前组件内部可访问,实现封装性

private internalData: string = "secret"

纯内部逻辑变量/方法且无需响应式更新时可用

收起
自动换行
深色代码主题
复制
// 私有缓存数据,不涉及UI更新

private cacheList: string[] = []

禁止需要与父组件交互或装饰器时联用(@Prop、@Provide)

展开全部
7楼回复于2025-08-12 02:16 来自河北

@State:状态变量,可以联动UI刷新数据

cke_6762.png

如果如下声明,Text的内容不会改变:

cke_10316.png

@Builder:一般用来标识自定义构建函数,该函数可以理解为UI的一个片段

cke_10784.png

@Extend:有扩展的意思,扩展系统组件

cke_11225.png

相当于css里面提取公共样式,达到复用的目的。

private:有私有的意思,声明的变量或者方法只能在一定的范围内访问,比如在class A中定义的变量就只能在A类中使用,其他的地方无法调用

以上的讲解希望对你有帮助,记得“采纳意见”

1
3楼回复于2025-08-11 13:28 来自北京
  • SMING
    感谢大佬解答!!
    2025-08-12 01:50 来自福建

@State:状态管理装饰器

用于标记组件内部的状态变量。当状态变量变化时,触发UI自动刷新。

收起
自动换行
深色代码主题
复制
@Component
struct MyComponent {
  @State count: number = 0; // 状态变量
  build() {
    Column() {
      Text(`Count: ${this.count}`)
      Button('+1').onClick(() => { this.count++ })
    }
  }
}

@Builder:UI结构复用装饰器

用于封装可复用的UI描述片段,支持参数传递和动态内容构建。

收起
自动换行
深色代码主题
复制
@Builder
function CustomButton(text: string) {
  Button(text)
    .width(100)
    .backgroundColor(Color.Blue)
}

@Component
struct Parent {
  build() {
    Column() {
      CustomButton("Submit") // 复用UI片段
    }
  }
}

@Extend:组件样式扩展装饰器

扩展系统组件(如Text、Button)的样式和事件,支持参数传递。

收起
自动换行
深色代码主题
复制
@Extend(Text)
function FancyText(size: number) {
  .fontSize(size)
  .fontColor(Color.Red)
}

@Component
struct MyComponent {
  build() {
    Text("Hello").FancyText(20) // 应用扩展样式
  }
}

private 表示成员变量只能在当前组件内部访问和修改,外部组件(包括父组件)无法直接访问

展开全部
1
2楼回复于2025-08-11 08:13 来自安徽
  • SMING
    感谢大佬解答!!
    2025-08-12 01:50 来自福建

     装饰器说明

  • @State

    给变量添加数据监听功能,当变量值发生变化时,会自动触发 UI 刷新。

    主要用于实现数据驱动的界面更新。

  • @Builder

    自定义组件装饰器。

    常用于页面中存在多个样式、结构、字段完全相同的模块时,将其抽取成可复用的组件。

    也可用于模块化页面功能,使结构更清晰、易维护。

  • @Extend

    公共样式装饰器。

    可将页面中相同的字体、颜色、宽度、高度等样式统一抽取成一个公共定义,方便复用与维护。

    访问修饰符

  • private

    表示私有属性,只能在类或结构体内部访问,外部无法直接访问或修改。

    用于保护内部数据,避免被外部随意更改。

2
1楼回复于2025-08-11 07:47 来自北京
  • hid39339293
    装饰器是 arkui 的 访问修饰符是 arts 建议你先学学 ts 再学 arkui
    2025-08-11 07:48 来自北京
  • SMING回复hid39339293
    感谢大佬解答!!
    2025-08-12 01:54 来自福建
第一课里面这个部分的讲解,这边说的@builder 是不是也是有个什么没写,上面是不是应该也有一个struct 包裹着才对?  待大佬解答!!cke_1714.png
6楼回复于2025-08-12 02:16 来自福建
想问问 @Builder 有时候为什么打不出来,它是需要再什么结构内吗?还是这个就是需要手动输入的?cke_197.png
2
5楼回复于2025-08-12 01:58 来自福建
  • SMING
    比如我们新建了一个页面 页面内的结构是包含@Entry 那这个时候 我们写@Builder 是写在什么位置?
    2025-08-12 02:07 来自福建
  • 谢道韫回复SMING
    简单说,上面那个Builder是 “对外暴露的页面入口构建器”,负责整体页面的构建;下面那个Builder是 “组件内部的按钮复用构建器”,负责局部 UI 元素的构建,两者在粒度、可见性和依赖关系上有本质区别。 你现在用的一般是下边那个@Builder 这里用的是 莫逍遥 大哥的解析 他那里写了
    2025-08-12 02:48 来自广东
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

了解社区公约,与您携手共创和谐专业的开发者社区。