Update documents for 1.1.0

docs/cell-strategy.md

@@ -14,13 +14,19 @@ And each cell will have 1/n of the grid size.
 The API of `Fixed` looks like this:
 
 ```kotlin
-class Fixed(private val count: Int) : SimpleGridCells
+class Fixed(
+    private val count: Int,
+    private val fill: Boolean = true
+) : SimpleGridCells
 ```
 
 There is a parameter called `count`. This is the maximum number of cells the grid should have on
 each line. The `count` must be a positive number. If 0 or negative number is provided, it occurs
 an exception.
 
+!!! note
+    For information about `fill` parameter, read [Fill Optoin](#fill-option) section.
+
 For example, a grid has 400dp width or height, and `Fixed(4)` is applied.
 
 ```kotlin
@@ -50,14 +56,20 @@ And each cell will have at least minimum size.
 The API of `Adaptive` looks like this:
 
 ```kotlin
-class Adaptive(private val minSize: Dp) : SimpleGridCells
+class Adaptive(
+    private val minSize: Dp,
+    private val fill: Boolean = true
+) : SimpleGridCells
 ```
 
 There is a parameter called `minSize`. This is the minimum size of each cell should have.
 The `minSize` must be a positive size. If the size is 0 or below, it occurs an exception.
 The grid layout with `Adaptive` calculates the maximum number of cells possible while keeping
 the `minSize` restriction.
 
+!!! note
+    For information about `fill` parameter, read [Fill Option](#fill-option) section.
+
 For example, a grid has 400dp width or height and `Adaptive(120.dp)` is applied.
 
 ```kotlin
@@ -81,3 +93,12 @@ And each cells will have 1/3 of 400dp (about 133.333dp) width or height.
 
 If the grid size is expanded to 600dp, the number of cells on each line will be changed to 5
 and each cell's size will be 120dp.
+
+## Fill Option
+
+Both `Fixed` and `Adaptive` have a optional parameter named `fill`.
+The `fill` parameter determines that grid's item composable should fill grid cell's size.
+
+When `fill` is true, grid layout forces item composable to have width or height to fit cell's maximum width or height.
+(width when vertical grid, height when horizontal grid)
+But when false, item composable can have width or height from 0 to cell's maximum width or height.

docs/installation.md

@@ -29,6 +29,7 @@ The following table shows Compose versions which each library version depends on
 
 | GridLayout Version | Compose Version (Android) | Compose Version (Multiplatform) |
 |--------------------|---------------------------|---------------------------------|
+| 1.1.0              | Jetpack Compose 1.5.0     | Compose Multiplatform 1.5.2     |
 | 1.0.0              | Jetpack Compose 1.5.0     | Compose Multiplatform 1.5.2     |
 | 0.2.0              | Jetpack Compose 1.4.3     | Compose Multiplatform 1.4.1     |
 | 0.1.0              | Jetpack Compose 1.4.3     | Compose Multiplatform 1.4.1     |
@@ -39,6 +40,7 @@ It is recommended to use following target SDK version when using this library fo
 
 | GridLayout Version | Android Target SDK | Android Minimum SDK |
 |--------------------|--------------------|---------------------|
+| 1.1.0              | Android 14 (34)    | Lollipop (21)       |
 | 1.0.0              | Android 14 (34)    | Lollipop (21)       |
 | 0.2.0              | Android 13 (33)    | Lollipop (21)       |
 | 0.1.0              | Android 13 (33)    | Lollipop (21)       |

docs/span.md

@@ -0,0 +1,29 @@
+# Spanning Cells
+
+The `content` composable lambda of grid layout extends `GridScope`.
+To apply span size, you can set `span` modifier in the `GridScope`.
+
+The following code and graphic show a example of span.
+
+```kotlin
+HorizontalGrid(rows = SimpleGridCells.Fixed(3)) {
+    Item()
+    Item(Modifier.span(2))
+    Item(Modifier.span(2))
+    Item()
+    Item()
+}
+
+VerticalGrid(columns = SimpleGridCells.Fixed(3)) {
+    Item()
+    Item(Modifier.span(2))
+    Item(Modifier.span(2))
+    Item()
+    Item()
+}
+```
+
+![span-graphic](images/span-graphic.png)
+
+!!! warning
+    If given span size is bigger than maximum cell count of the axis, the cell will be undisplayed.

mkdocs.yml

@@ -38,6 +38,7 @@ nav:
     - 'Layout Composables': layout-composables.md
     - 'Cell Strategy': cell-strategy.md
     - 'Arrangement': arrangement.md
+    - 'Spanning Cells': span.md
   - 'Changelog': 'https://github.com/cheonjaewoong/gridlayout-compose/blob/main/CHANGELOG.md'
 
 # Repository Information