XML DOM Node List

A list of nodes is returned by the getElementsByTagName() method and the childNodes property.

Examples

The examples below use the XML file books.xml.
A function, loadXMLDoc(), in an external JavaScript is used to load the XML file.

Get the text from the first <title> element
This example uses the getElementsByTagName() method to get the text from the first <title> element in "books.xml".

Loop through nodes using the length property
This example uses node list and the length property to loop through all <title> elements in "books.xml"

Get the attribute of an element
This example uses a attribute list to get attribute from the first <book> element in "books.xml".

DOM Node List

When using properties or methods like childNodes or getElementsByTagName(), a node list object is returned.

A node list object represents a list of nodes, in the same order as in the XML.

Nodes in the node list are accessed with index numbers starting from 0.

The following image represents a node list of the <title> elements in "books.xml":

The following code fragment loads "books.xml" into xmlDoc using loadXMLDoc() and returns a node list of title elements in "books.xml":

xmlDoc=loadXMLDoc("books.xml");

x=xmlDoc.getElementsByTagName("title");

After the execution of the statement above, x is a node list object.

The following code fragment returns the text from the first <title> element in the node list (x):

txt=x[0].childNodes[0].nodeValue;

After the execution of the statement above, txt = "Everyday Italian".

Try it yourself.

Node List Length

A node list object keeps itself up-to-date. If an element is deleted or added, the list is automatically updated.

The length property of a node list is the number of nodes in the list.

The following code fragment loads "books.xml" into xmlDoc using loadXMLDoc() and returns the number of <title> elements in "books.xml":

xmlDoc=loadXMLDoc("books.xml");

x=xmlDoc.getElementsByTagName('title').length;

After the execution of the statement above, x = 4.

The length of the node list can be used to loop through all the elements in the list.

The following code fragment uses the length property to loop through the list of <title> elements:

xmlDoc=loadXMLDoc("books.xml");

//the x variable will hold a node list
x=xmlDoc.getElementsByTagName('title');

for (i=0;i<x.length;i++)
{
document.write(x[i].childNodes[0].nodeValue);
document.write("<br />");
}

Output:

Everyday Italian
Harry Potter
XQuery Kick Start
Learning XML

Example explained:

1. Load "books.xml" into xmlDoc using loadXMLDoc()
2. Set the x variable to hold a node list of all title elements
3. Output the value from the text node of all <title> elements

Try it yourself.

DOM Attribute List (Named Node Map)

The attributes property of an element node returns a list of attribute nodes.

This is called a named node map, and is similar to a node list, except for some differences in methods and properties.

A attribute list keeps itself up-to-date. If an attribute is deleted or added, the list is automatically updated.

The following code fragment loads "books.xml" into xmlDoc using loadXMLDoc() and returns a list of attribute nodes from the first <book> element in "books.xml":

xmlDoc=loadXMLDoc("books.xml");

x=xmlDoc.getElementsByTagName('book')[0].attributes;

After the execution of the code above, x.length = is the number of attributes and x.getNamedItem() can be used to return an attribute node.

The following code fragment displays the value of the "category" attribute, and the number of attributes, of a book:

xmlDoc=loadXMLDoc("books.xml");

x=xmlDoc.getElementsByTagName("book")[0].attributes;

document.write(x.getNamedItem("category").nodeValue);
document.write("<br />" + x.length);

Output:

cooking
1

Example explained:

1. Load "books.xml" into xmlDoc using loadXMLDoc()
2. Set the x variable to hold a list of all attributes of the first <book> element
3. Output the value from the "category" attribute
4. Output the length of the attribute list

Try it yourself.

The Ektron Intranet lets you do everything you need to do on your corporate intranet and everything you want to do... all with just one application. What can you do with the Ektron Intranet? Navigate through content, documents, assets, colleagues and workgroups quickly and intuitively with enterprise search Communicate with friends and colleagues with forums, message boards and corporate blogging using the new Social Networking Platform Utilize the extensive out-of-the box features or customize your site through Ektron CMS400.NET's open architecture Promote collaboration in your organization through project workspaces where others can efficiently find information and work together Author/edit content, manage navigation, menus, audit trails, workflow and approvals with the best in breed Content Management See why there are 20,000+ Ektron integrations worldwide.
	TAKE THE VIDEO TOUR
	or download a FREE TRIAL today.

Jump to: Top of Page or HOME or Printer friendly page

W3Schools provides material for training only. We do not warrant the correctness of its contents. The risk from using it lies entirely with the user. While using this site, you agree to have read and accepted our terms of use and privacy policy.

Copyright 1999-2008 by Refsnes Data. All Rights Reserved.

W3Schools was converted to XHTML in December 1999