Document.createElement()

Esta traducción está incompleta. Por favor, ayuda a traducir este artículo del inglés.

 

En un documento HTML, el metodo Document.createElement() crea el elemento HTML especificado o una HTMLUnknownElement si el nombre del elemento dado no es conocido.

En un documento XUL, es creado el elemento XUL especificado.

En otros documentos, crea un elemento con un namespace nulo.

Sintaxis

var element = document.createElement(tagName);
  • element es el objecto Element creado.
  • tagName es una cadena que especifica el tipo del elemento a crear. El nodeName del elemento creado es inicializado con el valor del tagName. No usar nombres culificados (como "html:a") con este metodo.

Ejemplo

Esto crea un nuevo <div> y lo inserta antes del elemento con el ID "div1".

HTML

<!DOCTYPE html>
<html>
<head>
  <title>||Trabajando con elementos||</title>
</head>
<body>
  <div id="div1">El texto de abajo ha sido creado dinamicamente.</div>
</body>
</html>

JavaScript

document.body.onload = addElement;

function addElement () { 
  // crea un nuevo elemento div
  // y le agrega contenido
  var newDiv = document.createElement("div"); 
  var newContent = document.createTextNode("Hi there and greetings!"); 
  newDiv.appendChild(newContent); //agrega el nodo de texto al 
elemento div creado

  // agrega el elemeto y su contenido al DOM.
  var currentDiv = document.getElementById("div1"); 
  document.body.insertBefore(newDiv, currentDiv); 
}

Notas

  • When called on a document object flagged as an HTML document, createElement() lower-cases its argument prior to creating the element.
  • Para crear un elemento con nombre cualificado y URI namespace, use document.createElementNS().
  • Prior to Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1), you could include angled brackets (< and >) around the tagName in quirks mode; starting in Gecko 2.0, the function behaves the same way in both quirks mode and standards mode.
  • Starting with Gecko 19.0 (Firefox 19.0 / Thunderbird 19.0 / SeaMonkey 2.16) createElement(null) works like createElement("null"). Note that Opera stringifies null as well, but Chrome and Internet Explorer will both throw errors.
  • Starting with Gecko 22.0 (Firefox 22.0 / Thunderbird 22.0 / SeaMonkey 2.19) createElement() no longer uses the HTMLSpanElement interface when the argument is "bgsounds", "multicol", or "image".  Instead, HTMLUnknownElement is used for "bgsound" and "multicol" and HTMLElement HTMLElement is used for "image".
  • The Gecko implementation of createElement doesn't conform to the DOM spec for XUL and XHTML documents: localName and namespaceURI are not set to null on the created element. See bug 280692 for details.

Specifications

Etiquetas y colaboradores del documento

 Colaboradores en esta página: daesnorey_xy, JoaquinGonzalez
 Última actualización por: daesnorey_xy,