Appearance
Tree
A collapsible tree of areas, equipment or tags, with selection, search and alarm roll-up.
In Studio
In Studio, double-click Tree in the Components category of the Components panel. It is added to the open view, where you can drag it into place.
When to use
Use Tree to navigate a plant hierarchy or pick tags. plain is a simple list with chevrons, status adds a state dot and rolls the worst alarm up to collapsed parents, tag-browser adds search and checkboxes and lets tags be dragged out onto other components.
Properties
| Property | Type | Default | Description |
|---|---|---|---|
| Variant | plain, status, tag-browser | plain | How it looks: plain (default), status or tag-browser. |
| Source | property, tag-folder, udt-instances | property | Where the nodes come from: property (the items property, nested), tag-folder (browsed lazily from the tag provider) or udt-instances. |
| Root Path | String | (none) | For tag sources, the folder or provider shown as the top level, for example [Plant]Area1. Blank shows every provider. |
| Selection | single, multi | single | single or multi (Ctrl or Shift click, Space toggles). |
| Selected Paths | String | (none) | The selected node ids. Bind it to read or move the selection; the tree writes the operator's choice back. |
| Expanded Paths | String | (none) | The expanded node ids, bindable the same way. |
| Search Box | false, true | false | Show a search box. Always on for tag-browser. |
| Search Text | String | (none) | The text in the search box, bindable. |
| Checkboxes (tag-browser) | true, false | true | Tag-browser only: a checkbox on each node. |
| Icons | auto, on, off | auto | auto shows an icon per node type, on always, off never. |
| Alarm Roll-up | collapsed, always | collapsed | Status only: collapsed shows the worst alarm below a collapsed parent, always also on expanded ones. |
| Empty Text | String | No items | Shown when there are no nodes. |
Binding
This component has no single value binding.
The selection and expand state are OUTPUTS and inputs: selectedPaths, selectedPath, selectedNode and expandedPaths are published as live values. Events: onSelect, onExpand and onActivate (double click or Enter). Arrow keys move, Left and Right collapse and expand, and typing jumps to a matching node.