文档开发者中心
我的
|

HarmonyOS 6

应用媒体

HarmonyOS 5

鸿蒙应用中怎样管理组件状态?

1.鸿蒙应用中如何管理组件状态?
2.@State、@Link、@Provide有什么区别?
3.如何实现父子组件、跨层级组件的数据传递?
点赞
3
收藏
2
回复
2
分享
举报
浏览197 发布于2025-12-05 15:03贵州
全部评论
最多点赞
最新发布
最早发布
👍
2楼回复于2025-12-12 06:38 来自贵州

解决方案

收起
自动换行
深色代码主题
复制
/**
 * @State:组件内部状态
 */
@Component
struct StateDemo {
  @State count: number = 0;
  @State name: string = '张三';
  @State visible: boolean = false;
  
  build() {
    Column({ space: 12 }) {
      Text(`计数: ${this.count}`)
        .fontSize(18)
      
      Button('增加')
        .onClick(() => {
          this.count++; // 修改状态会触发UI更新
        })
      
      TextInput({ text: this.name })
        .onChange((value: string) => {
          this.name = value; // 双向绑定
        })
    }
    .padding(20)
  }
}
​
/**
 * @Link:父子双向绑定
 */
@Component
struct ChildComponent {
  @Link count: number; // 使用@Link接收
  
  build() {
    Column({ space: 8 }) {
      Text(`子组件显示: ${this.count}`)
      Button('子组件增加')
        .onClick(() => {
          this.count++; // 修改会同步到父组件
        })
    }
  }
}
​
@Component
struct ParentComponent {
  @State count: number = 0;
  
  build() {
    Column({ space: 12 }) {
      Text(`父组件显示: ${this.count}`)
      
      Button('父组件增加')
        .onClick(() => {
          this.count++;
        })
      
      // 使用$传递引用
      ChildComponent({ count: $count })
    }
    .padding(20)
  }
}
​
/**
 * @Provide/@Consume:跨层级传递
 */
@Entry
@Component
struct GrandParent {
  @Provide('theme') theme: string = 'light';
  @Provide('fontSize') fontSize: number = 16;
  
  build() {
    Column({ space: 16 }) {
      Text('祖父组件')
        .fontSize(20)
      
      Button('切换主题')
        .onClick(() => {
          this.theme = this.theme === 'light' ? 'dark' : 'light';
        })
      
      Parent()
    }
    .padding(20)
  }
}
​
@Component
struct Parent {
  build() {
    Column({ space: 12 }) {
      Text('父组件(不需要接收theme)')
      Child()
    }
  }
}
​
@Component
struct Child {
  @Consume('theme') theme: string; // 直接从祖父组件获取
  @Consume('fontSize') fontSize: number;
  
  build() {
    Column({ space: 8 }) {
      Text('子组件')
        .fontSize(this.fontSize)
      Text(`当前主题: ${this.theme}`)
        .fontColor(this.theme === 'light' ? '#333' : '#fff')
    }
  }
}
​
/**
 * @Watch:监听状态变化
 */
@Component
struct WatchDemo {
  @State @Watch('onCountChange') count: number = 0;
  @State @Watch('onNameChange') name: string = '';
  
  onCountChange() {
    console.log('count变化了:', this.count);
    if (this.count > 10) {
      promptAction.showToast({ message: '计数超过10了!' });
    }
  }
  
  onNameChange() {
    console.log('name变化了:', this.name);
  }
  
  build() {
    Column({ space: 12 }) {
      Text(`计数: ${this.count}`)
      Button('增加').onClick(() => this.count++)
      
      TextInput({ placeholder: '输入姓名' })
        .onChange((value: string) => {
          this.name = value;
        })
    }
    .padding(20)
  }
}
​
/**
 * @Prop:单向传递
 */
@Component
struct PropChild {
  @Prop count: number; // 只读,不能修改
  
  build() {
    Column() {
      Text(`接收到的值: ${this.count}`)
      // this.count++ // 错误!不能修改@Prop
    }
  }
}
​
@Component
struct PropParent {
  @State count: number = 0;
  
  build() {
    Column({ space: 12 }) {
      Button('父组件增加').onClick(() => this.count++)
      PropChild({ count: this.count }) // 直接传值
    }
  }
}
​
/**
 * @ObjectLink:对象双向绑定
 */
@Observed
class Person {
  name: string;
  age: number;
  
  constructor(name: string, age: number) {
    this.name = name;
    this.age = age;
  }
}
​
@Component
struct ObjectLinkChild {
  @ObjectLink person: Person;
  
  build() {
    Column({ space: 8 }) {
      Text(`姓名: ${this.person.name}`)
      Text(`年龄: ${this.person.age}`)
      Button('增加年龄')
        .onClick(() => {
          this.person.age++; // 修改会同步到父组件
        })
    }
  }
}
​
@Component
struct ObjectLinkParent {
  @State person: Person = new Person('张三', 25);
  
  build() {
    Column({ space: 12 }) {
      Text(`父组件: ${this.person.name}, ${this.person.age}岁`)
      ObjectLinkChild({ person: this.person })
    }
    .padding(20)
  }
}

关键要点

  1. @State: 组件内部状态,变化触发UI更新,用于基本类型和对象

  2. @Link: 父子组件双向绑定,使用$count传递引用,子组件修改会同步到父组件

  3. @Provide/@Consume: 跨层级传递,无需逐层传递,通过key匹配

  4. @Watch: 监听状态变化,执行副作用(如日志、提示等)

  5. @Prop: 单向传递,子组件只读,不能修改

  6. @ObjectLink: 对象双向绑定,需要配合@Observed使用

避坑指南

  1. 忘记$符号: @Link必须用$count传递,否则报错

  2. Provide名称: @Provide和@Consume的key必须完全一致

  3. 性能: 避免过多@State,每个@State变化都会触发重绘

  4. 对象修改: @State对象属性修改不会触发更新,需要整体赋值或用@ObjectLink

  5. Watch循环: @Watch回调中修改被监听的状态会导致无限循环

总结

掌握@State/@Link/@Provide是鸿蒙开发的基础,合理使用可以简化状态管理,提高代码可维护性。@State用于组件内部,@Link用于父子,@Provide用于跨层级。

展开全部
1楼回复于2025-12-05 15:04 来自贵州
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

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