Skip to content

Latest commit

 

History

History
191 lines (144 loc) · 4.92 KB

README.md

File metadata and controls

191 lines (144 loc) · 4.92 KB
Raw

SuperSwipeRefreshLayout

A Custom SwipeRefreshLayout.自定义HeaderView和FooterView，支持下拉刷新和上拉加载更多

##Why？

  • 1.本来SwipeRefreshLayout已经能够满足大部分的需求了。无奈，产品经理执意要做成下拉过程中，被嵌套的View也要跟随手指的滑动而滑动，并且下拉刷新头可以自定义。
  • 2.应大家要求，添加下拉加载更多

##Feature

  • 支持下拉刷新和上拉加载更多，使用极其方便。
  • 非侵入式，对原来的ListView、RecyclerView没有任何影响,用法和SwipeRefreshLayout类似。
  • 可自定义头部View的样式，调用setHeaderView方法即可。
  • 可自定义页尾View的样式，调用setFooterView方法即可。
  • 支持RecyclerView，ListView，ScrollView，GridView,NestedScrollView等等。
  • 被包含的View(RecyclerView,ListView etc.)可跟随手指的滑动而滑动
    默认是跟随手指的滑动而滑动，也可以设置为不跟随：setTargetScrollWithLayout(false)
  • 回调方法更多
    比如：onRefresh() onPullDistance(int distance)和onPullEnable(boolean enable)
    开发人员可以根据下拉过程中distance的值做一系列动画。

##Pull To Refresh(How to Use)

Step 1: In XML

<com.github.nuptboyzhb.lib.SuperSwipeRefreshLayout
		android:id="@+id/swipe_refresh"
		android:layout_width="match_parent"
		android:layout_height="match_parent" >

		<android.support.v7.widget.RecyclerView
			android:id="@+id/recycler_view"
			android:layout_width="match_parent"
			android:layout_height="match_parent" />
</com.github.nuptboyzhb.lib.SuperSwipeRefreshLayout>

Step 2: Init and setListener

swipeRefreshLayout = (SuperSwipeRefreshLayout) findViewById(R.id.swipe_refresh);
		swipeRefreshLayout.setHeaderView(createHeaderView());// add headerView
		swipeRefreshLayout
				.setOnPullRefreshListener(new OnPullRefreshListener() {

					@Override
					public void onRefresh() {
						//TODO 开始刷新
					}

					@Override
					public void onPullDistance(int distance) {
						//TODO 下拉距离
					}

					@Override
					public void onPullEnable(boolean enable) {
						//TODO 下拉过程中，下拉的距离是否足够出发刷新
					}
				});

加载完成之后： swipeRefreshLayout.setRefresh(false);

More


以上已经能够满足大部分需求，当然，你也可以这样：
  • Customized your header view
    自定义自己的下拉刷新头部View
swipeRefreshLayout.setHeaderView(createHeaderView());// add headerView

/**
 * create Header View
 */
private View createHeaderView(){
   //TODO 创建下拉刷新头部的View样式
}
  • setTargetScrollWithLayout(false/true);//default true
    设置下拉时，被包含的View是否随手指的移动而移动
swipeRefreshLayout.setTargetScrollWithLayout(true);
  • setHeaderViewBackgroundColor
    设置下拉刷新头部背景色
swipeRefreshLayout.setHeaderViewBackgroundColor(0xff888888);

  • setDefaultCircleProgressColor
    设置默认圆形进度条颜色

  • setDefaultCircleBackgroundColor
    设置默认圆形背景色

  • setDefaultCircleShadowColor
    设置默认圆形的阴影颜色

  • setEnable
    设置是否禁用下拉刷新，默认是使用

##Push to Load More 当拉倒底部时，上拉加载更多

setListener

swipeRefreshLayout
				.setOnPushLoadMoreListener(new OnPushLoadMoreListener() {

					@Override
					public void onLoadMore() {
						...
						new Handler().postDelayed(new Runnable() {

							@Override
							public void run() {
								...
                                //set false when finished
								swipeRefreshLayout.setLoadMore(false);
							}
						}, 5000);
					}

					@Override
					public void onPushEnable(boolean enable) {
						//TODO 上拉过程中，上拉的距离是否足够出发刷新
					}

					@Override
					public void onPushDistance(int distance) {
						// TODO 上拉距离

					}

				});

Customized your footer view

swipeRefreshLayout.setFooterView(createFooterView());

Support View

  • RecyclerView.
  • ListView
  • SrcollView
  • GridView
  • etc.

Demo

gif

About

@Author: Zheng Haibo 莫川
@Website: https://github.com/nuptboyzhb

License

Copyright 2015-2016 Zheng Haibo

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.