Provides a table library supporting Material and Material3 designs, enabling static and paginated data tables with customizable columns, headers, and pagination for multiple platforms.
This is a Compose Multiplatform table library that supports both Material and Material3 designs.
Add the MavenCentral repository to your build file
repositories {
...
mavenCentral()
}
Add dependency
implementation("io.github.windedge.table:table-m2:<version>")
// or
implementation("io.github.windedge.table:table-m3:<version>")
DataTable, BasicPaginatedDataTable, and both Material bindings expose two optional parameters:
minTableWidth: Dp = 0.dp – sets a minimum width for the table so columns are not squeezed too narrow.scrollable: Boolean = false – wraps the table in a horizontally scrollable container;
on desktop a horizontal scrollbar is shown.With these two parameters you can control table width and horizontal scrolling directly from the existing APIs, without any extra wrapper composables. For a complete example, see the sample app:
Please check the sample app for a more detailed showcase.
Below is a table showing the compatibility between Compose Table versions and the required toolchain:
| Compose Table Version |
|---|
Projects using older Kotlin or Compose versions may need to upgrade before consuming 0.3.0+. If you are on an older toolchain, use a pre-0.3.0 release instead.
0.3.0+Starting from version 0.3.0, each Android artifact has a unique namespace to support AGP 9+:
| Artifact | Android Namespace |
|---|---|
table |
If you reference Android R classes directly, update your imports accordingly. Kotlin API usage is unaffected.
This project is inspired by compose-data-table.
This project is licensed under the MIT License.
import androidx.compose.material3.Text
import io.github.windedge.table.DataTable
val data = listOf(
mapOf("Name" to "John Doe", "Age" to "30", "Email" to "john.doe@example.com"),
mapOf("Name" to "Jane Doe", "Age" to "25", "Email" to "jane.doe@example.com")
)
DataTable(
columns = {
headerBackground {
Box(modifier = Modifier.background(color = Color.LightGray))
}
column { Text("Name") }
column { Text("Age") }
column { Text("Email") }
}
) {
data.forEach { record ->
row(modifier = Modifier) {
cell { Text(record["Name"] ?: "") }
cell { Text(record["Age"] ?: "") }
cell { Text(record["Email"] ?: "") }
}
}
}
import androidx.compose.material3.Text
import io.github.windedge.table.m3.PaginatedDataTable
import io.github.windedge.table.rememberPaginationState
val data = List(50) {
mapOf("Column 1" to "Item $it", "Column 2" to "Item $it", "Column 3" to "Item $it")
}
val paginationState = rememberPaginationState(data.size, pageSize = 5)
PaginatedDataTable(
columns = {
headerBackground {
Box(Modifier.background(colorScheme.primary))
}
column { Text("Column 1") }
column { Text("Column 2") }
column { Text("Column 3") }
},
paginationState = paginationState,
onPageChanged = {
data.chunked(it.pageSize)[it.pageIndex - 1]
}
) { item: Map<String, String> ->
row(modifier = Modifier) {
cell { Text(item["Column 1"] ?: "") }
cell { Text(item["Column 2"] ?: "") }
cell { Text(item["Column 3"] ?: "") }
}
}
import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.material3.Text
import androidx.compose.ui.Modifier
import androidx.compose.ui.unit.dp
import io.github.windedge.table.m3.PaginatedDataTable
import io.github.windedge.table.rememberPaginationState
val paginationState = rememberPaginationState(data.size, pageSize = 5)
PaginatedDataTable(
columns = {
headerBackground {
Box(Modifier.background(colorScheme.primary))
}
column { Text("Column 1") }
column { Text("Column 2") }
column { Text("Column 3") }
},
paginationState = paginationState,
onPageChanged = {
data.chunked(it.pageSize)[it.pageIndex - 1]
},
modifier = Modifier.fillMaxWidth(),
minTableWidth = 960.dp,
scrollable = true,
) { item: Map<String, String> ->
row {
cell { Text(item["Column 1"] ?: "") }
cell { Text(item["Column 2"] ?: "") }
cell { Text(item["Column 3"] ?: "") }
}
}
| Kotlin Version |
|---|
| Compose Multiplatform |
|---|
| Android Gradle Plugin |
|---|
< 0.3.0 | older toolchains | older toolchains | AGP 8.x and earlier |
0.3.0+ | 2.2.20+ | 1.9.3+ | 9.0.1+ |
io.github.windedge.tabletable-m2 | io.github.windedge.table.m2 |
table-m3 | io.github.windedge.table.m3 |
Surfaced from shared tags and platforms — no rankings paid for.