replaceAll() 的作用是用目前選集合中的元素,去替換由參數 selector 所指定的那些元素。它的效果等同於 replaceWith(),只是兩者的「主詞與受詞」順序相反。
$(content).replaceAll(selector)
<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">
$(document).ready(function(){
$("button").click(function(){
$("<div>這是 div 元素</div>").replaceAll("p");
});
});
</script>
<p>這是 p 元素</p>
<p>這是 p 元素</p>
<p>這是 p 元素</p>
<button>執行替換</button>
點擊按鈕後,三個紅色 p 方塊全部消失,取而代之的是三個藍色 div 方塊。這裡要注意:一個新元素被「替換」到多個位置時,jQuery 會為每個位置產生一份對應的節點。
兩者功能完全相同,但語法方向相反,容易記錯:
// 讀法:把 p 用 div 取代
$("<div>新內容</div>").replaceAll("p");
// 讀法:p 被 div 取代
$("p").replaceWith("<div>新內容</div>");
實務上 replaceWith() 讀起來通常更貼近自然語感,因此比較常用;replaceAll() 的優勢出現在「新內容已存在於頁面某處、要把它搬去覆蓋別人」的情境。
被替換掉的元素會連同其後代節點一起從 DOM 移除,掛在它們上面的事件處理器也會消失。若替換的是有互動的元件,記得重新綁定事件,或改用事件委派掛在共同祖先上。
另外,若被替換的元素身上帶有重要的 class 或 id(例如被 CSS 或 JavaScript 參照),替換後這些識別資訊不會自動轉移到新元素上,需要自行補回。