一个下拉刷新框架。已有很多开源刷新工具,但是还找到一个方便自定义,可扩展的。所以自己造个轮子。 还是先写个中文文档就好了. English Doc
- 支持自定义下拉/上拉动画
- 支持无数据时上拉显示"没有更多"(可自定义)
- 支持显示满屏的加载动画(如首次没有数据的动画)
- 支持滑动到底部,自动加载
- 支持横向/纵向刷新
Gradle:
compile 'net.z0kai:kkrefreshlayout:x.x.x'or Maven:
<dependency> <groupId>net.z0kai</groupId> <artifactId>kkrefreshlayout</artifactId> <version>x.x.x</version> <type>pom</type> </dependency>
Demo apk下载
目前遇到的使用案例大部分都会添加到demo中
- 各种动画刷新
- 第一次进入页面没数据需要一个加载动画
- 横向弹性跳转更多页面
- 页面上下拉弹性滑动(像iOS弹性效果)
- 如微信各种中心也,一半图片下拉回弹效果
推荐自己集成于KKRefreshLayout如下(全局使用),然后可以自定义刷新样式。若不继承则使用默认样式。
/** * Created by Z_0Kai on 16/9/30. * APP封装新控件,请尽量不要使用到原来刷新控件的接口,封装后方便替换 */ public class AppRefreshLayout extends KKRefreshLayout { private AppRefreshLayoutListener mListener; // ... see demo public interface AppRefreshLayoutListener { void onRefresh(); void onLoadMore(); } public static class AppRefreshLayoutAdapter implements AppRefreshLayoutListener { public void onRefresh() { } public void onLoadMore() { } } public void setRefreshLayoutListener(AppRefreshLayoutListener listener) { mListener = listener; super.setRefreshListener(new KKRefreshListener() { @Override public void onRefresh() { if (mListener != null) { mListener.onRefresh(); } } @Override public void onLoadMore() { if (mListener != null) { mListener.onLoadMore(); } } }); } /** * @hide * @deprecated */ @Override public void setRefreshListener(KKRefreshListener listener) { super.setRefreshListener(listener); } }
obtainHeaderView自定义顶部刷新样式obtainFooterView自定义上拉样式obtainPageView自定义页面刷新样式(无默认)
setHeadView设置下拉刷新样式setFooterView设置上拉加载样式setPageView设置页面加载效果
<net.z0kai.kkrefreshlayout.KKRefreshLayout android:id="@+id/refreshLayout" android:layout_width="match_parent" android:layout_height="match_parent" app:rlLoadMoreEnable="true"> // one child view </net.z0kai.kkrefreshlayout.KKRefreshLayout>
app:rlOrientation="horizontal/vertical"横向纵向刷新app:rlRefreshEnable="true/false"是否可下拉刷新app:rlLoadMoreEnable="true/false"是否加载更多
onRefresh() onLoadMore()
欢迎提交自定义的Header/Footer/PageView到demo中,添加class到 AppConfigs.java
Z0Kai, @0kai on GitHub, blog-中文
MIT-licensed.