Fan

 

const class

xml::XAttr

sys::Obj
  xml::XAttr

XAttr models an XML attribute in an element. Attributes are immutable and may be shared across multiple XElem parents.

See docLib::Xml

Slots

makeSource

new make(Str name, Str val, XNs? ns := null)

Construct an element with unqualified local name, value, and optional XML namespace. The XNs instance should be defined as an attribute on an ancestor element. Throw ArgErr if an attempt is made to qualify the attribute by the default namespace with prefix of "".

makeNsSource

new makeNs(XNs ns)

Construct an attribute which defines a namespace with "xmlns:<prefix>" name and uri value. If prefix is "" then construct the default namespace attribute named "xmlns".

nameSource

const Str name

Unqualified local name of the attribute. If an XML namespace prefix was specified, then this is everything after the colon:

foo='val'   =>  foo
x:foo='val' =>  foo

Note that attributes which start with "xml:" are not treated as a namespace:

xml:lang='en' => xml:lang
XML:lang='en' => xml:lang
nsSource

const XNs? ns

The XML namespace which qualified this attribute's name. If the attribute name is unqualified return null.

prefixSource

Str? prefix()

If this attribute is qualified by an XML namespace then return the namespace's prefix. Otherwise return null. Note an attribute can never be qualified by the default namespace.

qnameSource

Str qname()

Qualified name of the attribute. This is the full name including the XML namespace prefix:

foo='val'   =>  foo
x:foo='val' =>  x:foo
toStrSource

override Str toStr()

Overrides sys::Obj.toStr

Return this attribute name/value pair as string.

uriSource

Uri? uri()

If this element is qualified by an XML namespace then return the namespace's uri. Otherwise return null.

valSource

const Str val

Value of the attribute.

writeSource

Void write(OutStream out)

Write this attribute to the output stream.