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 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.

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

• Self- 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

• Self- 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) -> &[Self]

Returns a slice of the children if this node is an element.

Returns

• &[Self]- The children slice, or an empty slice 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.

Trait Implementations

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.