learning jQuery 学习笔记十二（+jQuery 1.4.1 API）-- DOM操作-基于命令改变页面 ----包装元素

注：本笔记内容摘自《jQuery基础教程》+ jQuery 1.4.1中文参考

包装元素

jQuery 1.4.1 API

wrap()

wrap(elem)                                                    返回值:jQuery

概述

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

参数

elem              Element

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

示例

描述:

用ID是"content"的div将每一个段落包裹起来

HTML 代码:

<p>TestParagraph.</p><div id="content"></div>

jQuery 代码:

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

结果:

<divid="content"><p>Test Paragraph.</p></div><divid="content"></div>

 

wrap(fn)                                                        返回值:jQuery

概述

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

参数

fn    Function

生成包裹结构的一个函数

示例

描述:

用原先div的内容作为新div的class，并将每一个元素包裹起来

HTML 代码:

<divclass="container">

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

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

</div>

jQuery 代码:

$('.inner').wrap(function(){

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

});

结果:

<divclass="container">

  <div class="Hello">

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

  </div>

  <div class="Goodbye">

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

  </div>

</div>

 

wrap(html)                                             返回值:jQuery

概述

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

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

参数

html String

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

示例

描述:

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

HTML 代码:

<p>TestParagraph.</p>

jQuery 代码:

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

结果:

<divclass="wrap"><p>Test Paragraph.</p></div>

 

 

wrapAll(elem)                                                       返回值:jQuery

概述

将所有匹配的元素用单个元素包裹起来

这于 '.wrap()' 是不同的，'.wrap()'为每一个匹配的元素都包裹一次。

参数

elem              Element

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

示例

描述:

用一个生成的div将所有段落包裹起来

HTML 代码:

<p>Hello</p><p>cruel</p><p>World</p>

jQuery 代码:

$("p").wrapAll(document.createElement("div"));

结果:

<div><p>Hello</p><p>cruel</p><p>World</p></div>

 

 

wrapAll(html)                                                      返回值:jQuery

概述

将所有匹配的元素用单个元素包裹起来

这于 '.wrap()' 是不同的，'.wrap()'为每一个匹配的元素都包裹一次。这种包装对于在文档中插入额外的结构化标记最有用，而且它不会破坏原始文档的语义品质。这个函数的原理是检查提供的第一个元素并在它的代码结构中找到最上层的祖先元素－－这个祖先元素就是包装元素。

参数

html        String

TML标记代码字符串，用于动态生成元素并包装目标元素

示例

描述:

用一个生成的div将所有段落包裹起来

HTML 代码:

<p>Hello</p><p>cruel</p><p>World</p>

jQuery 代码:

$("p").wrapAll("<div></div>");

结果:

<div><p>Hello</p><p>cruel</p><p>World</p></div>

 

wrapInner(elem)                                            返回值:jQuery

概述

将每一个匹配的元素的子内容(包括文本节点)用DOM元素包裹起来

参数

elem              Element

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

示例

描述:

把所有段落内的每个子内容加粗

HTML 代码:

<p>Hello</p><p>cruel</p><p>World</p>

jQuery 代码:

$("p").wrapInner(document.createElement("b"));

结果:

<p><b>Hello</b></p><p><b>cruel</b></p><p><b>World</b></p>

 

wrapInner(fn)                                         返回值:jQuery

概述

将每一个匹配的元素的子内容(包括文本节点)用DOM元素包裹起来

参数

fn           Function

生成包裹结构的一个函数

示例

描述:

用原先div的内容作为新div的class，并将每一个元素包裹起来

HTML 代码:

<divclass="container">

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

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

</div>

jQuery 代码:

$('.inner').wrapInner(function(){

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

});

结果:

<divclass="container">

  <div class="inner">

    <divclass="Hello">Hello</div>

  </div>

  <div class="inner">

    <divclass="Goodbye">Goodbye</div>

  </div>

</div>

 

wrapInner(html)                                            返回值:jQuery

概述

将每一个匹配的元素的子内容(包括文本节点)用一个HTML结构包裹起来

这个函数的原理是检查提供的第一个元素（它是由所提供的HTML标记代码动态生成的），并在它的代码结构中找到最上层的祖先元素－－这个祖先元素就是包装元素。

参数

html        String

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

示例

描述:

把所有段落内的每个子内容加粗

HTML 代码:

<p>Hello</p><p>cruel</p><p>World</p>

jQuery 代码:

$("p").wrapInner("<b></b>");

结果:

<p><b>Hello</b></p><p><b>cruel</b></p><p><b>World</b></p>