Enum VirtualNode 

pub enum VirtualNode {
    Element {
        tag: Tag,
        attributes: Vec<AttributeEntry>,
        children: Vec<VirtualNode>,
        key: Option<String>,
    },
    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.

Variants

Element

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

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.

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 VirtualNode

Implementation of virtual node construction and property extraction.

pub fn get_element_node(tag_name: &str) -> Self

Creates a new element node with the given tag name.

Arguments

• &str: The HTML tag name.

Returns

• VirtualNode: A new element virtual node.

pub fn get_text_node(content: &str) -> Self

Creates a new text node with the given content.

Arguments

• &str: The text content.

Returns

• VirtualNode: A new text virtual node.

pub fn with_attribute(self, name: &str, value: AttributeValue) -> Self

Adds an attribute to this node if it is an element.

Arguments

• &str: The attribute name.
• AttributeValue: The attribute value.

Returns

• Self: This node with the attribute added.

pub fn with_child(self, child: VirtualNode) -> Self

Adds a child node to this node if it is an element.

Arguments

• VirtualNode: The child node to add.

Returns

• Self: This node with the child added.

pub fn is_component(&self) -> bool

Returns true if this node is a component node.

Returns

• bool: true if this is a component element.

pub fn 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_prop(&self, name: &str) -> Option<String>

Extracts a string property from this node if it is an element with the named attribute.

Arguments

• &str: The attribute name to look for.

Returns

• Option<String>: The attribute value as a string, or None.

pub fn try_get_typed_prop<T>(&self, name: &str) -> Option<T>

where T: FromStr,

Extracts a typed property from this node by parsing the attribute value string.

Arguments

• &str: The attribute name to look for.

Returns

• Option<T>: The parsed value, or None if not found or parsing fails.

pub fn try_get_signal_prop(&self, name: &str) -> Option<Signal<String>>

Extracts a signal property from this node if it is an element with the named attribute.

Arguments

• &str: The attribute name to look for.

Returns

• Option<Signal<String>>: The signal, or None if not found.

pub fn get_children(&self) -> Vec<VirtualNode>

Extracts children from this node if it is an element.

Returns

• Vec<VirtualNode>: The children, or an empty vec if not an element.

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

Extracts text content from this node.

Returns

• Option<String>: The text content, or None if unavailable.

pub fn try_get_event(&self, name: &str) -> Option<NativeEventHandler>

Extracts an event handler from this node if it is an element with the named event attribute.

Arguments

• &str: The event attribute name to look for.

Returns

• Option<NativeEventHandler>: The handler, or None if not found.

pub fn try_get_callback(&self, name: &str) -> Option<NativeEventHandler>

Extracts an event handler from this node by a custom attribute name.

Arguments

• &str: The custom callback attribute name to look for.

Returns

• Option<NativeEventHandler>: The handler, or None if not found.

Trait Implementations

impl AsNode for &VirtualNode

Converts a VirtualNode reference into an owned node.

fn as_node(&self) -> Option<VirtualNode>

Clones this virtual node reference into an owned Option<VirtualNode>.

Returns

• Option<VirtualNode> - Always Some with the cloned node.

impl AsNode for VirtualNode

Converts a VirtualNode reference into an owned node.

fn as_node(&self) -> Option<VirtualNode>

Clones this virtual node into an owned Option<VirtualNode>.

Returns

• Option<VirtualNode> - Always Some with the cloned node.

impl Clone for VirtualNode

fn clone(&self) -> VirtualNode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VirtualNode

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

Formats the value using the given formatter.

impl Default for VirtualNode

fn default() -> VirtualNode

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 PartialEq for VirtualNode

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.