wrap(html|ele|fn) | jQuery API 3.2 中文文档 | jQuery API 在线手册

jQuery API 3.2.1

推荐办理招商信用卡,新户首刷礼,五折享美食,需要的速度围观~click here
首页  >  文档处理  > wrap(html|ele|fn) 源码下载

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

概述

把所有匹配的元素用其他元素的结构化标记包裹起来。

这种包装对于在文档中插入额外的结构化标记最有用,而且它不会破坏原始文档的语义品质。这个函数的原理是检查提供的第一个元素(它是由所提供的HTML标记代码动态生成的),并在它的代码结构中找到最上层的祖先元素--这个祖先元素就是包裹元素。当HTML标记代码中的元素包含文本时无法使用这个函数。因此,如果要添加文本应该在包裹完成之后再行添加。

参数

html String V1.0

HTML标记代码字符串,用于动态生成元素并包裹目标元素

element Element V1.0

用于包装目标元素的DOM元素

fn Function V1.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>