Facilitates UI list management from shared codebases, enabling seamless content creation for RecyclerView, UITableView, and UICollectionView. Supports viewbinding and databinding, enhancing code reusability across projects.
This is a Kotlin MultiPlatform library that provides RecyclerView/UITableView/UICollectionView filling from common code.
RecyclerView/UITableView/UICollectionView
creating from common kotlin code.root build.gradle
buildscript {
repositories {
gradlePluginPortal()
}
dependencies {
classpath("dev.icerock.moko:units-generator:0.8.0")
}
}
allprojects {
repositories {
mavenCentral()
}
}
project build.gradle
dependencies {
commonMainApi("dev.icerock.moko:units:0.8.0")
commonMainImplementation("dev.icerock.moko:units-basic:0.8.0")
commonTestImplementation("dev.icerock.moko:units-test:0.8.0")
}
On iOS, in addition to the Kotlin library add Pod in the Podfile.
pod 'MultiPlatformLibraryUnits', :git => 'https://github.com/icerockdev/moko-units.git', :tag => 'release/0.8.0'
MultiPlatformLibraryUnits CocoaPod requires that the framework compiled from Kotlin be named
MultiPlatformLibrary and be connected as a CocoaPod MultiPlatformLibrary.
's an example.
To simplify integration with MultiPlatformFramework you can use .
CocoaPod contains an swift additions for s of /.
In android build.gradle
databinding usage
apply plugin: "dev.icerock.mobile.multiplatform-units"
dependencies {
implementation("dev.icerock.moko:units-databinding:0.8.0")
}
multiplatformUnits {
classesPackage = "org.example.library.units"
dataBindingPackage = "org.example.library"
layoutsSourceSet = "main"
}
viewbinding usage
dependencies {
implementation("dev.icerock.moko:units-viewbinding:0.8.0")
}
common:
android with databinding (using module units-databinding)
<androidx.recyclerview.widget.RecyclerView
android:layout_width="match_parent"
android:layout_height="match_parent"
app:bindValue="@{viewModel.items}"
app:adapter="@{`dev.icerock.moko.units.adapter.UnitsRecyclerViewAdapter`}"
app:layoutManager="androidx.recyclerview.widget.LinearLayoutManager"/>
object UnitFactoryImpl: UnitFactory {
fun createHeader(text: String): TableUnitItem {
return LayoutHeader()
.setText(text)
.setItemId(text.hashCode())
}
fun createProfileTile(profileId: Long, avatarUrl: String, username: String): TableUnitItem {
return LayoutProfileTile()
.setAvatarUrl(avatarUrl)
.setUserName(username)
.setItemId(profileId)
}
}
mBinding.viewModel = ViewModel(UnitFactoryImpl)
android with viewbinding (using module units-viewbinding)
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height=
=>
For every unit_layout.xml should create class using viewbinding-generated class UnitLayoutBinding
On Android you can use units with viewbinding or with databinding, just plug in the corresponding module: units-viewbinding or units-databinding
iOS:
let viewModel = ViewModel(unitFactory: UnitFactoryImpl())
let tableDataSource = TableUnitsSourceKt.default(for: tableView)
tableDataSource.unitItems = viewModel.items
tableView.reloadTable()
If you want to use units in dropdown list you should implement DropDownUnitItem. Abstract class VBDropDownUnitItem already implement it so you can use it.
If you want the units UI will be different when dropdown list is close or open, you need to implement another interface TableUnitItem which already implemented in VBTableUnitItem.
The sample you can see here
Only what you need to make different UI to units in closed and open dropdown list with databinding is an another layout with _dropdown postfix
sample_unit.xml for sample unit, sample_unit_dropdown.xml for dropdown unit
Please see more examples in the sample directory.
units library;MR class generator;All development (both new features and bug fixes) is performed in the develop branch. This way master always contains the sources of the most recently released version. Please send PRs with bug fixes to the develop branch. Documentation fixes in the markdown files are an exception to this rule. They are updated directly in master.
The develop branch is pushed to master on release.
For more details on contributing please see the contributing guide.
Copyright 2019 IceRock MAG Inc.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance the License.
You may obtain a copy of the License at
http:
Unless applicable law agreed to writing, software
distributed under the License distributed an BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express implied.
See the License the specific language governing permissions
limitations under the License.
MultiPlatformLibraryUnitsUnitDataSourceUITableViewUICollectionViewinterface UnitFactory {
fun createHeader(text: String): TableUnitItem
fun createProfileTile(profileId: Long, avatarUrl: String, username: String): TableUnitItem
}
class ViewModel(unitFactory: UnitFactory) {
val items = listOf(
unitFactory.createHeader("Programmers"),
unitFactory.createProfileTile(1, "url", "Mikhailov"),
unitFactory.createProfileTile(2, "url", "Babenko"),
unitFactory.createProfileTile(3, "url", "Tchernov"),
unitFactory.createHeader("Designers"),
unitFactory.createProfileTile(4, "url", "Eugeny")
)
}
class UnitBlueDivider(override val itemId: Long) :
VBTableUnitItem<UnitBlueDividerBinding>() {
override val layoutId: Int = R.layout.unit_blue_divider
override fun bindView(view: View): UnitBlueDividerBinding {
return UnitBlueDividerBinding.bind(view)
}
override fun UnitBlueDividerBinding.bindData(
context: Context,
lifecycleOwner: LifecycleOwner,
viewHolder: VBViewHolder<UnitBlueDividerBinding>
) {
this.unitBlueDividerTextView.setBackgroundColor(Color.parseColor("#2196F3"))
}
}
override fun createBlueDividerUnit(id: Long): TableUnitItem {
return UnitBlueDivider(
itemId = id
)
}
class UnitFactoryImpl: NSObject, UnitFactory {
func createHeader(text: String) -> TableUnitItem {
let data = HeaderTableViewCell.CellModel(text: text)
return UITableViewCellUnit<HeaderTableViewCell>(
data: data,
itemId: text.hashCode(),
configurator: nil)
}
func createProfileTile(profileId: Long, avatarUrl: String, username: String) -> TableUnitItem {
let data = ProfileTableViewCell.CellModel(avatarUrl: avatarUrl, username: username)
return UITableViewCellUnit<ProfileTableViewCell>(
data: data,
itemId: profileId,
configurator: nil)
}
}
Surfaced from shared tags and platforms — no rankings paid for.