- 128 -
Return value
: CDATASection
Exceptions thrown
: None
Description
: Creates and returns a new CDATASection node that contains the string
data
.
createProcessingInstruction(target, data)
Parameters
:
target
and
data
are string values.
Return value
: ProcessingInstruction
Exceptions thrown
: None
Description
: Creates and returns a new ProcessingInstruction
node and sets the
ProcessingInstruction properties target and data to the given parameters
target
and
data
.
See the
ProcessingInstruction
section later in this chapter for an explanation of target and
data.
createAttribute(name)
Parameters
:
name
is a string value.
Return value
: Attribute
Exceptions thrown
: None
Description
: Creates and returns a new Attribute node and
sets the nodeName property
to
name
. The nodeValue property is left blank.
createEntityReference(name)
Parameters
:
name
is a string value.
Return value
: EntityReference
Exceptions thrown
: None
Description
: Creates and returns a new EntityReference node and sets the nodeName
property to
name
.
getElementsByTagName(tagname)
Parameters
:
name
is a string value.
Return value
: NodeList
Exceptions thrown
: None
Description
: Returns a list of Element nodes that have a property tagName (or
nodeName) that matches the parameter name name. This method searches the whole
tree that belongs to the Document node. If name equals “*",
then all the Element nodes
are returned.
- 129 -
Comments
: This method performs the same operation as the
getElementsByTagName(name) method that is found on the Document node. The
Document node’s getElementsByTagName(name) searches the whole tree, whereas the
Element’s method searches only the subtree of the Element on which it was called.
Tree Management Examples
A few examples of using the Node and Document methods are presented here to bring
together some actual scenarios of DOM usage.
Creating Nodes
This example shows how to create a new Element node and insert it into the tree.
createElement(...) is used to create the new Element node, and insertBefore(...) is used
to insert it into the tree. The second parameter is set to null
because we want to insert
new Element node to the end of the list. The xml property on the Document node, also
called xml, is used to show the resulting XML document. The xml property is a Microsoft
extension, which means it only works in MSXML (it is
described in more detail in
Chapter
7
).