Description

The .replaceWith() method replaces selected elements with new content.

Tip: The replaceWith() and replaceAll() methods do the same thing. The difference is in the syntax: the placement of the content and selector, and that replaceWith() can replace content using a function.

---

This method has the form:

.replaceWith(content)

Parameter	Description
content	(required) Specifies the new content. Possible values: HTML code - eg. <div>Hello world</div> New elements - eg. document.createElement("div") Existing elements - eg. $(".div1")

Return Value

This form returns a jQuery object.

---

Replace Elements Using a Function

Using a function to replace selected elements with new content.

This method has the alternate form:

.replaceWith(function())

Parameter	Description
function()	(required) A function that returns the new content to replace the selected elements with

Return Value

This form returns a jQuery object.

Examples

Replace the first p element with some bold text:

$("button").click(function(){
  $("p:first").
    replaceWith("<b>jQuery</b>");
});