--- title: Document.createElement() slug: Web/API/Document/createElement tags: - Documento - Referencia - Referência(2) - metodo translation_of: Web/API/Document/createElement ---
Em um documento HTML, o método Document.createElement()
cria o elemento HTML especificado ou um {{domxref("HTMLUnknownElement")}} se o nome do elemento dado não for conhecido.
Em um documento XUL, o elemento XUL especificado é criado.
Em outros documentos, ele cria um elemento com um namespace URI null
.
var elemento = document.createElement(nomeDaTag);
elemento
é o objeto {{domxref("Element")}} criado.nomeDaTag
é uma string que especifica o tipo do elemento a ser criado. O {{domxref("Node.nodeName", "nodeName")}} do elemento criado é inicializado com o valor da nomeDaTag
. Não use nomes qualificados (como "html:a") com este método.Este código cria uma nova <div>
e a insere antes do elemento com ID "div1
".
<!DOCTYPE html> <html> <head> <title>||Trabalhando com elementos||</title> </head> <body> <div id="div1">O texto acima foi criado dinamicamente.</div> </body> </html>
document.body.onload = adcElemento; function adcElemento () { // cria um novo elemento div // e dá à ele conteúdo var divNova = document.createElement("div"); var conteudoNovo = document.createTextNode("Olá, cumprimentos!"); divNova.appendChild(conteudoNovo); //adiciona o nó de texto à nova div criada // adiciona o novo elemento criado e seu conteúdo ao DOM var divAtual = document.getElementById("div1"); document.body.insertBefore(divNova, divAtual); }
{{EmbedLiveSample("Exemplo", 500, 50)}}
createElement()
torna seu argumento caixa-baixa antes de criá-lo.tagName
no modo quirks; a partir do Gecko 2.0, a função comporta-se da mesma forma em ambos os modos quirks e estrito.createElement(null)
funciona como createElement("null")
. Note que o Opera torna null
uma string, mas ambos Chrome e Internet Explorer lançarão erros.createElement()
não mais usa a interface {{domxref("HTMLSpanElement")}} quando o argumento é "bgsounds", "multicol", or "image". Ao invés disso, HTMLUnknownElement
é usado para "bgsound", "multicol" e {{domxref("HTMLElement")}} HTMLElement
é usado para "image".createElement
não se conforma à especificação DOM para documentos XUL e XHTML: localName
e namespaceURI
não estão definidos para null
no elemento criado. Veja {{ Bug(280692) }} para detalhes.