Struct Element 

pub struct Element {
    pub name: String,
    pub namespace: Option<String>,
    pub attributes: IndexMap<String, String>,
    pub children: Vec<Node>,
}

XML element in the AST

Represents a single XML element with its name, namespace, attributes, and child nodes. The structure maintains deterministic ordering of attributes using IndexMap to ensure consistent XML output.

Fields

name: String

Element name (local name without prefix)

namespace: Option<String>

Namespace URI if element is namespaced

attributes: IndexMap<String, String>

Element attributes (name -> value) Uses IndexMap to ensure deterministic attribute ordering

children: Vec<Node>

Child nodes (elements, text, comments)

Implementations

impl Element

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

Create a new element with the given name

Arguments

• name - The element name (local name without namespace prefix)

Example

use ddex_builder::ast::Element;
let element = Element::new("Title");

pub fn with_namespace(self, ns: impl Into<String>) -> Self

Set the namespace for this element

Arguments

• ns - The namespace URI

Example

use ddex_builder::ast::Element;
let element = Element::new("Title")
    .with_namespace("http://ddex.net/xml/ern/43");

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

Add an attribute to this element

Arguments

• key - The attribute name
• value - The attribute value

Example

use ddex_builder::ast::Element;
let element = Element::new("Title")
    .with_attr("LanguageAndScriptCode", "en");

pub fn with_text(self, text: impl Into<String>) -> Self

Add text content to this element

Arguments

• text - The text content

Example

use ddex_builder::ast::Element;
let element = Element::new("Title")
    .with_text("My Song Title");

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

Add a child element

Arguments

• child - The child element to add

Example

use ddex_builder::ast::Element;
let mut parent = Element::new("Release");
let child = Element::new("Title").with_text("My Song");
parent.add_child(child);

pub fn add_text(&mut self, text: impl Into<String>)

Add text content as a child node

Arguments

• text - The text content to add

Example

use ddex_builder::ast::Element;
let mut element = Element::new("Title");
element.add_text("My Song Title");

pub fn add_comment(&mut self, comment: Comment)

Add a structured comment to this element

Arguments

• comment - The structured comment with position information

Example

use ddex_builder::ast::Element;
use ddex_core::models::{Comment, CommentPosition};
let mut element = Element::new("Release");
let comment = Comment::new("Release generated by system".to_string(), CommentPosition::Before);
element.add_comment(comment);

pub fn add_simple_comment(&mut self, comment: impl Into<String>)

Add a simple comment (for backward compatibility)

Arguments

• comment - The comment text

Example

use ddex_builder::ast::Element;
let mut element = Element::new("Release");
element.add_simple_comment("This is a simple comment");

pub fn with_comment(self, content: String, position: CommentPosition) -> Self

Add a comment with a specific position

Arguments

• content - The comment content
• position - The position where the comment should appear

Example

use ddex_builder::ast::Element;
use ddex_core::models::CommentPosition;
let element = Element::new("Release")
    .with_comment("Release comment".to_string(), CommentPosition::Before);

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.