DIV CSS 佈局教程網

jQuery wrapAll() 方法:用單一元素一次包住多個節點
編輯:JavaScript綜合知識     

wrapAll() 的功能是把選集合中所有符合條件的元素,用同一個元素一起包裹起來。這正是它與 wrap() 最關鍵的差別:後者會為每個元素各自產生一個新的外層,前者只產生一層。

語法一:用既有 DOM 元素包裹

$(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 裡,共用同一個容器。

語法二:用 HTML 字串包裹

$(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()、wrapAll()、wrapInner() 三者對照

  • wrap():每個元素各自包一層,n 個元素產生 n 個容器。
  • wrapAll():所有元素一起包進一個容器,n 個元素產生 1 個容器。
  • wrapInner():包的是元素的內容而非元素本身,外殼套在裡面。

什麼時候會用到

最常見的場景是將分散的多個節點收攏成一個群組,以便統一控制。例如把某個區塊內所有 <p> 收進一個 .text-group,之後就能對這個群組整體做淡入、拖曳或加上共同的邊框樣式。另一個用法是把多個圖片包進一個 .gallery 容器,方便套用相簿排版。

提醒一個細節:wrapAll() 是把元素「搬移」而非複製,操作後原本的位置會空掉,DOM 順序也會依選集合的順序重新排列在容器內。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved