谷歌的下拉刷新,新的界面效果
SwipeRefreshLayout 是一个下拉刷新控件,几乎可以包裹一个任何可以滚动的内容(ListView GridView ScrollView RecyclerView),可以自动识别垂直滚动手势。使用起来非常方便。
1.将需要下拉刷新的空间包裹起来
2.设置刷新动画的触发回调
…通过 setRefreshing(false) 和 setRefreshing(true) 来手动调用刷新的动画。
onRefresh的回调只有在手势下拉的情况下才会触发,通过setRefreshing只能调用刷新的动画是否显示。 SwipeRefreshLayout 也可放在 CoordinatorLayout 内共同处理滑动冲突,有兴趣可以尝试。
本文基于 v4 版本
23.2.0
extends ViewGroup implements NestedScrollingParent NestedScrollingChild
java.lang.Object
↳ android.view.View
↳ android.view.ViewGroup
↳ android.support.v4.widget.SwipeRefreshLayoutSwipeRefreshLayout 的分析分为两个部分:自定义 ViewGroup 的部分,处理和子视图的嵌套滚动部分。
其实就是一个自定义的 ViewGroup ,结合我们自己平时自定义 ViewGroup 的步骤:
dispatchTouchEvent onInterceptTouchEvent onTouchEvent)接下来就按照上面的步骤进行分析。
SwipeRefreshLayout 内部有 2 个 View,一个圆圈(mCircleView),一个内部可滚动的 View(mTarget)。除了 View,还包含一个 OnRefreshListener 接口,当刷新动画被触发时回调。
…// 创建刷新动画的圆圈
private void createProgressView() {
mCircleView = new CircleImageView(getContext(), CIRCLE_BG_LIGHT, CIRCLE_DIAMETER/2);
mProgress = new MaterialProgressDrawable(getContext(), this);
mProgress.setBackgroundColor(CIRCLE_BG_LIGHT);
mCircleView.setImageDrawable(mProgress);
mCircleView.setVisibility(View.GONE);
addView(mCircleView);
}初始化的时候创建一个出来一个 View (下拉刷新的圆圈)。可以看出使用背景圆圈是 v4 包里提供的 CircleImageView 控件,中间的是 MaterialProgressDrawable 进度条。
另一个 View 是在 xml 中包含的可滚动视图。
onMeasure 确定子视图的大小。
…java
/**
当你希望自己的自定义布局支持嵌套子视图并且处理滚动操作,就可以实现该接口。
实现这个接口后可以创建一个 NestedScrollingParentHelper 字段,使用它来帮助你处理大部分的方法。
处理嵌套的滚动时应该使用 ViewCompat,ViewGroupCompat或ViewParentCompat 中的方法来处理,这是一些兼容库,
他们保证 Android 5.0之前的兼容性垫片的静态方法,这样可以兼容 Android 5.0 之前的版本。
/
public interface NestedScrollingParent {
/*
* 当子视图调用 startNestedScroll(View, int) 后调用该方法。返回 true 表示响应子视图的滚动。
* 实现这个方法来声明支持嵌套滚动,如果返回 true,那么这个视图将要配合子视图嵌套滚动。当嵌套滚动结束时会调用到 onStopNestedScroll(View)。
*
* @param child 可滚动的子视图
* @param target NestedScrollingParent 的直接可滚动的视图,一般情况就是 child
* @param nestedScrollAxes 包含 ViewCompat#SCROLL_AXIS_HORIZONTAL, ViewCompat#SCROLL_AXIS_VERTICAL 或者两个值都有。
* @return 返回 true 表示响应子视图的滚动。
*/
public boolean onStartNestedScroll(View child, View target, int nestedScrollAxes);
/**
* 如果 onStartNestedScroll 返回 true ,然后走该方法,这个方法里可以做一些初始化。
*/
public void onNestedScrollAccepted(View child, View target, int nestedScrollAxes);
/**
* 子视图开始滚动前会调用这个方法。这时候父布局(也就是当前的 NestedScrollingParent 的实现类)可以通过这个方法来配合子视图同时处理滚动事件。
*
* @param target 滚动的子视图
* @param dx 绝对值为手指在x方向滚动的距离,dx 0 表示手指在屏幕向上移动
// mTotalUnconsumed 表示子视图Y轴未消费的距离
// 现在表示
if (dy > 0 && mTotalUnconsumed > 0) {
if (dy > mTotalUnconsumed) {
consumed[1] = dy - (int) mTotalUnconsumed; // SwipeRefreshLayout 就吧子视图位消费的距离全部消费了。
mTotalUnconsumed = 0;
} else {
mTotalUnconsumed -= dy; // 消费的 y 轴的距离
consumed[1] = dy;
}
// 出现动画圆圈,并向上移动
moveSpinner(mTotalUnconsumed);
}
// ... 省略代码
}
// onStartNestedScroll 返回 true 才会调用此方法。此方法表示子View将滚动事件分发到父 View(SwipeRefreshLayout) @Override public void onNestedScroll(final View target, final int dxConsumed, final int dyConsumed, final int dxUnconsumed, final int dyUnconsumed) { // ... 省略代码
// This is a bit of a hack. Nested scrolling works from the bottom up, and as we are
// sometimes between two nested scrolling views, we need a way to be able to know when any
// nested scrolling parent has stopped handling events. We do that by using the
// 'offset in window 'functionality to see if we have been moved from the event.
// This is a decent indication of whether we should take over the event stream or not.
// 手指在屏幕上向下滚动,并且子视图不可以滚动
final int dy = dyUnconsumed + mParentOffsetInWindow[1];
if (dy mTouchSlop && !mIsBeingDragged) {
mInitialMotionY = mInitialDownY + mTouchSlop;
mIsBeingDragged = true;
// 正在拖动状态,更新圆圈的 progressbar 的 alpha 值
mProgress.setAlpha(STARTING_PROGRESS_ALPHA);
}
break;
case MotionEventCompat.ACTION_POINTER_UP:
onSecondaryPointerUp(ev);
break;
case MotionEvent.ACTION_UP:
case MotionEvent.ACTION_CANCEL:
mIsBeingDragged = false;
mActivePointerId = INVALID_POINTER;
break;
}
return mIsBeingDragged;
}
可以看到源码也就是进行简单处理,DOWN 的时候记录一下位置,MOVE 时判断移动的距离,返回值 mIsBeingDragged 为 true 时, 即 onInterceptTouchEvent 返回true,SwipeRefreshLayout 拦截触摸事件,不分发给 mTarget,然后把 MotionEvent 传给 onTouchEvent 方法。其中有一个判断子View的是否还可以滚动的方法 `canChildScrollUp`。
```java
/**
* @return Whether it is possible for the child view of this layout to
* scroll up. Override this if the child view is a custom view.
*/
public boolean canChildScrollUp() {
if (android.os.Build.VERSION.SDK_INT 0
&& (absListView.getFirstVisiblePosition() > 0 || absListView.getChildAt(0)
.getTop() 0;
}
} else {
return ViewCompat.canScrollVertically(mTarget, -1);
}
}
当SwipeRefreshLayout 拦截了触摸事件之后( mIsBeingDragged 为 true ),将 MotionEvent 交给 onTouchEvent 处理。
@Override
public boolean onTouchEvent(MotionEvent ev) {
// ... 省略代码
switch (action) {
case MotionEvent.ACTION_DOWN:
// 获取第一个按下的手指
mActivePointerId = MotionEventCompat.getPointerId(ev, 0);
mIsBeingDragged = false;
break;
case MotionEvent.ACTION_MOVE: {
// 处理多指触控
pointerIndex = MotionEventCompat.findPointerIndex(ev, mActivePointerId);
// ... 省略代码
final float y = MotionEventCompat.getY(ev, pointerIndex);
final float overscrollTop = (y - mInitialMotionY) * DRAG_RATE;
if (mIsBeingDragged) {
if (overscrollTop > 0) {
// 正在拖动状态,更新圆圈的位置
moveSpinner(overscrollTop);
} else {
return false;
}
}
break;
}
// ... 省略代码
case MotionEvent.ACTION_UP: {
pointerIndex = MotionEventCompat.findPointerIndex(ev, mActivePointerId);
if (pointerIndex STARTING_PROGRESS_ALPHA
&& !isAnimationRunning(mAlphaStartAnimation)) {
// Animate the alpha
startProgressAlphaStartAnimation();
}
} else {
if (mProgress.getAlpha() mTotalDragDistance) {
//移动距离超过了刷新的临界值,触发刷新动画
setRefreshing(true, true /* notify */);
} else {
// 取消刷新的圆圈,将圆圈移动到初始位置
mRefreshing = false;
mProgress.setStartEndTrim(0f, 0f);
// ...省略代码
// 移动到初始位置
animateOffsetToStartPosition(mCurrentTargetOffsetTop, listener);
// 设置没有箭头
mProgress.showArrow(false)
}
}
可以看到调用 setRefresh(true,true) 方法触发刷新动画并进行回调,但是这个方法是 private 的。前面提到我们自己调用 setRefresh(true) 只能产生动画,而不能回调刷新函数,那么我们就可以用反射调用 2 个参数的 setRefresh 函数。 或者手动调 setRefreshing(true)+ OnRefreshListener.onRefresh 方法。
/**
* 改变刷新动画的的圆圈刷新状态。Notify the widget that refresh state has changed. Do not call this when
* refresh is triggered by a swipe gesture.
*
* @param refreshing 是否显示刷新的圆圈
*/
public void setRefreshing(boolean refreshing) {
if (refreshing && mRefreshing != refreshing) {
// scale and show
mRefreshing = refreshing;
int endTarget = 0;
if (!mUsingCustomStart) {
endTarget = (int) (mSpinnerFinalOffset + mOriginalOffsetTop);
} else {
endTarget = (int) mSpinnerFinalOffset;
}
setTargetOffsetTopAndBottom(endTarget - mCurrentTargetOffsetTop,
true /* requires update */);
mNotify = false;
startScaleUpAnimation(mRefreshListener);
} else {
setRefreshing(refreshing, false /* notify */);
}
}startScaleUpAnimation 开启一个动画,然后在动画结束后回调 onRefresh 方法。
private Animation.AnimationListener mRefreshListener = new Animation.AnimationListener() {
// .. 省略代码
@Override
public void onAnimationEnd(Animation animation) {
if (mRefreshing) {
mProgress.setAlpha(MAX_ALPHA); //确保刷新圆圈中间的进度条是完全不透明了
mProgress.start();
if (mNotify) { // 当 mNotify 为 true 时才会回调 onRefresh
if (mListener != null) {
// 回调 listener 的 onRefresh 方法
mListener.onRefresh();
}
}
mCurrentTargetOffsetTop = mCircleView.getTop();
} else {
reset();
}
}
};分析 SwipeRefreshLayout 的流程就是按照平时我们自定义 ViewGroup 的流程,但是其中也有好多需要我们借鉴的地方,如何使用 NestedScrolling相关机制 ,多点触控的处理,onMeasure 中减去了 padding,如何判断子 View 是否可滚动,如何确定 ViewGroup 中某一个 View 的索引等。
此外,一个好的下拉刷新框架不仅仅要兼容各种滚动的子控件,还要考虑自己要兼容 NestedScrollingChild 的情况,比如放到 CooCoordinatorLayout 的情况,目前大多数开源的下拉刷新好像都没有达到这个要求,一般都是只考虑了内部嵌套滚动子视图的情况,没有考虑自己作为滚动子视图的情况。
No open issues yet, or sync has not completed.