Enum DomEvent 

pub enum DomEvent<'a> {
    NodeStart {
        tag: Cow<'a, str>,
        namespace: Option<Cow<'a, str>>,
    },
    Attribute {
        name: Cow<'a, str>,
        value: Cow<'a, str>,
        namespace: Option<Cow<'a, str>>,
    },
    ChildrenStart,
    ChildrenEnd,
    NodeEnd,
    Text(Cow<'a, str>),
    Comment(Cow<'a, str>),
    ProcessingInstruction {
        target: Cow<'a, str>,
        data: Cow<'a, str>,
    },
    Doctype(Cow<'a, str>),
}

Events emitted by a DOM parser.

These events represent the structure of a tree-based document (HTML/XML). The event stream follows this pattern for each element:

NodeStart { tag: "div" }
  Attribute { name: "class", value: "container" }
  Attribute { name: "id", value: "main" }
  ChildrenStart
    Text("Hello ")
    NodeStart { tag: "strong" }
      ChildrenStart
        Text("world")
      ChildrenEnd
    NodeEnd
    Text("!")
  ChildrenEnd
NodeEnd

Variants

NodeStart

Start of an element node.

Followed by zero or more Attribute events, then ChildrenStart.

Fields

tag: Cow<'a, str>

The tag name (e.g., “div”, “p”, “my-component”).

namespace: Option<Cow<'a, str>>

Optional namespace URI.

Attribute

An attribute on the current element.

Only valid between NodeStart and ChildrenStart.

Fields

name: Cow<'a, str>

Attribute name.

value: Cow<'a, str>

Attribute value.

namespace: Option<Cow<'a, str>>

Optional namespace URI.

ChildrenStart

Start of the children section.

After this, expect Text, NodeStart, or ChildrenEnd.

ChildrenEnd

End of the children section.

NodeEnd

End of an element node.

Must be preceded by ChildrenEnd (or directly by attributes for void elements).

Text(Cow<'a, str>)

Text content.

Only valid between ChildrenStart and ChildrenEnd.

Comment(Cow<'a, str>)

A comment (usually ignored during deserialization).

ProcessingInstruction

A processing instruction (XML) or DOCTYPE (HTML).

Fields

target: Cow<'a, str>

Target (e.g., “xml” for <?xml ...?>).

data: Cow<'a, str>

Data content.

Doctype(Cow<'a, str>)

DOCTYPE declaration (HTML5).

Implementations

impl<'a> DomEvent<'a>

pub fn is_node_start(&self) -> bool

Returns true if this is a NodeStart event.

pub fn is_node_end(&self) -> bool

Returns true if this is a NodeEnd event.

pub fn is_attribute(&self) -> bool

Returns true if this is an Attribute event.

pub fn is_text(&self) -> bool

Returns true if this is a Text event.

pub fn is_children_start(&self) -> bool

Returns true if this is ChildrenStart.

pub fn is_children_end(&self) -> bool

Returns true if this is ChildrenEnd.

pub fn trace(&self) -> TraceFmt<'_, 'a>

Wrap this event for XML-like trace formatting.

Trait Implementations

impl<'a> Clone for DomEvent<'a>

fn clone(&self) -> DomEvent<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for DomEvent<'a>

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

Formats the value using the given formatter.

impl<'a> PartialEq for DomEvent<'a>

fn eq(&self, other: &DomEvent<'a>) -> 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.

impl<'a> StructuralPartialEq for DomEvent<'a>