Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

document.createElement — criar um elemento DOM

document.createElement cria um novo elemento DOM com o nome especificado. Não o insere automaticamente no documento.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

document.createElement(localName)
document.createElement(localName, options)

document.createElement(localName, options) devolve um novo elemento sem nó pai. O argumento localName é o nome de um elemento, não código HTML. Define o conteúdo através de textContent e insere o elemento separadamente, por exemplo, com appendChild.

Num documento HTML, o nome é convertido para minúsculas ASCII. Um nome inválido lança uma DOMException com o nome InvalidCharacterError. Usa createElementNS para escolher explicitamente um espaço de nomes.

No argumento opcional options, a propriedade is indica o nome registado de um elemento personalizado que estende o elemento incorporado indicado por localName. Para criar um elemento personalizado autónomo, passa o seu nome registado diretamente como localName, e não como options.is. O Safari não suporta elementos incorporados personalizados, pelo que esta utilização de options.is não funciona em todos os navegadores.

O exemplo mostra apenas a chamada com um argumento, sem options. Requer um documento HTML num navegador; o suporte de JavaScript, por si só, não garante que document esteja disponível.

Exemplos

const element = document.createElement("DIV");
element.textContent = "Hello";
console.log(element.localName);
console.log(element.textContent);
console.log(element.parentNode === null);

Resultado

div
Hello
true

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes