.wrapInner() 將 匹配元素的「內部內容」(子節點、文字節點) 用指定結構包裹,而元素本身保持不變。這與包裹「元素本身」的 .wrap()、包裹「整組元素」的 .wrapAll() 形成互補。
| 語法 | 參數類型 | 適用場景 |
|---|---|---|
.wrapInner(wrappingElement) |
DOM 元素 / jQuery 物件 | 復用頁面上現有的容器元素 |
.wrapInner(htmlString) |
HTML 字串 | 快速構建包裹結構,最常用 |
.wrapInner(function) |
回調函數(返回上述任一類型) | 根據元素屬性/索引動態生成不同包裹 |
<div class="outer">這是外層 div 的原始文字內容</div>
<div class="outer">另一個外層 div</div>
<button id="btn1">用 <p> 包裹內容</button>
<script>
$('#btn1').click(function() {
// 創建一個新的 <p> 元素作為包裹器
var wrapper = document.createElement('p');
wrapper.style.cssText = 'border:1px solid red; padding:10px; background:#ffe;';
$('.outer').wrapInner(wrapper);
});
</script>
結果:每個 .outer 的文字內容被移入新建的 <p> 中,原 div 變為空殼套著 p。
<button id="btn2">用 <span class="highlight"> 包裹內容</button>
<script>
$('#btn2').click(function() {
$('.outer').wrapInner('<span class="highlight" style="color:#e74c3c; font-weight:bold;"></span>');
});
</script>
<div class="item" data-type="alert">警告內容</div>
<div class="item" data-type="info">資訊內容</div>
<div class="item" data-type="success">成功內容</div>
<script>
$('.item').wrapInner(function(index) {
var type = $(this).data('type');
var colors = { alert: '#e74c3c', info: '#3498db', success: '#27ae60' };
return '<span style="color:' + colors[type] + '; border:1px solid ' + colors[type] + '; padding:2px 6px; border-radius:3px;"></span>';
});
</script>
每個 .item 內容被不同顏色的 <span> 包裹,實現語義化高亮。
| 方法 | 包裹對象 | 包裹次數 | 典型用途 |
|---|---|---|---|
.wrap() |
每個匹配元素「本身」 | N 次(N = 匹配數) | 給每個輸入框加外框、給每張圖加燈箱觸發層 |
.wrapAll() |
所有匹配元素「整體」 | 1 次 | 將多個段落放入同一容器、表單分組 |
.wrapInner() |
每個匹配元素的「內部內容」 | N 次 | 為文字加樣式標籤、為圖片加說明層、內容遷移 |
// 移除最近的父包裹層
$('.highlight').contents().unwrap(); // 只解開一層
// 或
$('.outer').children().unwrap(); // 解開子元素的包裹
wrapInner 是「移動」內容節點,非複製。原位置內容消失。<mark> 包裹關鍵字(需先拆分文字節點)。lang 屬性自動包裹 <span lang="en"> 供 CSS :lang() 樣式化。<div data-ad-slot> 包裹,便於後續廣告腳本定位。<span class="sr-only"> 提供螢幕閱讀器提示。.wrapInner() 專注於「內容層面」的結構增強,配合回調函數可實現極具表現力的動態包裹。熟練掌握三兄弟(wrap/wrapAll/wrapInner)的分工差異,是 jQuery DOM 操作進階的必修課。