一、概述
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