Files
textual/docs/styles/layout.md
2022-09-06 16:06:01 +01:00

54 lines
1.3 KiB
Markdown

# Layout
The `layout` property defines how a widget arranges its children.
See [layout](../guide/layout.md) guide for more information.
## Syntax
```
layout: [center|grid|horizontal|vertical];
```
### Values
| Value | Description |
|----------------------|-------------------------------------------------------------------------------|
| `center` | A single child widget will be placed in the center. |
| `grid` | Child widgets will be arranged in a grid. |
| `horizontal` | Child widgets will be arranged along the horizontal axis, from left to right. |
| `vertical` (default) | Child widgets will be arranged along the vertical axis, from top to bottom. |
## Example
Note how the `layout` property affects the arrangement of widgets in the example below.
=== "layout.py"
```python
--8<-- "docs/examples/styles/layout.py"
```
=== "layout.css"
```sass
--8<-- "docs/examples/styles/layout.css"
```
=== "Output"
```{.textual path="docs/examples/styles/layout.py"}
```
## CSS
```sass
layout: horizontal;
```
## Python
```python
widget.layout = "horizontal"
```