Description
An Adapter that allows a RecyclerView to be split into Sections with headers and/or footers.
In addition, each Section can have its state(Loading/Loaded/Failed) controlled individually.
SectionedRecyclerViewAdapter alternatives and similar packages
Based on the "Adapter" category.
Alternatively, view SectionedRecyclerViewAdapter alternatives based on common mentions on social networks and blogs.
-
Epoxy
Epoxy is an Android library for building complex screens in a RecyclerView -
FastAdapter
The bullet proof, fast and easy to use adapter library, which minimizes developing time to a fraction... -
Renderers
Renderers is an Android library that avoids all the boilerplate needed to create a new ListView adapter. -
MultiChoiceAdapter
Android - A ListView adapter with support for multiple choice modal selection -
AutoplayVideos
Android library to auto-play/pause videos from url in recyclerview. -
SlimAdapter
A slim & clean & typeable Adapter withoooooooout# VIEWHOLDER -
RecyclerViewHelper
๐ Provides the most common functions around recycler view like Swipe to dismiss, Drag and Drop, Divider in the ui, events for when item selected and when not selected, on-click listener for items. -
EfficientAdapter
An efficient adapter to make the use of RecyclerView much easier for Android. -
GridListViewAdapters
This library provides GridAdapters(ListGridAdapter & CursorGridAdapter) which enable you to bind your data in grid card fashion within android.widget.ListView, Also provides many other features related to GridListView. -
instant-adapter
Just like instant coffee, saves 78% of your time on Android's Custom Adapters. -
SmartRecyclerAdapter
Never code any boilerplate RecyclerAdapter again! -
RxRecyclerAdapter
Rx based generic RecyclerView Adapter Library with support for sections. -
EasyListViewAdapters
This library provides Easy Android ListView Adapters(EasyListAdapter & EasyCursorAdapter) which makes designing Multi-Row-Type ListView very simple & cleaner, It also provides many useful features for ListView. -
generic-adapter
Generic RecyclerView adapter -
Preview Image Collection
A library to make a mosaic with a preview of multiple images -
IntentSharingAnim
Intent sharing between activities of views with animation -
Android-BasicAdapter
No separate adapter files for not-so-complex RecyclerViews -
MultiLevelAdapter
Android library to allow collapsing and expanding items in RecyclerView's Adapter on multiple levels -
Register-Yourself
This app uses SQLite database to sign-up and register a user -
Suggestive ๐
An Android UI library that allows easy implementation of (text) input suggestion popup windows.
Get performance insights in less than 4 minutes
* Code Quality Rankings and insights are calculated and provided by Lumnify.
They vary from L1 to L5 with "L5" being the highest. Visit our partner's website for more details.
Do you think we are missing an alternative of SectionedRecyclerViewAdapter or a related project?
README
SectionedRecyclerViewAdapter
An Adapter that allows a RecyclerView to be split into Sections with headers and/or footers.
[Linear](art/sc1.png) [Grid](art/sc4.png)
In addition, each Section can have its state(Loading/Loaded/Failed/Empty) controlled individually.
[Loading](art/sc2.png) [Loaded](art/sc3.png)
Gradle Dependency
Add this to the dependencies
section in your project-level build.gradle file:
implementation 'io.github.luizgrp.sectionedrecyclerviewadapter:sectionedrecyclerviewadapter:x.y.z'
Guide to upgrade to version 3.x here.
Latest version without AndroidX: 1.2.0
.
Basic usage
1) Create a custom Section class:
class MySection extends Section {
List<String> itemList = Arrays.asList("Item1", "Item2", "Item3");
public MySection() {
// call constructor with layout resources for this Section header and items
super(SectionParameters.builder()
.itemResourceId(R.layout.section_item)
.headerResourceId(R.layout.section_header)
.build());
}
@Override
public int getContentItemsTotal() {
return itemList.size(); // number of items of this section
}
@Override
public RecyclerView.ViewHolder getItemViewHolder(View view) {
// return a custom instance of ViewHolder for the items of this section
return new MyItemViewHolder(view);
}
@Override
public void onBindItemViewHolder(RecyclerView.ViewHolder holder, int position) {
MyItemViewHolder itemHolder = (MyItemViewHolder) holder;
// bind your view here
itemHolder.tvItem.setText(itemList.get(position));
}
@Override
public RecyclerView.ViewHolder getHeaderViewHolder(View view) {
// return an empty instance of ViewHolder for the headers of this section
return new EmptyViewHolder(view);
}
}
2) Create a custom ViewHolder for the section items:
class MyItemViewHolder extends RecyclerView.ViewHolder {
private final TextView tvItem;
public MyItemViewHolder(View itemView) {
super(itemView);
tvItem = (TextView) itemView.findViewById(R.id.tvItem);
}
}
3) Set up your RecyclerView with the SectionedRecyclerViewAdapter:
// Create an instance of SectionedRecyclerViewAdapter
SectionedRecyclerViewAdapter sectionAdapter = new SectionedRecyclerViewAdapter();
// Add your Sections
sectionAdapter.addSection(new MySection());
// Set up your RecyclerView with the SectionedRecyclerViewAdapter
RecyclerView recyclerView = (RecyclerView) findViewById(R.id.recyclerview);
recyclerView.setLayoutManager(new LinearLayoutManager(getContext()));
recyclerView.setAdapter(sectionAdapter);
Demo app
You can find a demo app [here](app) with many examples on how to implement:
- [Section with Header](app/src/main/java/io/github/luizgrp/sectionedrecyclerviewadapter/demo/example1/)
- [Section with Header and Footer](app/src/main/java/io/github/luizgrp/sectionedrecyclerviewadapter/demo/example2/)
- [Section with States](app/src/main/java/io/github/luizgrp/sectionedrecyclerviewadapter/demo/example3/)
- [Expandable Section](app/src/main/java/io/github/luizgrp/sectionedrecyclerviewadapter/demo/example4/)
- [Grid Section with Header](app/src/main/java/io/github/luizgrp/sectionedrecyclerviewadapter/demo/example5/)
- [Expandable Grid Section](app/src/main/java/io/github/luizgrp/sectionedrecyclerviewadapter/demo/example6/)
- [SearchView with Sections](app/src/main/java/io/github/luizgrp/sectionedrecyclerviewadapter/demo/example7/)
- [Animations](app/src/main/java/io/github/luizgrp/sectionedrecyclerviewadapter/demo/example8/)
- [Payloads](app/src/main/java/io/github/luizgrp/sectionedrecyclerviewadapter/demo/example9/)
[Demo](art/demosc.png)
Apps on Google Play using this library
License
The MIT License (MIT)
Copyright (c) 2016 Gustavo Pagani
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
*Note that all licence references and agreements mentioned in the SectionedRecyclerViewAdapter README section above
are relevant to that project's source code only.