wrap(html|ele|fn)

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

概述

把所有匹配的元素用其他元素的結(jié)構(gòu)化標(biāo)記包裹起來。

這種包裝對(duì)于在文檔中插入額外的結(jié)構(gòu)化標(biāo)記最有用，而且它不會(huì)破壞原始文檔的語義品質(zhì)。這個(gè)函數(shù)的原理是檢查提供的第一個(gè)元素（它是由所提供的HTML標(biāo)記代碼動(dòng)態(tài)生成的），并在它的代碼結(jié)構(gòu)中找到最上層的祖先元素－－這個(gè)祖先元素就是包裹元素。當(dāng)HTML標(biāo)記代碼中的元素包含文本時(shí)無法使用這個(gè)函數(shù)。因此，如果要添加文本應(yīng)該在包裹完成之后再行添加。

參數(shù)

htmlStringV1.0

HTML標(biāo)記代碼字符串，用于動(dòng)態(tài)生成元素并包裹目標(biāo)元素

elemElementV1.0

用于包裝目標(biāo)元素的DOM元素

fnFunctionV1.4

生成包裹結(jié)構(gòu)的一個(gè)函數(shù)

示例

html參數(shù)描述:

把所有的段落用一個(gè)新創(chuàng)建的div包裹起來

jQuery 代碼:

$("p").wrap("<div class='wrap'></div>");

elem參數(shù)描述:

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

jQuery 代碼:

$("p").wrap(document.getElementById('content'));

回調(diào)函數(shù) 描述:

用原先div的內(nèi)容作為新div的class，并將每一個(gè)元素包裹起來

HTML 代碼:

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

jQuery 代碼:

$('.inner').wrap(function() {
  return '<div class="' + $(this).text() + '" />';
});

結(jié)果:

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