Element

This is a scriptable interface corresponding to the nsIDOMElement XPCOM interface.

Constants

The nsIDOMNode interface is the primary datatype for the entire Document Object Model. It represents a single node in the document tree.

For more information on this interface please see http://www.w3.org/TR/DOM-Level-2-Core/

short ELEMENT_NODE = 1
short ATTRIBUTE_NODE = 2
short TEXT_NODE = 3
short CDATA_SECTION_NODE = 4
short ENTITY_REFERENCE_NODE = 5
short ENTITY_NODE = 6
short PROCESSING_INSTRUCTION_NODE = 7
short COMMENT_NODE = 8
short DOCUMENT_NODE = 9
short DOCUMENT_TYPE_NODE = 10
short DOCUMENT_FRAGMENT_NODE = 11
short NOTATION_NODE = 12

Properties

readonly NamedNodeMap attributes

readonly NodeList childNodes

readonly Node firstChild

readonly Node lastChild

readonly String localName

readonly String namespaceURI

readonly Node nextSibling

readonly String nodeName

readonly short nodeType

String nodeValue

readonly Document ownerDocument

readonly Node parentNode

String prefix

readonly Node previousSibling

readonly String tagName

The nsIDOMElement interface represents an element in an HTML or XML document.

For more information on this interface please see http://www.w3.org/TR/DOM-Level-2-Core/


Methods

Node appendChild ( Node newChild ) Node cloneNode ( boolean deep ) String getAttribute ( String name ) Attr getAttributeNode ( String name ) Attr getAttributeNodeNS ( String namespaceURI , String localName ) String getAttributeNS ( String namespaceURI , String localName ) NodeList getElementsByTagName ( String name ) NodeList getElementsByTagNameNS ( String namespaceURI , String localName ) boolean hasAttribute ( String name ) boolean hasAttributeNS ( String namespaceURI , String localName ) boolean hasAttributes ( ) boolean hasChildNodes ( ) Node insertBefore ( Node newChild , Node refChild ) boolean isSupported ( String feature , String version ) void normalize ( ) void removeAttribute ( String name ) Attr removeAttributeNode ( Attr oldAttr ) void removeAttributeNS ( String namespaceURI , String localName ) Node removeChild ( Node oldChild ) Node replaceChild ( Node newChild , Node oldChild ) void setAttribute ( String name , String value ) Attr setAttributeNode ( Attr newAttr ) Attr setAttributeNodeNS ( Attr newAttr ) void setAttributeNS ( String namespaceURI , String qualifiedName , String value )

Node appendChild ( Node newChild )

Arguments:
newChild

Node cloneNode ( boolean deep )

Arguments:
deep

String getAttribute ( String name )

Arguments:
name

Attr getAttributeNode ( String name )

Arguments:
name

Attr getAttributeNodeNS ( String namespaceURI , String localName )

Arguments:
namespaceURI
localName

String getAttributeNS ( String namespaceURI , String localName )

Arguments:
namespaceURI
localName

NodeList getElementsByTagName ( String name )

Arguments:
name

NodeList getElementsByTagNameNS ( String namespaceURI , String localName )

Arguments:
namespaceURI
localName

boolean hasAttribute ( String name )

Arguments:
name

boolean hasAttributeNS ( String namespaceURI , String localName )

Arguments:
namespaceURI
localName

boolean hasAttributes ( )


boolean hasChildNodes ( )


Node insertBefore ( Node newChild , Node refChild )

Arguments:
newChild
refChild

boolean isSupported ( String feature , String version )

Arguments:
feature
version

void normalize ( )


void removeAttribute ( String name )

Arguments:
name

Attr removeAttributeNode ( Attr oldAttr )

Arguments:
oldAttr

void removeAttributeNS ( String namespaceURI , String localName )

Arguments:
namespaceURI
localName

Node removeChild ( Node oldChild )

Arguments:
oldChild

Node replaceChild ( Node newChild , Node oldChild )

Arguments:
newChild
oldChild

void setAttribute ( String name , String value )

Arguments:
name
value

Attr setAttributeNode ( Attr newAttr )

Arguments:
newAttr

Attr setAttributeNodeNS ( Attr newAttr )

Arguments:
newAttr

void setAttributeNS ( String namespaceURI , String qualifiedName , String value )

Arguments:
namespaceURI
qualifiedName
value

Reference documentation is generated from Mozilla's source.

Add a note User Contributed Notes
August 2, 2005, 8:56 am liboni dot stefano at libero dot it
maybe it' trivial to many...

If you declared a namespace like this:
<?xml version="1.0"?>
<RDF:RDF xmlns:RDF="http://www.w3.org/1999/02/22-rdf-syntax-ns#">
...
</RDF:RDF>

the way to create a new node into the DOM with the correct namespace is:
xmlDOM.createElementNS("http://www.w3.org/1999/02/22-rdf-syntax-ns#","tag")

It's not:
xmlDOM.createElementNS("RDF","tag")

because it will create another namespace 'a0' corresponding to the string "RDF", nor:
xmlDOM.createElement("RDF:tag")

because it will create an element named "RDF:tag" (in this way if you serialize the XML and parse it again the DOM will be correct).

This way will let you have a correct DOM, otherwise methods like getElementById and getElementsByTagName wont return what you would expect.

Copyright © 1999 - 2005 XULPlanet.com