For a description and a complete list of UI Objects, see
UI Objects.
Controls a light or automation device.
If the button object is connected to a device or light that allows it, a long press on the button will open a popup with a slider. A second long press will close the popup.
If specified on systemtopo.txt, it will show a thumbnail on mouse over or touch.
Parameters
- address: device data point name
- position: the object's position. Use the pixels or rows and columns coordinates format
- label: the text label on the button. Can contain HTML tags
Syntax
(button <address>; <position>; <label>)
Eg.
(button autom.1; x10y20; Front Door)
UI Attributes
Common attributes
Name
|
Value
|
Description
|
pos
|
x<x>y<y>
|
Position specified as x/y coordinates. E.g. x-5y10
|
visible
|
true
|
Default. Show the object
|
false
|
Hide the object
|
blink
|
true | slow
|
Blink the object at a slow speed
|
fast
|
Blink the object at a fast speed
|
false
|
Stop the blinking
|
opacity
|
0.0 ... 1.0
|
Object opacity from 0 (not visible) to 1 (fully visible)
|
rotation
|
0 ... 360
|
Object rotation in degrees. Images are rotated around the center point, all other objects are rotated around the top left corner
|
Label attributes
Name
|
Value
|
Description
|
label
|
<string>
|
Label's text. Can contain HTML tags
|
fontfamily
|
<family name>
|
A prioritized list of font family names
|
fontsize
|
<size>
|
Font size in pixels. E.g. 15px
|
fontcolor
|
<CSS color>
|
Font color
|
fontstyle
|
normal
|
Normal font style, default
|
italic
|
Italic font style
|
oblique
|
Oblique font style
|
fontweight
|
normal
|
Normal characters, default
|
bold
|
Thick characters
|
bolder
|
Thicker characters
|
lighter
|
Lighter characters
|
100 ... 900
|
Defines from thin to thick characters. 400 is the same as normal, and 700 is the same as bold
|
Button attributes
Name
|
Value
|
Description
|
style
|
red,green,blue...
|
Set the button's style (color). Styles vary depending on the selected skin
|
enabled
|
true
|
Default. Enable the button
|
false
|
Disable the button
|