NestedScrollingParent

简称

         NestedScrollView——NSV

        NestedScrollingParent——NSP

        NestedScrollingChild——NSC

        NestedScrollingChildHelper——NSCH

        NestedScrollingParentHelper——NSPH

总体过程

        事件的触发点在于NSC对Touch事件的处理，而NSC通过调用NSCH中相应方法，最终调用到NSP中对应的方法。而NSP中的方法通过返回值影响着NSC的操作。

常用方法

        onStartNestedScroll(View child, View target, int nestedScrollAxes)：用于判断当前View是否接收嵌套滚动，返回为true的话，则表示该View接收嵌套滚动——并对嵌套滚动进行处理。target：当前触摸在的View；child：target的父类，并且是接收嵌套滚动View的直接子类，nestedScrollAxes：滚动方向。
        onNestedScrollAccepted(View child, View target, int nestedScrollAxes)：当开始嵌套滚动时的回调。参数同上。

        以NestedScrollView源码分析上面两个方法的调用。

       在NSV的onInterceptTouchEvent()中，当发生ACTION_MOVE时，会调用startNestedScroll——该方法是NestedScrollingChild接口中的回调——而该方法的实现就是调用NestedScrollingChildHelper#startNestedScroll(int)中，其源码如下：

     public boolean startNestedScroll(int axes) {
        if (hasNestedScrollingParent()) {
            // Already in progress
            return true;
        }
        if (isNestedScrollingEnabled()) {
            ViewParent p = mView.getParent();
            View child = mView;
            while (p != null) {
                if (ViewParentCompat.onStartNestedScroll(p, child, mView, axes)) {//回调p中的onStartNestedScroll
                    mNestedScrollingParent = p;
                    ViewParentCompat.onNestedScrollAccepted(p, child, mView, axes);//回调p中的onNestedScrollAccepted
                    return true;
                }
                if (p instanceof View) {
                    child = (View) p;
                }
                p = p.getParent();
            }
        }
        return false;
     }

        上述代码中的p必须实现NestedScrollingParent，而且也可以看出：只要target的最内层NestedScrollingParent没有接收(返回false)该嵌套滚动，则target永远不会有机会处理嵌套滚动。例如：

<com.example.hufeng.demo.DemoView xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:padding="16dp">

    <RelativeLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent">

        <LinearLayout
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:orientation="vertical">

            <TextView
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:text="@string/nested_scroll_long_text"
                android:textAppearance="?android:attr/textAppearance" />

            <com.example.hufeng.demo.DemoView
                android:id="@+id/text"
                android:layout_width="match_parent"
                android:layout_height="200dp"
                android:padding="16dp">

                <TextView
                    android:layout_width="match_parent"
                    android:layout_height="wrap_content"
                    android:text="@string/nested_scroll_long_text"
                    android:textAppearance="?android:attr/textAppearance" />
            </com.example.hufeng.demo.DemoView>

            <TextView
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:text="@string/nested_scroll_long_text"
                android:textAppearance="?android:attr/textAppearance" />
        </LinearLayout>
    </RelativeLayout>
</com.example.hufeng.demo.DemoView>

        该布局中，若触摸在内层的DemoView(继承于NestedScrollView)上，则外层DemoView的onStartNestedScroll会执行，并且其中的target为内层的DemoView，child为RelativeLayout。

        onNestedPreScroll(View target, int dx, int dy, int[] consumed)：当手指发生滑动时进行的预处理，此时界面展示上并没有进行滑动。target：与上两个方法中的target含义一样；dx与dy表示水平、垂直滑动的距离；consumed表示消费掉的dx与dy——它是一个二维int类型数组，0表示dx，1表示dy。

        该方法是在target中触发，但最终会回调到父类中的该方法。如上面的布局中，触发点在内层的DemoView#onTouchEvent()中，通过一系列的转换最终会回调到外层DemoView的onNestedPreScroll方法。以ＮestedScrollView为例，其onTouchEvent中，当ACTION_MOVE时，有如下代码：

                final int activePointerIndex = ev.findPointerIndex(mActivePointerId);
                if (activePointerIndex == -1) {
                    Log.e(TAG, "Invalid pointerId=" + mActivePointerId + " in onTouchEvent");
                    break;
                }

                final int y = (int) ev.getY(activePointerIndex);
                int deltaY = mLastMotionY - y;
                if (dispatchNestedPreScroll(0, deltaY, mScrollConsumed, mScrollOffset)) {//会回调到onNestedPreScroll，且在回调之前会将consumed的两个元素全设置为0
                    deltaY -= mScrollConsumed[1];
                    vtev.offsetLocation(0, mScrollOffset[1]);
                    mNestedYOffset += mScrollOffset[1];
                }

        而且可以看出，dy为正表示上滑，dy为负表示下滑。

        consume最终会影响deltaY的值，而deltaY最终会影响scrollTo()方法中的y值——也就是影响target最终滚动到的位置——可参见overScrollByCompat()与onOverScrolled()方法，因此consume表示本次滑动中有多少滑动距离被消费掉，可以通过该参数控制target的移动方向以及移动大小。

        onNestedScroll(View target, int dxConsumed, int dyConsumed, int dxUnconsumed, int dyUnconsumed)：其参数来源也是在NestScrollView的onTouchEvent()中。如下：

 final int scrolledDeltaY = getScrollY() - oldY;//此时已经调用了target的scrollTo，而oldY是调用scrollTo之前的getScrollY()的返回值
                    final int unconsumedY = deltaY - scrolledDeltaY;
                    if (dispatchNestedScroll(0, scrolledDeltaY, 0, unconsumedY, mScrollOffset)) {

        通过第一行中看出dyConsumed表示target在本次触摸中一共移动的距离，如果未到界，其值就是上一个方法中dy-consumed[1]的值，如果已到边界，则其值为0——因为移动不了。

        通过第二行可以看出dxUnconsumed表示本次触摸事件中，target未消耗的距离。若未到边界，则该值为0，因为target全部消耗了；若已到边界，则该值为dy-consumed[1]因为target一点也未消耗；若在移动的过程中到达边界，则其值为dy-consumed[1]-dyConsumed。

        onNestedPreFling(View target, float velocityX, float velocityY)：参数略。以NestedScrollView源码分析其返回值作用：

    private void flingWithNestedDispatch(int velocityY) {
        final int scrollY = getScrollY();
        final boolean canFling = (scrollY > 0 || velocityY > 0)
                && (scrollY < getScrollRange() || velocityY < 0);
        if (!dispatchNestedPreFling(0, velocityY)) {//该方法最终会调用到target的最接近的并且实现的NestedScrollParent接口的父View的onNestedPreFling()
            dispatchNestedFling(0, velocityY, canFling);//会调用到parent的onNestedFling()
            if (canFling) {
                fling(velocityY);//该方法中target会进行fling操作
            }
        }
}

        从中可以看出，如果父View的onNestedPreFling返回true，则target不会执行fling操作，同时也不会执行自己的onNestedFling()方法。返回值表示parent是否已经处理完毕该fling操作——无论parent有无进行实际上的fling操作，只要返回true都代表它已经消费完整个fling操作。

        该方法的触发时机在parent的onTouchEvent()中发生ACTION_UP时调用。

        onNestedFling(View target, float velocityX, float velocityY, boolean consumed)：返回值没啥用处。最后一个参数表示target是否可以进行fling操作。

        onStopNestedScroll(View target)：在View的dispatchTouchEvent()中会调用stopNestedScroll()方法，而NestedScrollView重写了该方法，它最终会调用到parent的onStopNestedScroll中。