mirror of
https://github.com/Zedfrigg/ironbar.git
synced 2025-08-17 23:01:04 +02:00
Jake Stanger
ccfe73f6a7
Adds a new module which shows the status of toggle mod keys (capslock, num lock, scroll lock). Resolves #700
102 lines
3.2 KiB
Markdown
102 lines
3.2 KiB
Markdown
> [!NOTE]
|
|
> This module requires your user is in the `input` group.
|
|
|
|
Displays the toggle state of the capslock, num lock and scroll lock keys.
|
|
|
|
|
|
|
|
## Configuration
|
|
|
|
> Type: `keys`
|
|
|
|
| Name | Type | Default | Description |
|
|
|--------------------|-----------------------------|---------|--------------------------------------------------|
|
|
| `show_caps` | `boolean` | `true` | Whether to show capslock indicator. |
|
|
| `show_num` | `boolean` | `true` | Whether to show num lock indicator. |
|
|
| `show_scroll` | `boolean` | `true` | Whether to show scroll lock indicator. |
|
|
| `icon_size` | `integer` | `32` | Size to render icon at (image icons only). |
|
|
| `icons.caps_on` | `string` or [image](images) | `` | Icon to show for enabled capslock indicator. |
|
|
| `icons.caps_off` | `string` or [image](images) | `''` | Icon to show for disabled capslock indicator. |
|
|
| `icons.num_on` | `string` or [image](images) | `` | Icon to show for enabled num lock indicator. |
|
|
| `icons.num_off` | `string` or [image](images) | `''` | Icon to show for disabled num lock indicator. |
|
|
| `icons.scroll_on` | `string` or [image](images) | `` | Icon to show for enabled scroll lock indicator. |
|
|
| `icons.scroll_off` | `string` or [image](images) | `''` | Icon to show for disabled scroll lock indicator. |
|
|
| `seat` | `string` | `seat0` | ID of the Wayland seat to attach to. |
|
|
|
|
<details>
|
|
<summary>JSON</summary>
|
|
|
|
```json
|
|
{
|
|
"end": [
|
|
{
|
|
"type": "keys",
|
|
"show_scroll": false,
|
|
"icons": {
|
|
"caps_on": ""
|
|
}
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
</details>
|
|
|
|
<details>
|
|
<summary>TOML</summary>
|
|
|
|
```toml
|
|
[[end]]
|
|
type = "keys"
|
|
show_scroll = false
|
|
|
|
[end.icons]
|
|
caps_on = ""
|
|
```
|
|
|
|
</details>
|
|
|
|
<details>
|
|
<summary>YAML</summary>
|
|
|
|
```yaml
|
|
end:
|
|
- type: keys
|
|
show_scroll: false
|
|
icons:
|
|
caps_on:
|
|
```
|
|
|
|
</details>
|
|
|
|
<details>
|
|
<summary>Corn</summary>
|
|
|
|
```corn
|
|
{
|
|
end = [
|
|
{
|
|
type = "keys"
|
|
show_scroll = false
|
|
icons.caps_on = ""
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
</details>
|
|
|
|
## Styling
|
|
|
|
| Selector | Description |
|
|
|------------------------|--------------------------------------------|
|
|
| `.keys` | Keys box container widget. |
|
|
| `.keys .key` | Individual key indicator container widget. |
|
|
| `.keys .key.enabled` | Key indicator where key is toggled on. |
|
|
| `.keys .key.caps` | Capslock key indicator. |
|
|
| `.keys .key.num` | Num lock key indicator. |
|
|
| `.keys .key.scroll` | Scroll lock key indicator. |
|
|
| `.keys .key.image` | Key indicator image icon. |
|
|
| `.keys .key.text-icon` | Key indicator textual icon. |
|
|
|
|
For more information on styling, please see the [styling guide](styling-guide).
|