aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authoruser <user@clank>2026-09-22 11:59:10 +0200
committeruser <user@clank>2026-09-22 11:59:10 +0200
commitcb0d993fa284005d5679b628bb08d51f12812b8c (patch)
tree9d28b86f925255a24adb27306c6dde62e9f86292 /docs
parentsidebar: air between tabs (tab_gap) (diff)
downloadslosh-cb0d993fa284005d5679b628bb08d51f12812b8c.tar.gz
slosh-cb0d993fa284005d5679b628bb08d51f12812b8c.tar.xz
slosh-cb0d993fa284005d5679b628bb08d51f12812b8c.zip
tabs: a plate under the ones you are not in (tab_idle_bg)
The active tab has been filled with the accent since the strip existed; every other tab was words on the background. That leaves the strip with one shape on it and nothing to compare it against -- where a tab ends, how far the row you are about to click reaches, and in the sidebar which rows are tabs rather than statuses, all had to be read off the text. tab_idle_bg fills them. Barely off the background and in the label's own grey, because this is not a second highlight: it gives a tab edges, and it gives the accent something to be brighter than, which on a strip of short labels is most of how the eye finds the tab it is in. Hover keeps it for the same reason the active tab keeps its fill -- losing the plate under the pointer would read as the tab going away -- so hovering still lands on the text, and the bell mark sits on the plate rather than punching a hole in it. Derived a third of the way from default_bg to tab_idle when nobody names it, the same bargain tab_status_fg and tab_status_stripe already make: both ends are colours every theme in contrib defines, so each gets a plate in its own family -- paper lightens, phosphor greens, mono stays grey -- without a line added to any of them. Naming it wins, and naming your own background is how you ask for the bare tabs back. The `+ new tab` button and the gaps between tabs stay unpainted: the button is the one row in the list that does not mean "go here", and tab_gap is air between plates, which is what makes them read as separate tabs at all.
Diffstat (limited to 'docs')
-rw-r--r--docs/panes.md12
1 files changed, 12 insertions, 0 deletions
diff --git a/docs/panes.md b/docs/panes.md
index 96fefc8..087c873 100644
--- a/docs/panes.md
+++ b/docs/panes.md
@@ -126,6 +126,18 @@ yours wins; the band is unset by default, which leaves a translucent
terminal's own background alone. The top strip has one row and no room for any of this, which is half of
why the sidebar exists.
+**Every tab is a plate, not a word on the background.** The one you are in is
+filled with the accent (`tab_active_bg`); the rest sit on `tab_idle_bg`, a
+third of the way from the theme's background to the grey it writes idle labels
+in. Two things come of the quiet fill: a tab has edges, so where one ends, how
+far the row you are about to click reaches, and — in the sidebar especially —
+which rows are tabs rather than statuses are all visible; and the active fill
+has something to be brighter *than*, which on a strip of short labels is most
+of how the eye finds it. Unset, it is mixed from two colours every theme
+defines, so each gets a plate in its own family — paper lightens, phosphor
+greens. Name it and yours wins: set it to your own `default_bg` for the bare
+strip, or somewhere further along for a louder one.
+
**An unnamed tab borrows the directory its focused pane is in** — the
kernel's answer, so a `cd` moves the label with you, and home shows as `~`.
A real name or a [purpose](layouts.md#purposes) wins the moment one exists;