https://github.com/dsiner/pulllayout
A reusable Pull to Refresh library for Android. Support RecyclerView ListView ScrollView ViewPager CoordinatorLayout. Sliding damping, supports all directions. Drag and drop sort. You can use it like a standard RecyclerView -适用于Android的下拉刷新, 加载更多库. 滑动阻尼, 支持所有方向. 支持RecyclerView ListView ScrollView ViewPager CoordinatorLayout. 拖放排序.
https://github.com/dsiner/pulllayout
common-adapter itemtouchhelper loadmore mulitiple pulltorefresh recyclerview refreshlayout
Last synced: about 2 months ago
JSON representation
A reusable Pull to Refresh library for Android. Support RecyclerView ListView ScrollView ViewPager CoordinatorLayout. Sliding damping, supports all directions. Drag and drop sort. You can use it like a standard RecyclerView -适用于Android的下拉刷新, 加载更多库. 滑动阻尼, 支持所有方向. 支持RecyclerView ListView ScrollView ViewPager CoordinatorLayout. 拖放排序.
- Host: GitHub
- URL: https://github.com/dsiner/pulllayout
- Owner: Dsiner
- Created: 2017-04-26T09:44:17.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2021-01-10T15:58:40.000Z (over 4 years ago)
- Last Synced: 2025-03-27T05:02:21.700Z (7 months ago)
- Topics: common-adapter, itemtouchhelper, loadmore, mulitiple, pulltorefresh, recyclerview, refreshlayout
- Language: Java
- Homepage:
- Size: 1.35 MB
- Stars: 31
- Watchers: 3
- Forks: 8
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# PullLayout for Android
[](https://www.apache.org/licenses/LICENSE-2.0)
[](https://android-arsenal.com/api?level=11)
[ ](https://bintray.com/dsiner/maven/pulllayout/_latestVersion)
> A reusable Pull to Refresh library for Android.
## Set up
Maven:
```xml
com.dsiner.lib
pulllayout
2.0.0
```
or Gradle:
```groovy
// AndroidX
implementation 'com.dsiner.lib:pulllayout:2.0.0'
// Or Support
implementation 'com.dsiner.lib:pulllayout:1.0.4'
```
## Features
* Supports both Pulling Down from the top, and Pulling Up from the bottom (or even both).
* Animated Scrolling for all devices.
* Currently works with:
* **RecyclerView**
* **ListView**
* **ScrollView**
* **WebView**
* **ViewPager**
* **CoordinatorLayout**
* Integrated End of List Listener for use of detecting when the user has scrolled to the bottom.
* Callback method to be invoked when Pullable's scroll state changes.
* Dynamically add headers and footers.
* Support `duration` `factor` `TimeInterpolator`
* Sliding damping, supports all directions (`left` `top` `right` `bottom`).
* Multi-type adapter support.
* Drag and drop sort.
* Lots of [Customisation](https://github.com/Dsiner/PullLayout/blob/master/app/src/main/java/com/d/pulllayout/MainActivity.java) options!
## Screenshot
## How do I use it?
## Configuration ##
### Via XML ###
#### Damp ####
```XML
```
| attribute name | description |
|---|---|
| lib_pull_enable | Draggable |
| lib_pull_gravity | Draggable direction |
#### Pull to Refresh list ####
```XML
```
| attribute name | description |
|---|---|
| lib_pull_type | Nested style - `PullRecyclerview` (by default) or `RecyclerView` or `ListView` |
## Animation ##
### Refreshing callback ###
Just implement `Refreshable.OnRefreshListener`:
```Java
mPullList.setOnRefreshListener(new Refreshable.OnRefreshListener() {
@Override
public void onRefresh() {
// Refresh your data here
}
@Override
public void onLoadMore() {
// Load your data here
}
});
```
### Pulling callback ###
Just implement `Pullable.OnPullListener`:
```Java
mPullList.addOnPullListener(new Pullable.OnPullListener() {
@Override
public void onPullStateChanged(Pullable pullable, int newState) {
// Callback method to be invoked when Pullable's scroll state changes.
}
@Override
public void onPulled(Pullable pullable, int dx, int dy) {
// Callback method to be invoked when the Pullable has been scrolled.
}
});
```
### To start or stop animation: ###
```Java
mPullList.refresh();
mPullList.loadMore();
mPullList.refreshSuccess();
mPullList.refreshError();
mPullList.loadMoreSuccess();
mPullList.loadMoreError();
mPullList.loadMoreNoMore();
```
### Using custom views ###
For using custom views just implement `IEdgeView`:
```Java
mPullList.setHeader(new HeaderView(context));
mPullList.setFooter(new FooterView(context));
```
## Adapter ##
### Simple adapter ###
```Java
public class SimpleAdapter extends CommonAdapter {
public SimpleAdapter(Context context, List datas, int layoutId) {
super(context, datas, layoutId);
}
@Override
public void convert(final int position, CommonHolder holder, Bean item) {
...
}
}
```
### Multiple adapter ###
```Java
public class MultipleAdapter extends CommonAdapter {
public MultipleAdapter(Context context, List datas, MultiItemTypeSupport multiItemTypeSupport) {
super(context, datas, multiItemTypeSupport);
}
@Override
public void convert(final int position, CommonHolder holder, Bean item) {
switch (holder.layoutId) {
...
}
}
}
```
### Support headers or footers ###
```Java
mPullList.addHeaderView(view);
mPullList.addFooterView(view);
mPullList.removeHeaderView(view);
mPullList.removeFooterView(view);
```
More usage see [Demo](app/src/main/java/com/d/pulllayout/MainActivity.java)
## Thanks
- [Android-PullToRefresh](https://github.com/chrisbanes/Android-PullToRefresh) - A pull to refresh widget
- [XRecyclerView](https://github.com/jianghejie/XRecyclerView) - RecyclerView that implements pullrefresh , loadingmore and header featrues
## Licence
```txt
Copyright 2018 D
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.
```