JavaScript - Create Element (DOM)

Referência prática da função createElement()

A função createElement() irá criar um elemento HTML para ser, posteriormente, inserido em um documento HTML.

Veja a sintaxe da função:

var element = document.createElement(tagName);

Aparentemente, a função não surte efeito algum, precisamos aplicar o método appendChild() para que o elemento seja, efetivamente, inserido ao documento HTML e fique visível ao usuário. Além disso, precisamos definir (buscar) um elemento pai, ou seja, o elemento HTML que receberá nosso elemento (recém criado) como filho.

// Buscar elemento pai
var elemento_pai = document.body;

// Criar elemento
var titulo = document.createElement('h1');

// Inserir (anexar) o elemento filho (titulo) ao elemento pai (body)
elemento_pai.appendChild(titulo);

Há um porém, o código acima irá inserir corretamente o título ao corpo do documento, só que não haverá título algum, pois apenas a tag h1 foi inserida, falta o nó de texto. Quer dizer, temos o resultado...

<body>
    <h1></h1>
</body>

...e precisamos de um texto para a tag h1. Para criar o nó de texto utilizamos a função createTextNode() e também utilizaremos a função appendChild() para anexar o nó ao elemento em questão, resumidamente:

var titulo = document.createElement('h1');
var texto  = document.createTextNode("Um título qualquer");
titulo.appendChild(texto);

Atualizando nosso código com o trecho acima, teremos...

// Buscar elemento pai
var elemento_pai = document.body;

// Criar elemento
var titulo = document.createElement('h1');

// Criar o nó de texto
var texto = document.createTextNode("Um título qualquer");

// Anexar o nó de texto ao elemento h1
titulo.appendChild(texto);

// Agora sim, inserir (anexar) o elemento filho (titulo) ao elemento pai (body)
elemento_pai.appendChild(titulo);

Aí então, chegaremos ao resultado esperado:

<body>
    <h1>Um título qualquer</h1>
</body>

textContent

Outra forma de chegar ao mesmo resultado é utilizar a propriedade textContent. Ao invés de criar e anexarmos um nó de texto podemos lançar mão da propriedade textContent do elemento que estamos criando.

As duas linhas abaixo criam o elemento e seu texto equivalente.

var titulo = document.createElement('h1');
titulo.textContent = "Um título qualquer"

Atualizando nosso código, teremos...

// Buscar elemento pai
var elemento_pai = document.body;

// Criar elemento
var titulo = document.createElement('h1');

// Criando o nó de texto de outra forma
titulo.textContent = "Um título qualquer"

// Inserir (anexar) o elemento filho (titulo) ao elemento pai (body)
elemento_pai.appendChild(titulo);

Inserindo com insertBefore

A função insertBefore insere um elemento antes (before) de um determinado elemento. Por tanto, o uso desta função é indicado para trabalhar com listas, tabelas, itens, etc... ou seja, elementos que representam uma listagem. Obviamente, você pode utilizá-la como bem entender.

A função insertBefore() recebe dois argumentos. O primeiro é o nó a ser inserido. O segundo argumento é o nó antes do qual esse nó vai ser inserido, exemplo:

elemento_pai.insertBefore(novoElem, elemDeReferencia);

Imagina que você quer inserir um item de uma lista (li) em uma lista (ul), seu HTML será mais ou menos isso...

<ul>
    <li>primeiro item</li>
    <li>segundo item</li>
    <li>quarto item</li>
</ul>

Repare que está faltando o terceiro elemento, então vamos criá-lo e inserir antes do quarto elemento.

//
// Criando o terceiro elemento
//
var novoElem  = document.createElement('li');
var texto     = document.createTextNode('terceiro item');
novoElem.appendChild(texto);

//
// Recuperando a lista
//
var lista = document.getElementsByTagName('ul')[0];

//
// Recuperando os itens
//
var itens = document.getElementsByTagName('li');

//
// Inserindo com insertBefore()
//
lista.insertBefore(novoElem, itens[0]);

Leia o artigo JavaScript - Insert Before (DOM) para mais detalhes.

Comentários

comments powered by Disqus