简介

开发者使用 BGARefreshLayout-Android 可以对各种控件实现多种下拉刷新效果、上拉加载更多以及配置自定义头部广告位。

常见问题-加载更多视图无法显示.

1.BGARefreshLayout 的直接子控件的高度请使用 android:layout_height="0dp" 和 android:layout_weight="1"

1. <cn.bingoogolapple.refreshlayout.BGARefreshLayout xmlns:android="http://schemas.android.com/apk/res/android" 
2.     android:id="@+id/rl_modulename_refresh" 
3.     android:layout_width="match_parent" 
4.     android:layout_height="match_parent"> 
5.  
6.     <!-- BGARefreshLayout 的直接子控件 --> 
7.     <AnyView 
8.         android:layout_width="match_parent" 
9.         android:layout_height="0dp" 
10.         android:layout_weight="1" /> 
11. </cn.bingoogolapple.refreshlayout.BGARefreshLayout>  

2.如果是在 Fragment 中使用 BGARefreshLayout

请在 onCreateView 方法中初始化 BGARefreshLayout，不要在 onActivityCreated 方法中初始化

目前已经实现了四种下拉刷新效果:

• 新浪微博下拉刷新风格(可设置各种状态是的文本，可设置整个刷新头部的背景)
• 慕课网下拉刷新风格(可设置其中的 logo 和颜色成自己公司的风格，可设置整个刷新头部的背景)
• 美团下拉刷新风格(可设置其中的图片和动画成自己公司的风格，可设置整个刷新头部的背景)
• 类似 qq 好友列表黏性下拉刷新风格(三阶贝塞尔曲线没怎么调好，刚开始下拉时效果不太好，可设置整个刷新头部的背景)

一种上拉加载更多效果

• 新浪微博上拉加载更多(可设置背景、状态文本)

开发者也可以继承 BGARefreshViewHolder 这个抽象类，实现相应地抽象方法做出格式各样的下拉刷新效果【例如实现 handleScale(float scale, int moveYDistance) 方法，根据 scale 实现各种下拉刷新动画】和上拉加载更多特效，可参考 BGAMoocStyleRefreshViewHolder、BGANormalRefreshViewHolder、BGAStickinessRefreshViewHolder、BGAMeiTuanRefreshViewHolder 的实现方式。

效果图

基本使用

1.添加 Gradle 依赖

没有支持 Eclipse，建议还在用 Eclipse 的小伙伴都开始转 Android Studio 吧

latestVersion 是指对应库的最新版本号,别再问我为什么找不到 xxxxxxxlatestVersion 了!

1. dependencies { 
2.    compile 'com.android.support:recyclerview-v7:latestVersion' 
3.    compile 'com.android.support:appcompat-v7:latestVersion' 
4.    compile 'cn.bingoogolapple:bga-refreshlayout:latestVersion@aar'}  

2.在布局文件中添加 BGARefreshLayout

注意：内容控件的高度请使用 android:layout_height="0dp" 和 android:layout_weight="1"

1. <cn.bingoogolapple.refreshlayout.BGARefreshLayout xmlns:android="http://schemas.android.com/apk/res/android" 
2.    android:id="@+id/rl_modulename_refresh" 
3.    android:layout_width="match_parent" 
4.    android:layout_height="match_parent">    <!-- 内容控件 --> 
5.    <AnyView 
6.        android:layout_width="match_parent" 
7.        android:layout_height="0dp" 
8.        android:layout_weight="1" /> 
9. </cn.bingoogolapple.refreshlayout.BGARefreshLayout>  

3.在 Activity 或者 Fragment 中配置 BGARefreshLayout

1. // 让 activity 或者 fragment 实现 BGARefreshLayoutDelegate 接口 
2. public class ModuleNameActivity extends AppCompatActivity implements BGARefreshLayout.BGARefreshLayoutDelegate { 
3.     private BGARefreshLayout mRefreshLayout; 
4.  
5.     @Override 
6.     protected void onCreate(Bundle savedInstanceState) { 
7.         super.onCreate(savedInstanceState); 
8.         setContentView(R.layout.activity_moudlename); 
9.  
10.         initRefreshLayout(); 
11.     } 
12.  
13.     private void initRefreshLayout(BGARefreshLayout refreshLayout) { 
14.         mRefreshLayout = (BGARefreshLayout) findViewById(R.id.rl_modulename_refresh); 
15.         // 为BGARefreshLayout 设置代理 
16.         mRefreshLayout.setDelegate(this); 
17.         // 设置下拉刷新和上拉加载更多的风格     参数1：应用程序上下文，参数2：是否具有上拉加载更多功能 
18.         BGARefreshViewHolder refreshViewHolder = new XXXImplRefreshViewHolder(this, true)) 
19.         // 设置下拉刷新和上拉加载更多的风格 
20.         mRefreshLayout.setRefreshViewHolder(refreshViewHolder); 
21.  
22.  
23.         // 为了增加下拉刷新头部和加载更多的通用性，提供了以下可选配置选项  -------------START 
24.         // 设置正在加载更多时不显示加载更多控件 
25.         // mRefreshLayout.setIsShowLoadingMoreView(false); 
26.         // 设置正在加载更多时的文本 
27.         refreshViewHolder.setLoadingMoreText(loadingMoreText); 
28.         // 设置整个加载更多控件的背景颜色资源 id 
29.         refreshViewHolder.setLoadMoreBackgroundColorRes(loadMoreBackgroundColorRes); 
30.         // 设置整个加载更多控件的背景 drawable 资源 id 
31.         refreshViewHolder.setLoadMoreBackgroundDrawableRes(loadMoreBackgroundDrawableRes); 
32.         // 设置下拉刷新控件的背景颜色资源 id 
33.         refreshViewHolder.setRefreshViewBackgroundColorRes(refreshViewBackgroundColorRes); 
34.         // 设置下拉刷新控件的背景 drawable 资源 id 
35.         refreshViewHolder.setRefreshViewBackgroundDrawableRes(refreshViewBackgroundDrawableRes); 
36.         // 设置自定义头部视图（也可以不用设置）     参数1：自定义头部视图（例如广告位）， 参数2：上拉加载更多是否可用 
37.         mRefreshLayout.setCustomHeaderView(mBanner, false); 
38.         // 可选配置  -------------END 
39.     } 
40.  
41.     @Override 
42.     public void onBGARefreshLayoutBeginRefreshing(BGARefreshLayout refreshLayout) { 
43.         // 在这里加载最新数据 
44.  
45.         if (mIsNetworkEnabled) { 
46.             // 如果网络可用，则加载网络数据 
47.             new AsyncTask<Void, Void, Void>() { 
48.  
49.                 @Override 
50.                 protected Void doInBackground(Void... params) { 
51.                     try { 
52.                         Thread.sleep(MainActivity.LOADING_DURATION); 
53.                     } catch (InterruptedException e) { 
54.                         e.printStackTrace(); 
55.                     } 
56.                     return null; 
57.                 } 
58.  
59.                 @Override 
60.                 protected void onPostExecute(Void aVoid) { 
61.                     // 加载完毕后在 UI 线程结束下拉刷新 
62.                     mRefreshLayout.endRefreshing(); 
63.                     mDatas.addAll(0, DataEngine.loadNewData()); 
64.                     mAdapter.setDatas(mDatas); 
65.                 } 
66.             }.execute(); 
67.         } else { 
68.             // 网络不可用，结束下拉刷新 
69.             Toast.makeText(this, "网络不可用", Toast.LENGTH_SHORT).show(); 
70.             mRefreshLayout.endRefreshing(); 
71.         } 
72.     } 
73.  
74.     @Override 
75.     public boolean onBGARefreshLayoutBeginLoadingMore(BGARefreshLayout refreshLayout) { 
76.         // 在这里加载更多数据，或者更具产品需求实现上拉刷新也可以 
77.  
78.         if (mIsNetworkEnabled) { 
79.             // 如果网络可用，则异步加载网络数据，并返回 true，显示正在加载更多 
80.             new AsyncTask<Void, Void, Void>() { 
81.  
82.                 @Override 
83.                 protected Void doInBackground(Void... params) { 
84.                     try { 
85.                         Thread.sleep(MainActivity.LOADING_DURATION); 
86.                     } catch (InterruptedException e) { 
87.                         e.printStackTrace(); 
88.                     } 
89.                     return null; 
90.                 } 
91.  
92.                 @Override 
93.                 protected void onPostExecute(Void aVoid) { 
94.                     // 加载完毕后在 UI 线程结束加载更多 
95.                     mRefreshLayout.endLoadingMore(); 
96.                     mAdapter.addDatas(DataEngine.loadMoreData()); 
97.                 } 
98.             }.execute(); 
99.  
100.             return true; 
101.         } else { 
102.             // 网络不可用，返回 false，不显示正在加载更多 
103.             Toast.makeText(this, "网络不可用", Toast.LENGTH_SHORT).show(); 
104.             return false; 
105.         } 
106.     } 
107.  
108.     // 通过代码方式控制进入正在刷新状态。应用场景：某些应用在 activity 的 onStart 方法中调用，自动进入正在刷新状态获取最新数据 
109.     public void beginRefreshing() { 
110.         mRefreshLayout.beginRefreshing(); 
111.     } 
112.  
113.     // 通过代码方式控制进入加载更多状态 
114.     public void beginLoadingMore() { 
115.         mRefreshLayout.beginLoadingMore(); 
116.     } 
117.  
118. }