往期鸿蒙全套实战文章必看:
概述
ArkUI触控事件,根据输入源不同,主要划分为touch类与mouse类。
touch类的输入源包含:finger、pen
mouse类的输入源包含:mouse、touchpad、joystick
由这两类输入源可以触发如下事件:
touch | mouse |
---|---|
触摸事件 | 触摸事件 |
点击事件 | 鼠标事件 |
拖拽事件 | 点击事件 |
手势事件 | 拖拽事件 |
手势事件 |
无论是touch类事件还是mouse类事件,在ArkUI框架上均由触摸测试发起,触摸测试直接决定了ArkUI事件响应链的生成及事件的分发。
触摸测试
如下是对触摸测试结果影响较大的几个因素:
-
TouchTest:触摸测试入口方法,此方法无外部接口
-
hitTestBehavior:触摸测试控制
-
interceptTouch:事件自定义拦截
-
responseRegion:触摸热区设置
-
enabled:禁用控制
-
安全组件
-
其他属性设置:透明度/组件下线
TouchTest
-
TouchTest的触发时机由每次点按的按下动作发起,默认由组件树的根节点TouchTest方法作为入口。
-
hitTestBehavior可以由InterceptTouch事件变更。
-
触摸热区/禁用控制/透明度等不满足组件事件交互诉求,会导致立即返回父节点。
触摸测试控制
-
命中:触摸测试成功收集到当前组件/子组件的事件。
-
子组件对父组件触摸测试的影响,取决于最后一个没有被阻塞触摸测试的子组件。
-
HitTestMode.Default:默认不配hitTestBehavior属性的效果,自身如果命中会阻塞兄弟,但是不阻塞孩子。
-
HitTestMode.None:自身不接收事件,但不会阻塞兄弟/孩子继续做触摸测试。
-
HitTestMode.Block:阻塞孩子的触摸测试,如果自身触摸测试命中,会阻塞兄弟及父亲的触摸测试。
-
HitTestMode.Transparent:自身进行触摸测试,同时不阻塞兄弟及父亲。
自定义事件拦截
自定义事件拦截在按下触发时,可以根据业务状态动态改变组件的hitTestBehavior属性。
禁用控制
设置禁用控制的组件,包括其子组件不会发起触摸测试过程,会直接返回父节点继续触摸测试。
触摸热区设置
触摸热区设置会影响触屏/鼠标类的触摸测试,如果设置为0,或不可触控区域,则事件直接返回父节点继续触摸测试。
安全组件
ArkUI包含的安全组件有:使用位置组件、使用粘贴组件、使用保存组件等。
安全组件当前对触摸测试影响:如果有组件的z序比安全组件的z序靠前,且遮盖安全组件,则安全组件事件直接返回到父节点继续触摸测试。
事件响应链的收集
ArkUI事件响应链收集,根据右子树(按组件布局的先后层级)优先的后序遍历流程,流程为:
foreach(item=>(node.rbegin(),node.rend(){
item.TouchTest()
}
node.collectEvent()
响应链收集举例,按下图的组件树,hitTestBehavior属性均为默认,用户点按的动作如果发生在组件5上,则最终收集到的响应链,以及先后关系是5,3,1。
因为组件3的hitTestBehavior属性为Default,收集到事件后会阻塞兄弟节点,所以没有收集组件1的左子树。