GridLayout for Compose

GridLayout for Compose is a library for missing grid layout in Compose Multiplatform.

Jetpack Compose doesn't offer non lazy grid layout, there are only lazy grid layout and alternatives (for example, flow layout). But sometimes, we need to use grid layout for less complexity and more intuitive layout code. This library can be simpler solution for small grid UI.

There are benefits of this library:

• Similar API to LazyGrid: The GridLayout's APIs are designed to provide similar development experience to LazyGrid.
• Easy to implement adaptive grid: There are "Fixed" and "Adaptive" for grid layout management like LazyGrid. Like LazyGrid, it eliminates dealing with different screen sizes.
• Simple to use as a part of LazyList: The GridLayout is not lazy layout. It can be simply placed in lazy layouts. If only a portion of the full layout is grid, No need to use LazyGrid with span size for full layout.
• Efficient for small datasets: LazyGrid has complex logics for large datasets. But when datasets are small, it can be inefficient. The GridLayout is just a simple layout. It can be more efficient for smaller datasets.

Overview

GridLayout for Compose provides a simple layout composables for building grid UI.

This library provides 2 types of grid, box grid and sequential grid.

BoxGrid is a grid layout that allows you to place items in grid format. Items in BoxGrid can be placed in any position, and multiple items can placed in the same cell like Box composable.

Sequential grid is a layout that arranges items in a grid format, either horizontally or vertically. There are 2 composables for each direction: HorizontalGrid and VerticalGrid. Its API is similar to LazyGrid. For example to draw grid like this:

You can write code like this:

VerticalGrid(
    columns = SimpleGridCells.Fixed(3),
    modifier = Modifier.fillMaxWidth(),
) {
    for ((index, color) in colors.withIndex()) {
        ColorBox(
            color = color,
            text = (index + 1).toString(),
        )
    }
}

To read more detail documentation, please read documentation.

License

This library is licensed under the Apache License, Version 2.0.