Merge branch 'master' of https://github.com/Alexays/Waybar

man/waybar.5.scd.in

@@ -19,7 +19,7 @@ Valid locations for this file are:
 A good starting point is the default configuration found at https://github.com/Alexays/Waybar/blob/master/resources/config.jsonc
 Also, a minimal example configuration can be found at the bottom of this man page.
 
-The visual display elements for waybar use a CSS stylesheet, see *waybar-styles(5)* for details.
+The visual display elements for waybar use a CSS stylesheet. Waybar supports *style.css* and the appearance-specific *style-light.css* and *style-dark.css* files; see *waybar-styles(5)* for details.
 
 # BAR CONFIGURATION
 
@@ -50,6 +50,10 @@ The visual display elements for waybar use a CSS stylesheet, see *waybar-styles(
 	Output specification follows sway's and can either be the output port such as "HDMI-A-1" or a string consisting of the make, model, and serial such as "Some Company ABC123 0x00000000". See *sway-output(5)* for details.
 	In an array, star '*\**' can be used at the end to accept all outputs, in case all previous entries are exclusions.
 
+*output-dimensions* ++
+	typeof: string|array ++
+	If *output* is not specified, allows selecting outputs by dimensions. Format "(width/height) (</>) (value)", e.g. "width > 1080". Multiple conditions can be chained.
+
 *position* ++
 	typeof: string ++
 	default: top ++
@@ -168,6 +172,7 @@ The visual display elements for waybar use a CSS stylesheet, see *waybar-styles(
 # MODULE FORMAT
 
 You can use PangoMarkupFormat (See https://developer.gnome.org/pango/stable/PangoMarkupFormat.html#PangoMarkupFormat).
+Tooltip appearance is generally controlled globally via CSS and cannot be truly scoped per module. Some modules (such as the clock) provide limited workarounds for customization.
 
 e.g.
 
@@ -355,9 +360,19 @@ A group may hide all but one element, showing them only on mouse hover. In order
 
 *children-class*: ++
 	typeof: string ++
-	default: "hidden" ++
+	default: "drawer-child" ++
 	Defines the CSS class to be applied to the hidden elements.
 
+*always-visible-class*: ++
+	typeof: string ++
+	default: "" ++
+	Defines the CSS class that marks a child module as always visible. The module carrying this class remains shown while the drawer is collapsed and drives the drawer's visibility management. When empty, the leader (first) module is used.
+
+*reveal-delay*: ++
+	typeof: integer ++
+	default: 0 ++
+	Delay in milliseconds to wait after the mouse enters the group before revealing the drawer. When 0, the drawer is revealed immediately.
+
 *click-to-reveal*: ++
 	typeof: bool ++
 	default: false ++
@@ -378,6 +393,18 @@ A group may hide all but one element, showing them only on mouse hover. In order
     typeof: integer ++
     If set, when waybar recives SIGRTMIN+N (where N is this value) it will toggle the visibility of the drawer.
 
+*empty-if-drawer-empty*: ++
+	typeof: bool ++
+	default: false ++
+	Defines whether the group should be assigned the "empty" CSS class when all modules inside the drawer are hidden or missing. If false, the group will not receive the "empty" class as long as the leader module remains visible. This allows users to dynamically style or hide the entire group using CSS when its drawer contents are unavailable.
+
+*reveal-by-default*: ++
+	typeof: bool ++
+	default: false ++
+	Whether the child should be revealed when Waybar starts up. This has to be used with click-to-reveal to take effect.
+
+Group drawers are also given the `.expanded` CSS class when they are expanded.
+
 ```
 "group/power": {
     "orientation": "inherit",
@@ -394,6 +421,37 @@ A group may hide all but one element, showing them only on mouse hover. In order
     ]
 },
 ```
+To hide the power group if it is empty, apply to #power and all its children:
+```
+#power.empty,
+#power.empty * {
+    min-width: 0px;
+    min-height: 0px;
+    padding: 0px;
+    margin: 0px;
+    border: none;
+    font-size: 0px;
+    opacity: 0;
+}
+```
+
+## Select outputs by dimensions
+
+```
+{
+	"layer": "top",
+	"output-dimensions": "width > 1080",
+	...
+}
+```
+
+```
+{
+	"layer": "top",
+	"output-dimensions": ["width < 3840", "height < 2160"],
+	...
+}
+```
 
 # SUPPORTED MODULES
 
@@ -420,6 +478,7 @@ A group may hide all but one element, showing them only on mouse hover. In order
 - *waybar-inhibitor(5)*
 - *waybar-jack(5)*
 - *waybar-keyboard-state(5)*
+- *waybar-load(5)*
 - *waybar-memory(5)*
 - *waybar-mpd(5)*
 - *waybar-mpris(5)*