Node

live Represents the instantiation of an Element in the live element tree. Nodes are the mutable, long-lived counterparts to immutable Element descriptions. They track parent-child relationships, manage lifecycle state, and serve as the bridge between the declarative element descriptions and the rendered output. This is an internal framework type not intended for direct use by end users.

Properties

IsFaulted

True if this node’s last Build call threw an unhandled exception. A faulted node renders an ErrorPlaceholder and will not be re-queued for rebuilds until the parent replaces it with a fresh element.

IsUnmounted

True once this node has been unmounted. A node that is unmounted may still be in the rebuild scheduler queue (scheduled before the parent rebuilt and replaced this subtree). The scheduler skips unmounted nodes.

Fields

_inheritedDependents

Nodes that depend on this node when this node holds an InheritedElement. These are scheduled for rebuild when UpdateShouldNotify returns true.

Methods

AddInheritedDependent

Registers as a node that depends on the inherited data carried by this node. Called when a descendant’s build context invokes DependOnInherited and resolves to this node.

FindInheritedAncestor“1

Walks up the ancestor chain to find the nearest Node whose element is an InheritedElement of type . Returns null when no such ancestor exists.

MarkUnmounted

Marks this node as unmounted so the rebuild scheduler can skip it if it was queued before the parent rebuilt and replaced this subtree.

NotifyInheritedDependents

Marks all registered inherited dependents dirty so they are rebuilt on the next frame. Called by TreePatcher when an InheritedElement update returns true from UpdateShouldNotify.

RemoveInheritedDependent

Removes from the inherited dependents set. Called when the dependent node is unmounted.