kiln.widgets
kiln.widgets declares bars and client decorations from kiln.ui elements.
Values belong to your config; these functions do not create persistent widget
objects. Read widget conventions for state, callbacks
and IDs.
Form widgets
| Function | Displays |
|---|---|
| progress | A horizontal fill from 0 to 1. |
| separator | A horizontal or vertical line. |
| toggle | A boolean switch. |
| slider | A draggable value from 0 to 1. |
widgets.progress(cfg)
See progress options and example.
widgets.separator(cfg?)
See separator options and example.
widgets.toggle(cfg)
See toggle options and example.
widgets.slider(cfg)
See slider options and example.
Bar cells
| Function | Displays |
|---|---|
| taglist | Tags on a screen. |
| tasklist | Client titles and icons. |
| systray | Status-notifier items. |
| layoutbox | The selected layout. |
| layoutlist | A menu for selecting layouts. |
| clock | Date and time, updated each minute. |
widgets.filter
See tasklist filters.
The handler table
See press and scroll callbacks.
Client widgets
| Function | Declares |
|---|---|
| client | Border, titlebar, surface and resize handles. |
| titlebar | Title and window buttons. |
| resize_handles | Eight invisible resize targets. |
The module table is the extension point
See replacing a widget.
Writable by a config
See the API available to widgets.