applyElement Method

Makes the element either a child or parent of another element.

Syntax

oElement = object.applyElement(oNewElement [, sWhere])

Parameters

oNewElement Required. Object that becomes the child or parent of the current element.
sWhere Optional. String that specifies one of the following values:
outside Default. Specified element becomes a parent of the current element.
inside Specified element becomes a child of the current element, but contains all children of the current element.

Return Value

Returns a reference to the applied element.

Remarks

This method is accessible at run time. If elements are removed at run time before the closing tag is parsed, areas of the document might not render.
Calling the applyElement method on an element that has been created with the createElement method, but not yet added to the document tree, will cause the element to lose the contents of its innerHTML property.

Example

This example uses the applyElement method to apply the i element to an unordered list.

<SCRIPT>
function fnApply(){
   var oNewNode = document.createElement("I");
   oList.applyElement(oNewNode);
}
</SCRIPT>

<UL ID = oList>
<LI>List item 1
<LI>List item 2
<LI>List item 3
<LI>List item 4
</UL>

<INPUT
   TYPE="button"
   VALUE="Apply Element"
   onclick="fnApply()"
>

Standards Information

There is no public standard that applies to this method.

Applies To

A, ACRONYM, ADDRESS, APPLET, AREA, B, BASE, BASEFONT, BDO, BGSOUND, BIG, BLOCKQUOTE, BODY, BR, BUTTON, CAPTION, CENTER, CITE, CODE, COL, COLGROUP, COMMENT, CUSTOM, DD, DEL, DFN, DIR, DIV, DL, DT, EM, EMBED, FIELDSET, FONT, FORM, FRAME, FRAMESET, HEAD, hn, HR, HTML, I, IFRAME, IMG, INPUT type=button, INPUT type=checkbox, INPUT type=file, INPUT type=hidden, INPUT type=image, INPUT type=password, INPUT type=radio, INPUT type=reset, INPUT type=submit, INPUT type=text, INS, KBD, LABEL, LEGEND, LI, LINK, LISTING, MAP, MARQUEE, MENU, nextID, OBJECT, 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