.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>
| 操作前 | 操作後 |
|---|---|
<div class="wrapper"> <p class="content">...</p> <p class="content">...</p> </div> |
<p class="content">...</p> <p class="content">...</p> (兩個 .wrapper 皆被移除,段落提升至 body 直屬) |
// 僅移除 class 為 .wrapper 的父層
$(".content").unwrap(".wrapper"); // jQuery 3.0+ 支援選取器參數
// 1. 先包裹
$("p").wrap("");
// 2. 稍後解除包裹
$("p").unwrap(); // 移除 .temp-wrapper
// wrapAll: 所有 p 共用一個父層
$("p").wrapAll("");
// wrapInner: 包裹 p 內部內容
$("p").wrapInner("");
// 某富文本編輯器輸出可能產生巢狀 text
$("#editor").find("span").contents().unwrap(); // 移除所有 span 標籤,保留文字內容
// 或
$("#editor *").contents().unwrap(); // 移除所有元素標籤,僅保留文字節點 (慎用!)
| 方法 | 作用 | 反向操作 |
|---|---|---|
wrap() | 每個匹配元素**單獨**包裹一層 | unwrap() |
wrapAll() | 所有匹配元素**共同**包裹一層 | unwrap() (移除共同父層) |
wrapInner() | 包裹元素**內部內容** (子節點) | 無直接反向 (需 `.contents().unwrap()`) |
unwrap() | 移除父元素,保留自身 | wrap()/wrapAll() |
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*` 系列方法可靈活重構文件結構。