GraphTree

Key bindings

Key	Action
↑ / k	Move up
↓ / j	Move down
→ / l	Expand or move into first child
← / h	Collapse or move to parent
Home / g	Jump to first node
End / G	Jump to last node
PgUp	Page up
PgDn	Page down
Ctrl+U	Half-page up
Ctrl+D	Half-page down
Space / o	Toggle expand/collapse
Enter	Select node (fires onSelect)

Difference from Tree

GraphTree is optimized for workflow/pipeline DAGs where nodes may have status states (running, success, failed, etc.). Node colors and icons reflect the Status field. Use the standard Tree component for general hierarchical data.

catppuccin-frappecatppuccin-lattecatppuccin-macchiatocatppuccin-mochadraculadracula-lighteverforest-darkeverforest-lightgithub-darkgithub-lightgruvbox-darkgruvbox-lightkanagawamonokainordonedarkonelightrosepinerosepine-dawnrosepine-moonsolarized-darksolarized-lighttokyonight-daytokyonight-moontokyonight-nighttokyonight-storm

GraphTree is a tree view specialized for displaying workflow relationships.

Constructor func NewGraphTree() *GraphTree

Usage

data := components.NewGraphTreeData()
data.AddNode(&components.GraphTreeNode{ID: "root", Label: "Workflow", Status: "Running", Children: []string{"step1"}, Expanded: true})
data.AddNode(&components.GraphTreeNode{ID: "step1", Label: "Validate", Status: "Completed"})

tree := components.NewGraphTree().
  SetData(data).
  SetShowEdgeLabels(true)

fmt.Println(tree != nil)

Methods

Method	Signature	Description
GetSelected	func (t *GraphTree) GetSelected() *GraphTreeNode	GetSelected returns the currently selected node.
SetData	func (t *GraphTree) SetData(data *GraphTreeData) *GraphTree	SetData sets the tree data.
SetOnChange	func (t *GraphTree) SetOnChange(fn func(node *GraphTreeNode)) *GraphTree	SetOnChange sets the callback for selection changes.
SetOnLoadChildren	func (t *GraphTree) SetOnLoadChildren(fn func(nodeID string) ([]*GraphTreeNode, []*GraphTreeEdge)) *GraphTree	SetOnLoadChildren sets the lazy loading callback.
SetOnSelect	func (t *GraphTree) SetOnSelect(fn func(node *GraphTreeNode)) *GraphTree	SetOnSelect sets the callback for node selection (Enter).
SetShowEdgeLabels	func (t *GraphTree) SetShowEdgeLabels(show bool) *GraphTree	SetShowEdgeLabels enables/disables edge label display.

Types

type GraphTreeData struct GraphTreeData holds the data for a GraphTree.

Field	Type	Description
RootID	string

type GraphTreeEdge struct GraphTreeEdge represents an edge between nodes.

Field	Type	Description
From	string
To	string
Type	GraphEdgeType
Label	string	Optional edge label

type GraphTreeNode struct GraphTreeNode represents a node in the workflow graph tree.

Field	Type	Description
ID	string
Label	string
Sublabel	string	Secondary text (e.g., workflow type)
Status	string	Status for coloring (e.g., "Running", "Completed")
NodeType	GraphNodeType	Visual type
Children	[]string	Child node IDs
CanExpand	bool	Whether node can have children loaded
Expanded	bool	Whether children are visible
Loading	bool	Show loading indicator
Depth	int	Depth in tree
Data	any	Associated data

type GraphEdgeType GraphEdgeType defines the line style for edges.

Constant	Description
GraphEdgeSolid
GraphEdgeDashed
GraphEdgeDotted

type GraphNodeType GraphNodeType defines the visual type of a node.

Constant	Description
GraphNodePrimary
GraphNodeSecondary
GraphNodeLink