Skip to content

vivchar/RendererRecyclerViewAdapter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
Oct 14, 2017
Oct 14, 2017
Mar 24, 2017
Oct 14, 2017
Oct 14, 2017
Jan 10, 2017
Mar 24, 2017
Oct 4, 2017
Jan 9, 2017
Mar 24, 2017
Aug 31, 2017
Sep 21, 2017
Jan 10, 2017
Jan 10, 2017
Sep 18, 2017
Mar 24, 2017
Oct 14, 2017

Repository files navigation

Renderer Recycler View Adapter Maven Central API API

  • 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 support;
  • Using this library will protect you from the appearance of any business logic in an adapter 😊.

Example

Example

Gradle

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

Usage

  • Step 1. Implement SomeModel
public class SomeModel implements ItemModel {

	public static final int TYPE = 0;
	private String mTitle;

	public SomeModel(String title) {
		mTitle = title;
	}

	@Override
	public int getType() {
		return TYPE;
	}

	public String getTitle() {
		return mTitle;
	}
	...
}
  • Step 2. Implement SomeViewHolder
public class SomeViewHolder extends RecyclerView.ViewHolder {

	public TextView mTitle;

	public SomeViewHolder(View itemView) {
		super(itemView);
		mTitle = (TextView) itemView.findViewById(R.id.title);
		...
	}
}
  • Step 3. Implement SomeViewRenderer
public class SomeViewRenderer extends ViewRenderer<SomeModel, SomeViewHolder> {

	public SomeViewRenderer(int type, Context context) {
		super(type, context);
	}

	@Override
	public void bindView(SomeModel model, SomeViewHolder holder) {
		holder.mTitle.setText(model.getTitle());
		...
	}

	@Override
	public SomeViewHolder createViewHolder(ViewGroup parent) {
		return new SomeViewHolder(inflate(R.layout.some_item, parent));
	}
}
  • Step 4. Initialize Adapter and register the SomeViewRenderer
public class SomeActivity extends AppCompatActivity {

	private RendererRecyclerViewAdapter mRecyclerViewAdapter;
	private RecyclerView mRecyclerView;

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.main);

		mRecyclerViewAdapter = new RendererRecyclerViewAdapter();
		mRecyclerViewAdapter.registerRenderer(new SomeViewRenderer(SomeModel.TYPE, this));
		mRecyclerViewAdapter.registerRenderer(...); /* you can use several types of cells */

		mRecyclerView = (RecyclerView) findViewById(R.id.recycler_view);
		mRecyclerView.setLayoutManager(new LinearLayoutManager(this));
		mRecyclerView.setAdapter(mRecyclerViewAdapter);

		mRecyclerViewAdapter.setItems(getItems());
		mRecyclerViewAdapter.notifyDataSetChanged();
		
		//Or you can use method with the DiffUtil support
		//mRecyclerViewAdapter.setItems(getItems(), new YourDiffCallBack());
	}
	...
}

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.