HarmonyOS Next开发学习手册——事件分发

概述

ArkUI触控事件，根据输入源不同，主要划分为touch类与mouse类。

touch类的输入源包含：finger、pen

mouse类的输入源包含：mouse、touchpad、joystick

由这两类输入源可以触发如下事件：

touch	mouse
触摸事件	触摸事件
点击事件	鼠标事件
拖拽事件	点击事件
手势事件	拖拽事件
	手势事件

无论是touch类事件还是mouse类事件，在ArkUI框架上均由触摸测试发起，触摸测试直接决定了ArkUI事件响应链的生成及事件的分发。

触摸测试

如下是对触摸测试结果影响较大的几个因素：

• TouchTest：触摸测试入口方法，此方法无外部接口

• hitTestBehavior：触摸测试控制

• interceptTouch：事件自定义拦截

• responseRegion：触摸热区设置

• enable：禁用控制

• 安全组件

• 其他属性设置：透明度/组件下线

TouchTest

• TouchTest的触发时机由每次点按的按下动作发起，默认由组件树的根节点TouchTest方法作为入口。

• hitTestBehavior可以由InterceptTouch事件变更。

• 触摸热区/禁用控制/透明度等不满足组件事件交互诉求，会导致立即返回父节点。

触摸测试控制

具体用法参考 触摸测试控制

• 命中：触摸测试成功收集到当前组件/子组件的事件。

• 子组件对父组件触摸测试的影响，取决于最后一个没有被阻塞触摸测试的子组件。

• hitTestMode.default:默认不配hitTestBehavior属性的效果，自身如果命中会阻塞兄弟，但是不阻塞孩子。

• hitTestMode.none:自身不接收事件，但不会阻塞兄弟/孩子继续做触摸测试。

• hitTestMode.block：阻塞孩子的触摸测试，如果自身触摸测试命中，会阻塞兄弟及父亲的触摸测试。

• hitTestMode.transparent：自身进行触摸测试，同时不阻塞兄弟及父亲。

自定义事件拦截

自定义事件拦截 在按下触发时，可以根据业务状态动态改变组件的hitTestBehavior属性。

禁用控制

设置 禁用控制 的组件，包括其子组件不会发起触摸测试过程，会直接返回父节点继续触摸测试。

触摸热区设置

触摸热区设置 会影响触屏/鼠标类的触摸测试，如果设置为0，或不可触控区域，则事件直接返回父节点继续触摸测试。

安全组件

ArkUI包含的安全组件有： 使用位置组件 、 使用粘贴组件 、 使用保存组件 等。

安全组件当前对触摸测试影响：如果有组件z序比安全组件靠前，且遮盖安全组件，则安全组件事件直接返回到父节点继续触摸测试。

其他属性影响

设置组件透明度为0，或者其他导致组件下树的行为，会导致触摸测试中断。

事件响应链的收集

ArkUI事件响应链收集，根据右子树（按组件布局的先后层级）优先的后续遍历流程，流程为：

foreach(item=>(node.rbegin(),node.rend(){
    item.TouchTest()
}
node.collectEvent()

响应链收集举例，按下图的组件树，hitTestBehavior属性均为默认，用户点按的动作如果发生在组件5上，则最终收集到的响应链，以及先后关系是5，3，1。

因为组件3的hitTestBehavior属性为default，收集到事件后会阻塞兄弟节点，所以没有收集组件1的左子树。

鸿蒙全栈开发全新学习指南

有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以要有一份实用的鸿蒙（HarmonyOS NEXT）学习路线与学习文档用来跟着学习是非常有必要的。

针对一些列因素，整理了一套纯血版鸿蒙（HarmonyOS Next）全栈开发技术的学习路线，包含了鸿蒙开发必掌握的核心知识要点，内容有（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、WebGL、元服务、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、OpenHarmony驱动开发、系统定制移植等等）鸿蒙（HarmonyOS NEXT）技术知识点。

本路线共分为四个阶段：

第一阶段：鸿蒙初中级开发必备技能

第二阶段：鸿蒙南北双向高工技能基础：gitee.com/MNxiaona/733GH

第三阶段：应用开发中高级就业技术

第四阶段：全网首发-工业级南向设备开发就业技术：gitee.com/MNxiaona/733GH

《鸿蒙 (Harmony OS)开发学习手册》（共计892页）

如何快速入门？

1.基本概念
2.构建第一个ArkTS应用
3.……

开发基础知识:gitee.com/MNxiaona/733GH

1.应用基础知识
2.配置文件
3.应用数据管理
4.应用安全管理
5.应用隐私保护
6.三方应用调用管控机制
7.资源分类与访问
8.学习ArkTS语言
9.……

基于ArkTS 开发

1.Ability开发
2.UI开发
3.公共事件与通知
4.窗口管理
5.媒体
6.安全
7.网络与链接
8.电话服务
9.数据管理
10.后台任务(Background Task)管理
11.设备管理
12.设备使用信息统计
13.DFX
14.国际化开发
15.折叠屏系列
16.……

鸿蒙开发面试真题（含参考答案）:gitee.com/MNxiaona/733GH

鸿蒙入门教学视频：

美团APP实战开发教学：gitee.com/MNxiaona/733GH

写在最后

• 如果你觉得这篇内容对你还蛮有帮助，我想邀请你帮我三个小忙：
• 点赞，转发，有你们的 『点赞和评论』，才是我创造的动力。
• 关注小编，同时可以期待后续文章ing🚀，不定期分享原创知识。
• 想要获取更多完整鸿蒙最新学习资源，请移步前往小编：gitee.com/MNxiaona/733GH