Module xml 

XML structures XML and XHTML parsing for declarative UI definitions.

This module provides comprehensive XML parsing and manipulation for Azul’s XML-based UI format (.azul files). It supports:

• XHTML parsing: Parse HTML-like syntax into DOM structures
• CSS extraction: Extract <style> blocks and inline styles
• Component system: Define reusable UI components with arguments
• Hot reload: Track file changes and rebuild UI incrementally
• Error reporting: Detailed syntax error messages with line/column info

Examples

use azul_core::xml::{XmlNode, XmlParseOptions};

let xml = "<div>Hello</div>";
// let node = XmlNode::parse(xml)?;

Structs

ARenderer

ArticleRenderer

AsideRenderer

BRenderer

BlockquoteRenderer

BodyRenderer

Render for a body component

BrRenderer

Render for a br component

ButtonRenderer

CodeRenderer

ComponentArguments

A component can take various arguments (to pass down to its children), which are then later compiled into Rust function arguments - for example

CssMatcher

DdRenderer

DivRenderer

Render for a div component

DlRenderer

DomXml

Wrapper for the XML parser - necessary to easily create a Dom from XML without putting an XML solver into azul-core.

DtRenderer

DuplicatedAttributeError

DuplicatedNamespaceError

DynamicXmlComponent

Component that was created from a XML node (instead of being registered from Rust code). Necessary to

EmRenderer

ExternalResource

An external resource URL found in an XML/HTML document

ExternalResourceVec

ExternalResourceVecSlice

C-compatible slice type for $struct_name. This is a non-owning view into a Vec’s data.

FilteredComponentArguments

FooterRenderer

FormRenderer

H1Renderer

H2Renderer

H3Renderer

H4Renderer

H5Renderer

H6Renderer

HeadRenderer

HeaderRenderer

HrRenderer

HtmlRenderer

IRenderer

IconRenderer

Renderer for an icon component

InvalidCharError

InvalidCharMultipleError

InvalidQuoteError

InvalidSpaceError

InvalidStringError

LabelRenderer

LiRenderer

MainRenderer

MalformedHierarchyError

Error for mismatched open/close tags in XML hierarchy

MarkRenderer

MimeTypeHint

MIME type hint for an external resource

NavRenderer

NonXmlCharError

OlRenderer

PreRenderer

SectionRenderer

SmallRenderer

SpanRenderer

StrongRenderer

SubRenderer

SupRenderer

TableRenderer

TbodyRenderer

TdRenderer

TextRenderer

Render for a p component

TfootRenderer

ThRenderer

TheadRenderer

TitleRenderer

TrRenderer

URenderer

UlRenderer

UnexpectedCloseTagError

UnknownEntityReferenceError

UnknownNamespaceError

Xml

XmlAttributeMap

Attributes of an XML node, such as ["color" => "blue"] in <button color="blue" />.

XmlComponent

XmlComponentMap

Holds all XML components - builtin components

XmlNode

Represents one XML node tag

XmlNodeChildVec

XmlNodeChildVecSlice

C-compatible slice type for $struct_name. This is a non-owning view into a Vec’s data.

XmlNodeVec

XmlNodeVecSlice

C-compatible slice type for $struct_name. This is a non-owning view into a Vec’s data.

XmlQualifiedName

XmlTagName

Tag of an XML node, such as the “button” in <button>Hello</button>.

XmlTextError

XmlTextPos

Enums

CompileError

Error that can happen from the translation from XML code to Rust code - stringified, since it is only used for printing and is not exposed in the public API

ComponentError

ComponentParseError

DomXmlParseError

DynamicItem

Item of a split string - either a variable name or a string

ExternalResourceKind

Classification of an external resource referenced in HTML/XML

ExternalResourceVecDestructor

OptionExternalResource

OptionMimeTypeHint

OptionXmlNode

OptionXmlNodeChild

RenderDomError

ResultXmlXmlError

XmlError

XmlNodeChild

Represents a child of an XML node - either an element or text

XmlNodeChildVecDestructor

XmlNodeType

XmlNodeVecDestructor

XmlParseError

XmlStreamError

c_void

Constants

DEFAULT_ARGS

Traits

XmlComponentTrait

Specifies a component that reacts to a parsed XML node

Functions

combine_and_replace_dynamic_items

Combines the split string back into its original form while replacing the variables with their values

compile_body_node_to_rust_code

compile_component

compile_components

compile_components_to_rust_code

Takes all components and generates the source code function from them

compile_node_to_rust_code_inner

find_attribute

find_node_by_type

Searches in the the root_nodes for a node_type, convenience function in order to for example find the first node in all these nodes. This function searches recursively through the entire tree.

format_args_dynamic

Given a string and a key => value mapping, replaces parts of the string with the value, i.e.:

format_component_args

get_body_node

Find the one and only <body> node, return error if there is no app node or there are multiple app nodes

get_html_node

Find the one and only <body> node, return error if there is no app node or there are multiple app nodes

get_item

Given a root node, traverses along the hierarchy, and returns a mutable reference to the last child node of the root node

normalize_casing

Normalizes input such as abcDef, AbcDef, abc-def to the normalized form of abc_def

parse_bool

Parses a string (“true” or “false”)

parse_component_arguments

Compiles a XML args="a: String, b: bool" into a ["a" => "String", "b" => "bool"] map

prepare_string

render_component_inner

render_dom_from_body_node

render_dom_from_body_node_inner

Takes a single (expanded) app node and renders the DOM or returns an error

set_attributes

set_stringified_attributes

split_dynamic_string

Splits a string into formatting arguments

str_to_dom

Parses an XML string and returns a StyledDom with the components instantiated in the <app></app>

str_to_rust_code

Parses an XML string and returns a String, which contains the Rust source code (i.e. it compiles the XML to valid Rust)

validate_and_filter_component_args

Filters the XML attributes of a component given XmlAttributeMap

Type Aliases

CompiledComponent

ComponentArgumentName

ComponentArgumentOrder

ComponentArgumentType

ComponentArgumentTypes

ComponentName

ExternalResourceVecDestructorType

SyntaxError

Error that can occur during XML parsing or hot-reload.

XmlNodeChildVecDestructorType

XmlNodeVecDestructorType

XmlTextContent

(Unparsed) text content of an XML node, such as the “Hello” in <button>Hello</button>.