Android View 的事件體系 -- 事件分發機制

東平人氏發表於2018-12-17

Android View 的事件體系 -- 事件分發機制

文章是閱讀了《Android 開發藝術探索》這本書較詳細的理解了事件分發機制後,再通過研究原始碼,系統性的總結事件分發機制,主要目的是為了更好的理解對同一系列事件(DOWN --> MOVE --> UP),它的分發過程是怎麼樣的,所以文章的講解要比書上的細,要更深入些(^_^)。

文中原始碼使用的是 API 26,因為新版本的 Studio 不能開啟 API 19 的原始碼了,所以就直接用 API 26 了(^_^)。

文中配有流程圖,結合流程圖,大家可以更好的理解,和記憶(對我而言後者更重要)(^_^)。另外本文對原始碼的解析顆粒度會很小,所以流程圖並不會把所有原始碼包含進來。

本來是想直接寫在《Android View 的事件體系》這篇部落格中,但發現這部分內容太多了,就獨立出來了。如果對 Android 事件完全沒有接觸的話,可以先看下事件體系部落格(只要看到事件分發機制部分即可)。

前言

所謂的點選事件分發,其實就是對 MotionEvent 事件的分發過程,即一個 MotionEvent 產生以後,系統需要把這個事件傳遞給具體的View,而這個傳遞過程就是分發過程。

目錄(相容稀土掘金)

  • 一、三個重要方法
  • 二、事件分發機制簡略過程圖
  • 三、從 Activity 到 View 的事件傳遞
  • 四、View 的事件傳遞
  • 流程圖
  • dispatchTouchEvent:全部原始碼
  • onTouchEvent:整體原始碼(簡述)
  • onTouchEvent:clickable 判定
  • onTouchEvent:View 不可用
  • onTouchEvent:存在代理
  • onTouchEvent:點選事件
  • performClick:全部原始碼
  • 五、ViewGroup 的事件傳遞
  • 流程圖
  • onInterceptTouchEvent:決定 ViewGroup 是否攔截事件。
  • onTouchEvent:ViewGroup 自身嘗試消費事件。
  • dispatchTouchEvent:整體原始碼(簡述)
  • dispatchTouchEvent:攔截判定模組(核心)
  • dispatchTouchEvent:ACTION_DOWN 重置
  • dispatchTouchEvent:ViewGroup 自身消費事件(核心)
  • dispatchTouchEvent:子 View 消費事件(核心)
  • dispatchTouchEvent:遍歷所有子 View(簡述)
  • dispatchTouchEvent:子 View 不能接受事件判定
  • dispatchTouchEvent:尋找方式一:直接從連結串列中找到可消費該事件的子 View
  • dispatchTouchEvent:尋找方式二:事件被子 View 消費(DOWN 事件)
  • 六、滑動衝突
  • requestDisallowInterceptTouchEvent:修改 mGroupFlags

一、三個重要方法

// Activity
boolean dispatchTouchEvent(MotionEvent event) // 事件分發
boolean onTouchEvent(MotionEvent event) // 事件處理

// View:
boolean dispatchTouchEvent(MotionEvent event) // 事件分發
boolean onTouchEvent(MotionEvent event) // 事件處理

// ViewGoup:
boolean onInterceptTouchEvent(MotionEvent event) // 事件攔截
boolean dispatchTouchEvent(MotionEvent event) // 事件分發
boolean onTouchEvent(MotionEvent event) // 事件處理
複製程式碼

返回值說明:

  • true: 事件被攔截,事件處理到此為止,不再繼續分發
  • false: 事件未被攔截,繼續往下/上一個控制元件傳遞

二、事件分發機制簡略過程圖

事件分發機制簡略過程圖

通過上圖,可得:

  • View:OnTouchListener --> onTouchEvent --> OnClickListener
  • View 是可點選的,則事件就會被該 View 消費

三、從 Activity 到 View 的事件傳遞

從Activity到View的事件傳遞流程圖

/**
 * Activity 類
 */
public boolean dispatchTouchEvent(MotionEvent ev) {
    if (ev.getAction() == MotionEvent.ACTION_DOWN) {
        onUserInteraction();
    }
    if (getWindow().superDispatchTouchEvent(ev)) {
        return true;
    }
    return onTouchEvent(ev);
}

public boolean onTouchEvent(MotionEvent event) {
    if (mWindow.shouldCloseOnTouch(this, event)) {
        finish();
        return true;
    }
    return false;
}

/**
 * Window 類
 */
public abstract boolean superDispatchTouchEvent(MotionEvent event);

/**
 * PhoneWindow extends Window 類
 */
public boolean superDispatchTouchEvent(MotionEvent event) {
    return super.dispatchTouchEvent(event);
}

/**
 * DecorView 類
 */
public boolean superDispatchTouchEvent(MotionEvent event) {
    return super.dispatchTouchEvent(event);
}

複製程式碼

四、View 的事件傳遞

從下面的流程圖可知:

  • OnTouchListener --> onTouchEvent --> OnClickListener
  • View 可點選,無論 View 是否可用,都會消費事件

View的事件傳遞流程圖

dispatchTouchEvent:全部原始碼

public boolean dispatchTouchEvent(MotionEvent event) {
    ...
    boolean result = false;
    ...
    if (onFilterTouchEventForSecurity(event)) {
        if ((mViewFlags & ENABLED_MASK) == ENABLED && handleScrollBarDragging(event)) {
            result = true;
        }
        //noinspection SimplifiableIfStatement
        ListenerInfo li = mListenerInfo;
        if (li != null && li.mOnTouchListener != null
                && (mViewFlags & ENABLED_MASK) == ENABLED
                && li.mOnTouchListener.onTouch(this, event)) {
            result = true;
        }

        if (!result && onTouchEvent(event)) {
            result = true;
        }
    }
    ...
    return result;
}
複製程式碼

onTouchEvent:整體原始碼(簡述)

從原始碼可知:View 可點選,無論 View 是否可用,都會消費事件

public boolean onTouchEvent(MotionEvent event) {
    ...

    // clickable 判定
    final boolean clickable = ...

    // View 不可用處理
    if ((viewFlags & ENABLED_MASK) == DISABLED) {
        ...
        return clickable;
    }

    // 存在代理
    if (mTouchDelegate != null) {
        if (mTouchDelegate.onTouchEvent(event)) {
            return true;
        }
    }

    // View 可點選
    if (clickable || (viewFlags & TOOLTIP) == TOOLTIP) {
        switch (action) {
            case MotionEvent.ACTION_UP:
                ...
                if (!clickable) {
                    ...
                    break;
                }
                
                ...
                // 點選事件處理
                if(...)
                    performClick();

                ...
                break;
	        case MotionEvent.ACTION_DOWN:
	            ...
	            break;
	        case MotionEvent.ACTION_CANCEL:
	            ...
	            break;
	        case MotionEvent.ACTION_MOVE:
	            ...
	            break;
        }
        return true;
    }
    return false;
}
複製程式碼

onTouchEvent:clickable 判定

final boolean clickable = ((viewFlags & CLICKABLE) == CLICKABLE
        || (viewFlags & LONG_CLICKABLE) == LONG_CLICKABLE)
        || (viewFlags & CONTEXT_CLICKABLE) == CONTEXT_CLICKABLE;
複製程式碼

通過 setOnClickListener、setOnLongClickListener、setOnContextClickListener 等方法設定 View 的點選事件,都會使 View 的 clickable 屬性等於 true

public void setOnClickListener(@Nullable OnClickListener l) {
    if (!isClickable()) {
        setClickable(true);
    }
    getListenerInfo().mOnClickListener = l;
}
複製程式碼
public void setContextClickable(boolean contextClickable) {
    setFlags(contextClickable ? CONTEXT_CLICKABLE : 0, CONTEXT_CLICKABLE);
}
複製程式碼
void setFlags(int flags, int mask) {
    ...
	mViewFlags = (mViewFlags & ~mask) | (flags & mask);
	...
}
複製程式碼

onTouchEvent:View 不可用

從原始碼可知: 一旦 View 不可用,流程就會結束,返回值為 clickable

if ((viewFlags & ENABLED_MASK) == DISABLED) {
    if (action == MotionEvent.ACTION_UP && (mPrivateFlags & PFLAG_PRESSED) != 0) {
        setPressed(false);
    }
    mPrivateFlags3 &= ~PFLAG3_FINGER_DOWN;
    // A disabled view that is clickable still consumes the touch
    // events, it just doesn't respond to them.
    return clickable;
}
複製程式碼

onTouchEvent:存在代理

if (mTouchDelegate != null) {
    if (mTouchDelegate.onTouchEvent(event)) {
        return true;
    }
}
複製程式碼

onTouchEvent:點選事件

從原始碼可知:

  • MotionEvent.ACTION_UP 事件觸發 performClick() 方法的執行
  • View 只要可點選,那麼當前 View 就會消費掉這個事件
if (clickable || (viewFlags & TOOLTIP) == TOOLTIP) {
    switch (action) {
        case MotionEvent.ACTION_UP:
            ...
            if (!clickable) {
                ...
                break;
            }
            boolean prepressed = (mPrivateFlags & PFLAG_PREPRESSED) != 0;
            if ((mPrivateFlags & PFLAG_PRESSED) != 0 || prepressed) {
                // take focus if we don't have it already and we should in
                // touch mode.
                boolean focusTaken = false;
                ...

                if (!mHasPerformedLongPress && !mIgnoreNextUpEvent) {
                    // This is a tap, so remove the longpress check
                    removeLongPressCallback();

                    // Only perform take click actions if we were in the pressed state
                    if (!focusTaken) {
                        // Use a Runnable and post this rather than calling
                        // performClick directly. This lets other visual state
                        // of the view update before click actions start.
                        if (mPerformClick == null) {
                            mPerformClick = new PerformClick();
                        }
                        if (!post(mPerformClick)) {
                            performClick();
                        }
                    }
                }
                ...
            }
            mIgnoreNextUpEvent = false;
            break;
        case MotionEvent.ACTION_DOWN:
            ...
            break;
        case MotionEvent.ACTION_CANCEL:
            ...
            break;
        case MotionEvent.ACTION_MOVE:
            ...
            break;
    }
    return true;
}
複製程式碼

performClick:全部原始碼

如下,呼叫了 onClick 方法

public boolean performClick() {
    final boolean result;
    final ListenerInfo li = mListenerInfo;
    if (li != null && li.mOnClickListener != null) {
        playSoundEffect(SoundEffectConstants.CLICK);
        li.mOnClickListener.onClick(this);
        result = true;
    } else {
        result = false;
    }

    sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_CLICKED);

    notifyEnterOrExitForAutoFillIfNeeded(true);

    return result;
}
複製程式碼

五、ViewGroup 的事件傳遞

必要說明:

  • 一般情況下,ViewGroup 會遍歷所有子 View,嘗試讓某個子 View 消費事件。僅當所有子 View 都不消費該事件時,ViewGroup 自身才會嘗試消費該事件
  • 攔截指 ViewGroup 不再讓事件遍歷經過子 View,直接由自身嘗試消費該事件

圖片待補充:

圖片待補充

onInterceptTouchEvent:決定 ViewGroup 是否攔截事件。

由原始碼可知:預設情況下 ViewGroup 不攔截事件(除特殊情況)

public boolean onInterceptTouchEvent(MotionEvent ev) {
    if (ev.isFromSource(InputDevice.SOURCE_MOUSE)
            && ev.getAction() == MotionEvent.ACTION_DOWN
            && ev.isButtonPressed(MotionEvent.BUTTON_PRIMARY)
            && isOnScrollbarThumb(ev.getX(), ev.getY())) {
        return true;
    }
    return false;
}
複製程式碼

onTouchEvent:ViewGroup 自身嘗試消費事件。

從原始碼可知,ViewGroup 並沒有重寫該方法。

dispatchTouchEvent:整體原始碼(簡述)

先讓大家對整體原始碼有個劃分

public boolean dispatchTouchEvent(MotionEvent ev) {
	// ACTION_DOWN 重置標誌(程式碼見下)

	// 攔截判定模組(程式碼見下)

	// ACTION_DOWN 事件時,遍歷所有子 View,尋找能消費該事件的子 View(程式碼見下)

	// ViewGroup 自身消費事件,或子 View 消費事件(程式碼見下)
}
複製程式碼

dispatchTouchEvent:攔截判定模組(核心)

注:說明很長,請先看下原始碼,在對照說明一起看。

必要說明(以下說明具體原因見之後的原始碼):

  • 1)boolean intercepted = true 表示當前事件被 ViewGroup 攔截,不再傳遞給子 View,交由 ViewGroup 自身處理該事件。
  • 2)當 ViewGroup 的某個子 View 消費了事件後,mFirstTouchTarget 就指向該子 View。否則為 null
  • 3)ACTION_DOWN 事件會對 mGroupFlags、mFirstTouchTarget 等進行重置,再執行後續邏輯

由上述可知,對同一系列事件(DOWN、MOVE、UP):

  • 4)mFirstTouchTarget != null,表示上一個事件由某個子 View 消費
  • 5)mFirstTouchTarget == null,表示上一個事件由 ViewGroup 自身處理,出現有場景:
  • ViewGroup 沒有子 View
  • ViewGroup 所有子 View 都不消費事件
  • ViewGroup 的 onInterceptTouchEvent 方法一直返回 true

以下原始碼可知:

  • 6)當事件不是 ACTION_DOWN,且 mFirstTouchTarget == null 時,表示 ViewGroup 繼續由自身處理事件(關聯第2點、第5點)
  • 7)boolean disallowIntercept = false,表示 ViewGroup 可能會攔截事件。反之則表示 ViewGroup 不會攔截事件
  • 8)事件為 ACTION_DOWN 時:
  • onInterceptTouchEvent 必然被執行(關聯第3點)
  • 該事件要麼被某個可點選的子 View 消費,要麼 ViewGroup 自身消費(關聯 View 的事件傳遞)
  • 一旦該事件被某個可點選的子 View 消費,則 mFirstTouchTarget != null,反之 mFirstTouchTarget == null(關聯第2點)
  • 9)連結串列 mFirstTouchTarget != null 時:
  • mGroupFlags 不發生改變的情況下,當前事件將繼續被連結串列中的某個子 View 消費(假設該子 View 會繼續消費掉該事件)
    1. mGroupFlags 可以通過 requestDisallowInterceptTouchEvent(boolean) 進行設定
  • 一旦 mGroupFlags 被設定,則 disallowIntercept = true,那麼 ViewGroup 將不會攔截除 ACTION_DOWN 以外的事件(關聯第3點)

從上述可知:

  • 11)ACTION_DOWN 事件被 ViewGroup 自身消費,則後續的一系列事件,仍然由 ViewGroup 自身消費
  • 12)ACTION_DOWN 事件被某個子 View 消費,則後續的一系列事件,仍然該子 View 消費(假設該子 View 會消費掉該事件)

上述證明見:

  • ACTION_DOWN 重置:第3點

  • ViewGroup 自身消費事件:第1點、第6點

  • 事件被子 View 消費(DOWN 事件):第2點

  • 本章節:第7點

  • ACTION_DOWN 重置、ViewGroup 自身消費事件、事件被子 View 消費(DOWN 事件)組合證明:第8點

  • 子 View 消費事件、遍歷所有子 View(簡略)組合證明:第9點

  • 滑動衝突:第10點

// Check for interception.
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); // restore action in case it was changed
    } else {
        intercepted = false;
    }
} else {
    // There are no touch targets and this action is not an initial down
    // so this view group continues to intercept touches.
    intercepted = true;
}
複製程式碼

dispatchTouchEvent:ACTION_DOWN 重置

該段程式碼在攔截判斷之前,可以看出以下資訊被重置了:

  • mGroupFlags
  • mFirstTouchTarget

該部分原始碼證明上述攔截判定模組的

  • 第3點
  • 第8點部分證明
// Handle an initial down.
if (actionMasked == MotionEvent.ACTION_DOWN) {
    // Throw away all previous state when starting a new touch gesture.
    // The framework may have dropped the up or cancel event for the previous gesture
    // due to an app switch, ANR, or some other state change.
    cancelAndClearTouchTargets(ev);
    resetTouchState();
}
複製程式碼
/**
 * Resets all touch state in preparation for a new cycle.
 */
private void resetTouchState() {
    clearTouchTargets();
    resetCancelNextUpFlag(this);
    mGroupFlags &= ~FLAG_DISALLOW_INTERCEPT;
    mNestedScrollAxes = SCROLL_AXIS_NONE;
}

/**
 * Clears all touch targets.
 */
private void clearTouchTargets() {
    TouchTarget target = mFirstTouchTarget;
    if (target != null) {
        do {
            TouchTarget next = target.next;
            target.recycle();
            target = next;
        } while (target != null);
        mFirstTouchTarget = null;
    }
}
複製程式碼

dispatchTouchEvent:ViewGroup 自身消費事件(核心)

很明顯 mFirstTouchTarget == null 的時候,ViewGroup 自身嘗試消費事件,講解:

  • dispatchTransformedTouchEvent:實際就是呼叫子 View 的 dispatchTouchEvent 方法
  • 很明顯 ViewGroup 自身消費事件時,child == null,意味著 ViewGroup 會走一遍 ViewGroup 作為 View 層次的事件傳遞過程

該部分原始碼證明上述攔截判定模組的

  • 第1點
  • 第6點
  • 第8點部分證明
// ACTION_DOWN 重置(mFirstTouchTarget = null)

// 攔截判定
boolean intercepted = ...

if (!canceled && !intercepted) {
    ...
}

// Dispatch to touch targets.
if (mFirstTouchTarget == null) {
    // No touch targets so treat this as an ordinary view.
    handled = dispatchTransformedTouchEvent(ev, canceled, null,
            TouchTarget.ALL_POINTER_IDS);
} else {
	// 子 View 消費 ACTION_DOWN 之外的事件
	...
}
複製程式碼
/**
 * Transforms a motion event into the coordinate space of a particular child view,
 * filters out irrelevant pointer ids, and overrides its action if necessary.
 * If child is null, assumes the MotionEvent will be sent to this ViewGroup instead.
 */
private boolean dispatchTransformedTouchEvent(MotionEvent event, boolean cancel, View child, int desiredPointerIdBits) {
    ...
    if (child == null) {
        handled = super.dispatchTouchEvent(event);
    } else {
        ...
        handled = child.dispatchTouchEvent(event);
		...
    }
    return handled;
}
複製程式碼

dispatchTouchEvent:子 View 消費事件(核心)

必要說明(以下說明具體原因見之後的原始碼):

  • 13)DOWN 事件被某個子 View 消費,則 alreadyDispatchedToNewTouchTarget == true
  • 14)DOWN 事件被某個子 View 消費,則 mFirstTouchTarget != null,且 mFirstTouchTarget 包含該子 View。
  • 15)對於同一系列事件(DOWN、MOVE、UP)只有 ACTION_DOWN 才能遍歷所有子 View,其他事件不會遍歷

結合上述以及由下述原始碼可知:

  • 當前事件為 ACTION_DOWN,且被消費時,事件不再重複分發。
  • 事件不為 ACTION_DOWN 時,不會遍歷所有子 View,而是直接通過 mFirstTouchTarget 連結串列遍歷查詢消費過 ACTION_DOWN 事件的子 View,讓這些子 View 嘗試消費事件,注意【target.pointerIdBits】屬性,該屬性自行研究

該部分原始碼證明上述攔截判定模組的

  • 第1點
  • 第6點
  • 第9點部分證明
// Dispatch to touch targets.
if (mFirstTouchTarget == null) {
	// ViewGroup 自身消費事件
    ...
} else {
    // Dispatch to touch targets, excluding the new touch target if we already
    // dispatched to it.  Cancel touch targets if necessary.
    TouchTarget predecessor = null;
    TouchTarget target = mFirstTouchTarget;
    while (target != null) {
        final TouchTarget next = target.next;
        if (alreadyDispatchedToNewTouchTarget && target == newTouchTarget) {
			// 事件被子 View 消費(DOWN 事件)
            handled = true;
        } else {
			// DOWN 之外事件處理邏輯
            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;
    }
}
複製程式碼

dispatchTouchEvent:遍歷所有子 View(簡述)

這部分原始碼是 ViewGroup 遍歷所有子 View,讓子 View 嘗試消費事件的整體原始碼。從下面的原始碼可知:

  • 對於同一系列事件(DOWN、MOVE、UP):只有 ACTION_DOWN 才能遍歷所有子 View,其他事件不會遍歷
  • 子 View 不能接受事件的條件:該子 View 正在播放動畫、焦點不在子 View 的區域內
  • 跳出遍歷的方式有兩種:
  • 直接從 mFirstTouchTarget 連結串列中找到可消費該事件的子 View
  • 事件被某個子 View 消費

該部分原始碼講解證明上述攔截判定模組的

  • 第9點部分證明

該部分原始碼證明上述子 View 消費事件章節的

  • 第15點
TouchTarget newTouchTarget = null;
if (!canceled && !intercepted) {
	// 尋找方式:指尋找能夠消費本事件的子 View 的方式
    // 優化尋找(上):按官方註釋講解,是直接尋找可以接受該焦點的子 View
    View childWithAccessibilityFocus = ...;

    // 對於同一系列事件(ACTION_DOWN、ACTION_MOVE、ACTION_UP):只有 ACTION_DOWN 才能遍歷所有子 View
    if (actionMasked == MotionEvent.ACTION_DOWN
            || (split && actionMasked == MotionEvent.ACTION_POINTER_DOWN)
            || actionMasked == MotionEvent.ACTION_HOVER_MOVE) {

		...
	    if (newTouchTarget == null && childrenCount != 0) {
	        ...
	        for (int i = childrenCount - 1; i >= 0; i--) {
	            ...
	
	            // 優化尋找(下):直接找到能接受該焦點的子 View
	            if (childWithAccessibilityFocus != null) {
	                if (childWithAccessibilityFocus != child) {
	                    continue;
	                }
	                ...
	            }
	
	            // 不能接受事件:正在播放動畫,或焦點不在子 View 的區域內
	            if (!canViewReceivePointerEvents(child)
	                    || !isTransformedTouchPointInView(x, y, child, null)) {
	                ev.setTargetAccessibilityFocus(false);
	                continue;
	            }

	            // 尋找方式一:直接從 mFirstTouchTarget 連結串列中找到可消費該事件的子 View
	            newTouchTarget = getTouchTarget(child);
	            if (newTouchTarget != null) {
	                ...
	                break;
	            }
	
	            // 尋找方式二:事件被子 View 消費
	            resetCancelNextUpFlag(child);
	            if (dispatchTransformedTouchEvent(ev, false, child, idBitsToAssign)) {
	                ...
	                break;
	            }
	            ...
	        }
	        if (preorderedList != null) preorderedList.clear();
	    }
		...
    }
}
複製程式碼

dispatchTouchEvent:子 View 不能接受事件判定

注意:對於同一系列事件(DOWN、MOVE、UP):只有 ACTION_DOWN 才能遍歷所有子 View,其他事件不會遍歷

自行閱讀相關方法:

  • canViewReceivePointerEvents == true:正在播放動畫
  • isTransformedTouchPointInView == true:焦點不在子 View 的區域內
for (int i = childrenCount - 1; i >= 0; i--) {
	...
	if (!canViewReceivePointerEvents(child)
	        || !isTransformedTouchPointInView(x, y, child, null)) {
	    ev.setTargetAccessibilityFocus(false);
	    continue;
	}
	...
}
複製程式碼
/**
 * Returns true if a child view can receive pointer events.
 * @hide
 */
private static boolean canViewReceivePointerEvents(@NonNull View child) {
    return (child.mViewFlags & VISIBILITY_MASK) == VISIBLE
            || child.getAnimation() != null;
}
複製程式碼
/**
 * Returns true if a child view contains the specified point when transformed
 * into its coordinate space.
 * Child must not be null.
 * @hide
 */
protected boolean isTransformedTouchPointInView(float x, float y, View child, PointF outLocalPoint) {
    ...
}
複製程式碼

dispatchTouchEvent:尋找方式一:直接從連結串列中找到可消費該事件的子 View

注意:對於同一系列事件(DOWN、MOVE、UP):只有 ACTION_DOWN 才能遍歷所有子 View,其他事件不會遍歷

如下原始碼可知:可以直接從 mFirstTouchTarget 連結串列中找到可消費該事件的子 View,並跳出迴圈

for (int i = childrenCount - 1; i >= 0; i--) {
	...
	newTouchTarget = getTouchTarget(child);
	if (newTouchTarget != null) {
	    // Child is already receiving touch within its bounds.
	    // Give it the new pointer in addition to the ones it is handling.
	    newTouchTarget.pointerIdBits |= idBitsToAssign;
	    break;
	}
	...
}
}
複製程式碼
/**
 * Gets the touch target for specified child view.
 * Returns null if not found.
 */
private TouchTarget getTouchTarget(@NonNull View child) {
    for (TouchTarget target = mFirstTouchTarget; target != null; target = target.next) {
        if (target.child == child) {
            return target;
        }
    }
    return null;
}
複製程式碼

dispatchTouchEvent:尋找方式二:事件被子 View 消費(DOWN 事件)

注意:對於同一系列事件(DOWN、MOVE、UP):只有 ACTION_DOWN 才能遍歷所有子 View,其他事件不會遍歷

原始碼講解:

  • dispatchTransformedTouchEvent:實際就是呼叫子 View 的 dispatchTouchEvent 方法
  • 事件被子 View 消費後,跳出迴圈
  • addTouchTarget 將當前子 View 追加到 mFirstTouchTarget 連結串列的頭部,注意一開始 mFirstTouchTarget == null

該部分原始碼證明上述攔截判定模組的

  • 第2點
  • 第8點部分證明

該部分原始碼證明上述子 View 消費事件章節的

  • 第13點
  • 第14點
for (int i = childrenCount - 1; i >= 0; i--) {
	...
    if (dispatchTransformedTouchEvent(ev, false, child, idBitsToAssign)) {
        ...
        newTouchTarget = addTouchTarget(child, idBitsToAssign);
        alreadyDispatchedToNewTouchTarget = true;
        break;
    }
	...
}

複製程式碼
/**
 * Transforms a motion event into the coordinate space of a particular child view,
 * filters out irrelevant pointer ids, and overrides its action if necessary.
 * If child is null, assumes the MotionEvent will be sent to this ViewGroup instead.
 */
private boolean dispatchTransformedTouchEvent(MotionEvent event, boolean cancel, View child, int desiredPointerIdBits) {
    ...
    if (child == null) {
        handled = super.dispatchTouchEvent(event);
    } else {
        ...
        handled = child.dispatchTouchEvent(event);
		...
    }
    return handled;
}
複製程式碼
/**
 * Adds a touch target for specified child to the beginning of the list.
 * Assumes the target child is not already present.
 */
private TouchTarget addTouchTarget(@NonNull View child, int pointerIdBits) {
    final TouchTarget target = TouchTarget.obtain(child, pointerIdBits);
    target.next = mFirstTouchTarget;
    mFirstTouchTarget = target;
    return target;
}
複製程式碼

同一系列事件分發簡述

對簡單 ViewGroup 而言

ACTION_DOWN 事件:

  1. 遍歷子 View,事件被某個子 View 消費,將該子 View 存入連結串列中
  2. 遍歷子 View,所有子 View 都沒有消費,則連結串列為空,然後事件被 ViewGroup 消費
  3. 子 View 和 ViewGroup 都沒有消費

ACTION_MOVE 事件(與上述一一對應):

  1. 不再遍歷子 View,直接從連結串列中查詢子 View,讓連結串列中儲存的子 View 消費事件
  2. 不再遍歷子 View,因為連結串列為空,所以直接由 ViewGroup 嘗試消費
  3. 同上

ACTION_UP 事件(與上述一一對應):

  1. 同 ACTION_MOVE 事件
  2. 同 ACTION_MOVE 事件
  3. 同 ACTION_MOVE 事件

對於複雜 ViewGroup 而言(比如 RecyclerView),ACTION_DOWN 事件被子 View 消費後,ACTION_MOVE 時會根據情況將連結串列清空。這樣子 View 即不影響子 View 的點選事件,也不影響自身的滑動

六、滑動衝突

延期,待補充吧

requestDisallowInterceptTouchEvent:修改 mGroupFlags

結論:

  • disallowIntercept == true:不允許 ViewGroup 直接攔截事件,必須先遍歷子 View。
  • disallowIntercept == false:mGroupFlags 修改為預設值
@Override
public void requestDisallowInterceptTouchEvent(boolean disallowIntercept) {
    if (disallowIntercept == ((mGroupFlags & FLAG_DISALLOW_INTERCEPT) != 0)) {
        // We're already in this state, assume our ancestors are too
        return;
    }

    if (disallowIntercept) {
        mGroupFlags |= FLAG_DISALLOW_INTERCEPT;
    } else {
        mGroupFlags &= ~FLAG_DISALLOW_INTERCEPT;
    }

    // Pass it up to our parent
    if (mParent != null) {
        mParent.requestDisallowInterceptTouchEvent(disallowIntercept);
    }
}
複製程式碼

參考

  • 《Android 開發藝術探索》(任玉剛 著) 第三章 View 的事件體系
  • Android 26 原始碼(主要)

版本

  • 2017-12-17:未完成版本
  • 2017-12-23:完成對事件分發機制的說明
  • ???:完成對滑動衝突的說明

宣告

限於作者水平有限,出錯難免,請積極拍磚! 歡迎任何形式的轉載,轉載請保留本文原文連結:juejin.im/post/5c1764…

結言

斷斷續續的把這篇部落格一點點補全,感覺還是挺尷尬的,不過目前整體已經搞定了,剩下的邊邊角角,有時間再補充吧,捂臉。

相關文章