Click and mouse events

There are four interaction types: Click, Mouse Down, Mouse Up and Mouse Over. None of them displays a value — they attach an event handler to the object and run only on user interaction, which is why they take no part in the screen’s periodic evaluation loop.

Having chosen the type, you then choose an action.

Action	What it does
Set	Writes a value to a variable
Navigation	Takes the operator to another screen, a popup or a platform page
Confirm	Asks the operator a question before going ahead

Set — writing a value

The most common action. You give the target variable and the value to write, and the value’s type is chosen as Number or Text.

What really decides the experience is the interface the operator is asked through:

Style	What the operator sees
Auto	The interface is chosen for you from the variable’s type
Manual	Types the value in
Yes/No	A yes / no choice
Slider	Picks from a range with a slider
Toggle	Switches between two states
Auto Toggle	Switches to whichever state the variable is not currently in
Keyboard	An on-screen keyboard — for touch operator panels
Select (dropdown)	One of a predefined set of options

The interface’s size is set separately as Small / Medium / Large.

Entering the option list in bulk

With Select (dropdown) you can paste the options rather than typing them row by row. Two forms are accepted:

• JSON — { "Stopped": 0, "Running": 1 }, or [{ "label": "Stopped", "value": 0 }, …]
• Delimited text — each line, or each item separated by ;, as label:value or label=value

An item with no separator takes its label as its value. Malformed items are skipped.

Write permission and locks

The Set action is an ordinary variable write: it is refused if the user lacks the permission, and refused again if the variable carries an Operation Lock. For a user without access to an interaction type the handler is never attached at all — the screen becomes view-only for that user on its own.

Navigation — moving between screens

Decides where clicking the object takes the operator.

Sub-action	What it does
Navigate (open page)	Opens the target screen
Popup	Opens the target screen in a window
Back (previous page)	Returns to the previous screen — no target is chosen, the history is used
Map page	Opens the map page
System page	Opens a platform page
Visualization	Switches to the runtime view
Broadcast	Opens the broadcast page

Navigate and Popup can also carry placeholder values for the target screen; that is how one screen is opened for different equipment.

Confirm — asking first

Puts a question to the operator and goes ahead only on confirmation. It belongs in front of a critical write: it stops a button pressed by accident from sending a command to the field.

What it binds to

All four interaction types are available on any SVG object. You do not have to draw a button — an existing valve symbol, a rectangle or a piece of text can be made clickable.

Related

• Element Editor — the binding form
• Slider — the type that writes by being dragged rather than clicked
• Iframe and Faceplate