Files
textual/docs/styles/grid/row_span.md
Rodrigo Girão Serrão da9a481f1c Remove inclusion of old css types snippets.
Supposedly, this had been done in an earlier commit for all styles. Apparently, I forgot to open styles references that were one level deeper in the directory, so the pages about grid, links, and scrollbar colors still included the css types values directly in their reference pages.
2023-01-09 11:28:47 +00:00

1.1 KiB

Row-span

The row-span style specifies how many rows a widget will span in a grid layout.

!!! note

This style only affects widgets that are direct children of a widget with `layout: grid`.

Syntax

--8<-- "docs/snippets/syntax_block_start.md" row-span: <integer>; --8<-- "docs/snippets/syntax_block_end.md"

The style row-span accepts a single non-negative <integer> that quantifies how many rows the given widget spans.

Example

The example below shows a 4 by 4 grid where many placeholders span over several rows.

Notice that grid cells are filled from left to right, top to bottom. After placing the placeholders #p1, #p2, #p3, and #p4, the next available cell is in the second row, fourth column, which is where the top of #p5 is.

=== "Output"

```{.textual path="docs/examples/styles/row_span.py"}
```

=== "row_span.py"

```py
--8<-- "docs/examples/styles/row_span.py"
```

=== "row_span.css"

```sass
--8<-- "docs/examples/styles/row_span.css"
```

CSS

row-span: 3

Python

widget.styles.row_span = 3