Struct ElementBuilder

pub struct ElementBuilder<'a> { /* private fields */ }

An easy way to build a new element by chaining methods to add properties.

Call Element::build() to start building. To finish building, either call .finish() or .push_to(parent) which returns Element.

Examples

use xml_doc::{Document, Element, Node};

let mut doc = Document::new();

let root = Element::build(&mut doc, "root")
    .attribute("id", "main")
    .attribute("class", "main")
    .finish();
doc.push_root_node(root.as_node());

let name = Element::build(&mut doc, "name")
    .text_content("No Name")
    .push_to(root);

/* Equivalent xml:
  <root id="main" class="main">
    <name>No Name</name>
  </root>
*/

Implementations

impl<'a> ElementBuilder<'a>

pub fn prefix<S: Into<String>>(self, prefix: S) -> Self

Removes previous prefix if it exists, and attach new prefix.

pub fn attribute<S, T>(self, name: S, value: T) -> Self

where S: Into<String>, T: Into<String>,

pub fn namespace_decl<S, T>(self, prefix: S, namespace: T) -> Self

where S: Into<String>, T: Into<String>,

pub fn text_content<S: Into<String>>(self, text: S) -> Self

pub fn finish(self) -> Element

pub fn push_to(self, parent: Element) -> Element

Push this element to the parent’s children.