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

Syntax

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

Parameters

oNewElement	Required. An object that becomes the child or parent of the current element.
sWhere	Optional. A 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 the child elements 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.

If you call the applyElement method on an element that was created with the createElement method, but not yet added to the document tree, the element will 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, ABBR, 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, Element Constructor

See Also

getAdjacentText, insertAdjacentElement, replaceAdjacentText, About the W3C Document Object Model