Document.createElement()

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since julio de 2015.

* Some parts of this feature may have varying levels of support.

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").

optionsOpcional

Un objeto opcional ElementCreationOptions que contiene una única propiedad llamada is, cuyo valor es el de la etiqueta name de un elemento personalizado definido previamente utilizando customElements.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.

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

js
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);
}

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 24 jun 2025 by MDN contributors.

View this page on GitHub • Report a problem with this content

Document.createElement()

In this article

Sintaxis

Parámetros

Retorna

Ejemplo

HTML

JavaScript

Especificaciones

Compatibilidad del Navegador

Ver también

Help improve MDN