mirror of
https://github.com/rad4day/Waybar.git
synced 2023-12-21 10:22:59 +01:00
a3904ff039
Fix the following whitespace formatting issues: - Indentation in scdoc source files should be done with tabs. - Lines where there (clearly) should be a line break, need to have '++' at the end, but several were missing them. - The scdoc manual (clearly) states that lines should be hard wrapped at 80 columns, but when line(s) are indented, that causes rendering issues. So lines where a line break was not clearly intended or clearly not intended, have been put onto 1 line to circumvent the rendering issue. Link: https://lists.sr.ht/~sircmpwn/public-inbox/%3C8251560.T7Z3S40VBb%40bagend%3E
89 lines
2.3 KiB
Markdown
89 lines
2.3 KiB
Markdown
waybar-keyboard-state(5)
|
|
|
|
# NAME
|
|
|
|
waybar - keyboard-state module
|
|
|
|
# DESCRIPTION
|
|
|
|
The *keyboard-state* module displays the state of number lock, caps lock, and scroll lock.
|
|
|
|
You must be a member of the input group to use this module.
|
|
|
|
# CONFIGURATION
|
|
|
|
*interval*: ++
|
|
Deprecated, this module use event loop now, the interval has no effect.
|
|
typeof: integer ++
|
|
default: 1 ++
|
|
The interval, in seconds, to poll the keyboard state.
|
|
|
|
*format*: ++
|
|
typeof: string|object ++
|
|
default: {name} {icon} ++
|
|
The format, how information should be displayed. If a string, the same format is used for all keyboard states. If an object, the fields "numlock", "capslock", and "scrolllock" each specify the format for the corresponding state. Any unspecified states use the default format.
|
|
|
|
*format-icons*: ++
|
|
typeof: object ++
|
|
default: {"locked": "locked", "unlocked": "unlocked"} ++
|
|
Based on the keyboard state, the corresponding icon gets selected. The same set of icons is used for number, caps, and scroll lock, but the icon is selected from the set independently for each. See *icons*.
|
|
|
|
*numlock*: ++
|
|
typeof: bool ++
|
|
default: false ++
|
|
Display the number lock state.
|
|
|
|
*capslock*: ++
|
|
typeof: bool ++
|
|
default: false ++
|
|
Display the caps lock state.
|
|
|
|
*scrolllock*: ++
|
|
typeof: bool ++
|
|
default: false ++
|
|
Display the scroll lock state.
|
|
|
|
*device-path*: ++
|
|
typeof: string ++
|
|
default: chooses first valid input device ++
|
|
Which libevdev input device to show the state of. Libevdev devices can be found in /dev/input. The device should support number lock, caps lock, and scroll lock events.
|
|
|
|
# FORMAT REPLACEMENTS
|
|
|
|
*{name}*: Caps, Num, or Scroll.
|
|
|
|
*{icon}*: Icon, as defined in *format-icons*.
|
|
|
|
# ICONS
|
|
|
|
The following *format-icons* can be set.
|
|
|
|
- *locked*: Will be shown when the keyboard state is locked. Default "locked".
|
|
- *unlocked*: Will be shown when the keyboard state is not locked. Default "unlocked"
|
|
|
|
# EXAMPLE:
|
|
|
|
```
|
|
"keyboard-state": {
|
|
"numlock": true,
|
|
"capslock": true,
|
|
"format": "{name} {icon}",
|
|
"format-icons": {
|
|
"locked": "",
|
|
"unlocked": ""
|
|
}
|
|
}
|
|
```
|
|
|
|
# STYLE
|
|
|
|
- *#keyboard-state*
|
|
- *#keyboard-state label*
|
|
- *#keyboard-state label.locked*
|
|
- *#keyboard-state label.numlock*
|
|
- *#keyboard-state label.numlock.locked*
|
|
- *#keyboard-state label.capslock*
|
|
- *#keyboard-state label.capslock.locked*
|
|
- *#keyboard-state label.scrolllock*
|
|
- *#keyboard-state label.scrolllock.locked*
|