Files
textual/docs/styles/scrollbar_visibility.md
Will McGugan 88220b8f02 docs
2025-10-05 11:57:18 +01:00

1.3 KiB

Scrollbar-visibility

The scrollbar-visibility is used to show or hide scrollbars.

If scrollbars are hidden, the user may still scroll the container using the mouse wheel / keys / and gestures, but there will be no scrollbars shown.

Syntax

--8<-- "docs/snippets/syntax_block_start.md" scrollbar-visibility: hidden | visible; --8<-- "docs/snippets/syntax_block_end.md"

Values

Value Description
hidden The widget's scrollbars will be hidden.
visible (default) The widget's scrollbars will be displayed as normal.

Examples

The following example contains two containers with the same text. The container on the right has its scrollbar hidden.

=== "Output"

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

=== "scrollbar_visibility.py"

```py
--8<-- "docs/examples/styles/scrollbar_visibility.py"
```

=== "scrollbar_visibility.tcss"

```css
--8<-- "docs/examples/styles/scrollbar_visibility.tcss"
```

CSS

scrollbar-visibility: visible;
scrollbar-visibility: hidden;

Python

widget.styles.scrollbar_visibility = "visible";
widget.styles.scrollbar_visibility = "hidden";