Struct Element 

pub struct Element { /* private fields */ }

An HTML element: a tag name, attributes, optional text content, and children.

Every builder method takes self and returns Self, so they chain. Content and attribute values are escaped as they go in, not when the element is rendered.

Examples

use winged_rust::prelude::*;
let card = div()
    .add_class("card")
    .set_id("hero")
    .child(h1().text("Welcome"))
    .child(p().text("Fuel, tyres & chain."));
assert_eq!(
    card.render(),
    r#"<div class="card" id="hero"><h1>Welcome</h1><p>Fuel, tyres &amp; chain.</p></div>"#
);

Implementations

impl Element

pub fn new(tag: impl Into<String>) -> Self

Creates an element with the given tag name.

pub fn tag(&self) -> &str

The tag name.

pub fn attributes(&self) -> &[Attribute]

The attributes, in insertion order.

pub fn content(&self) -> Option<&str>

The escaped text content, if any.

pub fn children(&self) -> &[Node]

The child nodes.

pub fn text(self, content: impl AsRef<str>) -> Self

Sets the text content, escaping it.

Replaces any content already set.

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

Sets the text content without escaping it.

The documented escape hatch for markup you already trust. <script> and <style> use this by default.

pub fn child(self, child: impl Into<Node>) -> Self

Appends a child node.

pub fn children_from<N: Into<Node>>( self, children: impl IntoIterator<Item = N>, ) -> Self

Appends several child nodes.

pub fn add_attribute(self, attribute: Attribute) -> Self

Appends an attribute. Does not deduplicate.

pub fn attr(self, key: impl Into<String>, value: impl AsRef<str>) -> Self

Appends key="value", escaping the value. Does not deduplicate.

Ports setAttribute(key:value:).

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

Appends a boolean attribute, which renders as a bare key.

pub fn data_attr(self, key: impl AsRef<str>, value: impl AsRef<str>) -> Self

Appends data-{key}="{value}".

pub fn data_attrs<K: AsRef<str>, V: AsRef<str>>( self, data: impl IntoIterator<Item = (K, V)>, ) -> Self

Appends several data-* attributes.

Takes an ordered iterator rather than a map. Winged-Swift’s dataAttributes(_:) takes a Swift Dictionary, so its rendered attribute order is nondeterministic between runs; this signature makes the output stable. See PORTING.md.

pub fn aria_attr(self, key: impl AsRef<str>, value: impl AsRef<str>) -> Self

Appends aria-{key}="{value}".

pub fn aria_attrs<K: AsRef<str>, V: AsRef<str>>( self, aria: impl IntoIterator<Item = (K, V)>, ) -> Self

Appends several aria-* attributes, in the order given.

pub fn set_id(self, id: impl AsRef<str>) -> Self

Sets id, replacing any existing one.

pub fn set_style(self, style: impl AsRef<str>) -> Self

Sets style, replacing any existing one.

pub fn set_role(self, role: impl AsRef<str>) -> Self

Sets role, replacing any existing one.

pub fn add_class(self, class_name: impl AsRef<str>) -> Self

Appends a class name to class, space-joined.

Only the new value is escaped — the existing attribute is already escaped, and re-escaping it would double-encode. Tests/WingedSwiftTests/CSSHelpersTests.swift has a regression test for exactly that.

pub fn add_classes<S: AsRef<str>>( self, class_names: impl IntoIterator<Item = S>, ) -> Self

Appends several class names.

Trait Implementations

impl Clone for Element

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Element

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

Formats the value using the given formatter.

impl Drop for Element

Tears the subtree down iteratively.

The derived drop glue recurses once per nesting level, so a tree deep enough to need the iterative writer would abort while being freed instead — after rendering fine. Draining into an explicit worklist keeps teardown flat.

Each node has its children moved out before it goes out of scope, so the Drop that runs for it finds nothing left to recurse into.

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl Eq for Element

impl From<Element> for Node

fn from(element: Element) -> Self

Converts to this type from the input type.

impl PartialEq for Element

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Render for Element

fn write_into(&self, out: &mut String, options: &RenderOptions, depth: usize)

Writes this node and its subtree into an existing buffer.

fn render(&self) -> String

Renders as a single line of markup.

fn render_pretty(&self) -> String

Renders with indentation and line breaks.

fn render_with(&self, options: &RenderOptions) -> String

Renders with the given options.

impl StructuralPartialEq for Element