.replaceAll() 使用 匹配集合中的元素 去 替換選擇器指定的目標元素。它是 .replaceWith() 的「反向操作」姊妹方法,功能完全等價,只是語法主賓倒置。
$(newContent).replaceAll(targetSelector)
// newContent: 用於替換的內容(HTML 字串、DOM 元素、jQuery 物件)
// targetSelector: 被替換目標的選擇器
newContent 是現有元素,會被移動而非複製(同 .appendTo() 行為)。<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>replaceAll 示例</title>
<style>
.box { width: 100px; height: 100px; margin: 10px; display: inline-block; text-align: center; line-height: 100px; font-weight: bold; color: #fff; }
.old { background: #e74c3c; } /* 紅 - 被替換目標 */
.new { background: #27ae60; } /* 綠 - 替換者 */
</style>
<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
</head>
<body>
<p class="box old">舊段落 1</p>
<p class="box old">舊段落 2</p>
<p class="box old">舊段落 3</p>
<br>
<button id="btn-replace">用 div 替換所有 p.old</button>
<script>
$('#btn-replace').click(function() {
// 用新建的 div 替換所有 class="old" 的 p
$('<div class="box new">新 div 元素</div>').replaceAll('p.old');
});
</script>
</body>
</html>
| 維度 | .replaceAll(target) | .replaceWith(newContent) |
|---|---|---|
| 調用主體 | 新內容 $(newContent) |
被替換目標 $(target) |
| 參數 | 目標選擇器 | 新內容 |
| 語義 | 「拿新的去換舊的」 | 「把舊的換成新的」 |
| 鏈式調用 | 返回新元素,可繼續操作新元素 | 返回原目標集合(已脫離 DOM),通常鏈式結束 |
| 適用場景 | 批量替換多個目標為同一新結構 | 單個目標替換為不同新內容 |
// 若希望保留原 newContent 元素,需先 .clone()
var $template = $('#template-row'); // 頁面隱藏的模板行
$template.clone().replaceAll('.dynamic-row');
// 每次點擊都用克隆副本替換,模板保留原位
.clone() 替換佔位行。$('<div class="loaded">內容</div>').replaceAll('.loading-placeholder');targetSelector 匹配多個元素,同一個新內容實例會被依次移動到每個目標位置,最終只留在最後一個目標位置(因為元素不能同時存在多處)。批量替換請配合 .clone()。<script> 標籤不會執行腳本,需手動 .eval() 或使用 .html() 重新注入。.replaceAll() 提供了「以新換舊」的直觀語義,配合 .clone() 是批量 DOM 替換的標準模式。理解其與 .replaceWith() 的主賓關係差異,能讓你在模板渲染、狀態切換、組件熱替換等場景中寫出更清晰的代碼。