The tab-bar Alias
This alias, by default translated to the internal zellij:bars plugin url with the role "tab-bar" configuration, represents the tab bar loaded on the top line of the default layout. The zellij:tab-bar plugin url works as well (see The bars plugin).
Features
- Shows the tabs and the session name
- Clicking a tab switches to it, and dragging a tab moves it to another position
- Double-clicking a tab renames it, and double-clicking the empty part of the bar opens a new tab
- Shows a symbol next to a tab whose panes need attention, and a session indicator counting what needs you across all sessions (eg.
◉ 2 need you · 1 running). Clicking the indicator opens the inbox - Right-clicking a tab or the bar opens the right-click menu
Configuration
| Key | Description |
|---|---|
role | tab-bar (the default when no role is given) |
double_click_tab | "none" turns off renaming a tab with a double-click |
double_click_empty | "none" turns off opening a new tab with a double-click on the empty part of the bar |
plugins {
tab-bar location="zellij:bars" {
role "tab-bar"
double_click_tab "none"
}
}
Hiding the bars
Bars can be hidden and shown again while Zellij runs:
Ctrl p+Shift z(theToggleBarsaction) hides all bars, or shows them again if any are hidden- The right-click menu of a bar has "Hide ..." for that bar and "Hide all bars", and every right-click menu has "Show bars" while a bar is hidden
zellij action hide-bars [BARS]...,zellij action show-barsandzellij action toggle-bars [BARS]..., where a bar is namedtab-bar,status-bar,compact-bar, a plugin alias or location, orall
The bars_hidden_on_start, hidden_bars_notification and mode_hints_when_bars_hidden options choose which bars a new session starts with hidden, whether a short note is shown when bars are hidden, and whether the keys of a mode are shown in a corner while the status bar is hidden.
Contract
Zellij loads this tab bar with a height of 1 and a width the size of the user's full screen. Zellij has no other expectations from this plugin, even though users will probably expect at least the tabs to be shown.
A bar plugin can give its space in the layout back while it has nothing to draw.