Creates an instance of the element for the specified tag.
Syntax
oElement = document.createElement(sTag)
Parameters
| sTag |
Required.
A String that specifies the name of an element. |
Return Value
Returns a reference to the new element.
Remarks
In Microsoft Internet Explorer 4.0, the only new elements you can create are img, area, and option. As of Internet Explorer 5, you can create all elements programmatically,
except frame and iframe. The properties of these created elements are read/write and can be accessed programmatically. Before you use new objects, you must explicitly add them to their respective collections or to the document. To insert new elements into the current document, use the insertBefore method or the appendChild method.
You must perform a second step when you use createElement to create the input element. The createElement method generates an input text box, because that is the default input type property. To insert any other kind of input element, first invoke createElement for input, and then set the type property to the appropriate value in the next line of code.
Attributes can be included with the sTag
as long as the entire string is valid HTML. To include the NAME attribute at run time on objects created with the createElement method, use the sTag
.
Use the sTag
to include attributes when form elements are created that will be reset using the reset method or a BUTTON with a TYPE attribute value of reset.
Examples
This example uses the createElement method to dynamically update the contents of a Web page by adding an element selected from a drop-down list box.
<SCRIPT>
function fnCreate(){
oData.innerHTML="";
var oOption=oSel.options[oSel.selectedIndex];
if(oOption.text.length>0){
var aElement=document.createElement(oOption.text);
eval("aElement." + oOption.value + "='" + oText.value + "'");
if(oOption.text=="A"){
aElement.href="javascript:alert('A link.')";
}
}
oData.appendChild(aElement);
}
</SCRIPT>
<SELECT ID="oSel" >
<OPTION VALUE="innerText">A
<OPTION VALUE="value"><INPUT TYPE="button">
</SELECT>
<SELECT ID=oText >
<OPTION>
<OPTION VALUE="Text">Text
<OPTION VALUE="More and More Text">More and More Text
</SELECT>
<SPAN ID="oData" ></SPAN>
This feature requires Microsoft® Internet Explorer 5 or later. Click the following icon to install the latest version. Then reload this page to view the sample.
You can also specify all the attributes inside the createElement method by using an HTML string for the method argument. The following example demonstrates how to dynamically create two radio buttons utilizing this technique.
<HTML>
<HEAD>
<SCRIPT>
function createRadioButton(){
// Create radio button object with value="First Choice" and then insert
// this element into the document hierarchy.
var newRadioButton = document.createElement("<INPUT TYPE='RADIO' NAME='RADIOTEST' VALUE='First Choice'>")
document.body.insertBefore(newRadioButton);
// Create radio button object with value="Second Choice" and then insert
// this element into the document hierarchy.
newRadioButton = document.createElement("<INPUT TYPE='RADIO' NAME='RADIOTEST' VALUE='Second Choice'>")
document.body.insertBefore(newRadioButton);
}
</SCRIPT>
</HEAD>
<BODY>
<INPUT TYPE="BUTTON" VALUE="Create two Radio Buttons"><BR>
<INPUT TYPE="BUTTON" VALUE="Click here to see HTML">
<BODY>
</HTML>
Standards Information
This method is defined in
World Wide Web Consortium (W3C) Document Object Model (DOM) Level 1 
.
Applies To
See Also
add, cloneNode, removeNode, About the W3C Document Object Model