最近开始系统性的整理自定义View相关的知识,譬如绘制过程源码解析、图形学绘制基础、自定义View的多种方式、动画实现等等,脑子真是感觉不够用了,期间又绕到了android点击事件响应这一块,发现之前竟然没有整理出来系统化的文档。。。
文章目录
先看一张图,思考:安卓上面的View是树形结构的,View可能会重叠在一起,当我们点击的地方有多个View都可以响应的时候,这个点击事件应该给谁呢?为了解决这一个问题,就有了事件分发机制。
如上图所示:View是一层一层嵌套的,当手指点击 View1 的时候,下面的ViewGroupA、 RootView 等也是能够响应的,为了确定到底应该是哪个View处理这次点击事件,就需要事件分发机制来帮忙
总结:
-
点击事件自上而下传递,当点击事件产生后由Activity来处理,传递给PhoneWindows,再传递给DecorView,最后传给定成ViewGroup
-
boolean dispatchTouchEvent(event)实现了整个迭代回调过程,其中调用onInterceptTouchEvent、onTouchEvent和child.dispatchTouchEvent
- Down方式通过dispatchTouchEvent分发,分发的目的是为了找到真正需要处理完整Touch请求的View。当某个View或者ViewGroup的onTouchEvent事件返回true时,便表示它是真正要处理这次请求的View,之后的Aciton_UP和Action_MOVE将由它处理
-
ViewGroup#dispatchTouchEvent 实现 整个分发链和消费链的串联过程
- 事件分发链只触及点击位置穿透的控件,由父到子,由上到下. 具体的实现在于 Gropu#dispatchTouchEvent中会倒序遍历 Childrens, 遍历过程中会校验 触摸点位置是否在子View范围内或者子view是否在播放动画
- 消费链中一旦被消费(返回true)就终止整个事件分发流程
- ViewGroup 和 ChildView 同时注册了事件监听器(onClick等),事件优先给 ChildView,会被 ChildView消费掉,ViewGroup 不会响应。因为 ChildView位于消费链的前端
- onInterceptTouchEvent有两个作用:1.拦截Down事件的分发。2.中止Up和Move事件向目标View传递,使得目标View所在的ViewGroup捕获Up和Move事件
-
View#dispatchTouchEvent 处理单击事件(onClick)、长按事件(onLongClick)、触摸事件(onTouch),和View自身 onTouchEvent 方法的调度流程
- 调度顺序应该是 onTouchListener > onTouchEvent > onLongClickListener > onClickListener
- 给 View 注册 OnTouchListener 不会影响 View 的可点击状态。即使给 View 注册 OnTouchListener ,只要不返回 true 就不会消费事件
- 只要View是CLICKABLE,LONG_CLICKABLE,CONTEXT_CLICKABLE就会消费该点击事件。无论点击回调和长按回调中如何处理,都会消费点击事件(返回true)
- 点击包括很多种情况:譬如给View注册了 onClickListener、onLongClickListener、OnContextClickListener 其中的任何一个监听器或者设置了 android:clickable=”true”
- 某些 View 默认就是可点击的,例如,Button,CheckBox 等
- 所有事件都应该被同一 View 消费
- 安卓对第一次的事件( ACTION_DOWN )进行了特殊判断,View 只有消费了 ACTION_DOWN 事件,才能接收到后续的事件(可点击控件会默认消费所有事件),并且会将后续所有事件传递过来,不会再传递给其他 View,除非上层 View 进行了拦截
一、事件分发、拦截与消费
Touch事件分发中只有两个主角:ViewGroup和View。Activity的Touch事件事实上是调用它内部的ViewGroup的Touch事件,可以直接当成ViewGroup处理
主要涉及到的函数只有三个:onInterceptTouchEvent、dispatchTouchEvent、onTouchEvent。这个三个方法均有一个 boolean(布尔) 类型的返回值,通过返回 true 和 false 来控制事件传递的流程
类型 | 相关方法 | 返回值 | Activity | ViewGroup | View |
---|---|---|---|---|---|
事件分发 | dispatchTouchEvent | boolean | √ | √ | √ |
事件拦截 | onInterceptTouchEvent | boolean | X | √ | X |
事件消费 | onTouchEvent | boolean | √ | √ | √ |
- 从上表可以看到 Activity 和 View 都是没有事件拦截的,这是因为:
- Activity 作为原始的事件分发者,如果 Activity 拦截了事件会导致整个屏幕都无法响应事件,这肯定不是我们想要的效果。
- View最为事件传递的最末端,要么消费掉事件,要么不处理进行回传,根本没必要进行事件拦截
整个事件转发流程是由两条线组成:
1.分发线,事件收集之后最先传递给 Activity, 然后依次向下传递,大致如下:
Activity -> PhoneWindow -> DecorView -> ViewGroup -> ... -> View
2.消费线,没有任何View消费掉事件,那么这个事件会按照反方向回传,最终传回给Activity,如果最后 Activity 也没有处理,本次事件才会被抛弃:
Activity <- PhoneWindow <- DecorView <- ViewGroup <- ... <- View
1.1 ViewGroup分析
整个分发流程最核心的代码就是dispatchTouchEvent,它负责调用onInterceptTouchEvent和onTouchEvent以实现整个分发流程
我们可以看下ViewGroup事件分发的伪代码:
public boolean dispatchTouchEvent(MotionEvent ev) {
boolean result = false; // 默认状态为没有消费过
if (!onInterceptTouchEvent(ev)) {//【步骤A.1】自己是否拦截该事件,如果需要,调用自己的 onTouchEvent。
result = child.dispatchTouchEvent(ev);//【步骤A.2】递归式,分发给child(一般来说是调用手指触摸位置的 ChildView)
}
if (!result) {//【步骤B.1】如果事件没有被消费或者被自身拦截,询问自身onTouchEvent
result = onTouchEvent(ev);
}
return result;//【步骤B.2】迭代式,返回结果以告知父布局自己是否消费了该事件
}
- 分发链
- 【步骤A.1】自己是否拦截该事件,如果需要,调用自己的 onTouchEvent
- 【步骤A.2】递归式,分发给child(一般来说是调用手指触摸位置的 ChildView)
- 消费链
- 【步骤B.1】如果事件没有被消费或者被自身拦截,询问自身onTouchEvent
- 【步骤B.2】迭代式,返回结果以告知父布局自己是否消费了该事件
现在我们针对图示中的例子做相关的测试,印证以下信息:
1.1.1 事件分发链只触及点击位置穿透的控件
- 事件分发链只触及点击位置穿透的控件
- ViewGroup会遍历自己的子控件,判断子控件的绘制区域是否包含目标点:包含才做分发
1.1.1.1 示例
我们做以下示例:所有函数均使用默认实现不消费事件时,点击ViewGroupA
I/MainActivity: dispatchTouchEvent开始
I/RootView: dispatchTouchEvent开始
I/RootView: onInterceptTouchEvent开始
I/ViewGroupA: dispatchTouchEvent开始
I/ViewGroupA: onInterceptTouchEvent开始
I/ViewGroupA: onTouchEvent开始
I/RootView: onTouchEvent开始
I/MainActivity: onTouchEvent开始
- 分发链:
点击位置穿透MainActivity、RootView、ViewGroupA--->
--->MainActivity#dispatchTouchEvent
--->RootView#dispatchTouchEvent(其中调用RootView#onInterceptTouchEvent)
--->ViewGroupA.dispatchTouchEvent(其中调用ViewGroupA#onInterceptTouchEvent)
- ViewGroupA是穿透控件链的最后一个,不再往下分发
- 消费链
---->ViewGroupA#onTouchEvent
---->RootView#onTouchEvent
---->MainActivity#onTouchEvent
1.1.1.2 分析
如何实现“事件分发链只触及点击位置穿透的控件”的呢?
其实就是把所有的 ChildView 遍历一遍,如果手指触摸的点在 ChildView 区域内就分发给这个View
当 ChildView 重叠时,一般会分配给显示在最上面的 ChildView(后面加载的一般会覆盖掉之前的,所以显示在最上面的是最后加载的)
1.1.2 消费链中一旦被消费(返回true)就终止整个事件分发流程
我们做以下示例:View1的onTouchEvent返回true消费该事件,点击View1
I/MainActivity: dispatchTouchEvent
I/RootView: dispatchTouchEvent
I/RootView: onInterceptTouchEvent
I/ViewGroupA: dispatchTouchEvent
I/ViewGroupA: onInterceptTouchEvent
I/View1: dispatchTouchEvent
I/View1: onTouchEvent
- 分发链:
点击位置穿透MainActivity、RootView、ViewGroupA、View1--->
--->MainActivity#dispatchTouchEvent
--->RootView#dispatchTouchEvent(其中调用RootView#onInterceptTouchEvent)
--->ViewGroupA.dispatchTouchEvent(其中调用ViewGroupA#onInterceptTouchEvent)
--->View1.dispatchTouchEvent(其中调用View1#onInterceptTouchEvent)
- View1是穿透控件链的最后一个,不再往下分发
- 消费链
---->View1#onTouchEvent
- View1消费事件,并结束整个流程
1.1.3 事件一旦被消费,则后续的move和up都由该控件消费
onInterceptTouchEvent有两个作用:1.拦截Down事件的分发。2.中止Up和Move事件向目标View传递,使得目标View所在的ViewGroup捕获Up和Move事件
- ACTION_DOWN事件会首先传递到ViewGroup中的onInterceptTouchEvent方法中
- 如果onInterceptTouchEvent处理完ACTION_DOWN事件返回false,则系统还会将该ACTION_DOWN事件传到目标View当中
- 如果onInterceptTouchEvent处理完ACTION_DOWN事件返回true,则系统不会将该ACTION_DOWN事件传到目标View中的onTouchEvent方法中,就会调用ViewGroup中自己的onTouchEvent方法处理。
- 前提:ViewGroup中的onInterceptTouchEvent处理完ACTION_DOWN事件返回false,后续ACTION_MOVE事件同样先传递到onInterceptTouchEvent中
- 如果onInterceptTouchEvent处理完ACTION_MOVE返回false,则系统还会将ACTION_MOVE事件传递到目标View中的onTouchEvent方法中。
- 如果onInterceptTouchEvent处理完ACTION_MOVE返回true,则系统不会将ACTION_MOVE事件传递到目标View中的onTouchEvent方法中,而是传递ACTION_CANCEL事件到目标View的onTouchEvent方法中,只传递一次,此后与目标View没有任何关系(包括最后的ACTION_UP事件),只调用ViewGroup中的onTouchEvent方法。
- 前提:ViewGroup中的onInterceptTouchEvent处理完ACTION_DOWN事件返回true
后续的ACTION_MOVE、ACTION_UP事件将不再调用该ViewGroup中的onInterceptTouchEvent方法,直接将这些事件传递给该ViewGroup中的onTouchEvent处理。
1.2 View分析
dispatchTouchEvent 是事件分发机制中的核心,所有的事件调度都归它管。不过我细看表格, ViewGroup 有 dispatchTouchEvent 也就算了,毕竟人家有一堆 ChildView 需要管理,但为啥 View 也有?
View 可以注册很多事件监听器,例如:单击事件(onClick)、长按事件(onLongClick)、触摸事件(onTouch),并且View自身也有 onTouchEvent 方法。View#dispatchTouchEvent 主要是对以上响应流程的处理
1.2.1 监听器优先级
调度顺序应该是
onTouchListener监听回调 > onTouchEvent自身 > onLongClickListener监听回调 > onClickListener监听回调
- 单击事件(onClickListener) 需要两个两个事件(ACTION_DOWN 和 ACTION_UP )才能触发,如果先分配给onClick判断,等它判断完,用户手指已经离开屏幕,黄花菜都凉了,定然造成 View 无法响应其他事件,应该最后调用。(最后)
- 长按事件(onLongClickListener) 同理,也是需要长时间等待才能出结果,肯定不能排到前面,但因为不需要ACTION_UP,应该排在 onClick 前面。(onLongClickListener > onClickListener)
- 触摸事件(onTouchListener) 如果用户注册了触摸事件,说明用户要自己处理触摸事件了,这个应该排在最前面。(最前)
- View自身处理(onTouchEvent) 提供了一种默认的处理方式,如果用户已经处理好了,也就不需要了,所以应该排在 onTouchListener 后面。(onTouchListener > onTouchEvent)
我们来看下实例:手指按下,不移动,稍等片刻再抬起。
[Listener ]: onTouchListener ACTION_DOWN
[GcsView ]: onTouchEvent ACTION_DOWN
[Listener ]: onLongClickListener
[Listener ]: onTouchListener ACTION_UP
[GcsView ]: onTouchEvent ACTION_UP
[Listener ]: onClickListener
1.2.2 分析
public boolean dispatchTouchEvent(MotionEvent event) {
if (mOnTouchListener.onTouch(this, event)) {//【步骤1】调用onTouchListener监听回调,如果其返回ture,表示消费了该事件
return true;
} else if (onTouchEvent(event)) {//【步骤2】调用自身onTouchEvent,如果其返回ture,表示消费了该事件
return true;
}
return false;
}
- 【步骤1】调用onTouchListener监听回调,如果其返回ture,表示消费了该事件
- 【步骤2】调用自身onTouchEvent,如果其返回ture,表示消费了该事件
- OnClick 和 OnLongClick 的具体调用位置在 onTouchEvent
我们先看下dispatchTouchEvent的实际代码:
public boolean dispatchTouchEvent(MotionEvent event) {
...
boolean result = false; // result 为返回值,主要作用是告诉调用者事件是否已经被消费。
if (onFilterTouchEventForSecurity(event)) {
ListenerInfo li = mListenerInfo;
/**
* 【步骤1】如果设置了OnTouchListener,并且当前 View 可点击,就调用监听器的 onTouch 方法, 如果 onTouch 方法返回值为 true,就设置 result 为 true。
*/
if (li != null && li.mOnTouchListener != null
&& (mViewFlags & ENABLED_MASK) == ENABLED
&& li.mOnTouchListener.onTouch(this, event)) {
result = true;
}
/**
* 【步骤2】如果 result 为 false,则调用自身的 onTouchEvent。
* 如果 onTouchEvent 返回值为 true,则设置 result 为 true。
*/
if (!result && onTouchEvent(event)) {
result = true;
}
}
...
return result;
}
再来看步骤2 View#onTouchEvent(MotionEvent event):
public boolean onTouchEvent(MotionEvent event) {
...
final int action = event.getAction();
// 检查各种 clickable
if (((viewFlags & CLICKABLE) == CLICKABLE ||
(viewFlags & LONG_CLICKABLE) == LONG_CLICKABLE) ||
(viewFlags & CONTEXT_CLICKABLE) == CONTEXT_CLICKABLE) {
switch (action) {
case MotionEvent.ACTION_UP:
...
removeLongPressCallback(); // 移除长按
...
performClick(); // 检查单击
...
break;
case MotionEvent.ACTION_DOWN:
...
checkForLongClick(0); // 检测长按
...
break;
...
}
return true; // ◀︎表示事件被消费
}
return false;
}
需要注意的是:
只要View是CLICKABLE,LONG_CLICKABLE,CONTEXT_CLICKABLE就会消费该点击事件,无论点击回调和长按回调中如何处理,都会消费点击事件:
- 不论 View 自身是否注册点击事件,只要 View 是可点击的就会消费事件
- 事件是否被消费由返回值决定,true 表示消费,false 表示不消费,与是否使用了事件无关
View 中 onClick 事件需要同时接收到 ACTION_DOWN 和 ACTION_UP 才能触发,如果分配给了不同的 View,那么 onClick 将无法被正确触发。
Group#dispatchTouchEvent源码
- 【一、初始化:处理第一次ACTION_DOWN】
- 一个完整的事件序列从Down开始到Up结束,这里又收到了Down, 说明进入了一个新的序列
- 需要清除之前所有的状态
- 【二、检查是否需要拦截】.
- 【三、 检查事件是否被取消(ACTION_CANCEL).】
- 【四、 如果没有取消也没有被拦截 (进入事件分发),寻找目标View】
- 【4.1、倒序遍历:▼注意,从最后向前扫描,传递给子View】
- 【4.1.1 检查View是否允许接受事件(即处于显示状态(VISIBLE)或者正在播放动画)】
- 【4.1.2 检查触摸位置是否在View区域内】
- 【4.1、倒序遍历:▼注意,从最后向前扫描,传递给子View】
- 【五、分发 事件给 TouchTarget】
- 【5.1 没有 TouchTarget,将当前 ViewGroup 当作普通的 View 处理。】
- 【5.2 分发TouchTarget,如果我们已经分发过,则避免分配给新的目标。 】
public boolean dispatchTouchEvent(MotionEvent ev) {
// 调试用
if (mInputEventConsistencyVerifier != null) {
mInputEventConsistencyVerifier.onTouchEvent(ev, 1);
}
// 判断事件是否是针对可访问的焦点视图(很晚才添加的内容,个人猜测和屏幕辅助相关,方便盲人等使用设备)
if (ev.isTargetAccessibilityFocus() && isAccessibilityFocusedViewOrHost()) {
ev.setTargetAccessibilityFocus(false);
}
boolean handled = false;
if (onFilterTouchEventForSecurity(ev)) {
final int action = ev.getAction();
final int actionMasked = action & MotionEvent.ACTION_MASK;
// 【一、初始化:处理第一次ACTION_DOWN】
if (actionMasked == MotionEvent.ACTION_DOWN) {
// 一个完整的事件序列从Down开始到Up结束,这里又收到了Down, 说明进入了一个新的序列
//需要清除之前所有的状态
cancelAndClearTouchTargets(ev);
resetTouchState();
}
// 【二、检查是否需要拦截】.
final boolean intercepted;
if (actionMasked == MotionEvent.ACTION_DOWN || mFirstTouchTarget != null) {
final boolean disallowIntercept = (mGroupFlags & FLAG_DISALLOW_INTERCEPT) != 0;
if (!disallowIntercept) {
intercepted = onInterceptTouchEvent(ev); // 询问是否拦截
ev.setAction(action); // 恢复操作,防止被更改
} else {
intercepted = false;
}
} else {
// 没有目标来处理该事件,而且也不是一个新的事件事件(ACTION_DOWN), 进行拦截。
intercepted = true;
}
// 判断事件是否是针对可访问的焦点视图
if (intercepted || mFirstTouchTarget != null) {
ev.setTargetAccessibilityFocus(false);
}
//【三、 检查事件是否被取消(ACTION_CANCEL).】
final boolean canceled = resetCancelNextUpFlag(this)
|| actionMasked == MotionEvent.ACTION_CANCEL;
final boolean split = (mGroupFlags & FLAG_SPLIT_MOTION_EVENTS) != 0;
TouchTarget newTouchTarget = null;
boolean alreadyDispatchedToNewTouchTarget = false;
//【四、 如果没有取消也没有被拦截 (进入事件分发),寻找目标View】
if (!canceled && !intercepted) {
// 如果事件是针对可访问性焦点视图,我们将其提供给具有可访问性焦点的视图。
// 如果它不处理它,我们清除该标志并像往常一样将事件分派给所有的 ChildView。
// 我们检测并避免保持这种状态,因为这些事非常罕见。
View childWithAccessibilityFocus = ev.isTargetAccessibilityFocus()
? findChildWithAccessibilityFocus() : null;
if (actionMasked == MotionEvent.ACTION_DOWN
|| (split && actionMasked == MotionEvent.ACTION_POINTER_DOWN)
|| actionMasked == MotionEvent.ACTION_HOVER_MOVE) {
final int actionIndex = ev.getActionIndex();
final int idBitsToAssign = split ? 1 << ev.getPointerId(actionIndex)
: TouchTarget.ALL_POINTER_IDS;
// 清除此指针ID的早期触摸目标,防止不同步。
removePointersFromTouchTargets(idBitsToAssign);
final int childrenCount = mChildrenCount;
if (newTouchTarget == null && childrenCount != 0) {
final float x = ev.getX(actionIndex); // 获取触摸位置坐标
final float y = ev.getY(actionIndex);
// 查找可以接受事件的 ChildView
final ArrayList<View> preorderedList = buildOrderedChildList();
final boolean customOrder = preorderedList == null
&& isChildrenDrawingOrderEnabled();
final View[] children = mChildren;
// 【4.1、倒序遍历:▼注意,从最后向前扫描,传递给子View】
for (int i = childrenCount - 1; i >= 0; i--) {
final int childIndex = customOrder
? getChildDrawingOrder(childrenCount, i) : i;
final View child = (preorderedList == null)
? children[childIndex] : preorderedList.get(childIndex);
// 如果有一个视图具有可访问性焦点,我们希望它首先获取事件,
// 如果不处理,我们将执行正常的分派。
// 尽管这可能会分发两次,但它能保证在给定的时间内更安全的执行。
if (childWithAccessibilityFocus != null) {
if (childWithAccessibilityFocus != child) {
continue;
}
childWithAccessibilityFocus = null;
i = childrenCount - 1;
}
// 【4.1.1 检查View是否允许接受事件(即处于显示状态(VISIBLE)或者正在播放动画)】
// 【4.1.2 检查触摸位置是否在View区域内】
if (!canViewReceivePointerEvents(child)
|| !isTransformedTouchPointInView(x, y, child, null)) {
ev.setTargetAccessibilityFocus(false);
continue;
}
// getTouchTarget 中判断了 child 是否包含在 mFirstTouchTarget 中
// 如果有返回 target,如果没有返回 null
newTouchTarget = getTouchTarget(child);
if (newTouchTarget != null) {
// ChildView 已经准备好接受在其区域内的事件。
newTouchTarget.pointerIdBits |= idBitsToAssign;
break; // ◀︎已经找到目标View,跳出循环
}
resetCancelNextUpFlag(child);
if (dispatchTransformedTouchEvent(ev, false, child, idBitsToAssign)) {
mLastTouchDownTime = ev.getDownTime();
if (preorderedList != null) {
for (int j = 0; j < childrenCount; j++) {
if (children[childIndex] == mChildren[j]) {
mLastTouchDownIndex = j;
break;
}
}
} else {
mLastTouchDownIndex = childIndex;
}
mLastTouchDownX = ev.getX();
mLastTouchDownY = ev.getY();
newTouchTarget = addTouchTarget(child, idBitsToAssign);
alreadyDispatchedToNewTouchTarget = true;
break;
}
ev.setTargetAccessibilityFocus(false);
}
if (preorderedList != null) preorderedList.clear();
}
if (newTouchTarget == null && mFirstTouchTarget != null) {
// 没有找到 ChildView 接收事件
newTouchTarget = mFirstTouchTarget;
while (newTouchTarget.next != null) {
newTouchTarget = newTouchTarget.next;
}
newTouchTarget.pointerIdBits |= idBitsToAssign;
}
}
}
// 【五、分发 事件给 TouchTarget】
if (mFirstTouchTarget == null) {
// 【5.1 没有 TouchTarget,将当前 ViewGroup 当作普通的 View 处理。】
handled = dispatchTransformedTouchEvent(ev, canceled, null,
TouchTarget.ALL_POINTER_IDS);
} else {
// 【5.2 分发TouchTarget,如果我们已经分发过,则避免分配给新的目标。 】
// 如有必要,取消分发。
TouchTarget predecessor = null;
TouchTarget target = mFirstTouchTarget;
while (target != null) {
final TouchTarget next = target.next;
if (alreadyDispatchedToNewTouchTarget && target == newTouchTarget) {
handled = true;
} else {
final boolean cancelChild = resetCancelNextUpFlag(target.child)
|| intercepted;
if (dispatchTransformedTouchEvent(ev, cancelChild,
target.child, target.pointerIdBits)) {
handled = true;
}
if (cancelChild) {
if (predecessor == null) {
mFirstTouchTarget = next;
} else {
predecessor.next = next;
}
target.recycle();
target = next;
continue;
}
}
predecessor = target;
target = next;
}
}
// 如果需要,更新指针的触摸目标列表或取消。
if (canceled
|| actionMasked == MotionEvent.ACTION_UP
|| actionMasked == MotionEvent.ACTION_HOVER_MOVE) {
resetTouchState();
} else if (split && actionMasked == MotionEvent.ACTION_POINTER_UP) {
final int actionIndex = ev.getActionIndex();
final int idBitsToRemove = 1 << ev.getPointerId(actionIndex);
removePointersFromTouchTargets(idBitsToRemove);
}
}
if (!handled && mInputEventConsistencyVerifier != null) {
mInputEventConsistencyVerifier.onUnhandledEvent(ev, 1);
}
return handled;
}