Docs scrollbar gutter (#695)

* Add scrollbar-gutter docs

* Add scrollbar-gutter docs

* Add syntax and values section

* Rewording
This commit is contained in:
darrenburns
2022-08-19 13:07:22 +01:00
committed by GitHub
parent afdac156a4
commit 9eea01f5a1
4 changed files with 80 additions and 3 deletions

View File

@@ -0,0 +1,47 @@
# 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
```sass
/* Reserve space for vertical scrollbar */
scrollbar-gutter: stable;
```
## Python
```python
self.styles.scrollbar_gutter = "stable"
```