RecyclerViewDivider
A RecyclerView's divider that can be customized with simple properties or advanced ones.
It supports completely LinearLayoutManager, GridLayoutManager and partially StaggeredGridLayoutManager.
Usage
If you want to use the basic version of this divider you can just add this line of code after your setAdapter() method:
RecyclerViewDivider.with(context).build().addTo(recyclerView);
Customization
All dividers in the app have default values in xml resources:
- Color → R.color.recycler_view_divider_color (default is #CFCFCF)
- Size → R.dimen.recycler_view_divider_size (default is 1dp)
- Inset before → R.dimen.recycler_view_divider_inset_before (default is 0dp)
- Inset after → R.dimen.recycler_view_divider_inset_after (default is 0dp)
It can be customized in code with properties equals for each divider:
- color(int) → change color
- drawable(Drawable) → change drawable
- tint(int) → change drawables' tint
- size(int) → change height for an horizontal divider, width for a vertical one
- inset(int, int) → change left/right inset for an horizontal divider, top/bottom for a vertical one
Example with all general properties set:
RecyclerViewDivider.with(context)
.color(color)
// OR
.drawable(drawable)
.tint(tint)
.size(size)
.inset(insetBefore, insetAfter)
.hideLastDivider()
.build()
.addTo(recyclerView);
It can also use custom managers to have a different logic for each divider:
- drawableManager(DrawableManager) → set color/drawable
- insetManager(InsetManager) → set inset
- sizeManager(SizeManager) → set size
- tintManager(TintManager) → set tint
- visibilityManager(VisibilityManager) → set visibility
Example with all managers set:
RecyclerViewDivider.with(context)
.drawableManager(new DrawableManager() {
@Override
public Drawable itemDrawable(int groupCount, int groupIndex) {
return position % 2 == 0 ? new ColorDrawable(Color.BLACK) : new ColorDrawable(Color.BLUE);
}
}
)
.insetManager(new InsetManager() {
@Override
public int itemInsetAfter(int groupCount, int groupIndex) {
return position % 2 == 0 ? 10 : 10 * 2;
}
@Override
public int itemInsetBefore(int groupCount, int groupIndex) {
return position % 2 == 0 ? 15 : 15 * 2;
}
}
)
.sizeManager(new SizeManager() {
@Override
public int itemSize(@Nullable Drawable drawable, int orientation, int groupCount, int groupIndex) {
return position % 2 == 0 ? 45 : 78;
}
}
)
.tintManager(new TintManager() {
@Override
public int itemTint(int groupCount, int groupIndex) {
return position == 0 ? Color.YELLOW : Color.GRAY;
}
}
)
.visibilityManager(new VisibilityManager() {
@Override
public int itemVisibility(int groupCount, int groupIndex) {
return groupCount % groupIndex == 0 ? SHOW_ITEMS_ONLY : SHOW_ALL;
}
}
)
.build()
.addTo(recyclerView);
You can also use this divider as a simple space between RecyclerView's items:
Example of divider as space:
RecyclerViewDivider.with(context).asSpace().build().addTo(recyclerView);
Compatibility
Android SDK: RecyclerViewDivider requires a minimum API level of 14 (the same of RecyclerView).
Integration
You can download a jar from GitHub's releases page or grab it from jcenter() or mavenCentral().
Gradle
dependencies {
compile 'com.github.fondesa:recycler-view-divider:1.4.0'
}
Maven
<dependency>
<groupId>com.github.fondesa</groupId>
<artifactId>recycler-view-divider</artifactId>
<version>1.4.0</version>
<type>pom</type> </dependency>