Skip to content
Version 2026.25

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 ​

PropertyTypeDefaultDescription
Variantplain, status, tag-browserplainHow it looks: plain (default), status or tag-browser.
Sourceproperty, tag-folder, udt-instancespropertyWhere the nodes come from: property (the items property, nested), tag-folder (browsed lazily from the tag provider) or udt-instances.
Root PathString(none)For tag sources, the folder or provider shown as the top level, for example [Plant]Area1. Blank shows every provider.
Selectionsingle, multisinglesingle or multi (Ctrl or Shift click, Space toggles).
Selected PathsString(none)The selected node ids. Bind it to read or move the selection; the tree writes the operator's choice back.
Expanded PathsString(none)The expanded node ids, bindable the same way.
Search Boxfalse, truefalseShow a search box. Always on for tag-browser.
Search TextString(none)The text in the search box, bindable.
Checkboxes (tag-browser)true, falsetrueTag-browser only: a checkbox on each node.
Iconsauto, on, offautoauto shows an icon per node type, on always, off never.
Alarm Roll-upcollapsed, alwayscollapsedStatus only: collapsed shows the worst alarm below a collapsed parent, always also on expanded ones.
Empty TextStringNo itemsShown when there are no nodes.
Quality Markstandard, dimstandardHow a lost link is marked when a value this component shows has Stale or Bad quality. standard (the default) draws the quality outline and glyph over the value. dim keeps the last good value on screen, faded, with nothing drawn over it: it suits a dense panel where one lost link turns a whole column Bad. The value still reads as not live, and a binding that fails to evaluate keeps its outline either way.

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.