返回值:jQuerywrap(html|ele|fn)

概述

把所有匹配的元素用其他元素的結構化標記包裹起來。

這種包裝對于在文檔中插入額外的結構化標記最有用,而且它不會破壞原始文檔的語義品質。這個函數的原理是檢查提供的第一個元素(它是由所提供的HTML標記代碼動態生成的),並在它的代碼結構中找到最上層的祖先元素--這個祖先元素就是包裹元素。當HTML標記代碼中的元素包含文本時無法使用這個函數。因此,如果要添加文本應該在包裹完成之後再行添加。

參數

htmlStringV1.0

HTML標記代碼字符串,用于動態生成元素並包裹目標元素

elemElementV1.0

用于包裝目標元素的DOM元素

fnFunctionV1.4

生成包裹結構的一個函數

示例

html參數描述:

把所有的段落用一個新創建的div包裹起來

jQuery 代码:
$("p").wrap("<div class='wrap'></div>");

elem參數描述:

用ID是"content"的div將每一個段落包裹起來

jQuery 代码:
$("p").wrap(document.getElementById('content'));

回调函数 描述:

用原先div的內容作爲新div的class,並將每一個元素包裹起來

HTML 代码:
<div class="container">

  <div class="inner">Hello</div>

  <div class="inner">Goodbye</div>

</div>
jQuery 代码:
$('.inner').wrap(function() {

  return '<div class="' + $(this).text() + '" />';

});
結果:
<div class="container">

  <div class="Hello">

    <div class="inner">Hello</div>

  </div>

  <div class="Goodbye">

    <div class="inner">Goodbye</div>

  </div>

</div>