前陣子翻書時,注意到 jQuery 裡有三個名字長得很像的「包裹」方法:wrap()、wrapAll() 和 wrapInner()。隱隱約約知道它們都是拿一段 HTML 去包住元素,但細節差在哪,實在很難一眼想通。
於是上網搜了一下,排第一位的仍然是 W3School 的頁面,官方文件寫得四平八穩:
老實說,光讀這幾行文字,只會越讀越糊。與其硬猜,不如直接跑一遍。
<p>我是占位子的。</p> <p>我是占位子的。</p>
$("p").wrap("<strong></strong>");
執行結果:

可以清楚看到,strong 標籤被複製了兩份,每個 p 各自被獨立包住。也就是說,有幾個元素,就會產生幾層包裹。
$("p").wrapAll("<strong></strong>");
執行結果:

這次只產生一個 strong,兩個 p 被一起塞進同一個容器裡。差別在這裡就很明顯了:wrapAll 是「集體包一層」,而且被包的元素在 DOM 上也會變成同一層的兄弟關係。
$("p").wrapInner("<strong></strong>");
執行結果:

這次的包裹層出現在 p 的裡面,也就是說 p 本身位置沒動,被包起來的是它內部原本的文字節點。

如果只觀察瀏覽器的渲染結果,三個方法在這個簡單案例裡幾乎看不出差異,因為 strong 只是把文字加粗。但只要牽涉到 CSS 選擇器、事件綁定或 DOM 走訪,結構差異就會立刻顯現出來。
一句話總結:wrap 是每個元素各包一層、wrapAll 是全部一起包一層、wrapInner 是往元素內部包一層。分清楚這三件事,就不會再選錯工具。
以上純屬個人理解,若已有深厚基礎的高手,还请略過。