.wrapAll() 將 所有匹配元素 用 單一個父元素 包裹起來。這與 .wrap()(逐個包裹)有本質區別,是批量 DOM 結構重組的利器。
| 語法 | 參數 | 說明 |
|---|---|---|
.wrapAll(wrappingElement) |
DOM 元素、jQuery 物件、選擇器字串 | 用指定元素包裹匹配集合 |
.wrapAll(htmlString) |
HTML 字串(如 "<div class='box'></div>") |
根據 HTML 字串創建包裹元素 |
.wrapAll(function) |
回調函數,返回上述任一類型 | 動態生成包裹結構,this 指向當前匹配元素 |
<div class="container">
<p>段落 1</p>
<p>段落 2</p>
<p>段落 3</p>
</div>
$('p').wrapAll('<div class="wrapper"></div>');
// 結果:三個 p 被「同一個」.wrapper 包裹
$('p').wrap('<div class="wrapper"></div>');
// 結果:每個 p 都被「獨立的」.wrapper 包裹
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>wrapAll DOM 元素示例</title>
<style>
.box { border: 2px solid #3498db; padding: 10px; margin: 10px 0; background: #ecf0f1; }
p { border: 1px solid #e74c3c; padding: 5px; margin: 5px 0; background: #fff; }
</style>
<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
</head>
<body>
<p>我是段落 1</p>
<p>我是段落 2</p>
<div id="target-wrapper" class="box"></div>
<button id="btn-wrap">用現有 div 包裹所有 p</button>
<script>
$('#btn-wrap').click(function() {
$('p').wrapAll(document.getElementById('target-wrapper'));
});
</script>
</body>
</html>
點擊按鈕後,兩個 <p> 會被移動到 #target-wrapper 內部,原位置不再佔位。
<script>
$('#btn-wrap-html').click(function() {
$('p').wrapAll("<div class='box' style='border-color:#27ae60'></div>");
});
</script>
會動態創建一個 <div class="box"> 並將所有 <p> 置入其中。
$('section').wrapAll(function(index) {
// 根據 section 的 data-type 決定包裹樣式
var type = $(this).data('type') || 'default';
return "<div class='section-group section-" + type + "'></div>";
});
if ($('selector').length)。wrapAll 會將它們「強行聚合」到新父元素下,可能破壞原有語義結構。<input> 包裹在 <fieldset> 中。<li> 包裹在 <ul> 或 <section>。wrapAll 可無縫適配。.wrapAll() 是 jQuery DOM 操作中的「整體包裹」利器,核心優勢在於 單一父元素包裹多個同輩元素。掌握其與 .wrap()、.wrapInner() 的差異,能讓你在結構重組、插件適配、響應式調整等場景中游刃有餘。