Enum Attr 

#[repr(u8)]
pub enum Attr {
    Element,
    Elements,
    Attribute,
    Text,
    Tag,
    Ns(&'static str),
    NsAll(&'static str),
    CustomElement,
    Doctype,
}

XML attribute types for field and container configuration.

Variants

Element

Marks a field as a single XML child element

Elements

Marks a field as collecting multiple XML child elements

Attribute

Marks a field as an XML attribute (on the element tag)

Text

Marks a field as the text content of the element

Tag

Marks a field as storing the XML element tag name dynamically.

Used on a String field to capture the tag name of an element during deserialization. When serializing, this value becomes the element’s tag.

Ns(&'static str)

Specifies the XML namespace URI for this field.

Usage: #[facet(xml::ns = "http://example.com/ns")]

When deserializing, the field will only match elements/attributes in the specified namespace. When serializing, the element/attribute will be emitted with the appropriate namespace prefix.

NsAll(&'static str)

Specifies the default XML namespace URI for all fields in this container.

Usage: #[facet(xml::ns_all = "http://example.com/ns")]

This sets the default namespace for all fields that don’t have their own xml::ns attribute. Individual fields can override this with xml::ns.

CustomElement

Marks an enum variant as a catch-all for unknown XML elements.

Usage: #[facet(xml::custom_element)]

When deserializing, if no variant name matches the element tag, this variant is selected. Use with xml::tag to capture the tag name.

Doctype

Marks a field as capturing the DOCTYPE declaration from the XML document.

Usage: #[facet(xml::doctype)]

When deserializing, this field captures the DOCTYPE declaration if present. When serializing, the field’s value is emitted as the DOCTYPE declaration. This attribute is ignored on non-root structs to allow struct reuse.

The field type should be Option<String> to handle documents without DOCTYPE.

Trait Implementations

impl Clone for Attr

fn clone(&self) -> Attr

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Attr

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

Formats the value using the given formatter.

impl<'ʄ> Facet<'ʄ> for Attr

const SHAPE: &'static Shape

The shape of this type, including: whether it’s a Struct, an Enum, something else?

impl PartialEq for Attr

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.