Align

The align style defines how a widget's children are aligned.

Apply this rule to a container to adjust where its children are positioned.

Syntax

--8<-- "docs/snippets/syntax_block_start.md" align: <horizontal> <vertical>;

align-horizontal: <horizontal>; align-vertical: <vertical>; --8<-- "docs/snippets/syntax_block_end.md"

The align style takes a <horizontal> followed by a <vertical>.

You can also set the alignment for each axis individually with align-horizontal and align-vertical.

Examples

Basic usage

This example contains a simple app with two labels centered on the screen with align: center middle;:

=== "Output"

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

=== "align.py"

```python
--8<-- "docs/examples/styles/align.py"
```

=== "align.tcss"

```css hl_lines="2"
--8<-- "docs/examples/styles/align.tcss"
```

All alignments

The next example shows a 3 by 3 grid of containers with text labels. Each label has been aligned differently inside its container, and its text shows its align: ... value.

=== "Output"

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

=== "align_all.py"

```python
--8<-- "docs/examples/styles/align_all.py"
```

=== "align_all.tcss"

```css hl_lines="2 6 10 14 18 22 26 30 34"
--8<-- "docs/examples/styles/align_all.tcss"
```

CSS

/* Align child widgets to the center. */
align: center middle;
/* Align child widget to the top right */
align: right top;

/* Change the horizontal alignment of the children of a widget */
align-horizontal: right;
/* Change the vertical alignment of the children of a widget */
align-vertical: middle;

Python

# Align child widgets to the center
widget.styles.align = ("center", "middle")
# Align child widgets to the top right
widget.styles.align = ("right", "top")

# Change the horizontal alignment of the children of a widget
widget.styles.align_horizontal = "right"
# Change the vertical alignment of the children of a widget
widget.styles.align_vertical = "middle"

2.5 KiB Raw Blame History