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
|