En un documento HTML, el método Document.createElement()
crea un elemento HTML especificado por su tagName
, o un HTMLUnknownElement
si su tagName
no se reconoce. En un documento XUL, crea el elemento XUL especificado. En otros documentos, crea un elemento con un namespace URI null
.
Para declarar el namespace URI del elemento, utiliza document.createElementNS()
.
Sintaxis
var element = document.createElement(tagName, [options]);
Parámetros
tagName
Cadena que especifica el tipo de elemento a crear. El nodeName
del elemento creado se inicializa con el valor de tagName
. No utilizar nombres reservados (como "html:a") con este método. Al ser invocado en un documento HTML, createElement()
convierte tagName
a minúsculas antes de crear el elemento. En Firefox, Opera, y Chrome, createElement(null)
funciona como createElement("null")
.
options
Optional- Un objeto opcional
ElementCreationOptions
que contiene una única propiedad llamadais
, cuyo valor es el de la etiqueta name de un elemento personalizado definido previamente utilizandocustomElements.define()
. Para compatibilidad con versiones anteriores de Elements specification, algunos navegadores podrían permitir pasar una cadena aquí en vez de un objeto, donde el valor de la cadena es la etiqueta name del elemento creado. Ver Extending native HTML elements para más información sobre como usar este parámetro. - El nuevo elemento recibirá el atributo cuyo valor es la etiqueta name del elemento personalizado. Los elementos personalizados son una característica experimental solo disponible en algunos navegadores.
Retorna
El nuevo Element
.
Ejemplo
Crea un nuevo <div>
y lo inserta antes del elemento con ID "div1
".
HTML
<!DOCTYPE html>
<html>
<head>
<title>||Trabajando con elementos||</title>
</head>
<body>
<div id="div1">El texto superior se ha creado dinámicamente.</div>
</body>
</html>
JavaScript
document.body.onload = addElement;
function addElement () {
// crea un nuevo div
// y añade contenido
var newDiv = document.createElement("div");
var newContent = document.createTextNode("Hola!¿Qué tal?");
newDiv.appendChild(newContent); //añade texto al div creado.
// añade el elemento creado y su contenido al DOM
var currentDiv = document.getElementById("div1");
document.body.insertBefore(newDiv, currentDiv);
}
Especificaciones
Especificación | Estado | Comentario |
---|---|---|
DOM La definición de 'Document.createElement' en esta especificación. |
Living Standard |
Compatibilidad con navegadores
Característica | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|---|
Soporte básico | (Yes) | (Yes) | (Yes)[1][2] | (Yes) | (Yes) | (Yes) |
Parámetro options |
(Yes)[3] | ? | 50 (50)[4][5] | ? | ? | ? |
Característica | Android | Edge | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Soporte básico | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
[1] Desde Gecko 22.0 (Firefox 22.0 / Thunderbird 22.0 / SeaMonkey 2.19) createElement()
no utiliza HTMLSpanElement
interface cuando el argumento es "bgsounds", "multicol", o "image". En cambio, HTMLUnknownElement
se utiliza para "bgsound" y "multicol" y HTMLElement
HTMLElement
se utiliza para "image".
[2] La implementación en Gecko de createElement
no cumple la especificación DOM para documentos XUL y XHTML: localName
y namespaceURI
no son inicializados como null
en el elemento creado. Consúltese el error 280692 para más información.
[3] En versiones anteriores de la especificación, este argumento era solamente una cadena cuyo valor era la etiqueta name
del elemento personalizado. Por ejemplo: Podia recibir document.createElement("button", "mi-boton")
en lugar de document.createElement("button", {id: "mi-boton"})
. Por razones de compatibilidad, Chrome acepta ambas formas.
[4] Consultar [3] arriba: como Chrome, Firefox acepta una cadena en vez de un objeto en esta posición, pero solamente desde la versión 51 en adelante. En la versión 50, options
debe ser un objeto.
[5] Para experimentar con elementos personalizados
en Firefox, deben establecerse las preferencias dom.webcomponents.enabled
y dom.webcomponents.customelements.enabled
a true
.
Notas de CSS Quantum
- En Gecko, cuando creas un subarbol separado (por ejemplo, un
<div>
creado usandocreateElement()
que aún no ha sido insertado en el DOM), el elemento raíz del subarbol es insertado como un elemento "block". En el nuevo motor paralelo de CSS de Firefox (tambien conocido como Quantum CSS o Stylo, planeado para ser publicado en Firefox 57), el elemento es insertado como "inline", según se especifica en error 1374994.