Struct Element 

pub struct Element { /* private fields */ }

Available on crate feature container only.

An XML element with ordered attributes and children.

Implementations

impl Element

pub fn new(name: &str) -> Self

An empty element with the given tag name.

pub fn attr(self, name: &str, value: &str) -> Self

Adds an attribute (escaped on render). Repeats are kept in order.

pub fn text(self, text: &str) -> Self

Appends escaped text content.

pub fn child(self, child: Element) -> Self

Appends a child element.

pub fn push(&mut self, child: Element)

Appends a child element in place.

pub fn render(&self) -> String

Serializes this element and its descendants. No XML declaration is prepended; a caller that wants one writes DECLARATION first.

pub fn render_document(&self) -> String

Serializes a complete document part: the XML DECLARATION, then this element.

pub fn render_document_pretty(&self) -> String

Serializes a complete document part with two-space indentation: the XML DECLARATION, this element laid out over multiple lines, and a trailing newline. An element holding only text stays on one line; an element with child elements puts each child on its own indented line.

Trait Implementations

impl Clone for Element

fn clone(&self) -> Element

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.