canHaveChildren Property

Retrieves a value indicating whether the object can contain children.

Syntax

HTML N/A
Scripting [ bChildren = ] object.canHaveChildren

Possible Values

bChildren Boolean that receives one of the following values.
false Object cannot be a parent to child objects.
true Object can be a parent to child objects.
The property is read-only. The property has no default value.

Remarks

Objects do not have to contain children for the canHaveChildren property to return true. This property is useful in determining whether objects can be appended as children.

Example

This example uses the canHaveChildren property to add a new object to the first element in a Web page that can contain children.
<SCRIPT>
window.onload=fnInit;
function fnInit(){
   var oNewObject=document.createElement("SPAN");
   var oNewText=document.createTextNode("Test");
   oNewObject.appendChild(oNewText);
   for(var i=0;i<document.all.length;i++){
      if(document.all[i].canHaveChildren==true){
        document.all[i].appendChild(oNewObject);
        break;
     }
   }
}
</SCRIPT>
<INPUT TYPE=button VALUE="Add Child" onclick="fnAddChild()">
<DIV ID=oGrandParent STYLE="background-color: #CFCFCF;">
<WBR>WBR - </WBR>
<BR>
<NOBR>NOBR - </NOBR>
<P>P - <s/P>
</DIV>
This feature requires Microsoft® Internet Explorer 5 or later. Click the following icon to install the latest version. Then reload this page to view the sample.

Standards Information

There is no public standard that applies to this property.

Applies To

A, ACRONYM, ADDRESS, B, BDO, BIG, BLOCKQUOTE, BODY, BUTTON, CAPTION, CENTER, CITE, CODE, COL, COLGROUP, COMMENT, CUSTOM, DD, DEL, DFN, DIR, DIV, DL, DT, EM, FIELDSET, FONT, FORM, FRAMESET, HEAD, hn, HTML, I, IFRAME, INPUT type=button, INPUT type=checkbox, INPUT type=file, INPUT type=image, INPUT type=password, INPUT type=radio, INPUT type=reset, INPUT type=submit, INPUT type=text, INS, KBD, LABEL, LEGEND, LI, LISTING, MAP, MARQUEE, MENU, nextID, OBJECT, OL, OPTION, P, PLAINTEXT, PRE, Q, S, SAMP, SELECT, SMALL, SPAN, STRIKE, STRONG, SUB, SUP, TABLE, TBODY, TD, TEXTAREA, TFOOT, TH, THEAD, TR, TT, U, UL, VAR, XMP