MultiViewAdapter

Helper library for recyclerviews to create composable view holders without boilerplate code.

Gradle Dependency

The Gradle dependency is available via JCenter. JCenter is the default maven repository used by Android Studio.

The minimum API level supported by this library is API 9.

dependencies {

  compile 'com.github.devahamed:multi-view-adapter:1.2.3'

 // If you want to use data binding
  compile 'com.github.devahamed:multi-view-adapter-databinding:1.2.3' 
}

Why this library?

Most of the android apps out there uses recyclerview to display content. As with any other system-level api, recyclerview api is also designed in a generic way. So it needs lot of code to be written for displaying a simple list. And it doubles, if you need to display multiple view types. MultiViewAdapter library helps you in removing this boilerplate code while allowing you to truly re-use the viewholder code across various adapters.

There are many other libraries, which provides the same feature. But they do enforce the either or all of the following constraints :

Your POJO classes should extend/implement some Base classes. This forces us to make changes in model level.
Forces you to implement some boilerplate code - like managing view types by yourself.
Doesn't utilise diffutil or payloads from recyclerview api

Now the advantages of the MultiViewAdapter

No restrictions on POJO class' parent/hierarchy. Now, your model classes can truly reside inside data layer.
No need to cast your models, no need for switch/if-else cases when you are having multiple view types.
Takes advantage of diffutil and allows payload while notifying adapter.

Key concepts

RecyclerAdapter - This is the adapter class. It can have multiple ItemBinder and DataManagers. It extends from official RecyclerView.Adapter
ItemBinder - ItemBinder's responsibility is to create and bind viewholders. ItemBinder has type parameter which accepts the model class need to be displayed. ItemBinder needs to be registered inside RecyclerAdapter. ItemBinder can be registered with multiple adapters.
DataManger - Consider it as a List. But internally it calls necessary animations when the list is modified. There are two DataManagers. DataListManager for list of items. DataItemManager for a single item (Header, Footer etc.,).

You can read more about this library here in this Medium article.

Features

Multiple data set can be added to the adapter. WikiDoc
Adds different ItemDecoration for different ItemBinders. WikiDoc
Single and Multiple selection options are available. WikiDoc
Out of the box support for DiffUtil. WikiDoc
Custom span count for every binder. WikiDoc
Data binding support. WikiDoc
Advanced drag and drop support. WikiDoc
Swipe to dismiss. WikiDoc
Infinite scrolling. WikiDoc
Helper class for contextual action mode. WikiDoc
Items can be expanded/collapsed. WikiDoc
Groups can be expanded/collapsed. WikiDoc

File Templates

This library has default file templates for creating Adapters, ItemBinders for given model name. Take a look at wiki page for using the file templates. Wiki page

Usage

Let us display list of cars. No fuss. Here is the entire code.

CarBinder

class CarBinder extends ItemBinder<CarModel, CarBinder.CarViewHolder> {

 @Override public CarViewHolder create(LayoutInflater inflater, ViewGroup parent) {

  return new CarViewHolder(inflater.inflate(R.layout.item_car, parent, false));

}

 @Override public boolean canBindData(Object item) {

  return item instanceof CarModel;

}

 @Override public void bind(CarViewHolder holder, CarModel item) {

  // Bind the data here

}

 static class CarViewHolder extends BaseViewHolder<CarModel> {

  // Normal ViewHolder code

}
 
}

In your Activity/Fragment

class CarListActivity extends Activity {

 private RecyclerView recyclerView;
private List<CarModel> cars;
 public void initViews() {

  SimpleRecyclerAdapter<CarModel, CarBinder> adapter =

new SimpleRecyclerAdapter<>(new CarBinder());

recyclerView.setAdapter(adapter);

  adapter.setDataList(cars);

}
 
}

Now you are good to go.

For advanced usage and features kindly take a look at sample app code. Also we have comprehensive wiki pages as well. Take a look at Wiki home.

Changelog

See the project's Releases page for a list of versions with their changelog. View Releases
If you watch this repository, GitHub will send you an email every time there is an update.

Contribution

Contributing to this library is simple,

Clone the repo
Make the changes
Make a pull request to develop branch

The only requirement is whatever changes you make should be backward compatible. Also make sure its not a too specific feature which maynot be useful for everyone. Kindly make sure your code is formatted with this codestyle - Square Java code style

Alternatives

This library may not suit your needs or imposes too many restrictions. In that case create an issue/feature request. Mean time check these awesome alternatives as well.

MultipleViewTypesAdapter - Original inspiration for this library.
AdapterDelegates
Groupie
Epoxy

License

Copyright 2017 Riyaz Ahamed  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
  http://www.apache.org/licenses/LICENSE-2.0  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.

MultiViewAdapter