Struct Element 

pub struct Element<E: HtmlElement> { /* private fields */ }

A type-safe HTML element builder.

The type parameter E must implement [HtmlElement] and determines:

• The tag name (via E::TAG)
• Whether it’s a void element (via E::VOID)
• Which children are allowed (via CanContain<Child> implementations)

Implementations

impl<E: HtmlElement> Element<E>

pub fn new() -> Self

Create a new empty element.

pub fn attr( self, name: impl Into<Cow<'static, str>>, value: impl Into<String>, ) -> Self

Add an attribute with a string value.

pub fn attr_value<V: AttributeValue>( self, name: impl Into<Cow<'static, str>>, value: V, ) -> Self

Add an attribute with a type-safe value.

pub fn bool_attr(self, name: impl Into<Cow<'static, str>>) -> Self

Add a boolean attribute (no value, e.g., disabled, checked).

pub fn class(self, class: impl Into<String>) -> Self

Add a class. Multiple calls append to the class list.

pub fn id(self, id: impl Into<String>) -> Self

Add an id attribute.

pub fn data(self, name: &str, value: impl Into<String>) -> Self

Add a data-* attribute.

pub fn child<C, F>(self, f: F) -> Self

where E: CanContain<C>, C: HtmlElement, F: FnOnce(Element<C>) -> Element<C>,

Add a child element.

The child type must be allowed by the parent’s content model. This is enforced at compile time via the CanContain trait.

pub fn text(self, content: impl Into<String>) -> Self

where E: CanContain<Text>,

Add text content.

Only available for elements that can contain text (via CanContain<Text>).

pub fn raw(self, html: impl Into<String>) -> Self

where E: CanContain<Text>,

Add raw HTML content (not escaped).

Use with caution - this bypasses XSS protection.

pub fn children<C, I, F>(self, items: I, f: F) -> Self

where E: CanContain<C>, C: HtmlElement, I: IntoIterator, F: Fn(I::Item, Element<C>) -> Element<C>,

Add multiple children from an iterator.

pub fn when<F>(self, condition: bool, f: F) -> Self

where F: FnOnce(Self) -> Self,

Conditionally add content.

pub fn when_else<F, G>(self, condition: bool, if_true: F, if_false: G) -> Self

where F: FnOnce(Self) -> Self, G: FnOnce(Self) -> Self,

Conditionally add content with else branch.

pub fn into_node(self) -> TypedNode

Convert this element into a renderable node.

pub fn render(&self) -> String

Render this element to a string.

pub fn render_to(&self, output: &mut String)

Render this element to an existing string buffer.

Trait Implementations

impl<E: Clone + HtmlElement> Clone for Element<E>

fn clone(&self) -> Element<E>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<E: Debug + HtmlElement> Debug for Element<E>

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

Formats the value using the given formatter.

impl<E: HtmlElement> Default for Element<E>

fn default() -> Self

Returns the “default value” for a type.