Base type for all nodes in a Document Object Model (DOM) tree.

More...

Inherits :

• QObject

Inherited By : DzDomAttr, DzDomBasicNode, DzDomCharacterData, DzDomDocument, DzDomDocumentFragment, DzDomDocumentType, DzDomElement, DzDomEntity, DzDomEntityReference, DzDomNotation and DzDomProcessingInstruction

A script wrapper for QDomNode. This is an abstract base type that provides general functionality for Document Object Model (DOM) nodes.

For more information about the Document Object Model (DOM) see the Level 1 and Level 2 Core specifications.

For a more general introduction of the DOM implementation see the DzDomDocument documentation.

---

: NodeType

• ElementNode - A DzDomElement
• AttributeNode - A DzDomAttr
• TextNode - A DzDomText
• CDATASectionNode - A DzDomCDATASection
• EntityReferenceNode - A DzDomEntityReference
• EntityNode - A DzDomEntity
• ProcessingInstructionNode - A DzDomProcessingInstruction
• CommentNode - A DzDomComment
• DocumentNode - A DzDomDocument
• DocumentTypeNode - A DzDomDocumentType
• DocumentFragmentNode - A DzDomDocumentFragment
• NotationNode - A DzDomNotation
• BaseNode - A DzDomBasicNode
• CharacterDataNode - A DzDomCharacterData

---

String : localName

Holds the local name of this node, if the node uses namespaces; only DzDomElement or DzDomAttr nodes can have namespaces; a namespace must have be specified at creation time - it is not possible to add a namespace post-creation.. (Read Only)

---

String : namespaceURI

Holds the namespace URI of this node. (Read Only)

---

String : nodeName

Holds the name of this node - the meaning of which depends on nodeType : (Read Only)

• for AttributeNode - the name of the attribute
• for CDATASectionNode - the string “#cdata-section”
• for CommentNode - the string “#comment”
• for DocumentNode - the string “#document”
• for DocumentFragmentNode - the string “#document-fragment”
• for DocumentTypeNode - the name of the document type
• for ElementNode - the tag name
• for EntityNode - the name of the entity
• for EntityReferenceNode - the name of the referenced entity
• for NotationNode - the name of the notation
• for ProcessingInstructionNode - the target of the processing instruction
• for TextNode - the string “#text”

---

NodeType : nodeType

Holds the type of this node. (Read Only)

---

String : nodeValue

Holds the value of this node - the meaning of which depends on nodeType :

• for AttributeNode - the attribute value
• for CDATASectionNode - the contents of the CDATA section
• for CommentNode - the comment
• for ProcessingInstructionNode - the data of the processing instruction
• for TextNode - the text
• for all others - an empty string

---

String : prefix

Holds the namespace prefix of this node; only DzDomElement or DzDomAttr nodes can have namespaces; a namespace prefix must have be specified at creation time - it is not possible to add a namespace post-creation.

---

void : appendChild( DzDomNode child )

Appends a node in the DOM to the end of this node's child list.

Parameter(s):

• child - The node in the DOM to append.

---

Array : childNodes()

Return Value:

• A list of the direct node children of this node (if any).

Since:

• 4.11.0.279

---

Boolean : clear()

Converts the node into a DzDomBasicNode. Its type and contents are cleared.

---

DzDomNode : cloneNode( Boolean deep=true )

Parameter(s):

• deep - If true (default), the return value will be a recursive copy this node and all of its children.

Return Value:

• A new node in the DOM that is a (deep) copy of this node.

---

Number : columnNumber()

Return Value:

• The column number in the DOM document where the node was parsed.

Since:

• 4.11.0.279

---

DzDomNode : firstChild()

Return Value:

• This node's first child node (if any), otherwise a DzDomBasicNode.

---

DzDomNode : firstChildElement( String tagName=“” )

Parameter(s):

• tagName - The name of the child node to retrieve.

Return Value:

• If tagName is non-empty, the first child DzDomElement of this node with a matching name (if any), otherwise the first child DzDomElement (if any), otherwise a DzDomBasicNode. If tagName is empty, the first child DzDomElement (if any), otherwise a DzDomBasicNode.

Since:

• 4.11.0.279

---

Boolean : hasAttributes()

Return Value:

• true if the node has attributes, otherwise false.

---

Boolean : hasChildNodes()

Return Value:

• true if this node has children, otherwise false.

---

void : insertAfter( DzDomNode newChild, DzDomNode refChild )

Inserts a node in the DOM into this node's child list after another node.

Parameter(s):

• newChild - The node in the DOM to insert.
• refChild - The node in the DOM to insert after.

---

void : insertBefore( DzDomNode newChild, DzDomNode refChild )

Inserts a node in the DOM into this node's child list in front of another node.

Parameter(s):

• newChild - The node in the DOM to insert.
• refChild - The node in the DOM to insert before.

---

Boolean : isAttr()

Return Value:

• true if this node is an attribute, otherwise false.

See Also:

• nodeType
• AttributeNode

---

Boolean : isCDATASection()

Return Value:

• true if this node is a CDATA section, otherwise false.

See Also:

• nodeType
• CDATASectionNode

---

Boolean : isCharacterData()

Return Value:

• true if this node is a character data, otherwise false.

See Also:

• nodeType
• CharacterDataNode

---

Boolean : isComment()

Return Value:

• true if this node is a comment, otherwise false.

See Also:

• nodeType
• CommentNodenamedItem

---

Boolean : isDocument()

Return Value:

• true if this node is a document, otherwise false.

See Also:

• nodeType
• DocumentNode

---

Boolean : isDocumentFragment()

Return Value:

• true if this node is a document fragment, otherwise false.

See Also:

• nodeType
• DocumentFragmentNode

---

Boolean : isDocumentType()

Return Value:

• true if this node is a document type, otherwise false.

See Also:

• nodeType
• DocumentTypeNode

---

Boolean : isElement()

Return Value:

• true if this node is an element, otherwise false.

See Also:

• nodeType
• ElementNode

---

Boolean : isEntity()

Return Value:

• true if this node is an entity, otherwise false.

See Also:

• nodeType
• EntityNode

---

Boolean : isEntityReference()

Return Value:

• true if this node is an entity reference, otherwise false.

See Also:

• nodeType
• EntityReferenceNode

---

Boolean : isNotation()

Return Value:

• true if this node is a notation, otherwise false.

See Also:

• nodeType
• NotationNode

---

Boolean : isNull()

Return Value:

• true if this node is invalid (Null), otherwise false.

See Also:

• nodeType
• BaseNode

---

Boolean : isProcessingInstruction()

Return Value:

• true if this node is a processing instruction, otherwise false.

See Also:

• nodeType
• ProcessingInstructionNode

---

Boolean : isSupported( String feature, String version )

Parameter(s):

• feature - The feature to check.
• version - The version to check.

Return Value:

• true if the DOM implementation supports the specified feature in the specified version, otherwise false.

---

Boolean : isText()

Return Value:

• true if this node is text, otherwise false.

See Also:

• nodeType
• TextNode

---

DzDomNode : lastChild()

Return Value:

• This node's last child node (if any), otherwise a DzDomBasicNode.

---

DzDomNode : lastChildElement( String tagName=“” )

Parameter(s):

• tagName - The name of the child node to retrieve.

Return Value:

• If tagName is non-empty, the last child DzDomElement of this node with a matching name (if any), otherwise the last child DzDomElement (if any), otherwise a DzDomBasicNode. If tagName is empty, the last child DzDomElement (if any), otherwise a DzDomBasicNode.

Since:

• 4.11.0.279

---

Number : lineNumber()

Return Value:

• The line number in the DOM document where the node was parsed.

Since:

• 4.11.0.279

---

DzDomNode : namedItem( String name )

Parameter(s):

• name - The name of the child node to retrieve.

Return Value:

• The first direct child node with a matching name (if any), otherwise a DzDomBasicNode.

---

DzDomNode : nextSibling()

Return Value:

• This node's next sibling node (if any), otherwise a DzDomBasicNode.

---

DzDomNode : nextSiblingElement( String tagName=“” )

Parameter(s):

• tagName - The name of the sibling node to retrieve.

Return Value:

• If tagName is non-empty, the next sibling DzDomElement of this node with a matching name (if any), otherwise any next sibling DzDomElement (if any), otherwise a DzDomBasicNode. If tagName is empty, the next sibling DzDomElement (if any), otherwise a DzDomBasicNode.

Since:

• 4.11.0.279

---

void : normalize()

Converts all of this node's children into standard form (e.g. adjacent text nodes will be merged).

---

DzDomNode : ownerDocument()

Return Value:

• The document that this node belongs to.

---

DzDomNode : parentNode()

Return Value:

• This node's parent node (if any), otherwise a DzDomBasicNode.

---

DzDomNode : previousSibling()

Return Value:

• This node's previous sibling node (if any), otherwise a DzDomBasicNode.

---

DzDomNode : previousSiblingElement( String tagName=“” )

Parameter(s):

• tagName - The name of the sibling node to retrieve.

Return Value:

• If tagName is non-empty, the previous sibling DzDomElement of this node with a matching name (if any), otherwise any previous sibling DzDomElement (if any), otherwise a DzDomBasicNode. If tagName is empty, the previous sibling DzDomElement (if any), otherwise a DzDomBasicNode.

Since:

• 4.11.0.279

---

void : removeChild( DzDomNode oldChild )

Removes a node in the DOM from this node's child list.

Parameter(s):

• oldChild - The node in the DOM to replace.

---

void : replaceChild( DzDomNode newChild, DzDomNode oldChild )

Inserts a node in the DOM into this node's child list in place of another node.

Parameter(s):

• newChild - The node in the DOM to insert.
• oldChild - The node in the DOM to replace.