applyElement Method | Internet Development Index |
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
See Also
getAdjacentText, insertAdjacentElement, replaceAdjacentText, About the W3C Document Object Model