这篇翻译不完整。请帮忙从英语翻译这篇文章。
在一个HTML文档中, Document.createElement()方法用于创建指定的HTML元素，或者， 当指定未定义的元素时， 创建一个HTMLUnknownElement。
在XUL文档中，将会创建一个相应的XUL元素。
在其他文档里，将会创建一个namespace URI为null的元素。
语法
var element = document.createElement(tagName[, options]);
- element 是创建的
Element对象。 - tagName 指定将要创建的元素类型的字符串。创建的element的
nodeName会被初始化为tagName的值。该方法不接受带条件的元素名字(例如: html:a)。 - options 是一个可选的 ElementCreationOptions 对象. 如果这个对象被定义并赋予了一个 is 特性，则创建的element的 is 属性会被初始化为这个特性的值. 如果这个对象没有 is 特性，则值为空.
示例
创建一个新的<div>并且插入到ID为“div1”的元素前。
HTML
<!DOCTYPE html> <html> <head> <title>||Working with elements||</title> </head> <body> <div id="div1">The text above has been created dynamically.</div> </body> </html>
JavaScript
document.body.onload = addElement;
function addElement () {
// create a new div element
// and give it some content
var newDiv = document.createElement("div");
var newContent = document.createTextNode("Hi there and greetings!");
newDiv.appendChild(newContent); //add the text node to the newly created div.
// add the newly created element and its content into the DOM
var currentDiv = document.getElementById("div1");
document.body.insertBefore(newDiv, currentDiv);
}
注意
- 当在一个被标记为HTML文档的文档对象上执行时，createElement()优先将参数转换为小写。
- 当创建一个带限制条件的元素时，请使用
document.createElementNS()。 - Gecko 2.0(Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)之前,quirks模式下tagName可以包含尖括号(<和>)；从Gecko2.0开始，该方法在quirks模式和标准模式下表现一致。
- 从Gecko19.0开始，
createElement(null)和createElement("null")相同。注意Opera将null字符串化，但是Chrome和IE都会抛出错误。 - 从Gecko22.0(Firefox 22.0 / Thunderbird 22.0 / SeaMonkey 2.19)开始，当参数为"bgsounds", "multicol", 或"image"时，
createElement()不再使用HTMLSpanElement接口， 参数为"bgsound" 和 "multicol"时，使用HTMLUnknownElement，为“image”时使用HTMLElementHTMLElement。 createElement的Gecko实现不遵循XUL和XHTML的DOM说明文档: 创建元素的localName和namespaceURI不会被设置为null. 更多细节见bug 280692。- is 属性是 Custom Elements W3C Working Draft 的一部分， 同时， 该属性是一个只在部分浏览器上可用的试验性特性。