Files
textual/docs/styles/links/link_style.md
Rodrigo Girão Serrão 196d430582 Style all Textual CSS as 'sass'
Textual CSS is better highlighted in SASS code blocks because the SASS parser seems to be more lenient.
2023-01-09 11:20:04 +00:00

1.7 KiB

Link-style

The link-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: <text-style>; --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.

Values

--8<-- "docs/snippets/type_syntax/text_style.md"

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="8-9 12-13 16-17 20-21"
--8<-- "docs/examples/styles/link_style.py"
```

1. This label has an 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.css"

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

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

CSS

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

Python

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