Enum VirtualNode 

pub enum VirtualNode<T = ()> {
    Element {
        tag: Tag,
        attributes: Vec<AttributeEntry>,
        children: Vec<VirtualNode>,
        key: Option<String>,
        props: Option<Box<T>>,
    },
    Text(TextNode),
    Fragment(Vec<VirtualNode>),
    Dynamic(DynamicNode),
    Empty,
}

Represents a node in the virtual DOM tree.

The core enum representing elements, text, fragments, and empty nodes. The generic parameter T carries the component props type for component nodes. For non-component nodes, T defaults to ().

Variants

Element

An element node with a tag, attributes, children, and optional props.

Fields

tag: Tag

The tag type of this element.

attributes: Vec<AttributeEntry>

The attributes attached to this element.

children: Vec<VirtualNode>

The child nodes.

key: Option<String>

An optional key for diffing.

props: Option<Box<T>>

The component props, present only for component nodes.

Text(TextNode)

A text node containing string content and an optional reactive signal.

Fragment(Vec<VirtualNode>)

A fragment of multiple nodes without a wrapper element.

Dynamic(DynamicNode)

A dynamic node that re-renders based on signal changes.

Empty

An empty placeholder node.

Implementations

impl<T> VirtualNode<T>

Implementation of virtual node construction and property extraction.

pub fn try_get_tag_name(&self) -> Option<String>

Returns the tag name if this is an element or component node.

Returns

• Option<String> - The tag name, or None if not an element.

pub fn try_get_children(&self) -> Option<&Vec<VirtualNode>>

Returns a reference to the children of this node, if it has any.

Returns Some for Element and Fragment variants, None otherwise.

Returns

• Option<&Vec<VirtualNode>> - The children, or None.

pub fn has_children(&self) -> bool

Returns true if this node has non-empty children.

Returns

• bool - Whether this node has children.

pub fn try_get_props(&self) -> Option<&T>

Returns a reference to the props of this node, if it has any.

Only Element variants with component tags carry props.

Returns

• Option<&T> - The props reference, or None.

pub fn try_take_props(&mut self) -> Option<T>

Takes the props out of this node, leaving None in its place.

Returns

• Option<T> - The props, or None if this node has no props.

pub fn take_children(&mut self) -> VirtualNode

Takes the children out of this node, replacing them with an empty vector.

Returns a VirtualNode (Fragment or single child) representation of the children.

Returns

• VirtualNode - The children as a virtual node.

impl VirtualNode<()>

Implementation of virtual node construction for VirtualNode<()>.

pub fn create_dynamic<F>(render_fn: F) -> Self

where F: FnMut() -> Self + 'static,

Constructs a Self::Dynamic from a render closure with hook context management.

Arguments

• FnMut() -> Self + 'static - The render closure that produces a virtual node tree. Called on initial render and on every signal update.

Returns

• Self - A Self::Dynamic wrapping the render closure with a fresh HookContext.

pub fn create_dynamic_with_context<F>(render_fn: F) -> Self

where F: FnMut(&mut HookContext) -> Self + 'static,

Constructs a Self::Dynamic for match expressions where arm hook isolation is required. The render closure receives a &mut HookContext so it can call set_arm_changed before each arm body.

Arguments

• FnMut(&mut HookContext) -> Self + 'static - The render closure that receives a mutable reference to the hook context.

Returns

• Self - A Self::Dynamic wrapping the render closure with a fresh HookContext.

Trait Implementations

impl<T: Clone> Clone for VirtualNode<T>

Clones a VirtualNode<T> by deep-copying all fields.

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Debug> Debug for VirtualNode<T>

Debug formatting for VirtualNode<T>.

Skips Dynamic inner details and props for brevity.

fn fmt(&self, formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<T> Default for VirtualNode<T>

Default implementation returns VirtualNode::Empty.

fn default() -> Self

Returns the “default value” for a type.

impl IntoNode for VirtualNode

Converts a VirtualNode into itself via IntoNode.

fn into_node(self) -> VirtualNode

Returns this virtual node as-is.

Returns

• VirtualNode - This same virtual node.

impl<T: PartialEq> PartialEq for VirtualNode<T>

Visual equality comparison for virtual DOM nodes.

Used by DynamicNode re-rendering to skip unnecessary DOM patches when the rendered output has not changed. Event attributes are always considered equal because re-binding event listeners is handled separately by the handler registry and does not affect visual output. Dynamic nodes manage their own subtree re-rendering, so two Dynamic variants are always considered equal — the inner renderer handles patching when the dynamic content actually changes.

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.