wrapAll() 的功能是把選集合中所有符合條件的元素,用同一個元素一起包裹起來。這正是它與 wrap() 最關鍵的差別:後者會為每個元素各自產生一個新的外層,前者只產生一層。
$(selector).wrapAll(elem)
參數 elem 是作為容器的 DOM 元素。
<script type="text/javascript">
$(document).ready(function(){
$("button").click(function(){
$("p").wrapAll(document.getElementById("content"));
});
});
</script>
<p>我是個段落</p>
<p>我是個段落</p>
<div id="content"></div>
<button>用 div 包裹段落</button>
點擊後,兩個 p 都會被搬進 #content 這個 div 裡,共用同一個容器。
$(selector).wrapAll(html)
<style type="text/css">
.content { width:200px; height:200px; border:1px solid blue; }
</style>
<script type="text/javascript">
$(document).ready(function(){
$("button").click(function(){
$("p").wrapAll("<div class='content'></div>");
});
});
</script>
<p>這是個段落</p>
<p>這是個段落</p>
<button>用 div 包裹段落</button>
這次容器是臨時產生的,兩個段落會被包進同一個新 div 中。
wrap():每個元素各自包一層,n 個元素產生 n 個容器。wrapAll():所有元素一起包進一個容器,n 個元素產生 1 個容器。wrapInner():包的是元素的內容而非元素本身,外殼套在裡面。最常見的場景是將分散的多個節點收攏成一個群組,以便統一控制。例如把某個區塊內所有 <p> 收進一個 .text-group,之後就能對這個群組整體做淡入、拖曳或加上共同的邊框樣式。另一個用法是把多個圖片包進一個 .gallery 容器,方便套用相簿排版。
提醒一個細節:wrapAll() 是把元素「搬移」而非複製,操作後原本的位置會空掉,DOM 順序也會依選集合的順序重新排列在容器內。