childElementCount property

Article
05/02/2017

Retrieves the number of immediate child nodes of the current element or a zero if the element does not contain any child nodes. IElementTraversal::childElementCount does not return all child nodes, only child nodes that are IHTMLDOMNode::nodeType =1, or element nodes.

Syntax

HRESULT value = object.get_childElementCount(* p);

Property values

Type: long

The number of child elements.

Standards information

Element Traversal Specification, Section 2.5

Remarks

The IElementTraversal::childElementCount property only returns immediate children of the current node. It does not count descendent children of the immediate children.

Examples

This example shows how to use IElementTraversal::childElementCount to get the number of immediate children of a div tag. Be aware that because decendent children of the the div tag "divWithChildren" are ignored.

<!DOCTYPE html>
<html>
<head>
        <title>childElementCount example</title>
    <script>
        function GetCount () {
            var testArea = document.getElementById ("testArea");
            var childCount = 0;
                childCount = testArea.childElementCount;
            alert ("The number of child elements is " + childCount);
        }
    </script> 
</head>
<body>
    <div id="testArea" >
    <p>This is the test area, which contains several children.</p>
        <div id="divWithChildren">
            <div>a descendant child of a div</div>
            <div>also a descendent child of a div</div>
        </div>
        <p>A paragraph tag to consider.</p>
        <input type="text" size="80" value="And a text box as well"/> 
    </div>
    <p><input type="button" value="Get the number child elements in our test" name="abutton"  onclick="GetCount ();" /> </p>
    
</body> 
</html>

Partager via