replaceWith() 會把符合條件的元素整體替換成指定的 HTML 或 DOM 元素。它和 remove() 的差別在於:remove() 只是刪掉,replaceWith() 是「刪掉並在原位補上新的」。
傳入的參數如果是 HTML 字串,標籤會被瀏覽器正常解析並渲染;若內容中含有需要跳脫的預定義字元,則會被轉成 HTML 實體,標籤就會以純文字形式呈現。實作時要留意資料來源是否可信,避免把使用者輸入直接當 HTML 插入而造成 XSS 風險。
$(selector).replaceWith(content)
參數 content 是用來替換的內容,selector 則用於找出要被替換的目標元素。
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>replaceWith() 方法</title>
<style type="text/css">
div{
width:100px;
height:100px;
border:1px solid blue;
}
p{
width:150px;
height:150px;
border:1px solid red;
}
</style>
<script type="text/javascript" src="jquery-1.8.3.js"></script>
<script type="text/javascript">
$(document).ready(function(){
$("button").click(function(){
$("p").replaceWith("<div>我是div元素</div>");
});
});
</script>
</head>
<body>
<p>我是p元素</p>
<p>我是p元素</p>
<p>我是p元素</p>
<button>把所有段落換成 div</button>
</body>
</html>
點擊按鈕後,三個紅框的 p 元素會全部消失,取而代之的是三個藍框的 div,寬高與邊框樣式也跟著改成 div 的設定。這說明了替換是「節點層級」的:被換掉的元素連同它的樣式與內容一併退場,新元素完整接手。
第一,替換會抹去原元素上的事件綁定與 data() 資料。若那些元素掛了點擊事件,替換後必須重新綁一次,否則互動會失效。
第二,若只想換掉「內容」而保留元素本身,應該用 .html();若想反過來用既有元素包住目前內容,則該用 .wrap()。挑對方法能省下不少來回修正。