Node.replaceChild

Sum√°rio

Substitui o elemento filho especificado por outro.

Sintaxe

replacedNode = parentNode.replaceChild(newChild, oldChild);
  • newChild √© o novo elemento que ser√° inserido no lugar do oldChild. Se j√° existir no DOM, ser√° removido primeiro para depois ser inserido.
  • oldChild √© o elemento existente que ser√° substitu√≠do.
  • replacedNode √© elemento substitu√≠do. √Č o mesmo elemento que oldChild.

Exemplo

// <div>
//  <span id="childSpan">foo bar</span>
// </div>

// Cria um novo elemento vazio
// sem ID, atributos ou conte√ļdo
var sp1 = document.createElement("span");

// Adiciona um ID 'newSpan' para o elemento
sp1.setAttribute("id", "newSpan");

// Adiciona contéudo para o elemento
var sp1_content = document.createTextNode("new replacement span element.");

// Coloca o conte√ļdo no elemento
sp1.appendChild(sp1_content);

// Procura o elemento que será substituído
var sp2 = document.getElementById("childSpan");
var parentDiv = sp2.parentNode;

// Substituí o elemento que já existe (sp2) por o novo elemento (sp1)
parentDiv.replaceChild(sp1, sp2);

// resultado:
// <div>
//   <span id="newSpan">new replacement span element.</span>
// </div>

Especificação

Veja também