做相册时很容易遇到这样的现象:图片单独放在页面里可以拖动,塞进翻页容器后,手指刚动一点就开始切换照片。给图片的触摸回调加上日志,又会看到 DOWN 后没有预想中的 UP,而是收到了 CANCEL。
理解这个问题,需要先弄清一个手势到底由谁处理,以及父容器什么时候可以接管。本文围绕图片与翻页容器的协作来讲事件分发,先看生命周期,再区分消费与拦截,最后讨论如何根据图片当前状态分配手势。
这里使用 ViewPager2 作为例子。它继承 ViewGroup,内部使用 RecyclerView,两者不是父子类关系。分析问题时应沿实际的 View 层级观察,而不是只看控件名字。
1. 一个手势的生命周期
单指手势通常是 ACTION_DOWN → 零个或多个 ACTION_MOVE → ACTION_UP,或者以 ACTION_CANCEL 结束。CANCEL 与 UP 是两种终止路径,不是每次都先 CANCEL 再 UP。多指还包括 ACTION_POINTER_DOWN / ACTION_POINTER_UP,应使用 getActionMasked() 读取动作类型,并用 pointer ID 跟踪手指,不能把索引当成稳定身份。
先看一条完整的日志
假设手指落在图片上,图片接受 DOWN,之后跟随手指移动,最后正常抬起。这条路径中,图片应能完成自己的状态清理。如果移动到一半父级决定接管,图片看到的结束事件就变成 CANCEL:它需要停止拖动、撤销点击候选,并结束当前识别。
因此,只有 DOWN 和 CANCEL 并不一定是事件“丢了”。这反而可能是一条正常的接管路径。真正需要追问的是:父级为什么在这个时刻拦截,以及图片收到取消后有没有恢复状态。把 CANCEL 当成异常忽略,往往会留下按压效果不消失、拖动标志不归零等后续问题。
2. 消费与拦截是两个概念
| 方法 | 所属对象 | 返回 true 的含义 |
|---|---|---|
dispatchTouchEvent |
Activity、View 等 | 这次分发被处理;内部仍可能已分发到子 View |
onInterceptTouchEvent |
ViewGroup | 父容器接管,不再继续按原目标分发 |
onTouchEvent |
View 等 | 当前处理者消费事件 |
dispatchTouchEvent() 返回 false 表示当前分发没有处理,结果返回调用者,并不表示继续往子控件传递。普通 View 也没有可重写的 onInterceptTouchEvent()。
不要自行用一个遍历子 View 的循环替代框架分发:系统还要处理命中测试、绘制顺序、坐标变换、多指拆分、触摸目标记录和 CANCEL。私有的 dispatchTransformedTouchEvent 也不是应用层能直接调用的公开 API。
这三个方法容易混淆,是因为它们都返回布尔值,却回答不同的问题。dispatchTouchEvent 关注这次分发有没有被处理;onInterceptTouchEvent 关注父容器是否要改变原来的处理目标;onTouchEvent 才是当前对象自身如何消费触摸。
所以,不能脱离方法名字只说“返回 true 就拦截”。在子 View 的 onTouchEvent 里返回 true,并不等于禁止父容器中途接管。反过来,父容器的分发返回 true,也可能只是它的子控件已经处理了事件,而非父容器亲自执行了拖动。
3. DOWN 决定后续目标
如果子 View 接受 DOWN,它通常成为当前手势的触摸目标,后续 MOVE/UP 沿这条路径分发。但父容器仍可能中途拦截;此时子 View 收到 CANCEL,随后事件转给父容器。
父容器即使不消费,仍可以在分发或拦截方法里观察事件,所以“子 View 消费 DOWN 后,父 ViewGroup 就看不到 MOVE”是不准确的。日志要写明观察的是哪个回调。
如果自定义 View 在 DOWN 返回 false,通常不会继续得到这个手势的后续事件;不能只在 MOVE 中才尝试接管。OnTouchListener 也受 View 是否启用及是否返回 true 等因素影响,监听器消费后可能不再调用该 View 的 onTouchEvent。
4. 请求父级不要拦截
getParent().requestDisallowInterceptTouchEvent(true) 是子 View 向父容器及祖先提出不拦截当前序列的请求,不是阻止父级所有回调,也不会自动让子 View 消费事件。新的 DOWN 开始时,框架会重置这一请求。
下面是可放进 TouchProbeView.java 的最小自定义 View。它从 DOWN 开始拥有手势、在移动超过 touch slop 后取消点击,并处理 UP/CANCEL 清理。它用于观察分发,不实现图片缩放或拖动。
import android.content.Context;
import android.util.AttributeSet;
import android.view.MotionEvent;
import android.view.View;
import android.view.ViewConfiguration;
public class TouchProbeView extends View {
private float downX, downY;
private boolean moved;
private final int touchSlop;
public TouchProbeView(Context context, AttributeSet attrs) {
super(context, attrs);
touchSlop = ViewConfiguration.get(context).getScaledTouchSlop();
setClickable(true);
}
@Override
public boolean onTouchEvent(MotionEvent event) {
switch (event.getActionMasked()) {
case MotionEvent.ACTION_DOWN:
downX = event.getX();
downY = event.getY();
moved = false;
if (getParent() != null)
getParent().requestDisallowInterceptTouchEvent(true);
return true;
case MotionEvent.ACTION_MOVE:
float dx = event.getX() - downX;
float dy = event.getY() - downY;
if (dx*dx + dy*dy > (float) touchSlop*touchSlop) moved = true;
return true;
case MotionEvent.ACTION_POINTER_DOWN:
moved = true; // 多指交互不触发单击
return true;
case MotionEvent.ACTION_UP:
if (getParent() != null)
getParent().requestDisallowInterceptTouchEvent(false);
if (!moved) performClick();
return true;
case MotionEvent.ACTION_CANCEL:
moved = false;
if (getParent() != null)
getParent().requestDisallowInterceptTouchEvent(false);
return true;
default:
return true;
}
}
@Override
public boolean performClick() {
super.performClick();
return true;
}
}
示例在 DOWN 中请求父级不要拦截,是为了把整个手势留给观察用的 View,便于看清回调序列。它的代价也很明显:如果直接放进翻页界面,父容器可能一直拿不到自己需要的横向拖动。因此它是一个观察工具,还不是最终的相册策略。
另一个值得留意的细节是点击。手指在屏幕上很难完全静止,不能有一点 MOVE 就取消点击;代码使用系统提供的 touch slop 作为移动容差。只有超过这个距离,或者出现多指操作,才把这次操作从点击候选中排除。UP 时调用 performClick(),也能让点击语义与触摸处理保持一致。
5. ViewPager2 与缩放图片如何协作
如果产品交互要求缩放期间禁止翻页,可以通过 ViewPager2.setUserInputEnabled(false) 暂停用户滚动,并在交互结束时恢复原状态。这不会直接替你实现图片缩放,也不阻止程序主动调用翻页方法。
更细的策略是:图片在原始倍率时把翻页方向的拖动交给父级;图片放大或双指缩放时请求不拦截;图片拖到边缘后,按方向决定是否允许父级接管。切换必须在父级已经拦截之前完成,一旦子 View 收到 CANCEL,就应结束当前识别,不能期待后续 MOVE 自动回到它。
同向滚动容器嵌套还涉及 nested scrolling;仅在 DOWN 中设置一次不拦截,可能造成父级永远无法翻页,不能说这样就解决了所有冲突。
用三个场景检查交接规则
第一种场景是图片未放大。用户向左拖,通常期待切到下一张,这时图片不应长期扣住横向手势。第二种是图片已经放大。相同的向左拖动,用户更可能是在查看图片右侧内容,此时应优先让图片移动。
第三种最容易出问题:图片已经移动到边缘,用户还继续向同一方向拖。产品可以选择把接下来的操作交给翻页容器,也可以要求松手后重新拖动。两种方式都能成立,关键是交互规则必须明确,再让代码按这条规则处理。单纯遇到冲突就到处调用“不允许拦截”,只会把问题移到别的场景。
如果希望中途交接,还要检查父容器接管时使用的位移基准,否则可能出现刚交过去就突然跳动。父子两边都需要知道当前手势处在哪个阶段;这不是只改一个返回值就能保证顺滑的。
6. 如何排查
分别记录 DOWN、MOVE、UP、CANCEL 与各方法返回值,测试单击、拖动、双指、父级中途接管和系统取消。源码与规则以 Android ViewGroup 触摸处理说明及 ViewPager2 API为准。本文的流程图解释一般机制,不替代具体控件版本的行为验证。

评论