Get rid of the old Recycler View with adapter and have fun showing list of views easily with EasyListView just like Flutter. Use the very easy builder pattern for setting up your list with only 8 to 10 lines of code.
To know how to use this library, kindly see - SampleEasyListView
- Android Studio (Gradle build system)*
- A project where you want to add a list of views like RecyclerView
In App Gradle File
dependencies {
...
implementation 'com.github.msayanece:EasyListView:0.1.1'
}In Project Gradle File
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}
See the project's Releases page for a list of versions with their change logs.
If you Watch this repository, GitHub will send you an email every time I publish an update.
-
In your Activity or Fragment : Where you have added the RecyclerView in your layout and get the RecyclerView object of your layout in your Java or Kotlin file and pass it to the SDK.
-
Create a ListTile object to map the getter methods of the model
ListTile<ItemsPOJO> listTile = new ListTile<ItemsPOJO>(ItemsPOJO.class)
.addTitle("getName") //Argument-> method name of the Model to be mapped
.addDescription("getDesc") //Argument-> method name of the Model to be mapped
.addIcon(EasyListView.IconPosition.LEADING, "getImage");
////Argument->LEADING or TRAILING and method name of the Model to be mapped- Build the EasyListView with your ListTile object.
new EasyListView.Builder<ItemsPOJO>(this)
.addRecyclerView(recyclerView) // Pass your RecyclerView
.addListItems(listItems) // The List of items to display
.addItemModel(ItemsPOJO.class) // The Item Model.class
.addRow(listTile) // Add the ListTile object you have just created
.setCount(listItems.size()) // Optional set item count
.setOnItemClickListener(this) // Optional set on click listener
.setOnBindViewHolderCalledListener(this) // Optional set on bind view holder to write your own logic
.build();-
In your Activity or Fragment : Where you have added the RecyclerView in your layout and get the RecyclerView object of your layout in your Java or Kotlin file and pass it to the SDK.
-
Create your custom layout for the row template.
<?xml version="1.0" encoding="utf-8"?>
<android.support.constraint.ConstraintLayout
xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:padding="5dp">
<TextView
android:id="@+id/textView"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_marginStart="5dp"
android:layout_marginTop="5dp"
android:layout_marginBottom="5dp"
android:text="asd"
app:layout_constraintBottom_toBottomOf="parent"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toTopOf="parent" />
</android.support.constraint.ConstraintLayout>- Create the model class and annotate with
@ID(viewResID)to the correspondinggettermethod for setting model data automatically without any logic, when the list loads.
You can skip this step, if you are going to write your own logic inside the onBindViewHolderListener using the setOnBindViewHolderCalledListener() method.
public class TestPOJO {
private String text;
public TestPOJO(String text) {
this.text = text;
}
@ID(R.id.textView)
public String getText() {
return text;
}
}- Build the EasyListView with your own custom objects.
new EasyListView.Builder<CustomItemsPOJO>(this)
.addRecyclerView(recyclerView) //Mandatory, the RecyclerView object
.addListItems(listItems) //Mandatory, the list of Items (Models)
.addItemModel(CustomItemsPOJO.class) //Mandatory, the Model .class
.setCount(listItems.size()) //Optional, set count of items in the list
.addLayoutManager(new LinearLayoutManager(this)) //Optional, The SDK will use this layout manager only for the custom setup
.addRow(R.layout.child_layout) // The custom layout of Recycler child
.setOnItemClickListener(this) //Optional
.setOnBindViewHolderCalledListener(this) //Optional, if you want to execute your own logic
.build();- If you want you may write your own logic inside the callback methods of the OnBindViewHolderCalledListener.
new EasyListView.OnBindViewHolderCalledListener<ItemsPOJO>() {
@Override
public void onBasicBindViewHolder(@NonNull SimpleTextAdapter.SimpleTextViewHolder<ItemsPOJO> viewHolder, ItemsPOJO itemOnThatPosition, int position) {
//not called for custom setup
//your Logic here
}
@Override
public void onCustomBindViewHolder(@NonNull CustomRecyclerAdapter.CustomRecyclerViewHolder<ItemsPOJO> viewHolder, ItemsPOJO itemOnThatPosition, int position) {
//not called for basic setup
//your Logic here
}
}- Fork this repository to your github profile (On the Top-Right corner).
- Copy the URL of your repository on your profile from your browser.
- Open Android Studio.
- click on File --> New --> Project from Version Control --> Git.
- Paste the URL on GIT Repository URL Box.
- Select your Parent Directory (Where the project should be installed in your local Computer).
- Change the Directory name if you want.
- Click on Clone. ( After cloning if any pop-up appears, Click on Remove Selected)
And You are done.
After gradle build finished, you can run it on your Emulator or real device by clicking on the green triangular buuton on the top.
Gradle
You are welcome to contribute to this repository. For Contribute to this repository follow this process...
- Commit your changes.
- Push to Github.
- Create a pull request with proper comment (Why these changes required, how these changes effect this project etc).
- You can also contribute to this project by editing or by writing contents etc.
Sayan Mukherjee - Android Developer See also the list of contributors who participated in this project.
This project is free and open source to use in any project if you want.
This Project is based on The RecyclerView of Android. Other concepts of Java like Annotations, Java Reflection API and Google's Glide library has been used in this project.