Struct Element 

pub struct Element<'t> { /* private fields */ }

Available on crate feature html only.

A matched element, for inspection and mutation by a handler.

Start-anchored edits (before, prepend, attribute changes) take effect at the start tag; end-anchored edits (append, after, set_inner_content, replace, remove, remove_and_keep_content) are deferred to the matching end tag by the rewriter.

Implementations

impl<'t> Element<'t>

pub fn tag(&self) -> HtmlTag<'_>

The element’s HtmlTag — a known element variant, or HtmlTag::Other (the original-case name) for a custom tag.

pub fn attribute(&self, name: &str) -> Option<&[u8]>

The value of the attribute with the given (ASCII case-insensitive) name, or None if absent. A valueless attribute reports Some(b"").

pub fn has_attribute(&self, name: &str) -> bool

Whether the element has the given attribute.

pub fn set_attribute(&mut self, name: AttributeName, value: &str)

Sets (or adds) an attribute. The AttributeName is pre-validated, so it cannot inject markup; the value is escaped on render.

pub fn remove_attribute(&mut self, name: &str)

Removes the attribute with the given (ASCII case-insensitive) name.

pub fn before(&mut self, content: impl IntoHtml)

Inserts content immediately before the element’s start tag.

Accepts any IntoHtml value: plain strings are escaped; wrap trusted HTML in PreEscaped to emit it verbatim.

pub fn prepend(&mut self, content: impl IntoHtml)

Inserts content as the element’s first children (immediately after the start tag). Escaping follows before.

pub fn append(&mut self, content: impl IntoHtml)

Inserts content as the element’s last children (immediately before the end tag). Escaping follows before.

pub fn after(&mut self, content: impl IntoHtml)

Inserts content immediately after the element’s end tag. Escaping follows before.

pub fn set_inner_content(&mut self, content: impl IntoHtml)

Replaces the element’s children, keeping the start and end tags (and any attribute edits). Escaping follows before.

pub fn replace(&mut self, content: impl IntoHtml)

Replaces the whole element (start tag through end tag). Escaping follows before.

pub fn remove(&mut self)

Removes the whole element, children included.

pub fn remove_and_keep_content(&mut self)

Removes only the element’s start and end tags, leaving its children in place.

pub fn is_removed(&self) -> bool

Whether a remove / remove_and_keep_content / replace disposition is in effect.