Back to Textual

Link-style

docs/styles/links/link_style.md

8.2.51.9 KB
Original Source

Link-style

The link-style style sets the text style for the link text.

!!! note

`link-style` only applies to Textual action links as described in the [actions guide](../../guide/actions.md#links) and not to regular hyperlinks.

Syntax

--8<-- "docs/snippets/syntax_block_start.md" link-style: <a href="../../../css_types/text_style"><text-style></a>; --8<-- "docs/snippets/syntax_block_end.md"

link-style will take all the values specified and will apply that styling to text that is enclosed by a Textual action link.

Defaults

If not provided, a Textual action link will have link-style set to underline.

Example

The example below shows some links with different styles applied to their text. It also shows that link-style does not affect hyperlinks.

=== "Output"

```{.textual path="docs/examples/styles/link_style.py" lines=6}
```

=== "link_style.py"

```py hl_lines="10-11 14-15 18-19 22-23"
--8<-- "docs/examples/styles/link_style.py"
```

1. This label has a hyperlink so it won't be affected by the `link-style` rule.
2. This label has an "action link" that can be styled with `link-style`.
3. This label has an "action link" that can be styled with `link-style`.
4. This label has an "action link" that can be styled with `link-style`.

=== "link_style.tcss"

```css hl_lines="2 6 10"
--8<-- "docs/examples/styles/link_style.tcss"
```

1. This will only affect one of the labels because action links are the only links that this rule affects.

CSS

css
link-style: bold;
link-style: bold italic reverse;

Python

py
widget.styles.link_style = "bold"
widget.styles.link_style = "bold italic reverse"

See also

  • link-style-hover to set the style of link text when the mouse pointer is over it.
  • text-style to set the style of text in a widget.