Android NestedScrolling嵌套滚动的示例代码

2023-09-12 02:46:05 340

一、什么是NestedScrolling?

Android在Lollipop版本中引入了NestedScrolling——嵌套滚动机制。在Android的事件处理机制中，事件序列只能由父View和子View中的一个处理。在嵌套滚动机制中，子View处理事件前会将事件传给父View处理，两者协作配合处理事件。

在嵌套滚动机制中，父View需实现NestedScrollingParent接口，子View需要实现NestedScrollingChild接口。从Lollipop起View都已经实现了NestedScrollingChild的方法。嵌套滚动过程如下：

开始滚动前，子View调用startNestedScroll方法。该方法会调用父View的onStartNestedScroll方法并返回onStartNestedScroll的值。如果返回true，则表示父View愿意接收后续的滚动事件，此时父View的onNestedScrollAccepted会被调用。该方法一般是在子View处理DOWN事件时调用。
子View滚动某个距离前，调用dispatchNestedPreScroll方法，把滚动距离传给父View。该方法回调父View的onNestedPreScroll方法，如果父View需要消耗滚动距离，只需要把需要消耗的距离赋给onNestedPreScroll方法的参数consumed。该参数是一个数组，consumed[0]表示消耗的水平滚动距离，consumed[1]表示消耗的垂直滚动距离。dispatchNestedPreScroll返回true则表示父View消耗了部分或者全部滚动距离。
子View滚动某个距离后，调用dispatchNestedScroll方法。如果该方法返回true则表示，子View会调用父View的onNestedScroll方法，把已消耗和未消耗的滚动距离传给父View。
子View处理Fling事件前，调用dispatchNestedPreFling方法。该方法会调用父View的onNestedPreFling并返回onNestedPreFling的值。如果true，则表示父View处理消耗了该Fling事件，则子View不应该处理该Fling事件。
如果dispatchNestedPreFling方法返回false，子View在处理Fling事件后会调用dispatchNestedFling方法，该方法会调用父View的onNestedFling方法。onNestedFling方法返回true表示父View消耗或处理了Fling事件。
当子View停止滚动时，调用stopNestedScroll方法。该方法会调用父View的onStopNestedScroll方法。

上面提及的各个方法的具体用法请参考官方文档。

二、怎么实现NestedScrollingChild?

Android为NestedScrollingChild提供了一个代理类NestedScrollingChildHelper。所以，NestedScrollingChild的最简单的实现如下。

publicclassNestedScrollingChildViewextendsFrameLayoutimplementsNestedScrollingChild{

privatefinalNestedScrollingChildHelpermChildHelper;

publicNestedScrollView(Contextcontext,AttributeSetattrs,intdefStyleAttr){
super(context,attrs,defStyleAttr);
mChildHelper=newNestedScrollingChildHelper(this);
}

@Override
publicvoidsetNestedScrollingEnabled(booleanenabled){
mChildHelper.setNestedScrollingEnabled(enabled);
}

@Override
publicbooleanisNestedScrollingEnabled(){
returnmChildHelper.isNestedScrollingEnabled();
}

@Override
publicbooleanstartNestedScroll(intaxes){
returnmChildHelper.startNestedScroll(axes);
}

@Override
publicvoidstopNestedScroll(){
mChildHelper.stopNestedScroll();
}

@Override
publicbooleanhasNestedScrollingParent(){
returnmChildHelper.hasNestedScrollingParent();
}

@Override
publicbooleandispatchNestedScroll(intdxConsumed,intdyConsumed,intdxUnconsumed,
intdyUnconsumed,int[]offsetInWindow){
returnmChildHelper.dispatchNestedScroll(dxConsumed,dyConsumed,dxUnconsumed,dyUnconsumed,
offsetInWindow);
}

@Override
publicbooleandispatchNestedPreScroll(intdx,intdy,int[]consumed,int[]offsetInWindow){
returnmChildHelper.dispatchNestedPreScroll(dx,dy,consumed,offsetInWindow);
}

@Override
publicbooleandispatchNestedFling(floatvelocityX,floatvelocityY,booleanconsumed){
returnmChildHelper.dispatchNestedFling(velocityX,velocityY,consumed);
}

@Override
publicbooleandispatchNestedPreFling(floatvelocityX,floatvelocityY){
returnmChildHelper.dispatchNestedPreFling(velocityX,velocityY);
}
}

然后，在适当的时机调用如下方法：
1.startNestedScroll
2.dispatchNestedPreScroll
3.dispatchNestedScroll
4.dispatchNestedPreFling
5.dispatchNestedFling
6.stopNestedScroll

三、怎么实现NestedScrollingParent?

Android为NestedScrollingParent提供了一个代理类NestedScrollingParentHelper。NestedScrollingParent的最简单实现如下。

publicclassNestedScrollViewextendsFrameLayoutimplementsNestedScrollingParent{
privatefinalNestedScrollingParentHelpermParentHelper;

publicNestedScrollView(Contextcontext,AttributeSetattrs,intdefStyleAttr){
super(context,attrs,defStyleAttr);
mParentHelper=newNestedScrollingParentHelper(this);
}

@Override
publicbooleanonStartNestedScroll(Viewchild,Viewtarget,intnestedScrollAxes){
...
return(nestedScrollAxes&ViewCompat.SCROLL_AXIS_VERTICAL)!=0;
}

@Override
publicvoidonNestedScrollAccepted(Viewchild,Viewtarget,intaxes){
mParentHelper.onNestedScrollAccepted(child,target,axes);
...
}

@Override
publicvoidonNestedPreScroll(Viewtarget,intdx,intdy,int[]consumed){
...
}

@Override
publicvoidonNestedScroll(Viewtarget,intdxConsumed,intdyConsumed,intdxUnconsumed,intdyUnconsumed){
...
}

@Override
publicbooleanonNestedPreFling(Viewtarget,floatvelocityX,floatvelocityY){
...
returnfalse;
}

@Override
publicbooleanonNestedFling(Viewtarget,floatvelocityX,floatvelocityY,booleanconsumed){
...
returnfalse;
}

@Override
publicvoidonStopNestedScroll(Viewchild){
mParentHelper.onStopNestedScroll(child);
}

@Override
publicintgetNestedScrollAxes(){
returnmParentHelper.getNestedScrollAxes();
}
}

四、NestedScrollingChildHelper的代码分析

publicbooleanstartNestedScroll(intaxes){
if(hasNestedScrollingParent()){
//Alreadyinprogress
returntrue;
}
if(isNestedScrollingEnabled()){
ViewParentp=mView.getParent();
Viewchild=mView;
while(p!=null){
if(ViewParentCompat.onStartNestedScroll(p,child,mView,axes)){
mNestedScrollingParent=p;
ViewParentCompat.onNestedScrollAccepted(p,child,mView,axes);
returntrue;
}
if(pinstanceofView){
child=(View)p;
}
p=p.getParent();
}
}
returnfalse;
}

startNestedScroll方法从NestedScrollingChild向上查找愿意接收嵌套滚动事件的父View，如果找到了则调用父View的onNestedScrollAccepted方法。ViewParentCompat是父View的兼容类，该类会判断版本，如果在Lollipop及以上则调用View自带的方法。否则，调用NestedScrollingParent的接口方法。

publicbooleandispatchNestedPreScroll(intdx,intdy,int[]consumed,int[]offsetInWindow){
if(isNestedScrollingEnabled()&&mNestedScrollingParent!=null){
if(dx!=0||dy!=0){
intstartX=0;
intstartY=0;
if(offsetInWindow!=null){
mView.getLocationInWindow(offsetInWindow);
startX=offsetInWindow[0];
startY=offsetInWindow[1];
}

if(consumed==null){
if(mTempNestedScrollConsumed==null){
mTempNestedScrollConsumed=newint[2];
}
consumed=mTempNestedScrollConsumed;
}
consumed[0]=0;
consumed[1]=0;
ViewParentCompat.onNestedPreScroll(mNestedScrollingParent,mView,dx,dy,consumed);

if(offsetInWindow!=null){
mView.getLocationInWindow(offsetInWindow);
offsetInWindow[0]-=startX;
offsetInWindow[1]-=startY;
}
returnconsumed[0]!=0||consumed[1]!=0;
}elseif(offsetInWindow!=null){
offsetInWindow[0]=0;
offsetInWindow[1]=0;
}
}
returnfalse;
}

调用父View的onNestedPreScroll方法并记录滚动偏移量。参数offsetInWindow是一个长度为2的一位数组，记录滚动的偏移量，用来修改Touch事件的坐标，保证下次滚动的准确性。dispatchNestedScroll方法也同理。

五、举个例子

实现一个简单的NestedScrollingParent。该View包含一个头部View和RecyclerView。RecyclerView已经实现了NestedScrollingChild接口方法。向上滚动时，如果头部没有完全收起，则向上滚动头部。如果头部收起才滚动RecyclerView。向下滚动时，如果头部收起，则向下滚动头部，否则滚动RecyclerView。

publicclassHeaderLayoutextendsLinearLayoutimplementsNestedScrollingParent{

privateNestedScrollingParentHelpermParentHelper;

privateintheaderH;

privateScrollerCompatmScroller;

privatebooleanresetH=false;

publicHeaderLayout(Contextcontext){
this(context,null);
}

publicHeaderLayout(Contextcontext,AttributeSetattrs){
this(context,attrs,0);
}

publicHeaderLayout(Contextcontext,AttributeSetattrs,intdefStyleAttr){
super(context,attrs,defStyleAttr);

mParentHelper=newNestedScrollingParentHelper(this);
mScroller=ScrollerCompat.create(this.getContext());
}

@Override
protectedvoidonMeasure(intwidthMeasureSpec,intheightMeasureSpec){
super.onMeasure(widthMeasureSpec,heightMeasureSpec);

headerH=getChildAt(0).getMeasuredHeight();
}

@Override
publicbooleanonStartNestedScroll(Viewchild,Viewtarget,intnestedScrollAxes){
return(nestedScrollAxes&ViewCompat.SCROLL_AXIS_VERTICAL)!=0;
}

@Override
publicvoidonNestedScrollAccepted(Viewchild,Viewtarget,intaxes){
mParentHelper.onNestedScrollAccepted(child,target,axes);
}

@Override
publicvoidonNestedPreScroll(Viewtarget,intdx,intdy,int[]consumed){
intscrollY=getScrollY();
if(dy>0&&scrollY=0){
intconsumedY=Math.min(dy,headerH-scrollY);
consumed[1]=consumedY;
scrollBy(0,consumedY);

if(!resetH){
resetH=true;
intw=getWidth();
inth=getHeight()+headerH;
setLayoutParams(newFrameLayout.LayoutParams(w,h));
}
}elseif(dy<0&&scrollY==headerH){
consumed[1]=dy;
scrollBy(0,dy);
}elseif(dy<0&&scrollY0){
intconsumedY=Math.max(dy,-scrollY);
consumed[1]=consumedY;
scrollBy(0,consumedY);
}
}

@Override
publicvoidonNestedScroll(Viewtarget,intdxConsumed,intdyConsumed,intdxUnconsumed,intdyUnconsumed){
}

@Override
publicbooleanonNestedPreFling(Viewtarget,floatvelocityX,floatvelocityY){
intscrollY=getScrollY();
if(velocityY>0&&scrollY0){
if(!mScroller.isFinished()){
mScroller.abortAnimation();
}
mScroller.fling(0,scrollY,(int)velocityX,(int)velocityY,0,0,0,headerH);
ViewCompat.postInvalidateOnAnimation(this);
returntrue;
}
returnfalse;
}

@Override
publicbooleanonNestedFling(Viewtarget,floatvelocityX,floatvelocityY,booleanconsumed){
returnfalse;
}

@Override
publicvoidonStopNestedScroll(Viewchild){
mParentHelper.onStopNestedScroll(child);
}

@Override
publicintgetNestedScrollAxes(){
returnmParentHelper.getNestedScrollAxes();
}

@Override
publicvoidcomputeScroll(){
if(mScroller.computeScrollOffset()){
scrollTo(mScroller.getCurrX(),mScroller.getCurrY());
postInvalidate();
}
}
}

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持毛票票。