by zhukic

Simple Android library that allows you to easily split your RecyclerView into expanding/collapsing s...

128 Stars 27 Forks Last release: over 1 year ago (1.2.3) Apache License 2.0 127 Commits 3 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:


Build Status Download

A simple Android library that allows you to easily split your RecyclerView into expanding/collapsing sections with headers.

Screenshots Screenshots


The Gradle dependency is available via jCenter.

Add this to your

implementation 'com.github.zhukic:sectioned-recyclerview:1.2.3'

How it works

The main idea of the library is to determine whether to place a subheader between a pair of neighboring items. To do this, you need to implement the

method, which returns
when you need to place a subheader between two neighboring items,
- otherwise. ```java @Override public boolean onPlaceSubheaderBetweenItems(int position) { final char movieTitleFirstCharacter = movieList.get(position).getTitle().charAt(0); final char nextMovieTitleFirstCharacter = movieList.get(position + 1).getTitle().charAt(0);
//The subheader will be placed between two neighboring items if the first characters in movie titles are different.
return movieTitleFirstCharacter != nextMovieTitleFirstCharacter;

} ```


Please try out sample app for more details. Or:


If you are using a

set it to adapter.
GridLayoutManager gridLayoutManager = new GridLayoutManager(getContext(), 2);


Copyright 2016 Vladislav Zhukov

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.