Struct xml::writer::events::StartElementBuilder

pub struct StartElementBuilder<'a> { /* fields omitted */ }

A builder for a starting element event.

Methods

impl<'a> StartElementBuilder<'a>

fn attr<N>(self, name: N, value: &'a str) -> StartElementBuilder<'a> where
    N: Into<Name<'a>>, 

Sets an attribute value of this element to the given string.

This method can be used to add attributes to the starting element. Name is a qualified name; its namespace is ignored, but its prefix is checked for correctness, that is, it is checked that the prefix is bound to some namespace in the current context.

Currently attributes are not checked for duplicates. Note that duplicate attributes are a violation of XML document well-formedness.

The writer checks that you don't specify reserved prefix names, for example xmlns.

fn ns<S1, S2>(self, prefix: S1, uri: S2) -> StartElementBuilder<'a> where
    S1: Into<String>,
    S2: Into<String>, 

Adds a namespace to the current namespace context.

If no namespace URI was bound to the provided prefix at this point of the document, then the mapping from the prefix to the provided namespace URI will be written as a part of this element attribute set.

If the same namespace URI was bound to the provided prefix at this point of the document, then no namespace attributes will be emitted.

If some other namespace URI was bound to the provided prefix at this point of the document, then another binding will be added as a part of this element attribute set, shadowing the outer binding.

fn default_ns<S>(self, uri: S) -> StartElementBuilder<'a> where
    S: Into<String>, 

Adds a default namespace mapping to the current namespace context.

Same rules as for ns() are also valid for the default namespace mapping.