Skip to content

Latest commit

 

History

History
104 lines (74 loc) · 3.09 KB

README.md

File metadata and controls

104 lines (74 loc) · 3.09 KB
Raw

DelegateAdapters

Simplify the creation of RecyclerView adapters with different view types with this library, which is inspired by Hannes Dorfmann's AdapterDelegates.

There is also an article about it in Russian on Habr.

Dependencies

android {
    //...
    viewBinding { enabled = true }
}
dependencies {
    implementation "io.github.d00mch:delegateadapter:4.2"
}

Build Status

Examples

Write a model that represents UI data:

data class ImageItem(val title: String, @DrawableRes val imageRes: Int)

Write a delegate adapter:

class ImageDelegateAdapter(private val clickListener: View.OnClickListener) :
    ViewBindingDelegateAdapter<ImageItem, ImageItemBinding>(ImageItemBinding::inflate) {

    override fun ImageItemBinding.onBind(item: ImageItem) {
        tvTitle.text = item.title
        imgBg.setOnClickListener(clickListener)
        imgBg.setImageResource(item.imageRes)
    }

    override fun isForViewType(item: Any): Boolean = item is ImageItem

    override fun ImageItem.getItemId(): Any = title
}

Check out the ImageItemBinding.onBind part. This works like a basic view holder without requiring you to create one. Simply override the onBind method. Note that for this to work, you need to turn on view binding.

viewBinding { enabled = true }

Now you can use the DiffUtilCompositeAdapter just like the base RecyclerView.Adapter, composing it with any number of delegate adapters:

    val adapter = CompositeDelegateAdapter(
        TxtDelegateAdapter(),
        CheckDelegateAdapter(),
        GenerateItemsDelegateAdapter { generateNewData() }
    )

example

See an example in the code: BaseExampleActivity.kt:

Release notes

Make sure you have local.properties filled with:

signing.keyId=<gpg key id>
signing.password=<gpg password>
ossrhUsername=<sonatype login>
ossrhPassword=...
sonatypeStagingProfileId=<https://s01.oss.sonatype.org/#stagingProfiles;<THIS ONE!>>
signing.key=<gpg key>

Run:

./gradlew delegateadapter:publishReleasePublicationToSonatypeRepository closeAndReleaseSonatypeStagingRepository

License

Copyright 2017 Artur Dumchev 

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.