Android 整合实现简单易用、功能强大的RecyclerView

来源:互联网 发布:mac os 10.6.8升级 编辑:程序博客网 时间:2024/06/10 21:37

之前总是会有人在一些开发群里问,有木有比较好使且功能强大些的RecyclerVew,比如支持下来刷新,加载更多等,还有人在问,如何为RecyclerView添加分割线,尤其是如何为网格布局添加分割线? 热心的群友会有一堆推荐,当然也不乏好事者来这么一句,自己封装去。。。。

  我自己也用了挺久的RecyclerView,在使用过程中,往往也会碰到各种各样的需求、设计,秉着不重复造轮子的原则,我在github上也搜过挺多二次封装的RecyclerView,最后选择了那么几个,重新再次整合、封装,形成了现有的、也是我常用的RecyclerView库,现支持:


功能:

 1. 普通列表功能、为列表添加分割线,设置分割线高度(宽度)、颜色等。

 2. 网格列表功能、为网格列表添加分割线,设置分割线高度(宽度)、颜色等。

 3. 普通列表、网格列表均支持滑动加载更多数据功能,并在网络失败情况下,添加了提醒重新加载功能(可看下面示意图)。

 4. 普通列表、网格列表均支持添加Header功能。 再不需要加载更多数据情况下,支持添加Footer。

 5. 未扩展下拉刷新功能,如需要,请使用Android官方提供的SwipeRefreshLayout 。


 在介绍我整合的项目之前,有必要先说明下我整合的两个最重要的库,他们才是真的原创,希望大家尊重原创。

Thanks:

 该项目主要整合了两个开源项目,是在它们的基础上进行的再创造:

 1. RecyclerView分割线:https://github.com/yqritc/RecyclerView-FlexibleDivider

 2. RecyclerView添加HeaderView和FooterView:https://github.com/cundong/HeaderAndFooterRecyclerView


效果图:

· 垂直列表,添加分割线


· 网格列表,添加分割线


· 垂直列表,添加HeaderView


· 网格列表,添加HeaderView



· 加载更多数据网络错误时,提示重新加载。


 实现: 

  关于该库是如何整合的,此处不多介绍的,有兴趣的人可以下载源码去看看,当然,不足之处,也可以进行再次扩展。

 关于该库的使用,我还是建议大家该library下载下来,导入自己项目,这样也方便自己随意修改使用。


 1. 实现垂直列表  

[java] view plain copy
 print?在CODE上查看代码片派生到我的代码片
  1. private void initView() {  
  2.   
  3.         listWeChats = (RecyclerView) findViewById(R.id.listWeChats);  
  4.   
  5.         mDatas = new ArrayList<>();  
  6.   
  7.         WeChatListAdapter weChatListAdapter = new WeChatListAdapter(this, mDatas, onClickListener);  
  8.         HeaderAndFooterRecyclerViewAdapter  recyclerViewAdapter = new HeaderAndFooterRecyclerViewAdapter(weChatListAdapter);  
  9.         listWeChats.setAdapter(recyclerViewAdapter);  
  10.   
  11.         listWeChats.setLayoutManager(new LinearLayoutManager(this));  
  12.         listWeChats.addItemDecoration(  
  13.                 new HorizontalDividerItemDecoration.Builder(WChatListActivity.this)  
  14.                         .color(Color.parseColor("#00c7c0"))  
  15.                         .sizeResId(R.dimen.list_divider_height)  
  16.                         .showLastDivider()  
  17.                         .marginResId(R.dimen.list_divider_left_margin, R.dimen.list_divider_right_margin)  
  18.                         .build(false));  
  19.   
  20.         listWeChats.addOnScrollListener(mOnScrollListener);  
  21.     }  

 简析:HeaderAndFooterRecyclerViewAdapter主要是为了是对RecyclerView.Adapter的扩展实现,通过它,可以添加HeaderView和FooterView(具体可看源码)。HorizontalDividerItemDecoration则是扩展了RecyclerView.ItemDecoration,用于为垂直列表添加分割线,如果你是一个横向的列表,则可以使用另一个
ItemDecoration的实现:
VerticalDividerItemDecoration。具体的使用可参加项目的示例。


2. 实现网格列表

[java] view plain copy
 print?在CODE上查看代码片派生到我的代码片
  1.  private void initView() {  
  2.   
  3.         listWeChats = (RecyclerView) findViewById(R.id.listWeChats);  
  4.   
  5.         mDatas = new ArrayList<>();  
  6.   
  7.         WeChatListAdapter weChatListAdapter = new WeChatListAdapter(this, mDatas, onClickListener);  
  8.   
  9.         HeaderAndFooterRecyclerViewAdapter recyclerViewAdapter = new HeaderAndFooterRecyclerViewAdapter(weChatListAdapter);  
  10.         listWeChats.setAdapter(recyclerViewAdapter);  
  11.   
  12.         GridLayoutManager gridLayoutManager = new GridLayoutManager(this2);  
  13.         gridLayoutManager.setSpanSizeLookup(new HeaderSpanSizeLookup((HeaderAndFooterRecyclerViewAdapter) listWeChats.getAdapter(), gridLayoutManager.getSpanCount()));  
  14.         listWeChats.setLayoutManager(gridLayoutManager);  
  15.   
  16. //        Drawable mDivider = getResources().getDrawable(R.drawable.list_divider);  
  17. //        ColorDrawable colorDrawable = new ColorDrawable(Color.parseColor("#00c7c0"));  
  18.   
  19.         GridSpacingItemDecoration itemDecoration = new GridSpacingItemDecoration(this2);  
  20.         itemDecoration.setH_spacing(50);  
  21.         itemDecoration.setV_spacing(50);  
  22. //        itemDecoration.setmDivider(mDivider);  
  23.   
  24.         itemDecoration.setDividerColor(Color.parseColor("#008E00"));  
  25.   
  26.         listWeChats.addItemDecoration(itemDecoration);  
  27.   
  28.         listWeChats.addOnScrollListener(mOnScrollListener);  
  29.     }  

简析:GridSpacingItemDecoration 用于为列表添加分割线。具体的使用可参加项目的示例。


3. 实现带有HeaderView的垂直列表

[java] view plain copy
 print?在CODE上查看代码片派生到我的代码片
  1. private void initView() {  
  2.   
  3.         listWeChats = (RecyclerView) findViewById(R.id.listWeChats);  
  4.   
  5.         mDatas = new ArrayList<>();  
  6.   
  7.   
  8.         WeChatListAdapter weChatListAdapter = new WeChatListAdapter(this, mDatas, onClickListener);  
  9.         HeaderAndFooterRecyclerViewAdapter  recyclerViewAdapter = new HeaderAndFooterRecyclerViewAdapter(weChatListAdapter);  
  10.   
  11.         listWeChats.setAdapter(recyclerViewAdapter);  
  12.   
  13.         listWeChats.setLayoutManager(new LinearLayoutManager(this));  
  14.   
  15.         listWeChats.addItemDecoration(  
  16.                 new HorizontalDividerItemDecoration.Builder(WChatListHeaderAndFooterActivity.this)  
  17.                         .colorResId(R.color.list_divider_color)  
  18. //                        .color(Color.parseColor("#FF0000"))  
  19.                         .sizeResId(R.dimen.list_divider_height)  
  20.                         .marginResId(R.dimen.list_divider_left_margin, R.dimen.list_divider_right_margin)  
  21.                         .build(true));  
  22.   
  23.         listWeChats.addOnScrollListener(mOnScrollListener);  
  24.   
  25.         RecyclerViewUtils.setHeaderView(listWeChats, new SampleHeader(this));  
  26.     }  

简析:RecyclerViewUtils,可以很方便的为RecyclerView添加HeaderView。


4. 实现带有HeaderView的网格布局

[java] view plain copy
 print?在CODE上查看代码片派生到我的代码片
  1.  private void initView() {  
  2.   
  3.         listWeChats = (RecyclerView) findViewById(R.id.listWeChats);  
  4.   
  5.         mDatas = new ArrayList<>();  
  6.   
  7.         WeChatListAdapter weChatListAdapter = new WeChatListAdapter(this, mDatas, onClickListener);  
  8.   
  9.         HeaderAndFooterRecyclerViewAdapter recyclerViewAdapter = new HeaderAndFooterRecyclerViewAdapter(weChatListAdapter);  
  10.         listWeChats.setAdapter(recyclerViewAdapter);  
  11.   
  12.         GridLayoutManager gridLayoutManager = new GridLayoutManager(this2);  
  13.         gridLayoutManager.setSpanSizeLookup(new HeaderSpanSizeLookup((HeaderAndFooterRecyclerViewAdapter) listWeChats.getAdapter(), gridLayoutManager.getSpanCount()));  
  14.         listWeChats.setLayoutManager(gridLayoutManager);  
  15.   
  16. //        Drawable mDivider = getResources().getDrawable(R.drawable.list_divider);  
  17. //        ColorDrawable colorDrawable = new ColorDrawable(Color.parseColor("#00c7c0"));  
  18.   
  19.         GridSpacingItemDecoration itemDecoration = new GridSpacingItemDecoration(this2);  
  20.         itemDecoration.setHasHeader(true);  
  21.         itemDecoration.setH_spacing(50);  
  22.         itemDecoration.setV_spacing(50);  
  23. //        itemDecoration.setmDivider(mDivider);  
  24.   
  25.         itemDecoration.setDividerColor(Color.parseColor("#008E00"));  
  26.   
  27.         listWeChats.addItemDecoration(itemDecoration);  
  28.   
  29.         listWeChats.addOnScrollListener(mOnScrollListener);  
  30.   
  31.         RecyclerViewUtils.setHeaderView(listWeChats, new SampleHeader(this));  
  32.     }  


  以上就是我整合使用的RecyclerView,挺顺手的,我已经在多个项目中使用它了,希望更多的人能喜欢支持它。


  项目github地址:https://github.com/zuiwuyuan/RecycleView_PullToRefresh_LoadMore

  

  如有疑问或建议,欢迎进QQ群讨论:487786925( Android研发村 

0 0
原创粉丝点击