replaceAll() 的用途是「拿符合條件的元素,去替換掉另一群元素」。它的功能與 replaceWith() 完全相同,差別只在寫法上的主詞與受詞位置對調——這也是它最常被拿來跟 replaceWith() 對照記憶的原因。
$(content).replaceAll(selector)
參數說明:content 是拿來替換的內容;selector 則用來找出要被替換掉的元素。
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>replaceAll() 示範</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 src="jquery/1.9.0/jquery.js"></script>
<script type="text/javascript">
$(document).ready(function(){
$("button").click(function(){
$("<div>這是 div 元素</div>").replaceAll("p");
});
});
</script>
</head>
<body>
<p>這是 p 元素</p>
<p>這是 p 元素</p>
<p>這是 p 元素</p>
<button>用 div 取代所有段落</button>
</body>
</html>
按下按鈕後,畫面上三個紅框段落會全部消失,取而代之的是新產生的 div 元素。這裡有個容易忽略的細節:$("<div>...</div>") 只建立了一個節點,但 replaceAll() 在替換多個目標時,會把這個節點複製成多份分別放入,而不是把同一個節點搬來搬去。
兩者可以互相轉寫:$("p").replaceWith("<div>...</div>") 等同於 $("<div>...</div>").replaceAll("p")。選擇哪一種通常看你想強調的是「新內容」還是「舊目標」。
被替換掉的元素連同其上的事件綁定與資料都會一併消失。如果替換後還需要互動,記得重新綁定事件,或改用事件委派(把 listener 掛在父層再判斷來源)。