wrap(html|ele|fn)

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

概述

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

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

參數(shù)

htmlStringV1.0

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

elemElementV1.0

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

fnFunctionV1.4

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

示例

html參數(shù)描述:

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

jQuery 代碼:

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

elem參數(shù)描述:

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

jQuery 代碼:

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

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

用原先div的內(nèi)容作為新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() + '" />';
});

結(jié)果:

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