childNodes

HTML (DHTML)

previous page next page

childNodes Collection

Internet Development Index

Retrieves a collection of HTML Elements and TextNode objects that are direct descendants of the specified object.

What's New for Microsoft® Internet Explorer 6

This collection now applies to the attribute object.

Syntax

[ oColl = ] object.childNodes
[ oObject = ] object.childNodes(iIndex)

Possible Values

oColl Array containing the children of a specified object.
oObject Reference to an individual item in the array of elements contained by the object.
iIndex Required. Integer that specifies the zero-based index of the item to be returned.

Members Table

The following table lists the members exposed by the childNodes object. Click a tab on the left to choose the type of member you want to view.
Attributes/Properties
Property Description
length Sets or retrieves the number of objects in a collection.
Methods
Method Description
item Retrieves an object from the childNodes or children collection.
urns Retrieves a collection of all objects to which a specified behavior is attached.

Property	Description
length	Sets or retrieves the number of objects in a collection.

Method	Description
item	Retrieves an object from the childNodes or children collection.
urns	Retrieves a collection of all objects to which a specified behavior is attached.

Remarks

The childNodes collection can contain HTML Elements and TextNode objects.
If you check the childNodes collection of an element created through standard HTML you will encounter TextNode objects in unexpected places, in place of line breaks, for example. Alternately, if you create an element via the Document Object Model (DOM), Internet Explorer will not create extraneous TextNode objects.

Examples

This example shows how to assign to a variable the childNodes collection of the body object.
<SCRIPT>
var aNodeList = oBody.childNodes;
</SCRIPT>
:
<BODY ID="oBody">
<SPAN ID="oSpan">A Span</SPAN>
</BODY>
This example shows how to assign to a variable the childNodes collection of a node created with the createElement method.
var oParentNode = document.createElement("DIV");
var oNode = document.createElement("B");
document.body.insertBefore(oParentNode);
oParentNode.insertBefore(oNode);
var aNodeList = oParentNode.childNodes;

Standards Information

This collection is defined in World Wide Web Consortium (W3C) Document Object Model (DOM) Level 1 .

Applies To

A, ACRONYM, ADDRESS, APPLET, AREA, attribute, B, BASE, BASEFONT, BDO, BIG, BLOCKQUOTE, BODY, BUTTON, CAPTION, CENTER, CITE, CODE, COL, COLGROUP, COMMENT, DD, DEL, DFN, DIR, DIV, DL, document, DT, EM, EMBED, FIELDSET, FONT, FORM, FRAME, FRAMESET, HEAD, hn, HR, HTML, I, IFRAME, IMG, INS, KBD, LABEL, LEGEND, LI, LINK, LISTING, MAP, MARQUEE, MENU, nextID, OL, OPTION, P, PLAINTEXT, PRE, Q, S, SAMP, SCRIPT, SELECT, SMALL, SPAN, STRIKE, STRONG, SUB, SUP, TABLE, TBODY, TD, TEXTAREA, TFOOT, TH, THEAD, TITLE, TR, TT, U, UL, VAR, XMP

oColl	Array containing the children of a specified object.
oObject	Reference to an individual item in the array of elements contained by the object.
iIndex	Required. Integer that specifies the zero-based index of the item to be returned.