Método append

O método append permite inserir no final de um elemento outro elemento. Como parâmetro, o método aceita um elemento, geralmente criado via createElement, ou uma string. É possível adicionar vários elementos ou strings de uma vez, listando-os separados por vírgula.

Sintaxe

javascriptelementoPai.append(elemento ou string);

Exemplo

Vamos criar um parágrafo, definir seu texto e colocá-lo na página no final do bloco #parent:

html<div id="parent">
  <p>1</p>
  <p>2</p>
  <p>3</p>
</div>

javascriptlet parent = document.querySelector('#parent');

let p = document.createElement('p');
p.textContent = '!';

parent.append(p);

Resultado da execução do código:

html<div id="parent">
  <p>1</p>
  <p>2</p>
  <p>3</p>
  <p>!</p>
</div>

Exemplo

Vamos colocar vários parágrafos de uma vez no final do bloco #parent:

html<div id="parent">
  <p>1</p>
  <p>2</p>
  <p>3</p>
</div>

javascriptlet parent = document.querySelector('#parent');

let p1 = document.createElement('p');
p1.textContent = 'a';

let p2 = document.createElement('p');
p2.textContent = 'b';

parent.append(p1, p2);

Resultado da execução do código:

html<div id="parent">
  <p>1</p>
  <p>2</p>
  <p>3</p>
  <p>a</p>
  <p>b</p>
</div>

Exemplo

Vamos usar uma string como parâmetro do método:

html<div id="parent">
  <p>1</p>
  <p>2</p>
  <p>3</p>
</div>

javascriptlet parent = document.querySelector('#parent');
parent.append('!');

Resultado da execução do código:

html<div id="parent">
  <p>1</p>
  <p>2</p>
  <p>3</p>
  !
</div>

Exemplo

Dado um ul. Vamos colocar nele 9 tags li, e fazer deles textos com números ordinais:

html<ul id="parent"></ul>

javascriptlet parent = document.querySelector('#parent');

for (let i = 1; i <= 9; i++) {
  let li = document.createElement('li');
  li.textContent = i;
  parent.append(li);
}

Resultado da execução do código:

html<ul id="parent">
  <li>1</li>
  <li>2</li>
  <li>3</li>
  <li>4</li>
  <li>5</li>
  <li>6</li>
  <li>7</li>
  <li>8</li>
  <li>9</li>
</ul>

Exemplo

Vamos preencher a tabela com trs e tds:

html<table id="table"></table>

javascriptlet table = document.querySelector('#table');

for (let i = 1; i <= 3; i++) {
  let tr = document.createElement('tr'); // criamos uma tr
  
  // Preenchemos a tr com tds:
  for (let j = 1; j <= 3; j++) {
    let td = document.createElement('td'); // criamos uma td
    td.textContent = j; // escrevemos nela o texto
    
    tr.append(td); // adicionamos a td criada no final da tr
  }
  
  table.append(tr); // adicionamos a tr criada no final da tabela
}

Resultado da execução do código:

html<table id="table">
  <tr>
    <td>1</td>
    <td>2</td>
    <td>3</td>
  </tr>
  <tr>
    <td>1</td>
    <td>2</td>
    <td>3</td>
  </tr>
  <tr>
    <td>1</td>
    <td>2</td>
    <td>3</td>
  </tr>
</table>

Veja também