Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kibotu/recyclerviewpresenter
RecyclerView Adapter Library with different models and different layouts as convenient as possible.
https://github.com/kibotu/recyclerviewpresenter
adapter android android-library hacktoberfest hacktoberfest2023 kotlin kotlin-android mvvm recyclerview recyclerview-adapter sort update
Last synced: about 1 month ago
JSON representation
RecyclerView Adapter Library with different models and different layouts as convenient as possible.
- Host: GitHub
- URL: https://github.com/kibotu/recyclerviewpresenter
- Owner: kibotu
- License: apache-2.0
- Created: 2016-05-15T07:05:35.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2021-10-31T15:09:22.000Z (about 3 years ago)
- Last Synced: 2024-04-15T02:55:55.699Z (9 months ago)
- Topics: adapter, android, android-library, hacktoberfest, hacktoberfest2023, kotlin, kotlin-android, mvvm, recyclerview, recyclerview-adapter, sort, update
- Language: Kotlin
- Homepage:
- Size: 916 KB
- Stars: 86
- Watchers: 7
- Forks: 28
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
[](https://www.paypal.me/janrabe/5) [](https://www.kibotu.net)
# RecyclerView Presenter [](https://jitpack.io/#kibotu/RecyclerViewPresenter) [](https://jitpack.io/#kibotu/RecyclerViewPresenter) [](https://hitsofcode.com/view/github/kibotu/RecyclerViewPresenter) [](https://android-arsenal.com/details/1/3593) [](https://appetize.io/app/twkuv0xydcy5h8whmkcmx81kur) [](https://jitpack.io/com/github/kibotu/RecyclerViewPresenter/master-SNAPSHOT/javadoc/index.html) [](https://app.travis-ci.com/kibotu/RecyclerViewPresenter) [](https://android-arsenal.com/api?level=15) [](https://docs.gradle.org/current/release-notes) [](https://kotlinlang.org/) [](https://raw.githubusercontent.com/kibotu/RecyclerViewPresenter/master/LICENSE) [](https://developer.android.com/topic/libraries/support-library/refactor)
Convenience library to handle different view types with different presenters in a single RecyclerView.
[](https://raw.githubusercontent.com/kibotu/RecyclerViewPresenter/master/screenshot.png)
### How to install
```groovy
repositories {
maven {
url "https://jitpack.io"
}
}
dependencies {
implementation 'com.github.kibotu:RecyclerViewPresenter:-SNAPSHOT'
}
```
### How to use
1. Create a presenter, e.g. [PhotoPresenter](app/src/main/kotlin/net/kibotu/android/recyclerviewpresenter/app/screens/kotlin/PhotoPresenter.kt#L21-L51) or [LabelPresenter](app/src/main/kotlin/net/kibotu/android/recyclerviewpresenter/app/screens/kotlin/LabelPresenter.kt#L14-L23)
```kotlin
class LabelPresenter : Presenter(
layout = R.layout.label_presenter_item,
viewBindingAccessor = LabelPresenterItemBinding::bind
) {
override fun bindViewHolder(
viewBinding: LabelPresenterItemBinding,
viewHolder: RecyclerView.ViewHolder,
item: PresenterViewModel,
payloads: MutableList?
) = with(viewBinding) {
Logger.v( "bindViewHolder ${viewHolder.adapterPosition} $item payload=$payloads" )
label.text = "${item.model}"
}
}
```
2. [Add the PresenterAdapter to your RecyclerView](app/src/main/kotlin/net/kibotu/android/recyclerviewpresenter/app/screens/kotlin/PresenterActivity.kt#L26)
```kotlin
val adapter = PresenterAdapter()
list.adapter = adapter
```
3. [Register Presenter](app/src/main/kotlin/net/kibotu/android/recyclerviewpresenter/app/screens/kotlin/PresenterActivity.kt#L33-L35)
```kotlin
adapter.registerPresenter(PhotoPresenter())
adapter.registerPresenter(LabelPresenter())
adapter.registerPresenter(NumberPresenter())
```
4. [Submit list of models with presenter matching layout](app/src/main/kotlin/net/kibotu/android/recyclerviewpresenter/app/screens/kotlin/PresenterActivity.kt#L50-L70) to the adapter, e.g.:
```kotlin
val items = mutableListOf>()
for (i in 0..99) {
items.add(PresenterModel(createRandomImageUrl(), R.layout.photo_presenter_item))
items.add(PresenterModel(createRandomImageUrl(), R.layout.label_presenter_item))
items.add(PresenterModel(createRandomImageUrl(), R.layout.number_presenter_item))
}
adapter.submitList(items)
```
5.1 Add click listener [to adapter](app/src/main/kotlin/net/kibotu/android/recyclerviewpresenter/app/screens/kotlin/PresenterActivity.kt#L37-L40)
```kotlin
adapter.onItemClick { item, view, position ->
snack("$position. ${item.model}")
}
```
5.2 or pass [to your RecyclerViewModel](app/src/main/kotlin/net/kibotu/android/recyclerviewpresenter/app/screens/kotlin/PresenterActivity.kt#L65-L67)
```kotlin
val item = PresenterViewModel(createRandomImageUrl(), R.layout.photo_presenter_item) { item, view, position ->
snack("$position. $item")
})
```
#### [Updating item](app/src/main/kotlin/net/kibotu/android/recyclerviewpresenter/app/screens/kotlin/PresenterActivity.kt#L56)
```kotlin
adapter.submitList(newItems)
```
#### [Circular](app/src/main/kotlin/net/kibotu/android/recyclerviewpresenter/app/screens/circular/CircularPresenterActivity.kt#L37)
```kotlin
adapter.isCircular = true
// Note: use adapter scroll methods for correct scroll position when using circular
adapter.smoothScrollToPosition(0)
adapter.scrollToPosition(0)
```
### Notes
Follow me on Twitter: [](https://twitter.com/wolkenschauer)
Let me know what you think: [[email protected]](mailto:[email protected])
Contributions welcome!
### License
Copyright 2021 Jan Rabe
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.