textual/docs/styles/text_align.md

Text-align

The text-align style sets the text alignment in a widget.

Syntax

--8<-- "docs/snippets/syntax_block_start.md" text-align: <text-align>; --8<-- "docs/snippets/syntax_block_end.md"

The text-align style accepts a value of the type <text-align> that defines how text is aligned inside the widget.

Defaults

The default value is start.

Example

This example shows, from top to bottom: left, center, right, and justify text alignments.

=== "Output"

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

=== "text_align.py"

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

=== "text_align.tcss"

```css hl_lines="2 7 12 17"
--8<-- "docs/examples/styles/text_align.tcss"
```

CSS

/* Set text in the widget to be right aligned */
text-align: right;

Python

# Set text in the widget to be right aligned
widget.styles.text_align = "right"

See also

• align to set the alignment of children widgets inside a container.
• content-align to set the alignment of content inside a widget.