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

67 lines
1.7 KiB
Markdown

# 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: <a href="../../css_types/text_style">&lt;text-style&gt;</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.
### 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
```sass
link-style: bold;
link-style: bold italic reverse;
```
## Python
```py
widget.styles.link_style = "bold"
widget.styles.link_style = "bold italic reverse"
```