前言
下拉刷新组件在开发中使用率是非常高的,基本上联网的APP都会采用这种方式。对于开发效率而言,使用获得大家认可的开源库必然是效率最高的,但是不重复发明轮子的前提是你得自己知道轮子是怎么发明出来的,并且自己能够实现这些功能。否则只是知道其原理,并没有去实践那也就是纸上谈兵了。做程序猿,动手做才会遇到真正的问题,否则就只是自以为是的认为自己懂了。今天这篇文章就是以自己重复发明轮子这个出发点而来的,通过实现经典、使用率较高的组件来提高自己的认识。下面我们就一起来学习吧。
整体布局结构
图1 图2
该组件整体以竖直方向的LinearLayout为根视图,分别是Header、ContentView、Foooter, 从上到下依次排列下来,其中ContentView的宽高都为match_parent,footer和header的宽、高分别为match_parent、wrap_content,原始效果如图1;在Header、Foooter初始时都会通过设置padding隐藏掉,如图2中的Header设置paddingTop为负的Header的高度值,同理Footer也通过设置paddingBottom为Footer的负的Footer高度来达到隐藏的效果,所以只有 ContentView区域显示出来。当用户下拉到顶端,并且继续下拉时触发下拉刷新操作;当用户上拉到底部, 并且继续上拉时触发加载更多的操作。
原理都虽然简单,但是实现起来却也是会有很多小麻烦。这里没有采用通过设置onTouchListener的方法,因此使用这个方式在下拉的时候依然会出现ListView的最顶部的"HOLD"视图,不太爽。这种实现方法也蛮简单的,具体看郭神的博客Android下拉刷新完全解析,教你如何一分钟实现下拉刷新功能。
下拉刷新基本原理
- /*
- * 在适当的时候拦截触摸事件,这里指的适当的时候是当mContentView滑动到顶部,并且是下拉时拦截触摸事件,否则不拦截,交给其child
- * view 来处理。
- * @see
- * android.view.ViewGroup#onInterceptTouchEvent(android.view.MotionEvent)
- */
- @Override
- public boolean onInterceptTouchEvent(MotionEvent ev) {
- /*
- * This method JUST determines whether we want to intercept the motion.
- * If we return true, onTouchEvent will be called and we do the actual
- * scrolling there.
- */
- final int action = MotionEventCompat.getActionMasked(ev);
- // Always handle the case of the touch gesture being complete.
- if (action == MotionEvent.ACTION_CANCEL || action == MotionEvent.ACTION_UP) {
- // Do not intercept touch event, let the child handle it
- return false;
- }
- switch (action) {
- case MotionEvent.ACTION_DOWN:
- mYDown = (int) ev.getRawY();
- break;
- case MotionEvent.ACTION_MOVE:
- // int yDistance = (int) ev.getRawY() - mYDown;
- mYDistance = (int) ev.getRawY() - mYDown;
- showStatus(mCurrentStatus);
- Log.d(VIEW_LOG_TAG, "%%% isBottom : " + isBottom() + ", isTop : " + isTop()
- + ", mYDistance : " + mYDistance);
- // 如果拉到了顶部, 并且是下拉,则拦截触摸事件,从而转到onTouchEvent来处理下拉刷新事件
- if ((isTop() && mYDistance > 0)
- || (mYDistance > 0 && mCurrentStatus == STATUS_REFRESHING)) {
- return true;
- }
- break;
- }
- // Do not intercept touch event, let the child handle it
- return false;
- }
/*
* 在适当的时候拦截触摸事件,这里指的适当的时候是当mContentView滑动到顶部,并且是下拉时拦截触摸事件,否则不拦截,交给其child
* view 来处理。
* @see
* android.view.ViewGroup#onInterceptTouchEvent(android.view.MotionEvent)
*/
@Override
public boolean onInterceptTouchEvent(MotionEvent ev) {
/*
* This method JUST determines whether we want to intercept the motion.
* If we return true, onTouchEvent will be called and we do the actual
* scrolling there.
*/
final int action = MotionEventCompat.getActionMasked(ev);
// Always handle the case of the touch gesture being complete.
if (action == MotionEvent.ACTION_CANCEL || action == MotionEvent.ACTION_UP) {
// Do not intercept touch event, let the child handle it
return false;
}
switch (action) {
case MotionEvent.ACTION_DOWN:
mYDown = (int) ev.getRawY();
break;
case MotionEvent.ACTION_MOVE:
// int yDistance = (int) ev.getRawY() - mYDown;
mYDistance = (int) ev.getRawY() - mYDown;
showStatus(mCurrentStatus);
Log.d(VIEW_LOG_TAG, "%%% isBottom : " + isBottom() + ", isTop : " + isTop()
+ ", mYDistance : " + mYDistance);
// 如果拉到了顶部, 并且是下拉,则拦截触摸事件,从而转到onTouchEvent来处理下拉刷新事件
if ((isTop() && mYDistance > 0)
|| (mYDistance > 0 && mCurrentStatus == STATUS_REFRESHING)) {
return true;
}
break;
}
// Do not intercept touch event, let the child handle it
return false;
}
- /*
- * 在这里处理触摸事件以达到下拉刷新或者上拉自动加载的问题
- * @see android.view.View#onTouchEvent(android.view.MotionEvent)
- */
- @Override
- public boolean onTouchEvent(MotionEvent event) {
- Log.d(VIEW_LOG_TAG, "@@@ onTouchEvent : action = " + event.getAction());
- switch (event.getAction()) {
- case MotionEvent.ACTION_DOWN:
- mYDown = (int) event.getRawY();
- Log.d(VIEW_LOG_TAG, "#### ACTION_DOWN");
- break;
- case MotionEvent.ACTION_MOVE:
- Log.d(VIEW_LOG_TAG, "#### ACTION_MOVE");
- int currentY = (int) event.getRawY();
- mYDistance = currentY - mYDown;
- // 高度大于header view的高度才可以刷新
- if (mYDistance >= mTouchSlop) {
- if (mCurrentStatus != STATUS_REFRESHING) {
- //
- if (mHeaderView.getPaddingTop() > mHeaderViewHeight * 0.7f) {
- mCurrentStatus = STATUS_RELEASE_TO_REFRESH;
- mTipsTextView.setText(R.string.pull_to_refresh_release_label);
- } else {
- mCurrentStatus = STATUS_PULL_TO_REFRESH;
- mTipsTextView.setText(R.string.pull_to_refresh_pull_label);
- }
- }
- rotateHeaderArrow();
- int scaleHeight = (int) (mYDistance * 0.8f);// 去了滑动距离的80%,减小灵敏度而已
- // Y轴的滑动距离小于屏幕高度4分之一时才会拉伸header,反之保持不变
- if (scaleHeight <= mScrHeight / 4) {
- adjustHeaderPadding(scaleHeight);
- }
- }
- break;
- case MotionEvent.ACTION_UP:
- // 下拉刷新的具体操作
- doRefresh();
- break;
- default:
- break;
- }
- return true;
- }
/*
* 在这里处理触摸事件以达到下拉刷新或者上拉自动加载的问题
* @see android.view.View#onTouchEvent(android.view.MotionEvent)
*/
@Override
public boolean onTouchEvent(MotionEvent event) {
Log.d(VIEW_LOG_TAG, "@@@ onTouchEvent : action = " + event.getAction());
switch (event.getAction()) {
case MotionEvent.ACTION_DOWN:
mYDown = (int) event.getRawY();
Log.d(VIEW_LOG_TAG, "#### ACTION_DOWN");
break;
case MotionEvent.ACTION_MOVE:
Log.d(VIEW_LOG_TAG, "#### ACTION_MOVE");
int currentY = (int) event.getRawY();
mYDistance = currentY - mYDown;
// 高度大于header view的高度才可以刷新
if (mYDistance >= mTouchSlop) {
if (mCurrentStatus != STATUS_REFRESHING) {
//
if (mHeaderView.getPaddingTop() > mHeaderViewHeight * 0.7f) {
mCurrentStatus = STATUS_RELEASE_TO_REFRESH;
mTipsTextView.setText(R.string.pull_to_refresh_release_label);
} else {
mCurrentStatus = STATUS_PULL_TO_REFRESH;
mTipsTextView.setText(R.string.pull_to_refresh_pull_label);
}
}
rotateHeaderArrow();
int scaleHeight = (int) (mYDistance * 0.8f);// 去了滑动距离的80%,减小灵敏度而已
// Y轴的滑动距离小于屏幕高度4分之一时才会拉伸header,反之保持不变
if (scaleHeight <= mScrHeight / 4) {
adjustHeaderPadding(scaleHeight);
}
}
break;
case MotionEvent.ACTION_UP:
// 下拉刷新的具体操作
doRefresh();
break;
default:
break;
}
return true;
}
抬起手指时出发的刷新操作,代码如下:
- /**
- * 执行刷新操作
- */
- private final void doRefresh() {
- if (mCurrentStatus == STATUS_RELEASE_TO_REFRESH) {
- // 设置状态为正在刷新状态
- mCurrentStatus = STATUS_REFRESHING;
- mArrowImageView.clearAnimation();
- // 隐藏header中的箭头图标
- mArrowImageView.setVisibility(View.GONE);
- // 设置header中的进度条可见
- mHeaderProgressBar.setVisibility(View.VISIBLE);
- // 设置一些文本
- mTimeTextView.setText(R.string.pull_to_refresh_update_time_label);
- SimpleDateFormat sdf = new SimpleDateFormat();
- mTimeTextView.append(sdf.format(new Date()));
- //
- mTipsTextView.setText(R.string.pull_to_refresh_refreshing_label);
- // 执行回调
- if (mPullRefreshListener != null) {
- mPullRefreshListener.onRefresh();
- }
- // 使headview 正常显示, 直到调用了refreshComplete后再隐藏
- new HeaderViewHideTask().execute(0);
- } else {
- // 隐藏header view
- adjustHeaderPadding(-mHeaderViewHeight);
- }
- }
/**
* 执行刷新操作
*/
private final void doRefresh() {
if (mCurrentStatus == STATUS_RELEASE_TO_REFRESH) {
// 设置状态为正在刷新状态
mCurrentStatus = STATUS_REFRESHING;
mArrowImageView.clearAnimation();
// 隐藏header中的箭头图标
mArrowImageView.setVisibility(View.GONE);
// 设置header中的进度条可见
mHeaderProgressBar.setVisibility(View.VISIBLE);
// 设置一些文本
mTimeTextView.setText(R.string.pull_to_refresh_update_time_label);
SimpleDateFormat sdf = new SimpleDateFormat();
mTimeTextView.append(sdf.format(new Date()));
//
mTipsTextView.setText(R.string.pull_to_refresh_refreshing_label);
// 执行回调
if (mPullRefreshListener != null) {
mPullRefreshListener.onRefresh();
}
// 使headview 正常显示, 直到调用了refreshComplete后再隐藏
new HeaderViewHideTask().execute(0);
} else {
// 隐藏header view
adjustHeaderPadding(-mHeaderViewHeight);
}
}
在刷新状态时,header正常显示,即此时的padding top需要设置为0,我们使用一个异步任务来逐步修改padding top的值,使得header从拉伸效果逐步、平滑的恢复原始的大小。用户调用refreshComplete()函数后,即刷新完成后,再逐步调整listview的padding top将其隐藏。至此,整个下拉刷新过程结束。
滑动到底部自动加载
滑动到底部自动加载相对来说要简单得多,我们也是以ContentView是ListView的情况来说明。原理就是监听ListView ( 即 ContentView )的的滚动事件,因此如果ContentView的类型不支持滚动事件,则不能实现该功能。listview符合要求,因此其能实现自动加载。我们在onScroll函数中判断listview是否到了最后一项,如果到了最后一项,那么显示出footer,并且开始加载。当用户调用loadMoreComplete函数时代表加载结束。此时隐藏footer,整个过程结束。- /*
- * 滚动事件,实现滑动到底部时上拉加载更多
- * @see android.widget.AbsListView.OnScrollListener#onScroll(android.widget.
- * AbsListView, int, int, int)
- */
- @Override
- public void onScroll(AbsListView view, int firstVisibleItem, int visibleItemCount,
- int totalItemCount) {
- Log.d(VIEW_LOG_TAG, "&&& mYDistance = " + mYDistance);
- if (mFooterView == null || mYDistance >= 0 || mCurrentStatus == STATUS_LOADING
- || mCurrentStatus == STATUS_REFRESHING) {
- return;
- }
- loadmore();
- }
- /**
- * 下拉到底部时加载更多
- */
- private void loadmore() {
- if (isShowFooterView() && mLoadMoreListener != null) {
- mFooterTextView.setText(R.string.pull_to_refresh_refreshing_label);
- mFooterProgressBar.setVisibility(View.VISIBLE);
- adjustFooterPadding(0);
- mCurrentStatus = STATUS_LOADING;
- mLoadMoreListener.onLoadMore();
- }
- }
/*
* 滚动事件,实现滑动到底部时上拉加载更多
* @see android.widget.AbsListView.OnScrollListener#onScroll(android.widget.
* AbsListView, int, int, int)
*/
@Override
public void onScroll(AbsListView view, int firstVisibleItem, int visibleItemCount,
int totalItemCount) {
Log.d(VIEW_LOG_TAG, "&&& mYDistance = " + mYDistance);
if (mFooterView == null || mYDistance >= 0 || mCurrentStatus == STATUS_LOADING
|| mCurrentStatus == STATUS_REFRESHING) {
return;
}
loadmore();
}
/**
* 下拉到底部时加载更多
*/
private void loadmore() {
if (isShowFooterView() && mLoadMoreListener != null) {
mFooterTextView.setText(R.string.pull_to_refresh_refreshing_label);
mFooterProgressBar.setVisibility(View.VISIBLE);
adjustFooterPadding(0);
mCurrentStatus = STATUS_LOADING;
mLoadMoreListener.onLoadMore();
}
}
其中loadmore函数中调用的isShowFooterView函数就是用来判断是否到了最底部的,代码如下 :
- /*
- * 下拉到listview 最后一项时则返回true, 将出发自动加载
- * @see com.uit.pullrefresh.base.PullRefreshBase#isShowFooterView()
- */
- @Override
- protected boolean isShowFooterView() {
- if (mContentView == null || mContentView.getAdapter() == null) {
- return false;
- }
- return mContentView.getLastVisiblePosition() == mContentView.getAdapter().getCount() - 1;
- }
/*
* 下拉到listview 最后一项时则返回true, 将出发自动加载
* @see com.uit.pullrefresh.base.PullRefreshBase#isShowFooterView()
*/
@Override
protected boolean isShowFooterView() {
if (mContentView == null || mContentView.getAdapter() == null) {
return false;
}
return mContentView.getLastVisiblePosition() == mContentView.getAdapter().getCount() - 1;
}
OK,至此整个核心的过程介绍完毕了。
效果图
ListView
TextView下拉刷新