当前位置：首页 > news >正文

HarmonyOS 鸿蒙应用开发基础：EventHub，优雅解决跨组件通信难题

news 来源：原创 2025/5/23 5:04:43

EventHub是鸿蒙开发中用于线程内通信的事件中心模块，基于发布订阅模式实现组件间的高效通信。它完美解决了传统回调方式在多层嵌套场景下的痛点，使得组件间的通信更加灵活和易于管理。

核心特性

事件中心机制：通过事件名进行通信，实现解耦，提高组件间的独立性。
线程内通信：仅支持同一线程内的事件传递，不适用于跨进程或虚拟机间的通信。
单例模式：每个AbilityContext实例拥有独立的EventHub，确保事件操作仅作用于当前上下文。

基础用法

以下是一个简单的EventHub使用案例，展示了如何在组件之间进行数据传递：

@Entry
@Component
struct DemoPage {aboutToAppear(): void {// 订阅事件getContext().eventHub.on("test", (data: string) => {console.log("接收数据：" + data)})}build() {Column() {Button("触发事件").onClick(() => {// 发布事件getContext().eventHub.emit("test", "示例数据")})}}
}

在这个例子中，点击按钮后触发test事件，并发送一个字符串参数。DemoPage在aboutToAppear生命周期中订阅了test事件，当事件被触发时，接收并打印发送的消息。

API详解

EventHub提供了三个主要方法：

on(event: string, callback: Function): void;
- 参数：
  - event: 事件名称。
  - callback: 回调函数。
- 说明：订阅指定事件。
off(event: string, callback?: Function): void;
- 参数：
  - event: 事件名称。
  - callback (可选): 回调函数。
- 说明：取消订阅事件。如果提供了回调函数，则取消该回调对指定事件的订阅；否则取消所有回调对该事件的订阅。
emit(event: string, …args: Object[]): void;
- 参数：
  - event: 事件名称。
  - ...args: 可变参数。
- 说明：触发指定事件，并可传递参数给订阅该事件的回调函数。

实战案例：组件间通信

以下是一个更复杂的实战案例，展示了父组件和子组件之间的通信：

@Entry
@Component
struct ParentComponent {@State message: string = ""aboutToAppear(): void {// 订阅事件getContext().eventHub.on("childEvent", (data: string) => {this.message = data})}aboutToDisappear(): void {// 取消订阅事件getContext().eventHub.off("childEvent")}build() {Column() {Text(this.message)ChildComponent()}}
}@Component
struct ChildComponent {@State count: number = 0build() {Button("通知父组件").onClick(() => {this.count++// 触发事件并发送参数getContext().eventHub.emit("childEvent", `点击次数: ${this.count}`)})}
}