Files
textual/docs/styles/scrollbar_gutter.md
darrenburns 9eea01f5a1 Docs scrollbar gutter (#695)
* Add scrollbar-gutter docs

* Add scrollbar-gutter docs

* Add syntax and values section

* Rewording
2022-08-19 13:07:22 +01:00

1.0 KiB

Scrollbar gutter

The scrollbar-gutter rule allows authors to reserve space for the vertical scrollbar.

Setting the value to stable prevents unwanted layout changes when the scrollbar becomes visible.

Syntax

scrollbar-gutter: [auto|stable];

Values

Value Description
auto (default) No space is reserved for the vertical scrollbar.
stable Space is reserved for the vertical scrollbar.

Example

In the example below, notice the gap reserved for the scrollbar on the right side of the terminal window.

=== "scrollbar_gutter.py"

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

=== "Output"

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

CSS

/* Reserve space for vertical scrollbar */
scrollbar-gutter: stable;

Python

self.styles.scrollbar_gutter = "stable"