bdapter

Additional

Language
Kotlin
Version
0.9.3 (Feb 19, 2021)
Created
Feb 19, 2021
Updated
Feb 28, 2021 (Retired)
Owner
quartack
Contributor
quartack
1
Activity
Badge
Generate
Download
Source code

welcome to bdapter!

Hello! bdapter is made for developers who are tired of coding RecyclerView.Adapter and RecyclerView.ViewHolder.

With bdapter You can use RecyclerView without implementation of RecyclerView.Adapter and RecyclerView.ViewHolder anymore, Also multiple viewHolder is works fine.

And, bdapter supports DataBinding and MVVM.

samples

multiple viewHolder any layoutManager update items
tree filter sort
recyclerView inside recyclerView drag event

download

repositories {
    maven { url 'https://jitpack.io' }}
}
dependencies {
    implementation "com.github.quartack.bdapter:bdapter:0.9.3"
    kapt "com.github.quartack.bdapter:generator:0.9.3"
}

how to use

model

MyModel.kt

@Keep
@bdapterViewHolder(
    dataBinding = ViewholderMyModelBinding::class,
    viewModelClass = MyViewModel::class
)
data class MyModel(
    val id: Int
)

Add @Keep and @bdapterViewHolder annotations in your model class. If you are using ProGuard's rule, @Keep can be omitted.

view holder - layout

viewholder_my_model.xml

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android">
    <data>
        <variable
            name="item"
            type="com.your.package.MyModel" />
        <variable
            name="viewModel"
            type="com.your.package.MyViewModel" />
    </data>
    <TextView
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text='@{item.toString()}' />
</layout>

Written in general DataBinding style.

view model

MyViewModel.kt

class MyViewModel : ViewModel() {
    private val _items = MutableLiveData<List<Any>>().apply {
        value = listOf(
            MyModel(1), MyModel(2), MyModel(3)
        )
    }
    val items: LiveData<List<Any>>
        get() = _items
}

Create items it will be the source of RecyclerView.

bdapter will update the RecyclerView if the value of the items changed. ????

activity - layout

activity_main.xml

<?xml version="1.0" encoding="utf-8"?>
<layout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:binding="http://schemas.android.com/apk/res-auto">
    <data>
        <variable
            name="viewModel"
            type="com.quartack.bdapter.sample.viewmodel.MainViewModel" />
    </data>
    <androidx.recyclerview.widget.RecyclerView
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:orientation="vertical"
        app:layoutManager="LinearLayoutManager"
        binding:bdapterItems="@{viewModel.items}"
        binding:bdapterViewModel="@{viewModel}" />
</layout>

Written in general DataBinding style. Set a viewModel.items to binding:bdapterItems and viewModel to binding:bdapterViewModel.

activity

MyActivity.kt

class MyActivity : AppCompatActivity() {
    private val viewModel by viewModels<MyViewModel>()

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        initDataBinding()
    }

    private fun initDataBinding() {
        ActivityMainBinding.inflate(layoutInflater).also {
            it.viewModel = viewModel
            it.lifecycleOwner = this
            it.lifecycleOwner!!.lifecycle.addObserver(viewModel)
            setContentView(it.root)
        }
    }
}

Written in general DataBinding style.

complete!

You used RecyclerView without implementing RecyclerView.Adater and RecyclerView.ViewHolder through bdapter.

FAQ

  • Is multiple ViewHolder possible? -> YEP
  • Need code for RecyclerView.ViewHolder Class? -> NOPE
  • Need code for RecyclerView.Adapter Class? -> NOPE
  • No need for RecyclerView.Adapter logic? Like a add, edit, delete, sort, hide and etc for items. -> NOPE, only manage items in ViewMoles
  • Can I use my own the DiffUtil? -> SURE, checkout it sample project
  • Can I change the variable name used in Databinding? -> SURE, checkout it sample project

license

Apache License 2.0