Android开源:一个通用的RecyclerView的分割线

didu5351 7年前
   <h2>前言</h2>    <p>写文章前我特地又去网上查了半天RecyclerView分割线的解决方案,大致分这么两种:</p>    <p>第一种:在item的布局里划一条线</p>    <p>第二种:自定义ItemDecoration</p>    <p>第一种方案,在LinearLayoutManager中可能没啥问题,但是到了GridViewLayoutManager你还想用吗?你确定不是在逗我?</p>    <p>第二种方案,网上几乎所有的例子都没有很好的通用性,要么只通用LinearLayoutManager,要么只通用GridViewLayoutManager,而且还没啥灵活性,比如我想某些LinearLayoutManager的最后一条item不显示分割线,默写显示,怎么办?这些都没解决好。</p>    <p>于是我想,作为一个梦想成为海贼王的男人,我必须站出来,将我私藏很久的大宝剑拿出来,分享给大家。</p>    <h2>RecyclerView分割线的难点</h2>    <p>无外乎两点:</p>    <ul>     <li>在哪里显示(哪个Item?Item的上下左右哪里?)</li>     <li>显示什么 (宽多少?虚线实线?啥颜色?纯色?渐变色?)</li>    </ul>    <p>其中最难最核心的,在哪里显示的问题,本项目已完美解决;</p>    <p>关于第二点,显示什么的问题,鉴于大部分分割线基本都是纯色的,很少有那种花里胡哨的设计,所以该项目暂时样式只支持自定义宽度和颜色,但这样相信已经满足你的要求了吧,不过很快更多可自定义的样式将放出,欢迎Star、Fork或PR。</p>    <h2>Y_DividerItemDecoration项目地址</h2>    <p><a href="/misc/goto?guid=4959747105647448203" rel="nofollow,noindex">Y_DividerItemDecoration</a></p>    <h2>简单介绍</h2>    <p>一个通用的RecyclerView的分割线,支持LinearLayoutManager和GridViewLayoutManager。只要你能描述清楚每个position上下左右分割线的情况,原则上支持任意LayoutManager</p>    <p style="text-align:center"><img src="https://simg.open-open.com/show/0621ae5f3249a5688d84dff9cb15f622.jpg"></p>    <p style="text-align:center">LinearLayoutManager</p>    <p style="text-align:center"><img src="https://simg.open-open.com/show/57e8c57a61f58b64cd5c55f4fb2937a4.jpg"></p>    <p style="text-align:center">普通GridViewLayoutManager</p>    <p style="text-align:center"><img src="https://simg.open-open.com/show/048c885a061b26d693a00f67831c7517.jpg"></p>    <p style="text-align:center">异形GridViewLayoutManager</p>    <h2>Features</h2>    <ul>     <li>LinearLayoutManager和GridViewLayoutManager通用</li>     <li>自定义分割线的宽度和颜色</li>     <li>灵活控制RecyclerView每个条目left、top、right、bottom的分割线的显示与否</li>    </ul>    <h2>Usage</h2>    <p>Step1</p>    <p>新建一个对象实现抽象类 Y_DividerItemDecoration ,在getItemSidesIsHaveOffsets(int itemPosition)中定义在itemPosition时条目的顺时针方向left, top, right, bottom是否需要显示分割线。</p>    <pre>  <code class="language-java">class DividerItemDecoration extends Y_DividerItemDecoration {            public DividerItemDecoration(Context context, int lineWidthDp, @ColorInt int colorRGB) {              super(context, lineWidthDp, colorRGB);          }            @Override          public boolean[] getItemSidesIsHaveOffsets(int itemPosition) {              //顺时针顺序:left, top, right, bottom              boolean[] isOffset = {false, false, false, true};//默认只有bottom显示分割线              return isOffset;          }      }</code></pre>    <p>Step2</p>    <p>给RecyclerView添加分割线,并传入分割线的width和color,width单位是dp,color必须是包含Alpha和R、G、B的16进值的int值,例如:0xff6c6c6c</p>    <pre>  <code class="language-java">recyclerView.addItemDecoration(new DividerItemDecoration(this, 6, 0xff6c6c6c));</code></pre>    <h2>Download</h2>    <p>Gradle</p>    <pre>  <code class="language-java">compile 'com.yanyusong.y_divideritemdecoration:y_divideritemdecoration:1.0</code></pre>    <h2> </h2>    <p> </p>    <p>项目主页:<a href="http://www.open-open.com/lib/view/home/1491963910495">http://www.open-open.com/lib/view/home/1491963910495</a></p>    <p> </p>