Skip to content
An Android library makes it easier and more flexible to create multiple types of RecyclerViews.
Branch: master
Clone or download
Latest commit 6a09ea5 Apr 11, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Update ISSUE_TEMPLATE.md Jun 20, 2017
gradle Migrate to Kotlin (#253) Feb 6, 2019
image Migrate to Kotlin (#253) Feb 6, 2019
library Prepare for release 4.0.0-alpha3 Mar 16, 2019
sample Open MultiTypeAdapter and Types (#260) Mar 16, 2019
.gitignore
.travis.yml Migrate to Kotlin (#253) Feb 6, 2019
CHANGELOG.md Open MultiTypeAdapter and Types (#260) Mar 16, 2019
CONTRIBUTING.md Migrate to Kotlin (#253) Feb 6, 2019
LICENSE Added Copyrights Aug 3, 2016
README.md
RELEASING.md
build.gradle Prepare for release 4.0.0-alpha3 Mar 16, 2019
checkstyle.xml Fixed checkstyle Indentation with basicOffset 2 Jan 28, 2018
findbugs.xml Added checkstyle.gradle and findbugs.xml Sep 17, 2017
gradle.properties Migrate to Kotlin (#253) Feb 6, 2019
gradlew Initial commit Aug 3, 2016
gradlew.bat Initial commit Aug 3, 2016
settings.gradle Migrate to Kotlin (#253) Feb 6, 2019

README.md

MultiType

An Android library makes it easier and more flexible to create multiple types of RecyclerViews.

Build Status License maven-central jetbrains-plugin

Previously, when we need to develop a complex RecyclerView / ListView, it is difficult and troublesome work. We should override the getItemViewType() of RecyclerView.Adapter , add some types, and create some ViewHolders relating to those types. Once we need to add a new item type, we have to go to the original adapter file and modify some old codes carefully, and these adapter classes will get more complicated.

Nowadays, I created a new intuitive and flexible way to easily create complex RecyclerViews, with the MultiType library, we could insert a new item type without changing any old adapter codes and make them more readable.

Getting started

In your build.gradle:

MultiType has been rebuilt based on AndroidX. If you are still using the android support library, please use multitype:3.4.4 and multitype-kotlin:3.4.4.

In addition, since 4.0.0 we have migrated to fully build with Kotlin. If you don't want to use Kotlin, you can use the last stable version multitype:3.5.0 and see 3.x.

dependencies {
  implementation 'me.drakeet.multitype:multitype:4.0.0-alpha3'
}

Usage

Step 1. Create a Kotlin class or data class, for example:

data class Foo(
  val value: String
)

Step 2. Create a class extends ItemViewBinder<T, VH : ViewHolder>, for example:

class FooViewBinder: ItemViewBinder<Foo, FooViewBinder.ViewHolder>() {

  override fun onCreateViewHolder(inflater: LayoutInflater, parent: ViewGroup): ViewHolder {
    return ViewHolder(inflater.inflate(R.layout.item_foo, parent, false))
  }

  override fun onBindViewHolder(holder: ViewHolder, item: Foo) {
    holder.fooView.text = item.value
    Log.d("ItemViewBinder API", "position: ${getPosition(holder)}")
    Log.d("ItemViewBinder API", "items: $adapterItems")
    Log.d("ItemViewBinder API", "adapter: $adapter")
    Log.d("More", "Context: ${holder.itemView.context}")
  }

  class ViewHolder(itemView : View): RecyclerView.ViewHolder(itemView) {
    val fooView: TextView = itemView.findViewById(R.id.foo)
  }
}

Step 3. register your types and setup your RecyclerView, for example:

class SampleActivity : AppCompatActivity() {

  private lateinit var adapter: MultiTypeAdapter
  private lateinit var items: MutableList<Any>

  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_list)
    val recyclerView = findViewById<RecyclerView>(R.id.list)

    adapter = MultiTypeAdapter()
    adapter.register(TextItemViewBinder())
    adapter.register(ImageItemViewBinder())
    adapter.register(RichItemViewBinder())
    recyclerView.adapter = adapter

    val textItem = TextItem("world")
    val imageItem = ImageItem(R.mipmap.ic_launcher)
    val richItem = RichItem("小艾大人赛高", R.drawable.img_11)

    items = ArrayList()
    for (i in 0..19) {
      items.add(textItem)
      items.add(imageItem)
      items.add(richItem)
    }
    adapter.items = items
    adapter.notifyDataSetChanged()
  }
}

That's all, you're good to go!

Advanced usage

One to many:

adapter.register(Data::class).to(
  DataType1ViewBinder(),
  DataType2ViewBinder()
).withKotlinClassLinker { _, data ->
  when (data.type) {
    Data.TYPE_2 -> DataType2ViewBinder::class
    else -> DataType1ViewBinder::class
  }
}

See OneDataToManyActivity, OneToManyFlow and OneToManyEndpoint for more details.

More methods that you can override from ItemViewBinder:

open fun onBindViewHolder(holder: VH, item: T, payloads: List<Any>)
open fun getItemId(item: T): Long
open fun onViewRecycled(holder: VH)
open fun onFailedToRecycleView(holder: VH): Boolean
open fun onViewAttachedToWindow(holder: VH)
open fun onViewDetachedFromWindow(holder: VH)

Android Studio Plugin

An intellij idea plugin for Android to generate MultiType Item and ItemViewBinder easily.

Screenshots

Pages created with MultiType:

License

Copyright (c) 2016-present. Drakeet Xu

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.
You can’t perform that action at this time.