wrap(html|ele|fn)

返回值

jQuery

概述

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

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

参数

参数 类型 说明 示例值
html String

v1.0
HTML标记代码字符串，用于动态生成元素并包裹目标元素
element Element

v1.0
用于包装目标元素的DOM元素
fn Function

v1.4
生成包裹结构的一个函数

示例

示例一

描述：把所有的段落用一个新创建的div包裹起来

jQuery 代码

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

描述：用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>