Quad Design Widgets

unique id for this widget (optional)

an (array of) item(s)

valid types: 'micro', 'mini', 'midi', 'icon', 'text' (optional, default: mini)

array of values (optional, default [0,1])
If the item has a value that is not part of the list, the state (icon, text, color) of the last value in the list will be shown.

array of icons (optional, default just if text is empty: control_on_off)
dynamic icons can be used, e.g. icon.light('', '', value_item, min_display, max_display); please note: these must not be wrapped by apostrophs (')

array of texts (optional)

array of colors; 'icon1' or e. g. '#f00' for red (optional, default: icon0)
additionally you can use 'hidden' to not diplay at all or 'blank' to make it invisible but preserve the space that would be used.

activity indicator which is active until response (or a timeout of 3 seconds is reached); pass either a color, 'icon1' or 'blink' (optional)

an item to which a value on longpress is sent (optional)

the value to send on longpress (optional)
If this starts with a + or - sign the value is treated as offset to current stateswitch value.

the value to send on releasing after a longpress (optional)

placeholder attributes for future features, etc.

placeholder attributes for future features, etc.
If you want to implement two state switches for one single item (e.g. on/off and timer or restart, etc.)
you can provide the following attributes as single statements without arrays.

text for the whole line (optional)

text for each column (optional)

a gad/item for UZSU

Array with standard UZSU parameters: pic_on, pic_off, valueType, valueParameterList, color_on, color_off. (optional)

array with all plot.period attributes to show a plot in popup. Alternatively just the item to be plotted.

icon triggering the plot popup

"root item" which holds stateengine information. show current state of stateengine/stateengine item. Adjust icons and states below accordingly

Array of arrays for extended popup window. Use this to create an icon to open a popup with switches, sliders, flips or select menues.
First entry can either be "stateengine" to make the stateengine plugin icon the trigger for the popup or an icon (e.g. time_automatic).
After that you have to create an array for each line of the popup. In this array you first define the elements like switch, text, etc.,
followed by the attributes for each element as you would for the basic widget.
Possible elements are: header, text, slider, flip, switch, select
Example: ['stateengine', ['header', 'Suspendzeit'], [['switch', 'slider'], [switch_item, 'icon', [0,1], ['secur_open','secur_locked']],
[slider_item, slider_min, slider_max, slider_step, '', 'handle']]

array with items for locking. You have to be aware of the order: item_lock, item_bwmlock (presence sensor), item_force (force on/off/neutral)

additional item for changing value (e.g. timer). A slider popup will be shown
You can provide additional attributes as an array: item, min, max, step, format, value_display (handle, etc.)

placeholder attributes for future features, etc.

placeholder attributes for future features, etc.

array with element description: Reorder elements to your liking (esp. relevant for smartphones as several columns might be too much)
possible elements are: 'switch', 'stateengine', 'uzsu', 'plot', 'locks', 'slider'
For empty columns either use ' ' or a number to define the column width (e.g. '40' = 40 pixels width)
Combine elements in one column by putting them in arrays. Standard is ['locks', 'switch', 'slider', 'stateengine', 'plot', 'uzsu']
Be aware that this only works with lines containing one switch only! For multiple switches leave column_order empty and rely on the defaults.