Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nuptboyzhb/SuperSwipeRefreshLayout
A custom SwipeRefreshLayout to support the pull-to-refresh featrue.RecyclerView，ListView，GridView，NestedScrollView，ScrollView are supported.
https://github.com/nuptboyzhb/SuperSwipeRefreshLayout
Last synced: about 6 hours ago
JSON representation
A custom SwipeRefreshLayout to support the pull-to-refresh featrue.RecyclerView，ListView，GridView，NestedScrollView，ScrollView are supported.
- Host: GitHub
- URL: https://github.com/nuptboyzhb/SuperSwipeRefreshLayout
- Owner: nuptboyzhb
- License: apache-2.0
- Created: 2015-08-09T11:37:12.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2018-06-14T02:47:23.000Z (over 6 years ago)
- Last Synced: 2023-11-07T13:53:51.257Z (about 1 year ago)
- Language: Java
- Homepage:
- Size: 1.91 MB
- Stars: 1,250
- Watchers: 46
- Forks: 359
- Open Issues: 40
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-android-ui - https://github.com/nuptboyzhb/SuperSwipeRefreshLayout
README
# SuperSwipeRefreshLayout
A custom SwipeRefreshLayout to support the pull-to-refresh featrue.You can custom your header view and footer view. RecyclerView，ListView，GridView，NestedScrollView，ScrollView are supported.
## aar
```
allprojects {
repositories {
jcenter()
maven {
url "http://dl.bintray.com/nuptboyzhb/maven"
}
}
}
```
```
compile 'com.github.nuptboyzhb.lib.uikit:superswiperefreshlayout:1.0.0'
```
## 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
```xml
```
### Step 2: Init and setListener
```java
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
```java
swipeRefreshLayout.setHeaderView(createHeaderView());// add headerView
/**
* create Header View
*/
private View createHeaderView(){
//TODO 创建下拉刷新头部的View样式
}
```
- setTargetScrollWithLayout(false/true);//default true
设置下拉时，被包含的View是否随手指的移动而移动
```java
swipeRefreshLayout.setTargetScrollWithLayout(true);
```
- setHeaderViewBackgroundColor
设置下拉刷新头部背景色
```java
swipeRefreshLayout.setHeaderViewBackgroundColor(0xff888888);
```
- setDefaultCircleProgressColor
设置默认圆形进度条颜色
- setDefaultCircleBackgroundColor
设置默认圆形背景色
- setDefaultCircleShadowColor
设置默认圆形的阴影颜色
- setEnable
设置是否禁用下拉刷新，默认是使用
## Push to Load More
当拉倒底部时，上拉加载更多
### setListener
```java
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
```java
swipeRefreshLayout.setFooterView(createFooterView());
```
## Support View
- RecyclerView.
- ListView
- SrcollView
- GridView
- etc.
## Demo
## About
@Author: Zheng Haibo 莫川
@Website: [https://github.com/nuptboyzhb](https://github.com/nuptboyzhb)
# License
Copyright 2015-2016 [Zheng Haibo](https://github.com/nuptboyzhb/)
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.