美文网首页安卓 精品收藏程序员Android进阶之路
快来看看你真的会用RecyclerView吗?无所不能的装饰器I

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

作者: CoorChice | 来源:发表于2016-10-27 12:15 被阅读1257次

    参考资料

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

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

    相关文章

      网友评论

      • b509ec45f281:看了 好几篇文章没搞懂,看了那两幅图,瞬间懂了
        heaven旅行包://添加到指定位置
        mItemDecorations.add(index, decor);
        这个博主理解是不是有问题,这个index不是item的位置,是decoration chain的位置吧
        CoorChice:@findViewBy_7b47 很高兴能帮助到你。

      本文标题:快来看看你真的会用RecyclerView吗?无所不能的装饰器I

      本文链接:https://www.haomeiwen.com/subject/rwojuttx.html