- Accepts:
ratio
- Animates: no
| Option | Type | Required | Default | Description |
|---|
label | string | no | payload.label | Prefix shown before the bar, e.g. "year" → year: ████░░░ 32%. Falls back to RatioData.label when omitted. |
value_format | "percent" | "fraction" | "both" | no | "percent" | Suffix format. fraction and both require RatioData.denominator — otherwise they fall back to percent. |
Overridable via the [theme] section of config.toml.
| Key | Description |
|---|
text | Primary body text colour for plain renderers (text_plain, text_ascii, list_plain, animated_typewriter). The top step of the chrome ladder — brighter than text_secondary, reads as diffuse daylight on the ocean surface. Set text = "reset" to inherit the terminal's own foreground instead. |
text_dim | Barely-visible chrome text: timeline date prefixes, empty-state placeholder, clip hint. Replaces the old Modifier::DIM usage — set an explicit colour so rendering stays consistent across terminals (some render DIM as invisible, some as a no-op). |