Método replaceWith

O método replaceWith substitui alguns elementos por outros. Ele funciona de forma semelhante ao método replaceAll.

Sintaxe

O parâmetro do método pode ser texto (possivelmente com tags), array, elemento DOM ou objeto jQuery:

javascript$(o_que_substituir).replaceWith(pelo_que_substituir);

Os elementos selecionados serão substituídos pelo conteúdo, definido pelo texto que a função do usuário retornar. A função é chamada separadamente para cada um dos elementos selecionados:

javascript$(seletor).replaceWith(function());

Exemplo

Vamos substituir todos os parágrafos com a classe www por uma div com o texto '!!!':

html<p class="www">text</p>
<p class="www">text</p>
<p class="www">text</p>
<p>text</p>
javascript$('p.www').replaceWith('<div>!!!</div>');

O código HTML ficará assim:

html<div>!!!</div>
<div>!!!</div>
<div>!!!</div>
<p>text</p>

Veja também

  • método replaceAll,
    que também substitui alguns elementos por outros