EasyRecyclerView

Click on image to watch video

Why we have to define adapter for a RecyclerView. It's very take time when we have a lot of list view right? With Easy RecyclerView we just need to care about 2 things

1. Data Object Model (DAO)
2. ViewBinder -> Input of ViewBinder consist of DAO and View item. It's contain only one function bind() to bind DAO with View item

That's is whats we need to care about. For now, we will handle as below with 3 steps only:

Step 1: In your xml

<com.thphuoc.erv.EasyRecyclerView
        android:id="@+id/listView"
        android:layout_width="match_parent"
        android:layout_height="0dp"
        app:layout_constraintBottom_toTopOf="@id/btnAddBottom"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintTop_toBottomOf="@id/btnAddTop"
        tools:ignore="SpeakableTextPresentCheck" />

Step 2: In your kotlin Add Item view binder. In here, we define 2 type of view types (data item and header item)

data class DataItemViewBinder(
    val context: Context,
    val name: String,
    val onRemove: (viewBinder: DataItemViewBinder) -> Unit
) : EasyItemViewBinder {
    override val viewResId: Int = R.layout.item_view

    override fun bind(view: View) {
        view.tvName.text = name
        view.btnDelete.setOnClickListener {
            onRemove(this)
        }
    }
}

data class HeaderItemViewBinder(
    val context: Context,
    val name: String
) : EasyItemViewBinder {
    override val viewResId: Int = R.layout.item_view_header

    override fun bind(view: View) {
        view.tvName.text = name
    }
}

Step 3: In your Activity/Fragment add list of view binder

repeat(10) {
    listView.addItem(DataItemViewBinder(this, "Item1 $it") { data ->
        listView.removeItem(data)
    })
}

listView.addItem(HeaderItemViewBinder(this, "Header1"))

repeat(10) {
    listView.addItem(DataItemViewBinder(this, "Item2 $it") { data ->
        listView.removeItem(data)
    })
}

Easy to handle load more:

listView.setLoadMore(LoadMoreViewBinder {
    //Load more in here
    if (pageIndex < 4) {
        Handler().postDelayed({
            pageIndex++
            listView.loadCompleted()
            repeat(4) {
                listView.addItem(DataItemViewBinder(this, UserDAO("User2 $pageIndex$it")) { data ->
                    listView.removeItem(data)
                })
            }
        }, 1000L)
    } else {
        listView.noMoreToLoad()
    }
})

Define Layout type in xml:

<attr name="layout_type" format="enum">
    <enum name="VERTICAL" value="0"/>
    <enum name="HORIZONTAL" value="1"/>
    <enum name="VGRID2" value="2"/>
    <enum name="VGRID3" value="3"/>
    <enum name="VGRID4" value="4"/>
    <enum name="HGRID2" value="5"/>
    <enum name="HGRID3" value="6"/>
    <enum name="HGRID4" value="7"/>
</attr>

Example:

<com.thphuoc.erv.EasyRecyclerView xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="100dp"
    android:id="@+id/hozList"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    app:layout_type="HORIZONTAL"/>

Additional Features:

1. Use DiffUtil to filter data. Please note that, when perform filter, load more will be auto disable

edtSearch.addTextChangedListener { text ->
    listView.filterBy {
        when (it) {
            is DataItemViewBinder -> {
                it.user.name.lowercase().contains(text.toString().lowercase())
            }
            else -> true
        }
    }
}

Support grid decoration:

• item_space: Grid spacing
• include_edge_space: Include edge space or not

<com.thphuoc.erv.EasyRecyclerView
        android:id="@+id/listView"
        android:layout_width="match_parent"
        android:layout_height="0dp"
        app:layout_type="VGRID2"
        app:item_space="30dp"
        app:include_edge_space="true"/>

Add decoration in Code:

listView.setDecoration(space: Int, includeEdgeSpace: Boolean)

Update list use DiffUtils: listView.updateViewBinders(newList: List<EasyItemViewBinder>) In your ViewBinder, example:

class PeopleItemViewBinder(val contentData: People) : EasyItemViewBinder {
    //Override compare function in order to compare between 2 items
    override fun sameContentWith(item: EasyItemViewBinder) : Boolean {
        return (item as PeopleItemViewBinder).contentData === this.contentData
    }
}

Support draggable: In your ViewBinder override the function getDraggableHandler. Example:

class PeopleItemViewBinder(val contentData: People) : EasyItemViewBinder {
    //Override compare function in order to compare between 2 items
    override fun getDraggableHandler() : Int {
        return R.layout.view_handler //This is a view which user touch down to start drag
    }
}

How to implement? Download aar file and add into your project library folder: aar