Renderer RecyclerView Adapter

Now you do not need to implement adapters for RecyclerView;
You can easily use several types of cells in a single list;
You can reuse cells in different RecyclerView;
You can easily add a nested RecyclerView;
You can easily add the DiffUtil;
You can easily add the DiffUtil Payloads;
You can easily save a state of a Item when scroll;
You can easily add a Load More Indicator;
Can be used without ViewHolder - use ViewBinder instead of ViewRenderer;
Using this library will help you to follow SOLID principles.

Articles & Presentations

Examples

All	View Renderer	View Binder	Load More

Composite	ViewState	Diff Util	Payload

Wiki

https://github.com/vivchar/RendererRecyclerViewAdapter/wiki

Gradle

dependencies {
    compile 'com.github.vivchar:RendererRecyclerViewAdapter:2.8.0'
}

BETA

Include this feature https://github.com/vivchar/RendererRecyclerViewAdapter/issues/32

maven { url 'https://oss.sonatype.org/content/repositories/snapshots/' }

dependencies {
    compile 'com.github.vivchar:RendererRecyclerViewAdapter:3.0.3-SNAPSHOT'
}

Usage

Step 1: Add the ViewModel interface to your UI model

public class SomeModel implements ViewModel {
    ...
}

Step 2: Create your item_layout

<LinearLayout ... >
<TextView android:id = "@+id/title" ... />
<ImageView android:id = "@+id/image" ... />
<Button android:id = "@+id/button" ... />
<CustomView android:id = "@+id/custom" ... />
</LinearLayout>

Step 3: Initialize Adapter and register the ViewBinder


mRecyclerViewAdapter = new RendererRecyclerViewAdapter();

mRecyclerViewAdapter.registerRenderer(new ViewBinder<>( R.layout.item_layout, SomeModel.class, (model, finder, payloads) -> finder .find(R.id.custom, (ViewProvider) customView -> { ... }) .setBackground(R.id.image, model.getBackground()) .setText(R.id.text, model.getText()) .setOnClickListener(R.id.button, v -> { ... }) )); mRecyclerViewAdapter.registerRenderer(...); / you can use several types of cells /

/* Regular code: mRecyclerView = (RecyclerView) findViewById(R.id.recycler_view); mRecyclerView.setLayoutManager(new LinearLayoutManager(this)); mRecyclerView.setAdapter(mRecyclerViewAdapter);

mRecyclerViewAdapter.setItems(getItems()); mRecyclerViewAdapter.notifyDataSetChanged(); */



## Release notes
See [the Releases Page](https://github.com/vivchar/RendererRecyclerViewAdapter/releases)

## Migrations
* [Migration to v2.5.0](https://github.com/vivchar/RendererRecyclerViewAdapter/wiki/Steps-for-migration-to-v2.5.0)
* [Migration to v2.5.0 (by TheJuki)](https://github.com/vivchar/RendererRecyclerViewAdapter/wiki/Migration-to-2.5.0)

## Projects using RendererRecyclerViewAdapter
* [Camfrog](https://play.google.com/store/apps/details?id=com.camshare.camfrog.android): Group Video Chat;
* [Paltalk](https://play.google.com/store/apps/details?id=com.paltalk.chat.android): Free group video calls & chat rooms;
* [DeskRoll](https://play.google.com/store/apps/details?id=com.deskroll.client1): Gives you secure remote access to computers;
* [MedikTest](https://play.google.com/store/apps/details?id=com.anisov.medical.accreditation): Preparation for accreditation of doctors;
* [KFormMaster](https://github.com/TheJuki/KFormMaster): Easily build generic forms with minimal effort;
* [KDV Online](https://play.google.com/store/apps/details?id=com.magonline.app): Online store of KDV, Russian producer of snacks and confectionery products, whose goods are well known and beloved not only in Russia but also well beyond.

Send me a pull request with modified README.md to get a shoutout!

## Communication
* If you need help, please use [Stack Overflow](https://stackoverflow.com/search?tab=newest&q=rendererrecyclerviewadapter).
* If you found a bug, please open [Issue](https://github.com/vivchar/RendererRecyclerViewAdapter/labels/bug).
* If you have a feature request, please open [Issue](https://github.com/vivchar/RendererRecyclerViewAdapter/labels/feature%20request).
* If you want to contribute, please submit [Pull request](https://github.com/vivchar/RendererRecyclerViewAdapter/pulls).

## License

    Copyright 2017 Vitaly Vivchar

    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.