Varable
Variables are at length described in the Command section where they are produced and in the Block section where they are consumed.
Standalone variables
You can declare your additional variables that do not come from commands. This is useful to
pre-process data with replace
and replace_first_match
to be used in multiple blocks.
[[var]]
name="clock_color_attr"
value = '${clock:color}'
replace = [["(.+)","foreground='$1'"]]
[[block]]
value = "<span ${clock_color_attr}>${clock:value}</span>"
Standalone variables can use each other only in the order they are declared in the file, otherwise the result is undefined.
Filters
Filters are additional functions you can apply to values inside of the ${...}
expressions. Example:
value = '${desktop:window_title.value|def:(no selected window)|max:100}'
Supported filters:
def
sets the default value if the input variable is emptymax
limits the length of the input. If it is larger, it is shortened with ellipsis (...
)align
aligns the text to take fixed width if it is smaller- First character is the filler
- Second character is an alignment:
<
,^
(center) or>
- Min width
- Example:
hello
passed viaalign: >10
will behello