Android NestedScrolling 子View与父View之间嵌套滑动

一、概述

Android在support.v4包中为大家提供了两个接口类：

• NestedScrollingParent

• NestedScrollingChild

这样的嵌套滑动机制是在 Android 发布 Lollipop 之后提供的。

要实现这两个接口，必需是ViewGroup的子类。

二、NestedScrollingChild

public interface NestedScrollingChild {  
  
    /** 
     * 设置嵌套滑动是否可用 
     * 
     * @param enabled 
     */  
    public void setNestedScrollingEnabled(boolean enabled);  
  
    /** 
     * 嵌套滑动是否可用 
     * 
     * @return 
     */  
    public boolean isNestedScrollingEnabled();  
  
    /** 
     * 开始嵌套滑动, 
     * 
     * @param axes 表示方向 有一下两种值 
     *             ViewCompat.SCROLL_AXIS_HORIZONTAL 横向哈东 
     *             ViewCompat.SCROLL_AXIS_VERTICAL 纵向滑动 
     */  
    public boolean startNestedScroll(int axes);  
  
    /** 
     * 停止嵌套滑动 
     */  
    public void stopNestedScroll();  
  
    /** 
     * 是否有父View 支持 嵌套滑动,  会一层层的网上寻找父View 
     * @return 
     */  
    public boolean hasNestedScrollingParent();  
  
    /** 
     * 在处理滑动之后 调用 
     * @param dxConsumed x轴上 被消费的距离 
     * @param dyConsumed y轴上 被消费的距离 
     * @param dxUnconsumed x轴上 未被消费的距离 
     * @param dyUnconsumed y轴上 未被消费的距离 
     * @param offsetInWindow view 的移动距离 
     * @return 
     */  
    public boolean dispatchNestedScroll(int dxConsumed, int dyConsumed,  
                                        int dxUnconsumed, int dyUnconsumed, int[] offsetInWindow);  
  
    /** 
     * 一般在滑动之前调用, 在ontouch 中计算出滑动距离, 然后 调用改 方法, 就给支持的嵌套的父View 处理滑动事件 
     * @param dx x 轴上滑动的距离, 相对于上一次事件, 不是相对于 down事件的 那个距离 
     * @param dy y 轴上滑动的距离 
     * @param consumed 一个数组, 可以传 一个空的 数组,  表示 x 方向 或 y 方向的事件 是否有被消费 
     * @param offsetInWindow   支持嵌套滑动到额父View 消费 滑动事件后 导致 本 View 的移动距离 
     * @return 支持的嵌套的父View 是否处理了 滑动事件 
     */  
    public boolean dispatchNestedPreScroll(int dx, int dy, int[] consumed, int[] offsetInWindow);  
  
    /** 
     * 
     * @param velocityX x 轴上的滑动速度 
     * @param velocityY y 轴上的滑动速度 
     * @param consumed 是否被消费 
     * @return 
     */  
    public boolean dispatchNestedFling(float velocityX, float velocityY, boolean consumed);  
  
    /** 
     * 
     * @param velocityX x 轴上的滑动速度 
     * @param velocityY y 轴上的滑动速度 
     * @return 
     */  
    public boolean dispatchNestedPreFling(float velocityX, float velocityY);  
}  

三、NestedScrollingChildHelper

这个类是一个辅助类,提供了一些方法给我们在实现NestedScrollingChild调用。

四、NestedScrollingParent

public interface NestedScrollingParent {
    /**
     * 在开始Scroll的时候调用，根据nestedScrollAxes进行判断，返回true还是false.
     */
    public boolean onStartNestedScroll(View child, View target, int nestedScrollAxes);

    /**
     * 在onStartNestedScroll返回true的时候调用
     */
    public void onNestedScrollAccepted(View child, View target, int nestedScrollAxes);

    /**
     * 在Scroll结束的时候调用
     */
    public void onStopNestedScroll(View target);

    /**
     * 在Scroll的过程中调用
     */
    public void onNestedScroll(View target, int dxConsumed, int dyConsumed,
            int dxUnconsumed, int dyUnconsumed);

    /**
     * 在target消费scroll之前调用，这个方法会传入内部view滑动的dx、dy，你需要设置消费掉的x和y的值consumed[0] 、consumed[1]
     */
    public void onNestedPreScroll(View target, int dx, int dy, int[] consumed);

    /**
     * 在fling(猛甩)的时候调用，返回true表示拦截掉fling事件。
     */
    public boolean onNestedFling(View target, float velocityX, float velocityY, boolean consumed);

    /**
     * 在target消费一个fling之前调用
     */
    public boolean onNestedPreFling(View target, float velocityX, float velocityY);

    /**
     * 返回当前NestedScrollingParent的scrolling的轴.
     */
    public int getNestedScrollAxes();
}

    /**
     * 在fling(猛甩)的时候调用，返回true表示拦截掉fling事件。
     */
    public boolean onNestedFling(View target, float velocityX, float velocityY, boolean consumed);

    /**
     * 在target消费一个fling之前调用
     */
    public boolean onNestedPreFling(View target, float velocityX, float velocityY);

    /**
     * 返回当前NestedScrollingParent的scrolling的轴.
     */
    public int getNestedScrollAxes();
}

五、NestedScrollingParentHelper

这个类是一个辅助类,提供了一些方法给我们在实现NestedScrollingParent调用。

 

六、Demo

https://github.com/suyimin/NestedScrolling