news 2026/1/9 11:24:33

ArkTS-EventHub使用

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
ArkTS-EventHub使用

轻量级的本地事件发布/订阅(Pub/Sub)机制,用于同一个 Ability 内不同页面或组件之间的通信,实现解耦的组件间通信

eventHubAbility 内部私有的,不能跨 Ability 通信(如从一个 EntryAbility 发消息到另一个 ServiceAbility)。

使用:

1:在 Ability 中获取 eventHub(你的代码)
// EntryAbility.ts export default class EntryAbility extends UIAbility { onCreate() { // 获取 eventHub(通常保存为成员变量) this.eventHub = this.context.eventHub; } }

this.context.eventHub只能在UIAbility的生命周期方法中访问(如onCreate,onWindowStageCreate)。

2:在页面中使用(需通过 AppStorage 或其他方式传递)

由于 ArkTS 页面组件(@Component)无法直接访问Abilitycontext,通常需要将eventHub存入全局状态:

在 Ability 中存入 AppStorage:

// EntryAbility.ts import { AppStorage } from '@kit.ArkUI'; export default class EntryAbility extends UIAbility { onWindowStageCreate(windowStage: window.WindowStage) { // 将 eventHub 存入全局(注意:仅存引用,不序列化) AppStorage.setOrCreate('eventHub', this.context.eventHub); windowStage.loadContent('pages/Index'); } }

在页面中使用:

// Index.ets import { AppStorage } from '@kit.ArkUI'; @Entry @Component struct Index { build() { Column() { Button('发送事件') .onClick(() => { const hub = AppStorage.get<EventHub>('eventHub'); // 发布事件 hub.emit('userLogin', { userId: '123', name: 'Alice' }); }) } } }

在另一个页面监听:

// Profile.ets @Entry @Component struct Profile { aboutToAppear() { const hub = AppStorage.get<EventHub>('eventHub'); // 订阅事件 hub.on('userLogin', (data) => { console.log('收到登录事件:', data); // 更新 UI }); } aboutToDisappear() { // 务必取消订阅,避免内存泄漏! const hub = AppStorage.get<EventHub>('eventHub'); hub.off('userLogin'); } }

方法

说明

emit(event: string, ...args: any[])

发布事件(可传参数)

on(event: string, callback: Function)

订阅事件

off(event: string, callback?: Function)

取消订阅(建议在aboutToDisappear中调用)

once(event: string, callback: Function)

订阅一次(触发后自动取消)

3:注意事项

1.不能跨 Ability 使用

  • eventHub仅限同一个 UIAbility 内部通信。

  • 跨 Ability 请使用Want / AbilityStage / 全局状态管理(如 AppStorage + 状态变量)

2.必须手动取消订阅

  • 否则会导致内存泄漏(回调函数持有页面引用,阻止 GC)。

  • 推荐在aboutToDisappear()中调用off()

3.不适合复杂状态管理

  • 对于全局状态(如用户信息、主题),建议使用:

    • @StorageLink+AppStorage

    • 自定义状态管理库(如类似 Redux 的方案)

4:替代方案对比
方案适用场景优点缺点
eventHub同 Ability 内简单通知轻量、官方支持不能跨 Ability,需手动管理订阅
AppStorage+@StorageLink全局状态共享响应式更新,自动同步仅支持简单数据类型
自定义 Callback父子组件通信简单直接需 props 逐层传递
UIContext封装统一事件管理可扩展非官方,增加复杂度
版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2025/12/12 16:50:38

3步解锁123云盘VIP特权:告别限速与广告困扰

你是否曾经因为123云盘的下载速度限制而焦急等待&#xff1f;是否被页面中无处不在的广告干扰了使用体验&#xff1f;现在&#xff0c;一个简单易用的浏览器脚本就能帮你彻底解决这些问题。通过本文介绍的123云盘解锁脚本&#xff0c;你无需支付任何费用就能享受到完整的会员级…

作者头像 李华
网站建设 2026/1/1 12:41:26

基于SpringBoot+vue的宠物领养系统

1. 演示地址 后台&#xff1a;http://chongwulingyangxitong.xiaobias.com/chongwulingyangxitong/admin/dist/index.html 前台&#xff1a;http://chongwulingyangxitong.xiaobias.com/chongwulingyangxitong/front/index.html 管理员&#xff1a;admin/admin 用户&#xff1a…

作者头像 李华
网站建设 2025/12/29 10:50:04

Monitorian:多显示器亮度调节的终极解决方案

Monitorian&#xff1a;多显示器亮度调节的终极解决方案 【免费下载链接】Monitorian A Windows desktop tool to adjust the brightness of multiple monitors with ease 项目地址: https://gitcode.com/gh_mirrors/mo/Monitorian 你是否曾经面对多个显示器时&#xff…

作者头像 李华
网站建设 2026/1/8 0:46:12

YOLOv7实战:突破半导体芯片表面缺陷检测难题的工业AI质检解决方案

YOLOv7实战&#xff1a;突破半导体芯片表面缺陷检测难题的工业AI质检解决方案 【免费下载链接】yolov7 YOLOv7 - 实现了一种新的实时目标检测算法&#xff0c;用于图像识别和处理。 项目地址: https://gitcode.com/GitHub_Trending/yo/yolov7 揭秘半导体制造业面临的核心…

作者头像 李华
网站建设 2025/12/12 16:49:29

abogen:一键将电子书转换为高质量有声书的智能工具

想象一下&#xff0c;你手头有一本精彩的电子书&#xff0c;却没有时间静心阅读。或者你希望为视障朋友提供文字内容的语音版本。现在&#xff0c;通过abogen这款开源工具&#xff0c;这些需求都能轻松实现。abogen是一款基于EPUB、PDF和文本文档生成有声书并同步字幕的开源工具…

作者头像 李华
网站建设 2026/1/2 23:47:41

3个步骤掌握FastHTML组件开发:从入门到精通的终极指南

3个步骤掌握FastHTML组件开发&#xff1a;从入门到精通的终极指南 【免费下载链接】fasthtml The fastest way to create an HTML app 项目地址: https://gitcode.com/gh_mirrors/fa/fasthtml 还在为重复编写相似HTML代码而烦恼吗&#xff1f;FastHTML组件库开发为您提供…

作者头像 李华