Split grid reference into subpages.

This commit is contained in:
Rodrigo Girão Serrão
2022-12-19 10:13:20 +00:00
parent 22351a7cfb
commit 9e7c4f4f4a
8 changed files with 14 additions and 1 deletions

View File

@@ -0,0 +1 @@
# Column-span

View File

@@ -0,0 +1 @@
# Grid-columns

View File

@@ -0,0 +1 @@
# Grid-gutter

View File

@@ -0,0 +1 @@
# Grid-rows

View File

@@ -0,0 +1 @@
# Grid-size

54
docs/styles/grid/index.md Normal file
View File

@@ -0,0 +1,54 @@
# Grid
There are a number of properties relating to the Textual `grid` layout.
For an in-depth look at the grid layout, visit the grid [guide](../guide/layout.md#grid).
| Property | Description |
|----------------|------------------------------------------------|
| `grid-size` | Number of columns and rows in the grid layout. |
| `grid-rows` | Height of grid rows. |
| `grid-columns` | Width of grid columns. |
| `grid-gutter` | Spacing between grid cells. |
| `row-span` | Number of rows a cell spans. |
| `column-span` | Number of columns a cell spans. |
## Syntax
```sass
grid-size: <INTEGER> [<INTEGER>];
/* columns first, then rows */
grid-rows: <SCALAR> . . .;
grid-columns: <SCALAR> . . .;
grid-gutter: <SCALAR>;
row-span: <INTEGER>;
column-span: <INTEGER>;
```
## Example
The example below shows all the properties above in action.
The `grid-size: 3 4;` declaration sets the grid to 3 columns and 4 rows.
The first cell of the grid, tinted magenta, shows a cell spanning multiple rows and columns.
The spacing between grid cells is because of the `grid-gutter` declaration.
=== "Output"
```{.textual path="docs/examples/styles/grid.py"}
```
=== "grid.py"
```python
--8<-- "docs/examples/styles/grid.py"
```
=== "grid.css"
```sass
--8<-- "docs/examples/styles/grid.css"
```
!!! warning
The properties listed on this page will only work when the layout is `grid`.

View File

@@ -0,0 +1 @@
# Row-span