Sectioned RecyclerView
Sectioned RecyclerView allows you to easily split a RecyclerView into sections with headers and optional footers. Headers can be expanded and collapsed, you can even hide empty sections.
Gradle Dependency
The Gradle dependency is available via jCenter. jCenter is the default Maven repository used by Android Studio.
Dependency
Add this to your module's build.gradle file:
dependencies {
// ... other dependencies
compile 'com.afollestad:sectioned-recyclerview:0.5.0'
}
Adapter
Here's a basic example:
public class MainAdapter extends SectionedRecyclerViewAdapter<MainAdapter.MainVH> {
@Override
public int getSectionCount() {
return 20; // number of sections, you would probably base this on a data set such as a map
}
@Override
public int getItemCount(int sectionIndex) {
return 8; // number of items in section, you could also pull this from a map of lists
}
@Override
public void onBindHeaderViewHolder(MainVH holder, int section, boolean expanded) {
// Setup header view
}
@Override
public void onBindViewHolder(MainVH holder, int section, int relativePosition, int absolutePosition) {
// Setup non-header view.
// 'section' is section index.
// 'relativePosition' is index in this section.
// 'absolutePosition' is index out of all items, including headers and footers.
// See sample project for a visual of how these indices work.
}
@Override
public void onBindFooterViewHolder(MainVH holder, int section) {
// Setup footer view, if footers are enabled (see the next section)
}
@Override
public MainVH onCreateViewHolder(ViewGroup parent, int viewType) {
// Change inflated layout based on type
int layoutRes;
switch(viewType) {
case VIEW_TYPE_HEADER:
layoutRes = R.layout.header;
break;
case VIEW_TYPE_FOOTER:
// if footers are enabled
layoutRes = R.layout.footer;
break;
default:
layoutRes = R.layout.normal_item;
break;
}
View v = LayoutInflater.from(parent.getContext())
.inflate(layoutRes, parent, false);
return new MainVH(v);
}
public static class MainVH extends SectionedViewHolder
implements View.OnClickListener {
public MainVH(View itemView) {
super(itemView);
// Setup view holder. You'd want some views to be optional, e.g. the
// header/footer will have views that normal item views do or do not have.
itemView.setOnClickListener(this);
}
@Override
public void onClick(View view) {
// SectionedViewHolder exposes methods such as:
boolean isHeader = isHeader();
boolean isFooter = isFooter();
ItemCoord position = getRelativePosition();
int section = position.section();
int relativePos = position.relativePos();
}
}
}
Enabling Footers
Enabling footers is simple:
adapter.shouldShowFooters(true);
You just have to make sure you handle footers in your view holder creation and view holder binding.
Expanding and Collapsing Sections
Expanding and collapsing sections is easy:
MainAdapter adapter = // ... adapter.expandSection(int);
adapter.collapseSection(int);
adapter.toggleSectionExpanded(int);
adapter.expandAllSections();
adapter.collapseAllSections();
boolean isExpanded = adapter.isSectionExpanded(int);
Hiding Empty Sections
You can tell the adapter to hide sections which have no items.
MainAdapter adapter = // ... adapter.shouldShowHeadersForEmptySections(false);
Notifying Adapter of Section Changes
Like notifyDataSetChanged(), notifyItemInserted(int), notifyItemRemoved(int) (etc.), the sectioned adapter provides a method called notifySectionChanged(int). It notifies the adapter that every item in that section has changed, rather than every item in the whole adapter. onBindViewHolder will be called again for each item in the section.
You should not use this method when a section has been added or removed. You should always use notifyDataSetChanged() for that to avoid data corruption in the adapter.
Layout Manager
If you're using a LinearLayoutManager, you're all set. If you're using a GridLayoutManager, you need to tell the adapter:
GridLayoutManager manager = // ... adapter.setLayoutManager(manager);
This is vital to getting headers to span all columns.