萬盛學電腦網

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

jQuery wrapInner() 方法詳解:為元素「內容」套上外衣的三種姿勢

方法定位

.wrapInner() 將 匹配元素的「內部內容」(子節點、文字節點) 用指定結構包裹,而元素本身保持不變。這與包裹「元素本身」的 .wrap()、包裹「整組元素」的 .wrapAll() 形成互補。

三大語法形態

語法參數類型適用場景
.wrapInner(wrappingElement) DOM 元素 / jQuery 物件 復用頁面上現有的容器元素
.wrapInner(htmlString) HTML 字串 快速構建包裹結構,最常用
.wrapInner(function) 回調函數(返回上述任一類型) 根據元素屬性/索引動態生成不同包裹

實戰範例 1:用 DOM 元素包裹內容

<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。

實戰範例 2:用 HTML 字串包裹(最常用)

<button id="btn2">用 <span class="highlight"> 包裹內容</button>

<script>
  $('#btn2').click(function() {
    $('.outer').wrapInner('<span class="highlight" style="color:#e74c3c; font-weight:bold;"></span>');
  });
</script>

實戰範例 3:回調函數動態包裹

<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 / wrapAll / wrapInner 三兄弟對比表

方法包裹對象包裹次數典型用途
.wrap() 每個匹配元素「本身」 N 次(N = 匹配數) 給每個輸入框加外框、給每張圖加燈箱觸發層
.wrapAll() 所有匹配元素「整體」 1 次 將多個段落放入同一容器、表單分組
.wrapInner() 每個匹配元素的「內部內容」 N 次 為文字加樣式標籤、為圖片加說明層、內容遷移

進階技巧:結合 .unwrap() 移除包裹

// 移除最近的父包裹層
$('.highlight').contents().unwrap(); // 只解開一層
// 或
$('.outer').children().unwrap(); // 解開子元素的包裹

常見誤區

  • 以為會複製元素:wrapInner 是「移動」內容節點,非複製。原位置內容消失。
  • 忽略文字節點:純文字也會被包裹,不僅限於元素節點。
  • 事件丟失:內容節點上的事件處理器會保留(因為節點本身未銷毀),但若包裹元素有事件委託需重新綁定。

實際業務場景

  1. 關鍵字高亮:搜尋結果中用 <mark> 包裹關鍵字(需先拆分文字節點)。
  2. 多語言包裹:根據 lang 屬性自動包裹 <span lang="en"> 供 CSS :lang() 樣式化。
  3. 廣告位隔離:將編輯器輸出的內容用 <div data-ad-slot> 包裹,便於後續廣告腳本定位。
  4. 無障礙增強:為互動元素內容包裹 <span class="sr-only"> 提供螢幕閱讀器提示。

總結

.wrapInner() 專注於「內容層面」的結構增強,配合回調函數可實現極具表現力的動態包裹。熟練掌握三兄弟(wrap/wrapAll/wrapInner)的分工差異,是 jQuery DOM 操作進階的必修課。

copyright © 萬盛學電腦網 all rights reserved