Retrieves a collection of HTML Elements and TextNode objects that are direct descendants of the specified 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.
| Property | Description |
|---|
| length |
Sets or retrieves the number of objects in a collection. |
Methods
| Method | Description |
|---|
| item |
Retrieves an object from a childNodes or StaticNodeList 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), Windows Internet Explorer will not create extraneous TextNode objects.
In Microsoft Internet Explorer 6, This collection now applies to the attribute object.
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 .gif)
.
Applies To
|
Attr Constructor,
A,
ABBR,
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,
Element Constructor,
HTMLDocument Constructor,
Text Constructor |
See Also
About the W3C Document Object Model