萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery unwrap() 方法詳解:移除父層包裹元素

方法定義

.unwrap() 將**每個匹配元素的父元素移除**,但保留該元素本身及其兄弟元素在 DOM 中的位置。本質上是 `.parent().replaceWith(this)` 的批次操作。

語法

$(selector).unwrap()

無參數。jQuery 1.4+ 支援。

基本範例

<!DOCTYPE html>
<html>
<head>
  <title>jQuery unwrap() 示範</title>
  <script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
  <style>
    .wrapper { border: 2px solid blue; padding: 20px; margin: 10px; background: #f0f8ff; }
    .content { border: 1px solid red; padding: 15px; background: #fff; }
  </style>
</head>
<body>
  <div class="wrapper">
    <p class="content">我是被包裹的段落 1</p>
    <p class="content">我是被包裹的段落 2</p>
  </div>
  <div class="wrapper">
    <p class="content">我是另一個包裹裡的段落</p>
  </div>
  <button id="unwrapBtn">移除父層包裹 (unwrap)</button>

  <script>
    $("#unwrapBtn").click(function() {
      $(".content").unwrap(); // 所有 .content 的父層 .wrapper 會被移除
    });
  </script>
</body>
</html>

執行前後 DOM 結構

操作前操作後
<div class="wrapper">
  <p class="content">...</p>
  <p class="content">...</p>
</div>
<p class="content">...</p>
<p class="content">...</p>
(兩個 .wrapper 皆被移除,段落提升至 body 直屬)

進階場景

1. 移除特定父層 (搭配選取器過濾)

// 僅移除 class 為 .wrapper 的父層
$(".content").unwrap(".wrapper"); // jQuery 3.0+ 支援選取器參數

2. 配合 wrap()/wrapAll()/wrapInner() 使用

// 1. 先包裹
$("p").wrap("
"); // 2. 稍後解除包裹 $("p").unwrap(); // 移除 .temp-wrapper // wrapAll: 所有 p 共用一個父層 $("p").wrapAll("
"); // wrapInner: 包裹 p 內部內容 $("p").wrapInner("");

3. 實戰:清理編輯器產生的多餘包裹

// 某富文本編輯器輸出可能產生巢狀 text
$("#editor").find("span").contents().unwrap(); // 移除所有 span 標籤,保留文字內容
// 或
$("#editor *").contents().unwrap(); // 移除所有元素標籤,僅保留文字節點 (慎用!)

相關方法對照

方法作用反向操作
wrap()每個匹配元素**單獨**包裹一層unwrap()
wrapAll()所有匹配元素**共同**包裹一層unwrap() (移除共同父層)
wrapInner()包裹元素**內部內容** (子節點)無直接反向 (需 `.contents().unwrap()`)
unwrap()移除父元素,保留自身wrap()/wrapAll()

注意事項

  • 若父元素包含**多個子元素**,`unwrap()` 會將所有子元素提升至父元素原位置 (兄弟關係保持)。
  • 事件處理器:被移除的父元素上的事件**不會**自動轉移給子元素。
  • 若父元素是 ``、`` 等關鍵結構,`unwrap()` 可能導致版面崩壞,請謹慎使用選取器限定範圍。

原生 JS 等效實作

function unwrapNative(selector) {
  document.querySelectorAll(selector).forEach(function(el) {
    var parent = el.parentNode;
    if (parent && parent !== document.body) {
      // 將所有子節點移到 parent 之前
      while (parent.firstChild) {
        parent.parentNode.insertBefore(parent.firstChild, parent);
      }
      parent.parentNode.removeChild(parent);
    }
  });
}

`unwrap()` 是 jQuery DOM 操作工具箱中「解包裹」的利器,配合 `wrap*` 系列方法可靈活重構文件結構。

copyright © 萬盛學電腦網 all rights reserved