快来看看你真的会用RecyclerView吗?无所不能的装饰器ItemDecoration

参考资料

参考资料1

背景介绍

RecyclerView由于它强大的灵活性,已经可以代替掉传统的ListViewGridView等列表控件了。但是也因为它的灵活性,一些东西就没有固定,需要我们自己来实现,比如RecyclerView就没有提供默认的分割线,当我们需要一条分割线时,我们需要自己通过继承RecyclerView.ItemDecoration来实现。当然,它不仅仅可以实现分割线,还能创造很多不一样的效果,这取决于我们的想象力在这个限制范围内能到什么程度了。本篇我们来好好聊聊ItemDecoration

认识ReccylerView.ItemDecoration

为RecyclverView添加ItemDecoration

我们可以通过调用:

mRecyclerView.addItemDecoration(mItemDecoration);

来为我们的RecyclerView添加一个自定义的ItemDecoration装饰它。
这里值得注意的是我们采用的是addXXX方法,这意味着我们可以为RcyclerView添加多个ItemDecoration。打开该方法的源码我们可以看到:

//这是我们通常调用的代码
public void addItemDecoration(ItemDecoration decor) {
        //这里又调用了另一个重载的方法
        addItemDecoration(decor, -1);
    }
    
/**
     * Add an {@link ItemDecoration} to this RecyclerView. Item decorations can
     * affect both measurement and drawing of individual item views.
     *
     * <p>Item decorations are ordered. Decorations placed earlier in the list will
     * be run/queried/drawn first for their effects on item views. Padding added to views
     * will be nested; a padding added by an earlier decoration will mean further
     * item decorations in the list will be asked to draw/pad within the previous decoration's
     * given area.</p>
     *
     * @param decor Decoration to add
     * @param index Position in the decoration chain to insert this decoration at. If this value
     *              is negative the decoration will be added at the end.
     * 通过文档我们可以知道,index参数控制这我们add的ItemDecoration添加到mItemDecorations数组中的位置。如果小于0,我们的ItemDecoration将被添加到最后。
     */
public void addItemDecoration(ItemDecoration decor, int index) {
        if (mLayout != null) {
            mLayout.assertNotInLayoutOrScroll("Cannot add item decoration during a scroll  or"
                    + " layout");
        }
        if (mItemDecorations.isEmpty()) {
            setWillNotDraw(false);
            //注意,当我们首次添加ItemDecoration时,mItemDecorations是一个空的数组,
           //但这事我们就需要让View开启自我绘制,否则RecyclerView的onDraw()方法将有可能不被执行。
           //我们在写自定义ViewGroup时也需要注意这个问题。
        }
        if (index < 0) {
        //这个逻辑保证了小于0,添加到末尾
            mItemDecorations.add(decor);
        } else {
        //添加到指定位置
            mItemDecorations.add(index, decor);
        }
        //这个方法最终把RecyclerView的Item的LayoutParams的mInsertDirty属性设置为true,
        //这样在measure时,才能够把所有的ItemDecoration中的itemOffset添加到Item的布局参数上。
        markItemDecorInsetsDirty();
        requestLayout();
    }

所以,我们可以多次调用addItemDecoration(),并且每次添加的ItemDecorationitemOffset都将累加到Item的布局参数上。

自定义ItemDecoration

对于自定义ItemDecoration我们通常仅仅关心以下3个方法就行。

getItemOffsets()

这个方法有2个重载方法:

public void getItemOffsets(Rect outRect, int itemPosition, RecyclerView parent) {
            outRect.set(0, 0, 0, 0);
            //注意,重写时super要慎重使用,否则设置的Rect会被重置。
            //通过上面的讲解,我们知道,在这里设置的outRect的参数最终都会被累加到Item的布局参数上。
            //如果值设为负数,那么Item会发生重叠。
        }

//这个方法主要能够方便的获取到View和当前RecyclerView的状态,
//但它最终调用的仍然是上一个方法,所以重写这个方法需要注意super,最好就不要要。
public void getItemOffsets(Rect outRect, View view, RecyclerView parent, State state) {
            getItemOffsets(outRect, ((LayoutParams) view.getLayoutParams()).getViewLayoutPosition(),
                    parent);
        }

这里借张图,侵删!


设置不同outRect参数的效果图

onDraw()

该方法同样有两个重载方法:

public void onDraw(Canvas c, RecyclerView parent){
    //在这个方法中利用Canvas绘制点什么,
    //它最终会绘制在Item的下一层,如果它超出Item,那么超出部分将可见。
    //注意,计算Item的top时,记得加上Translation,否则不能准确计算
}

//该方法最终还是调用上一个方法,所以要注意super,最好就不要。这个方法能够获取到RecyclerView状态。
public void onDraw(Canvas c, RecyclerView parent, State state) {
            onDraw(c, parent);
        }

借张图,侵删!

效果图

这里有个坑,在我使用mDrawable.canvas()来绘制分割线的时候,由于mDrawable.getIntrinscXXX()获得的值为-1,所以导致了绘制效果不可见。解决办法是在计算bottomright时,直接指定我们所希望的间距,除非我们已经设置mDrawable的尺寸。
还有一点需要注意:最终getItemOffset()方法中设置的偏移距离会叠加到Item的布局尺寸参数上,而分割线的绘制应该在Item底部(去尾),或者说Item顶部(去头),绘制区域

onDrawOver()

onDraw()方法类似,不同的是它将被覆盖在Item上面。它同样有两个重载方法:

public void onDrawOver(Canvas c, RecyclerView parent, State state) {
            onDrawOver(c, parent);
        }


@Deprecated
public void onDrawOver(Canvas c, RecyclerView parent) {
        }

总结

通过自定义ItemDecoration我们可以实现需要吊炸天的效果。先遵守规则,然后天马行空。

探讨

今天在换燕x矿泉水时(这不是广告),发现上面裹桶口裹的一层保护塑料,裹的倒是十分结实!但是我找了半天没发现有可以下手撕开的地方,也就是说要么硬抠开,要么借助工具,总之就是不能让你轻易就打开。不知道生产这种桶装水的人自己用不用,或者说自己换过水没?
这事儿,你怎么看?

如果这篇文章对你有帮助的话,记得点个赞哦!想要交流交流的话可以加个关注哦!

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

推荐阅读更多精彩内容