trendingtechnology / rendererrecyclerviewadapter

A single adapter with multiple view types for the whole project

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

• A RecyclerView with multiple item types  —  Medium
• How to easily add Nested RecyclerView  —  Medium
• Simplifying the work with RecyclerView  —  Medium

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.6.0'
}

BETA

    maven { url 'https://oss.sonatype.org/content/repositories/snapshots/' }
    implementation 'com.github.vivchar:RendererRecyclerViewAdapter:2.7.0-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>) 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

Migrations

• Migration to v2.5.0
• Migration to v2.5.0 (by TheJuki)

Projects using RendererRecyclerViewAdapter

• Camfrog: Group Video Chat;
• Paltalk: Free group video calls & chat rooms;
• DeskRoll: Gives you secure remote access to computers;
• MedikTest: Preparation for accreditation of doctors;
• KFormMaster: Easily build generic forms with minimal effort.

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

Communication

• If you need help, please use Stack Overflow.
• If you found a bug, please open Issue.
• If you have a feature request, please open Issue.
• If you want to contribute, please submit Pull request.

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.