If child is a XAttr then add an attribute. Otherwise it must be a XElem, XText, or XPi and is added a child node. If the child node is already parented, then throw ArgErr. Return this.
Add an attribute to this element. Return this. This method is a convenience for:
add(XAttr(name, val, ns))
Optionalns: XNsGet an attribute by its non-qualified local name. If the attribute is not found and checked is false then return null otherwise throw XErr.
Optionalchecked: booleanRemove all the attributes. Return this.
Return a negative integer, zero, or a positive integer if this object is less than, equal to, or greater than the specified object:
this < that => <0
this == that => 0
this > that => >0
This method may also be accessed via the < <= <=> >= and >
shortcut operators. If not overridden the default
implementation compares the toStr
representations. Also see docLang.
Examples:
3.compare(8) => -1
8.compare(3) => 1
8.compare(8) => 0
3 <=> 8 => -1 // shortcut for 3.compare(8)
Make a shallow copy of this element.
Get the root document node or null if this node is not mounted under a XDoc instance.
Find an element by its non-qualified local name. If there are multiple child elements with the name, then the first one is returned. If the element is not found and checked is false then return null otherwise throw XErr.
Optionalchecked: booleanCompare this object to the specified for equality. This
method may be accessed via the == and != shortcut operators.
If not overridden the default implementation compares for
reference equality using the === operator. If this method
is overridden, then hash() must also be overridden such that
any two objects which return true for equals() must return
the same value for hash(). This method must accept null and
return false.
Get an attribute value by its non-qualified local name. If the attribute is not found and checked is false then return null otherwise throw XErr.
Optionalchecked: booleanReturn a unique hashcode for this object. If a class overrides hash() then it must ensure if equals() returns true for any two objects then they have same hash code.
Line number of XML element in source file or zero if unknown.
Line number of XML element in source file or zero if unknown.
Unqualified local name of the element. If an XML namespace prefix was specified, then this is everything after the colon:
<foo> => foo
<x:foo> => foo
Unqualified local name of the element. If an XML namespace prefix was specified, then this is everything after the colon:
<foo> => foo
<x:foo> => foo
Return the XNodeType.elem. Note
that during pull parsing XParser will return elemStart and elemEnd.
Get the parent of this node or null if unmounted.
If this element is qualified by an XML namespace then return the namespace's prefix. Otherwise return null. If the namespace is the default namespace then prefix is "".
Qualified name of the element. This is the full name including the XML namespace prefix:
<foo> => foo
<x:foo> => x:foo
Return this element's child text node. If this element contains multiple text nodes then return the first one. If this element does not contain a text node return null.
Get an immutable representation of this instance or throw NotImmutableErr if this object cannot be represented as an immutable:
String representation is as a start tag.
Trap a dynamic call for handling. Dynamic calls are invoked with the -> shortcut operator:
a->x a.trap("x", null)
a->x() a.trap("x", null)
a->x = b a.trap("x", [b])
a->x(b) a.trap("x", [b])
a->x(b, c) a.trap("x", [b, c])
The default implementation provided by Obj attempts to use reflection. If name maps to a method, it is invoked with the specified arguments. If name maps to a field and args.size is zero, get the field. If name maps to a field and args.size is one, set the field and return args[0]. Otherwise throw UnknownSlotErr.
If this element is qualified by an XML namespace then return the namespace's uri. Otherwise return null.
This method called whenever an it-block is applied to an
object. The default implementation calls the function with this,
and then returns this.
Conveniece to write to an in-memory string.
StaticechoWrite x.toStr to standard output followed by newline. If x
is null then print "null". If no argument is provided then
print an empty line.
Optionalx: JsObjStaticmakeConstruct an element with unqualified local name and optional XML namespace. The XNs instance should be defined as an attribute on this or an ancestor element (see XAttr.makeNs).
Optionalns: XNs
Models an XML element: its name, attributes, and children nodes.