UltimateRecyclerView的使用方法详解

来源：互联网发布：python黑帽子和灰帽子编辑：程序博客网时间：2024/06/04 17:46

最近在用很多第三方库的时候，发现有一些附带的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

3 0