Skip to main content

Checkbox

The Checkbox element (visualized as a switch) is an input component that allows the user to switch between two states (active/inactive, true/false). It is ideal for controlling boolean variables such as starting motors, valves, or enabling systems.

Properties marked with bolt allow dynamization from an expression with variables.

General​

Basic identification and position configuration.

Name (string)​

Unique identifier of the element.

Description (string)​

Optional descriptive text.

X bolt (number)​

Horizontal position in pixels.

Y bolt (number)​

Vertical position in pixels.

Z bolt (number)​

Depth index (z-index).

Width bolt (number)​

Width of the element in pixels.

Height bolt (number)​

Height of the element in pixels.

Style​

Visual customization of the component.

Disabled bolt (boolean)​

Disables user interaction.

Hidden bolt (boolean)​

Makes the element invisible.

Color bolt (color)​

Color of the indicator (knob/handle).

Background Color bolt (color)​

Background color (track) of the switch.

Border Radius bolt (number)​

Corner rounding. A high value (e.g., 5000) creates the rounded pill effect.

Rotate bolt (number)​

Rotation angle in degrees.

Transition (string)​

CSS transition definition for smooth changes.

Anchor Point [Vert./Horiz.] (string)​

Defines which edge of the element acts as the fixed position reference. Extremely useful when dynamically resizing elements (e.g., a progress bar): if you anchor vertically to "Bottom", increasing the height will cause the element to grow upwards, keeping its base fixed on the synoptic.

Shadow (string)​

Allows selecting a predefined shadow level (None, Small, Medium, Large).

Advanced​

Interaction behavior and event configuration.

Variable (Tag)​

System variable linked to the switch state. Automatically reads from and writes to it.

Off Value (string/number)​

Value assigned to the variable when the switch is inactive (left). Default 0.

On Value (string/number)​

Value assigned to the variable when the switch is active (right). Default 1.

Remanent Value (boolean)​

Maintains the last selected state locally if the synoptic is reloaded.

Permissions​

Role-based access control.

Activate protection (boolean)​

Enables security restrictions. If inactive, any user can interact with the element.

Allowed groups (Array)​

List of authorized user groups.