Widgets Workspaces

Workspaces

Workspace indicators with click-to-switch support.

Options

Option	Type	Default	Description
label_type	string	"none"	"icons", "name", "index", or "none"
separator	string	""	Separator between indicators
animate	bool		Enable smooth indicator animations. Default: inherits theme.animations
filter_by_output	bool	true	Show only workspaces on this bar's output
show_unoccupied	bool	false	Show empty workspaces (no windows)
background_color	string		Custom background color (hex)

Label types:

• icons - Symbols: ● (active), ○ (occupied), ◆ (urgent)
• name - Workspace names.
• index - Numeric position (1, 2, 3…). Falls back to name if unavailable
• none - Minimal dots

Styling

Class	Description
.workspaces	Widget container
.workspace-indicator	Individual workspace dot/button
.workspace-indicator.active	Currently focused workspace
.workspace-indicator.occupied	Has windows
.workspace-indicator.urgent	Needs attention
.workspace-separator	Separator element
.workspace-indicator-minimal	Minimal mode indicator (label_type = "none")
.workspace-indicator-long	Indicator with label longer than 2 characters
.workspace-indicator-collapsed	Indicator animating out during removal
.workspace-grow-in	Indicator animating in during creation
.workspace-no-animate	Applied when animate = false

Example - pill-shaped indicators:

.workspace-indicator {
  border-radius: 4px;
  min-width: 16px;
}
.workspace-indicator.active {
  min-width: 24px;
}