UltimateRecyclerView的使用方法详解

最近在用很多第三方库的时候，发现有一些附带的demo写的不是很全面或者例子的代码太多，注释太少，要想使用还要去看下源码什么的（。。。用第三方开源库不就是想节省时间嘛），所以决定每周两到三篇，写一些比较热门的库的使用方法，让使用的人能快速上手（对我而言，要是发现库提供的功能有时不满足需求，可能会扩展下功能什么的）。不废话，以后都是直接贴代码，代码中写满注释，这样看起来的时候方便，我也省事。
（嫌麻烦的直接下拉到第5）

效果图

1.这是使用到的布局文件，很简单，看成时只有一个UltimateRecyclerView就行 activity_recycler_view.xml

 <?xml version="1.0" encoding="utf-8"?> <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:app="http://schemas.android.com/apk/res-auto" xmlns:tools="http://schemas.android.com/tools" android:layout_width="match_parent" android:layout_height="match_parent" tools:context="github.dzc.apptemplate.recyclerview.RecyclerViewActivity"> <android.support.design.widget.AppBarLayout android:id="@+id/action_bar" android:layout_width="match_parent" android:layout_height="wrap_content" android:theme="@style/AppTheme.AppBarOverlay"> <android.support.v7.widget.Toolbar android:id="@+id/toolbar" android:layout_width="match_parent" android:layout_height="?attr/actionBarSize" android:background="?attr/colorPrimary" app:popupTheme="@style/AppTheme.PopupOverlay" > <TextView android:layout_width="wrap_content" android:layout_height="match_parent" android:text="RecyclerViewActivity" android:gravity="center" android:textColor="@android:color/white"/> </android.support.v7.widget.Toolbar> </android.support.design.widget.AppBarLayout> <com.marshalchen.ultimaterecyclerview.UltimateRecyclerView android:id="@+id/recycler_view" android:layout_width="match_parent" android:layout_height="match_parent" android:layout_below="@id/action_bar" app:layout_behavior="@string/appbar_scrolling_view_behavior" tools:context="github.dzc.apptemplate.recyclerview.RecyclerViewActivity" ></com.marshalchen.ultimaterecyclerview.UltimateRecyclerView> </RelativeLayout> 

2.头部布局 只有一张图片 head_view.xml

<?xml version="1.0" encoding="utf-8"?>  <ImageView xmlns:android="http://schemas.android.com/apk/res/android" android:orientation="vertical" android:layout_width="match_parent" android:layout_height="wrap_content" android:src="@mipmap/img" android:scaleType="centerCrop">  </ImageView>

3.item的布局 string_item.xml

<?xml version="1.0" encoding="utf-8"?>  <TextView xmlns:android="http://schemas.android.com/apk/res/android" android:id="@+id/tv" android:layout_width="match_parent" android:layout_height="wrap_content" android:padding="20dp">    </TextView>

4.ViewHolder

package github.dzc.apptemplate.recyclerview.viewholder;    import android.view.View;  import android.widget.TextView;    import com.marshalchen.ultimaterecyclerview.UltimateRecyclerviewViewHolder;    /** * Created by dzc on 16/1/22. */  public class StringViewHolder extends UltimateRecyclerviewViewHolder{      public TextView tv;      public StringViewHolder(View itemView,boolean isItem) {          super(itemView);          if(isItem){              tv = (TextView) itemView;          }      }  }

5.重点来了，所有注释都在这里

 package github.dzc.apptemplate.recyclerview; import android.content.Intent; import android.os.Bundle; import android.os.Handler; import android.support.design.widget.FloatingActionButton; import android.support.v4.widget.SwipeRefreshLayout; import android.support.v7.widget.LinearLayoutManager; import android.support.v7.widget.RecyclerView; import android.support.v7.widget.Toolbar; import android.support.v7.widget.helper.ItemTouchHelper; import android.view.LayoutInflater; import android.view.MotionEvent; import android.view.View; import android.view.ViewGroup; import android.widget.SimpleAdapter; import com.marshalchen.ultimaterecyclerview.UltimateRecyclerView; import com.marshalchen.ultimaterecyclerview.UltimateViewAdapter; import com.marshalchen.ultimaterecyclerview.itemTouchHelper.SimpleItemTouchHelperCallback; import com.marshalchen.ultimaterecyclerview.stickyheadersrecyclerview.StickyRecyclerHeadersDecoration; import java.util.List; import butterknife.Bind; import butterknife.ButterKnife; import github.dzc.apptemplate.BaseActivity; import github.dzc.apptemplate.R; import github.dzc.apptemplate.recyclerview.viewholder.StringViewHolder; public class RecyclerViewActivity extends BaseActivity { @Bind(R.id.recycler_view) UltimateRecyclerView recyclerView; View headerView; private StringAdapter adapter; private Handler handler; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_recycler_view); ButterKnife.bind(this); handler = new Handler(); recyclerView.setLayoutManager(new LinearLayoutManager(this)); headerView = LayoutInflater.from(this).inflate(R.layout.head_view,null); adapter = new StringAdapter(data); recyclerView.setAdapter(adapter); //为每个item添加头部的布局 这里运用到的其实就是RecyclerView.ItemDecoration //没错 可能一般都是用这个来实现item之间的分隔线的 但是线也是一个view，但这个view够大的时候，就是一个头部了 StickyRecyclerHeadersDecoration stickyRecyclerHeadersDecoration = new StickyRecyclerHeadersDecoration(adapter); recyclerView.addItemDecoration(stickyRecyclerHeadersDecoration); ItemTouchHelper.Callback callback = new SimpleItemTouchHelperCallback(adapter){ //这个方法还有别的方法可以重载 可以控制如滑动删除等功能 @Override public int getMovementFlags(RecyclerView recyclerView, RecyclerView.ViewHolder viewHolder) { final int dragFlags = ItemTouchHelper.UP | ItemTouchHelper.DOWN;//控制拖动的方向 这里设置了智能上下拖动交换位置 final int swipeFlags = ItemTouchHelper.LEFT ;//控制滑动删除的方向 这里设置了只能左滑删除 // final int swipeFlags = ItemTouchHelper.LEFT |ItemTouchHelper.RIGHT;//左右滑删除 return makeMovementFlags(dragFlags, swipeFlags); } @Override public boolean isItemViewSwipeEnabled() { return super.isItemViewSwipeEnabled();//这里控制开启或关闭item是否可以滑动删除的功能 } @Override public boolean isLongPressDragEnabled() { return super.isLongPressDragEnabled();//控制长按拖动功能 } }; final ItemTouchHelper itemTouchHelper = new ItemTouchHelper(callback); itemTouchHelper.attachToRecyclerView(recyclerView.mRecyclerView); //设置头部一定要在setAdapter后面，因为这个操作会调用adapter的方法来显示头部，如果adapter为null，则出错 recyclerView.setParallaxHeader(headerView); recyclerView.enableDefaultSwipeRefresh(true);//开启下拉刷新 recyclerView.enableLoadmore();//开启上拉加载更多 recyclerView.setDefaultOnRefreshListener(new SwipeRefreshLayout.OnRefreshListener() { @Override public void onRefresh() { handler.postDelayed(new Runnable() { @Override public void run() { recyclerView.setRefreshing(false); } },2000); } }); } class StringAdapter extends UltimateViewAdapter<StringViewHolder>{ private List<String> stringList; public StringAdapter(List<String> stringList) { this.stringList = stringList; } @Override public StringViewHolder getViewHolder(View view) { return new StringViewHolder(view,false); //这个getViewHolder方法在内部实现中只有在获取头部、加载更多、下拉刷新的时候会调用 //直接设置itemView为GONE，所以不需要初始化什么的，只要返回的是个ViewHolder就行 } @Override public StringViewHolder onCreateViewHolder(ViewGroup parent) { View view = LayoutInflater.from(RecyclerViewActivity.this).inflate(R.layout.string_item,null); return new StringViewHolder(view,true); } @Override public int getAdapterItemCount() { return stringList==null?0:stringList.size(); //这里返回的是你的item的个数 不包括头部和加载view } @Override public long generateHeaderId(int position) { // if (getItem(position).length() > 0) // return getItem(position).charAt(0); // else return -1; if(customHeaderView!=null){ position-=1; } String s = position+""; return s.charAt(0); //为每一项item生成头部的View，如果返回－1，则不生成，假如多个连续的item返回同一个id， //则只会生成一个头部View //这里提取position的第一个数作为id //1 10 11 12 14等返回的id是一样的 为1 } @Override public void onBindViewHolder(StringViewHolder holder, int position) { //一定要加这个判断 因为UltimateRecyclerView本身有加了头部和尾部 这个方法返回的是包括头部和尾部在内的 if (position < getItemCount() && (customHeaderView != null ? position <= stringList.size() : position < stringList.size()) && (customHeaderView != null ? position > 0 : true)) { position -= customHeaderView==null?0:1; holder.tv.setText(stringList.get(position)); } } @Override public RecyclerView.ViewHolder onCreateHeaderViewHolder(ViewGroup parent) { View view = LayoutInflater.from(RecyclerViewActivity.this).inflate(R.layout.string_item,null); return new StringViewHolder(view,true); //初始化item的头部布局 这里为了方便 就直接用StringViewHolder,实际使用可以使用不同于item的布局 } @Override public void onBindHeaderViewHolder(RecyclerView.ViewHolder holder, int position) { if(customHeaderView!=null){ position-=1; } ((StringViewHolder)holder).tv.setText("header "+(position+"").charAt(0)); ((StringViewHolder)holder).tv.setTextColor(getResources().getColor(android.R.color.holo_red_dark)); //绑定item头部view的数据，这里提取每个view的position的第一个数来作为头部显示数据 //即10 11 12 13 14这些 返回的是1 //20 21 22等是2 } @Override public void onItemMove(int fromPosition, int toPosition) { swapPositions(data,fromPosition,toPosition); //如果开启的拖动移动位置的功能 //要重写这个方法 因为如果不重写 交换的只是view的位置，数据的位置没有交换 一拖动，就会变成原来的样子 super.onItemMove(fromPosition, toPosition); } @Override public void onItemDismiss(int position) { remove(data,position);//控制删除的 super.onItemDismiss(position); } } } 

代码我放在了github
https://github.com/duzechao/AppTemplate