Interface HierarchyTreeConfig

Optional active / selected record ID. When provided, the node is highlighted and all ancestors are expanded so it is visible in full tree context.

Whether to allow interactive drag-and-drop reparenting of nodes.

Whether to display quick node action buttons (Open Record, Add Child, Focus Subtree) on node cards.

When multiple root trees exist and an active/focus record is specified, automatically focuses on the root branch containing the active record. Users can click "Show All Roots" to zoom out to the full forest.

Optional field name containing a hex color or theme token for the node accent.

Default accent color when a node does not provide one. Prefer a design token over a literal so the accent follows the active theme.

Default Font Awesome icon class when a node does not provide one.

The MemberJunction entity name (e.g. 'MJ_BizApps_Common: Organizations', 'MJ_BizApps_Orders: Product Categories'). The component queries this entity and uses its metadata for primary keys and foreign keys.

Optional SQL-like filter string applied to the RunView query (e.g. 'IsActive = 1').

Optional subtree focus record ID. When provided, the tree renders only the specified record and its descendants.

Total height of the tree container (e.g. '100%', '560px').

Optional field name containing a Font Awesome icon class or image URL.

Maximum depth to expand initially upon loading. 0 expands all levels.

Vertical spacing between hierarchy depth levels in pixels.

Optional maximum number of rows to retrieve via RunView. 0 loads all records.

Minimum height of the tree container.

The field name to use for the primary node label. If omitted, automatically defaults to the entity's configured NameField / IsNameField.

Whether single-clicking a node card triggers navigation to that record.

Height of individual node cards in pixels.

Visual style for node cards.

Width of individual node cards in pixels.

Optional order-by clause for sorting sibling nodes (e.g. 'Name ASC', 'Sequence ASC').

Layout orientation.

The self-referencing foreign key field name that points to the parent record (e.g. 'ParentID', 'ParentCategoryID'). If omitted, defaults to 'ParentID' or automatically resolves from the entity's self-referencing foreign key metadata.

Whether to display the interactive search / filter bar at the top of the tree.

Whether to display the zoom / navigation toolbar (Fit, Zoom In, Zoom Out, Expand All, Collapse All).

Horizontal spacing between sibling nodes in pixels.

Optional field name to use for the node subtitle / secondary tag (e.g. 'OrganizationType', 'AccountCode').

Whether to enable verbose diagnostic console logging.