728x90

insertAdjacentElement Method

Internet Development Index

Inserts an element at the specified location.

Syntax

oElement = object.insertAdjacentElement(sWhere, oElement)

Parameters

sWhere Required. String that specifies where to insert the HTML element, using one of the following values:
beforeBegin Inserts oElement immediately before the object.
afterBegin Inserts oElement after the start of the object but before all other content in the object.
beforeEnd Inserts oElement immediately before the end of the object but after all other content in the object.
afterEnd Inserts oElement immediately after the end of the object.
oElement Required. Object that specifies the element to be inserted adjacent to the object that invoked the insertAdjacentElement method.

Return Value

Returns an element object.

Remarks

You cannot insert text while the document is loading. Wait for the onload event before attempting to call this method.

If you try to insert an object that already exists on the page, the existing object will be moved to the point that you specified in the insertAdjacentElement method; no new object will be created.

Example

This example uses the insertAdjacentElement method to add a new list item to an ol object.

Hide Example

<SCRIPT>
function fnAdd()
{
   var oNewItem = document.createElement("LI");	
   oList.children(0).insertAdjacentElement("BeforeBegin",oNewItem);
   oNewItem.innerText = "List Item 0";
}
</SCRIPT>
:
<BODY>
<OL ID = "oList">
<LI>List Item 1</LI>
<LI>List Item 2</LI>
<LI>List Item 3</LI>
</OL>

<INPUT TYPE = "button" VALUE = "Add Item" onclick="fnAdd()">

</BODY>

Standards Information

There is no public standard that applies to this method.

Applies To

TABLE
Platform Version
Win16: 5
Win32: 5
Unix: 5
Mac: 5
Windows CE: 5.5
A, ACRONYM, ADDRESS, APPLET, AREA, B, BASE, BASEFONT, BDO, BGSOUND, BIG, BLOCKQUOTE, BODY, BR, BUTTON, CAPTION, CENTER, CITE, CODE, COL, COLGROUP, COMMENT, 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
Move the mouse pointer over an element in the Applies To list to display availability information for the listed platforms.
728x90

+ Recent posts