Digital Valve

This text is AI-generated

This documentation was written with the help of AI and has not been fully reviewed. If something is wrong, unclear or missing, please let us know. Use the feedback form, and say which section it concerns.

The Digital Valve is an automation symbol for a valve that is either open or closed, such as a shut-off valve. It is found in the Automation - OpenBridge section of the Perspective Component Palette as Digital Valve.

It is meant to be placed in a mimic or diagram, typically in a coordinate container, with its properties bound to the state of the device. The Digital Valve shows the state it is given; it does not change it, and clicking it does nothing unless you configure an event.

The Digital Valve is one of the automation buttons. The readout and tag, the alert frame, the progress ring, the badges, the size and the positioning are shared by all of them and are described in Automation Buttons — Common Features. This page covers what is specific to the Digital Valve.

A Digital Valve dropped from the palette with default properties:

State

Bind open to the tag or property that tells whether the valve is open. The symbol is drawn filled and grey when open is false, and as an outline when it is true.

Closed	Open

The status row of the readout shows Off or On.

---

Variant and Orientation

variant selects whether the icon is drawn on a button or directly on the background:

• regular (default) — the icon sits on a round button.
• flat — only the icon is drawn, larger and without a button. Use it where the valve is part of a pipe in a diagram.

Set vertical to true for a valve in a vertical pipe.

	Closed	Open	Closed, vertical	Open, vertical
regular
flat

---

Properties

Name	Description	Property Type
open	Whether the valve is open. Default false.	value
variant	regular draws the icon on a button, flat draws only the icon. Default regular.	value
vertical	Draw the valve for a vertical pipe. Default false.	value

Common Properties

The Digital Valve is an automation button. The properties below work in the same way on every automation button, and are described in Automation Buttons — Common Features:

• Readout — The readout next to the symbol: the status row and the tag name. Properties: showReadoutStack, readoutPosition, readoutSize, showStatus, hasTag, tag.
• Positioning — Which part of the button is aligned to the component’s box. Properties: positioning.
• Size — Size of the whole component. Properties: componentSize.
• Activated — Highlighted background that marks the symbol as selected. Properties: activated.
• Alert Frame — Alert frame around the symbol. Properties: alert, alertFrameType, alertFrameStatus, alertFrameMode, alertFrameThickness, showAlertCategoryIcon, showAlertIcon.
• Progress — Progress ring while a command is carried out. Properties: progress, progressMode, progressValue.
• Badges — Badges in the corners of the symbol. Properties: badgeControl, badgeAlert, badgeInterlock, badgeCommandLocked.
• Style — Standard Perspective style object.

Component Events

The Digital Valve has no component events of its own. The standard Perspective events, such as onClick, are available in the component’s event configuration. See Operating a Device.