Categories

.replaceAll()

Categories: DOM Replacement

.replaceAll( target )Returns: jQuery

Description: Replace each target element with the set of matched elements.

  • .replaceAll( target )

    version added: 1.0

    target   A selector expression indicating which element(s) to replace.

The .replaceAll() method is corollary to .replaceWith(), but with the source and target reversed. Consider this DOM structure:

<div class="container">
  <div class="inner first">Hello</div>
  <div class="inner second">And</div>
  <div class="inner third">Goodbye</div>
</div>

We can create an element, then replace other elements with it:

$('<h2>New heading</h2>').replaceAll('.inner');

This causes all of them to be replaced:

<div class="container">
  <h2>New heading</h2>
  <h2>New heading</h2>
  <h2>New heading</h2>
</div>

Or, we could select an element to use as the replacement:

$('.first').replaceAll('.third');

This results in the DOM structure:

<div class="container">
  <div class="inner second">And</div>
  <div class="inner first">Hello</div>
</div>

From this example, we can see that the selected element replaces the target by being moved from its old location, not by being cloned.

  • Replace all the paragraphs with bold words.

    HTML:
    <p>Hello</p>
      <p>cruel</p>
      <p>World</p>
    Code:
    $("<b>Paragraph. </b>").replaceAll("p"); // check replaceWith() examples