ext
Creates a button that, when clicked, causes DashBoard to open an editor tab for a device in the DashBoard tree view. When the button is pressed, DashBoard searches its tree view for a node with the provided ID. If a node is found and the node contains an editor, its editor is opened and/or brought to the foreground (made the active tab).
If a component is buried deep within the UI (e.g. a tab within a tab), the card can supply multiple IDs to ‘reveal’ not only the desired component, but also the component’s parents.
Syntax
<ext name="button-name" objectid="node-id" buttontype="type" general attributes/>
<ext name="button-name" objectid="FileNavigator,file-path,file-name" buttontype="type" general attributes/>
Attributes
In addition to General Attributes, the following attributes may be specified to the <ext> tag:
Attribute |
Values |
Restrictions |
Description |
name |
String |
|
The name to display on the button. |
objectid |
String |
The value must refer to the node ID an element in DashBoard’s tree view. |
Specifies the id of the components to show. DashBoard provides a few shortcuts to reference elements under the device node in the tree or a sibling device in the same frame: %frame% will be replaced with the frame’s primary identifier. %device% will be replaced with the device’s primary identifier. %slot 1 (or 2, or 3, etc.)% will be replaced with the primary identifier of the device in the referenced slot in the same frame. If the String starts with “FileNavigator,” the objectid specifies a path and filename of a resource in the DashBoard file navigator, rather than the tree view. |
buttontype |
button label |
Optional |
“button” = display the link as a button “label” = display the link as a label |
Default values shown in bold.