RecyclerView更全解析之 - 基本使用和分割线解析

1.概述


昨天跟自己群里的人唠嗑的时候发现还有人在用Eclipse,我相信可能还是有很多人在用ListView,这里介绍一个已经出来的n年了的控件RecyclerView,实现ListView,GridView,瀑布流的效果。还可以轻松的实现一些复杂的功能,如QQ的拖动排序,侧滑删除等等。

相关文章:
  
  RecyclerView更全解析之 - 基本使用和分割线解析
  
  RecyclerView更全解析之 - 打造通用的万能Adapter
  
  RecyclerView更全解析之 - 为它优雅的添加头部和底部
  
  RecyclerView更全解析之 - 打造通用的下拉刷新上拉加载
  
  RecyclerView更全解析之 - 仿支付宝侧滑删除和拖动排序

这里写图片描述

2.概述


最终我们肯定要用到项目中,因为我觉得所有写的东西都必须封装好下次开发可以直接用到项目中。但是首先得要熟悉该控件才行。可以选择去google官方了解RecyclerView,但要翻墙。

据官方的介绍,该控件用于在有限的窗口中展示大量数据集,其实这样功能的控件我们并不陌生,例如:ListView、GridView。

那么有了ListView、GridView为什么还需要RecyclerView这样的控件呢?整体上看RecyclerView架构,提供了一种插拔式的体验,高度的解耦,异常的灵活,通过设置它提供的不同LayoutManager,ItemDecoration , ItemAnimator实现令人瞠目的效果。

1.你想要控制其显示的方式,请通过布局管理器LayoutManager,ListView–>GridView–>瀑布流 只需要一行代码;
2.你想要控制Item间的间隔(可绘制),请通过ItemDecoration(这个比较蛋疼) ;
3.你想要控制Item增删的动画,请通过ItemAnimator;
4.你想要控制点击、长按事件,请自己写(擦,这点尼玛)。

3.基本使用


首先我们需要添加RecyclerView的依赖包,在build.gradle中添加依赖:

compile 'com.android.support:recyclerview-v7:24.0.0'

和ListView一样通过设置Adapter()给他绑定数据源,但在这之前必须设置setLayoutManager()这个方法是用来设置显示效果的(这样我们就可以通过设置布局管理显示不同的效果:ListView、GridView、瀑布流等等)。

    // 设置recyclerView的布局管理  
    // LinearLayoutManager -> ListView风格
    // GridLayoutManager -> GridView风格
    // StaggeredGridLayoutManager -> 瀑布流风格
    LinearLayoutManager linearLayoutManager = new 
          LinearLayoutManager(this);
    mRecyclerView.setLayoutManager(linearLayoutManager);

3.1 Adapter编写

接下来我们先去后台服务器请求数据,然后我们来编写Adapter,我们直接使用Okhttp获取服务器数据,在这里就不多说了,我们主要看Adapter怎么写。在ListView和GridView中我们可以不用ViewHolder,反正没人打我,只是数据特别多可能会崩溃而已;但是在RecyclerView中就不一样了它强制我们使用ViewHolder:

/**
 * Created by Darren on 2016/12/27.
 * Email: 240336124@qq.com
 * Description: 热吧订阅列表的Adapter
 */
public class CategoryListAdapter extends RecyclerView.Adapter<CategoryListAdapter.ViewHolder> {

    private List<ChannelListResult.DataBean.CategoriesBean.CategoryListBean> mList;
    private Context mContext;
    private LayoutInflater mInflater;

    public CategoryListAdapter(Context context, List<ChannelListResult.DataBean.CategoriesBean.CategoryListBean> list) {
        this.mContext = context;
        this.mList = list;
        this.mInflater = LayoutInflater.from(mContext);
    }

    /**
     * 创建条目ViewHolder
     *
     * @param parent   RecyclerView
     * @param viewType view的类型可以用来显示多列表布局等等
     * @return
     */
    @Override
    public ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
        // 创建条目
        View itemView = mInflater.inflate(R.layout.channel_list_item, parent, false);
        // 创建ViewHolder
        ViewHolder viewHolder = new ViewHolder(itemView);
        return viewHolder;
    }

    /**
     * 绑定ViewHolder设置数据
     *
     * @param holder
     * @param position 当前位置
     */
    @Override
    public void onBindViewHolder(ViewHolder holder, int position) {
        // 设置绑定数据
        ChannelListResult.DataBean.CategoriesBean.CategoryListBean item = mList.get(position);
        holder.nameTv.setText(item.getName());
        holder.channelTopicTv.setText(item.getIntro());
        String str = item.getSubscribe_count() + " 订阅 | " +
                "总帖数 <font color='#FF678D'>" + item.getTotal_updates() + "</font>";
        holder.channelUpdateInfo.setText(Html.fromHtml(str));
        // 是否是最新
        if (item.isIs_recommend()) {
            holder.recommendLabel.setVisibility(View.VISIBLE);
        } else {
            holder.recommendLabel.setVisibility(View.GONE);
        }
        // 加载图片
        Glide.with(mContext).load(item.getIcon_url()).centerCrop().into(holder.channelIconIv);
    }

    /**
     * 总共有多少条数据
     */
    @Override
    public int getItemCount() {
        return mList.size();
    }

    /**
     * RecyclerView的Adapter需要一个ViewHolder必须要extends RecyclerView.ViewHolder
     */
    public static class ViewHolder extends RecyclerView.ViewHolder {
        public TextView nameTv;
        public TextView channelTopicTv;
        public TextView channelUpdateInfo;
        public View recommendLabel;
        public ImageView channelIconIv;

        public ViewHolder(View itemView) {
            super(itemView);
            // 在创建的时候利用传递过来的View去findViewById
            nameTv = (TextView) itemView.findViewById(R.id.channel_text);
            channelTopicTv = (TextView) itemView.findViewById(R.id.channel_topic);
            channelUpdateInfo = (TextView) itemView.findViewById(R.id.channel_update_info);
            recommendLabel = itemView.findViewById(R.id.recommend_label);
            channelIconIv = (ImageView) itemView.findViewById(R.id.channel_icon);
        }
    }
}

3.2 分隔线定制

对于分隔线这个也比较蛋疼,你会发现RecyclerView并没有支持divider这样的属性。那么怎么办,你可以在创建item布局的时候直接写在布局中,当然了这种方式不够优雅,我们早就说了可以自由的去定制它。
  既然比较麻烦那么我们可以去github上面下载一个:DividerItemDecoration来参考一下。我这里就直接来写一个效果,大家也可以找找别人的博客看看。
  分割线我们利用RecyclerView的addItemDecoration(ItemDecoration fromHtml) 新建一个类来看看到底是什么:

/**
 * Created by Darren on 2016/12/27.
 * Email: 240336124@qq.com
 * Description: RecyclerView 分割线定制
 */
public class CategoryItemDecoration extends RecyclerView.ItemDecoration {
    @Override
    public void onDraw(Canvas c, RecyclerView parent, RecyclerView.State state) {

    }

    @Override
    public void getItemOffsets(Rect outRect, View view, RecyclerView parent, RecyclerView.State state) {
        
    }
}

有两个方法getItemOffsets()这里我一般指定偏移量就可以了,就是分割线占多少高度,或者说是画在什么位置,你总的给我留出位置来;onDraw()我们可以直接去绘制,绘制什么都可以因为有Canvas ,但一般都是绘制Drawable,这里不多说具体看视频吧。

/**
 * Created by Darren on 2016/12/27.
 * Email: 240336124@qq.com
 * Description: RecyclerView 分割线定制
 */
public class CategoryItemDecoration extends RecyclerView.ItemDecoration {
    private Paint mPaint;

    public CategoryItemDecoration(int color) {
        // 直接绘制颜色  只是用来测试
        mPaint = new Paint();
        mPaint.setColor(color);
        mPaint.setAntiAlias(true);
    }

    @Override
    public void onDraw(Canvas c, RecyclerView parent, RecyclerView.State state) {
        int childCount = parent.getChildCount();
        // 获取需要绘制的区域
        Rect rect = new Rect();
        rect.left = parent.getPaddingLeft();
        rect.right = parent.getWidth() - parent.getPaddingRight();
        for (int i = 0; i < childCount; i++) {
            View childView = parent.getChildAt(i);
            rect.top = childView.getBottom();
            rect.bottom = rect.top + 20;
            // 直接利用Canvas去绘制一个矩形 在留出来的地方
            c.drawRect(rect, mPaint);
        }
    }

    @Override
    public void getItemOffsets(Rect outRect, View view, RecyclerView parent, RecyclerView.State state) {
        // 在每个子View的下面留出20px来画分割线
        outRect.bottom += 20;
    }
}

看一下效果

这里写图片描述

这只是用来测试一下,并不是我们所需要的效果,只是说一下这两个方法都可以干什么就是你想怎么弄分割线就怎么弄。我们一般会使用Drawable去画,所以我们必须调整成我们最终的效果,代码其实基本一致。

/**
 * Created by Darren on 2016/12/27.
 * Email: 240336124@qq.com
 * Description: RecyclerView 分割线定制
 */
public class CategoryItemDecoration extends RecyclerView.ItemDecoration {
    private Drawable mDivider;

    public CategoryItemDecoration(Drawable divider) {
        // 利用Drawable绘制分割线
        mDivider = divider;
    }

    @Override
    public void onDraw(Canvas canvas, RecyclerView parent, RecyclerView.State state) {
        int childCount = parent.getChildCount();
        // 计算需要绘制的区域
        Rect rect = new Rect();
        rect.left = parent.getPaddingLeft();
        rect.right = parent.getWidth() - parent.getPaddingRight();
        for (int i = 0; i < childCount; i++) {
            View childView = parent.getChildAt(i);
            rect.top = childView.getBottom();
            rect.bottom = rect.top + mDivider.getIntrinsicHeight();
            // 直接利用Canvas去绘制
            mDivider.draw(canvas);
        }
    }

    @Override
    public void getItemOffsets(Rect outRect, View view, RecyclerView parent, RecyclerView.State state) {
        // 在每个子View的下面留出来画分割线
        outRect.bottom += mDivider.getIntrinsicHeight();
    }
}

接下来我们就可以在drawable,下面新建一个xxx.xml的分割线文件了

<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android">
    <size android:height="0.5dp"   />
    <solid android:color="@color/list_item_divider" />
</shape>
这里写图片描述

基本没什么效果因为分割线比较小0.5dp,仔细看还是看得出来的,最后声明一下因为整个项目涉及到一键更换皮肤,那么恭喜恭喜这样做并没什么卵用,我们还是得直接写在item布局中,而不是用代码设置分割线。

3.3 RecyclerView分割线源码解析
  
  估计很大一部分的哥们在开发的时候都是使用的第三方的分割线,基本上都类似,一般都是利用系统自带的一个属性 android.R.attrs.listDriver我们直接获取这个属性的Drawable去绘制,那么这里我们分析一下源码去了解一些RecyclerView到底是怎样添加分割线的。
  一万一千多行代码我们就只挑关键的方法:measureChild(),onDraw() , soeasy()

    // 只挑关键代码 一万一千多行太多了
    /**
    * Measure a child view using standard measurement policy, taking the padding
    * of the parent RecyclerView and any added item decorations into account.
    *
    * <p>If the RecyclerView can be scrolled in either dimension the caller may
    * pass 0 as the widthUsed or heightUsed parameters as they will be irrelevant.</p>
    *
    * @param child Child view to measure
    * @param widthUsed Width in pixels currently consumed by other views, if relevant
    * @param heightUsed Height in pixels currently consumed by other views, if relevant
    */
    public void measureChild(View child, int widthUsed, int heightUsed) {
        final LayoutParams lp = (LayoutParams) child.getLayoutParams();
        // 关键看这个方法 --> getItemDecorInsetsForChild
        final Rect insets = mRecyclerView.getItemDecorInsetsForChild(child);
        widthUsed += insets.left + insets.right;
        heightUsed += insets.top + insets.bottom;
        // 考虑分割线返回的Rect
        final int widthSpec = getChildMeasureSpec(getWidth(), getWidthMode(),
            getPaddingLeft() + getPaddingRight() + widthUsed, lp.width,
            canScrollHorizontally());
        final int heightSpec = getChildMeasureSpec(getHeight(), getHeightMode(),
            getPaddingTop() + getPaddingBottom() + heightUsed, lp.height,
            canScrollVertically());
        if (shouldMeasureChild(child, widthSpec, heightSpec, lp)) {
            child.measure(widthSpec, heightSpec);
        }
    }

    /**
    *  获取分割线装饰的Rect
    **/
    Rect getItemDecorInsetsForChild(View child) {
        final LayoutParams lp = (LayoutParams) child.getLayoutParams();
        if (!lp.mInsetsDirty) {
            return lp.mDecorInsets;
        }

        if (mState.isPreLayout() && (lp.isItemChanged() || lp.isViewInvalid())) {
            // changed/invalid items should not be updated until they are rebound.
            return lp.mDecorInsets;
        }
        final Rect insets = lp.mDecorInsets;
        insets.set(0, 0, 0, 0);
        final int decorCount = mItemDecorations.size();
        for (int i = 0; i < decorCount; i++) {
            mTempRect.set(0, 0, 0, 0);
            // getItemOffsets()还是比较熟悉,获取分割线返回的占用位置
            mItemDecorations.get(i).getItemOffsets(mTempRect, child, this, mState);
            // 开始累加占用位置
            insets.left += mTempRect.left;
            insets.top += mTempRect.top;
            insets.right += mTempRect.right;
            insets.bottom += mTempRect.bottom;
        }
        lp.mInsetsDirty = false;
        // 返回分割线的Rect
        return insets;
    }

    // onDraw()方法异常简单,自己体会一下吧
    @Override
    public void onDraw(Canvas c) {
        super.onDraw(c);

        final int count = mItemDecorations.size();
        for (int i = 0; i < count; i++) {
            // 回调出去直接在getItemOffsets留出分割线位置的基础上直接绘制
            mItemDecorations.get(i).onDraw(c, this, mState);
        }
    }

3.4 长按和点击事件
  
  这个是第二坑,第一坑就是上面的,后面还会有第三坑,RecyclerView并没有方法可以setOnItemClickListener()。我们只能在Adapter里面去写接口了,但是想想我们会有很多Adapter的每个都单独的去写会不会很麻烦。这个不用担心后面我们会写万能的Adapter,后面也会去自定义RecyclerView,目前只能这么弄了,修改修改Adapter:

/**
 * Created by Darren on 2016/12/27.
 * Email: 240336124@qq.com
 * Description: 热吧订阅列表的Adapter
 */
public class CategoryListAdapter extends RecyclerView.Adapter<CategoryListAdapter.ViewHolder> {

    // 省略之前的代码 ......

    /**
     * 绑定ViewHolder设置数据
     *
     * @param holder
     * @param position 当前位置
     */
    @Override
    public void onBindViewHolder(ViewHolder holder, final int position) {
        // 省略之前的代码 ......

        // 设置点击和长按事件
        if (mItemClickListener != null) {
            holder.itemView.setOnClickListener(new View.OnClickListener() {
                @Override
                public void onClick(View v) {
                    mItemClickListener.onItemClick(position);
                }
            });
        }
        if (mLongClickListener != null) {
            holder.itemView.setOnLongClickListener(new View.OnLongClickListener() {
                @Override
                public boolean onLongClick(View v) {
                    return mLongClickListener.onLongClick(position);
                }
            });
        }
    }
    
    // 省略之前的代码 ......


    /***************
     * 给条目设置点击和长按事件
     *********************/
    public OnItemClickListener mItemClickListener;
    public OnLongClickListener mLongClickListener;

    public void setOnItemClickListener(OnItemClickListener itemClickListener) {
        this.mItemClickListener = itemClickListener;
    }

    public void setOnLongClickListener(OnLongClickListener longClickListener) {
        this.mLongClickListener = longClickListener;
    }

    public interface OnItemClickListener {
        public void onItemClick(int position);
    }

    public interface OnLongClickListener {
        public boolean onLongClick(int position);
    }
}

估计有些不想接触新事物的哥们会觉得,哪里好用。他们都说好我觉得也好用着用着就好了因为公司的人都在用我不用也没办法。下一期我们还是解析RecyclerView可能会要更好用一些.

附视频地址:http://pan.baidu.com/s/1jHW1X10

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 158,736评论 4 362
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,167评论 1 291
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,442评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,902评论 0 204
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,302评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,573评论 1 216
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,847评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,562评论 0 197
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,260评论 1 241
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,531评论 2 245
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,021评论 1 258
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,367评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,016评论 3 235
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,068评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,827评论 0 194
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,610评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,514评论 2 269

推荐阅读更多精彩内容