jquery之wrap(),wrap(),unwrap()方法详解

【注】wrap():为每个匹配元素外面添加指定的HTML结构,

  wrapAll(): 为所有匹配元素(作为一个整体)外面添加一个指定的HTML结构

原文地址:http://www.365mini.com/page/jquery-wrap.htm

wrap()函数用于在每个匹配元素外部包裹指定的HTML结构

与该函数相对的是unwrap()函数,用于当前匹配元素的父元素(只移除父元素,其内部节点全部保留)。

该函数属于jQuery对象(实例)。

语法

jQueryObject.wrap( wrapper )

参数

参数 描述
wrapper String/Element/jQuery/Function类型用于包裹匹配元素的节点。

如果参数wrapper为字符串,则将其视作jQuery选择器或html字符串,jQuery会自行判断。

jQuery 1.4 新增支持:参数wrapper可以为函数。wrap()将根据匹配的所有元素遍历执行该函数,函数中的this将指向对应的DOM元素。

wrap()还会为函数传入一个参数,即当前元素在匹配元素中的索引。函数的返回值就是用于包裹的节点内容(可以是html字符串、DOM元素或jQuery对象)。

注意:如果wrapper匹配多个元素,则只将第一个元素作为包裹元素。

注意:如果wrapper是多层嵌套的元素(例如<p><i></i></p>),wrap()将从外往内检查每层嵌套的第一个节点。如果该节点没有子节点或者第一个子节点不是Element节点(比如文本节点、注释节点等),就停止向内查找,直接在当前节点内部的末尾位置追加(append())当前匹配元素。

返回值

wrap()函数的返回值为jQuery类型,返回当前jQuery对象本身(以便于进行链式风格的编程)。

注意:即使wrapper元素是当前页面中的元素,该元素也不会从原位置上消失。因为wrap()使用的是该元素的副本(克隆)来充当包裹。

示例&说明

wrap()函数用于在每个匹配元素之前的位置插入内容:

<p>段落文本1<span></span></p><p>段落文本2<span></span></p>

<script type="text/javascript">$("p").wrap( ‘<div></div>‘ ); </script>

<!--以下是jQuery代码执行后的html内容--><div><p>段落文本1<span></span></p></div><div><p>段落文本2<span></span></p></div>

以下面这段HTML代码为例:

<p id="n1">    <span id="n2">span#n2</span>    </p><p id="n3">    <input id="n4" type="text" /></p><span id="n5">多层嵌套1</span><span id="n6">多层嵌套2</span>

以下jQuery示例代码用于演示wrap()函数的具体用法:

// 在n2元素外包裹strong元素:<strong>{#n2}</strong>$("#n2").wrap(‘<strong/>‘);

// 在n4元素外包裹form元素:<form name="myForm">{#n4}</form>$("#n4").wrap(‘<form name="myForm"></form>‘);

// 在每个p元素外包裹div元素:<div data_id="index">{p}</div>$("p").wrap( function(index){    return ‘<div data_id="‘ + index + ‘"></div>‘;   } );

// 在n5元素外包裹嵌套的div元素:<div><p><em><b>{#n5}</b></em></p></div>$("#n5").wrap( ‘<div><p><em><b></b></em></p></div>‘ );

// 在n6元素外包裹嵌套的div元素:<div><p> <em><b></b></em>${#n5}</p></div>// wrap()会从外层div依次往内部查找,以确定n5元素的所在位置// wrap()将从外往内检查每层嵌套的第一个元素,如果该元素没有子元素或者第一个子元素不是Element节点,就停止向内查找// 由于参数的‘<p>‘后面有空格(文本节点),也就是说p元素的第一个子元素不是Element类型,因此直接将n6插入到p元素内部的末尾位置$("#n6").wrap( ‘<div><p> <em><b></b></em></p></div>‘ );

运行代码

wrap()会将包裹元素的开始标记和结束标记分别置于匹配元素的两侧,不会额外添加任何空白字符,上述代码执行后的完整html代码如下(格式未作任何调整):

<div data_id="0"><p id="n1">    <strong><span id="n2">span#n2</span></strong>    </p></div><div data_id="1"><p id="n3">    <form name="myForm"><input id="n4" type="text"></form></p></div><div><p><em><b><span id="n5">多层嵌套1</span></b></em></p></div><div><p> <em><b></b></em><span id="n6">多层嵌套2</span></p></div>
时间: 2025-01-04 23:38:33

jquery之wrap(),wrap(),unwrap()方法详解的相关文章

jQuery Ajax实例各种使用方法详解

在jquery中ajax实现方法分类很多种,如有:load.jQuery.get.jQuery.post.jQuery.getScript.jQuery Ajax 事件.jQuery.ajaxSetup等等,前面几种为常用的也是用得最多的jquery ajax方法了,我下面给大家来详细介绍这里ajax实现方法.  jQuery.get( url, [data], [callback] ):使用GET方式来进行异步请求 这是一个简单的 GET 请求功能以取代复杂 $.ajax .请求成功时可调用回

缓冲加载图片的 jQuery 插件 lazyload.js 使用方法详解

在写代码的时候,经常会用到懒加载的模式,以前是通过window.onload的模式去加载,但是图片很多或者用ajax请求的时候,就会很麻烦,现在用lazyload的模式加载方便很多 <!doctype html> <html> <head> <meta charset="utf-8"> <title>Lazy Load Enabled</title> <!--[if lt IE 9]> <scri

jQuery.extend()、jQuery.fn.extend()扩展方法详解

jQuery自定义了jQuery.extend()和jQuery.fn.extend()方法.其中jQuery.extend()方法能够创建全局函数或者选择器,而jQuery.fn.extend()方法能够创建jQuery对象方法. 例如: jQuery.extend({ showName : function(name){ alert(name) } }); jQuery.showName("深蓝"); jQuery.extend()除了可以创建插件外,还可以用来扩展jQuery对象

jQuery插件制作方法详解

jQuery插件制作方法详解 jquery插件给我的感觉清一色的清洁,简单.如Jtip,要使用它的功能,只需要在你的元素的class上加 上Jtip,并引入jtip.js及其样式即可以了.其他事情插件全包.我喜欢jquery的一个重要原因是发现她已经有了很多很好,很精彩的插件.写一 个自己的jQuery插件是非常容易的,如果你按照下面的原则来做,可以让其他人也容易地结合使用你的插件. jquery插件给我的感觉清一色的清洁,简单.如Jtip,要使用它的功能,只需要在你的元素的class上加上Jt

Jquery遍历筛选数组的几种方法和遍历解析json对象|Map()方法详解

一.Jquery遍历筛选数组 1.jquery grep()筛选遍历数组 $().ready( function(){ var array = [1,2,3,4,5,6,7,8,9]; var filterarray = $.grep(array,function(value){ return value > 5;//筛选出大于5的 }); for(var i=0;i<filterarray.length;i++){ alert(filterarray[i]); } for (key in f

JqGrid 使用方法详解

JQGrid JQGrid是一个在jquery基础上做的一个表格控件,以ajax的方式和服务器端通信. JQGrid Demo 是一个在线的演示项目.在这里,可以知道jqgrid可以做什么事情. 下面是转自其他人blog的一个学习资料,与其说是学习资料,说成查询帮助文档更加合适. jqGrid学习之 ------------- 安装 jqGrid安装很简单,只需把相应的css.js文件加入到页面中即可. 按照官网文档: /myproject/css/ ui.jqgrid.css         

jQuery上传插件Uploadify使用详解(转发原作者冯威)

jQuery上传插件Uploadify使用详解 本文Uploadify版本为2.1.0,已经过时,截止(2016-09-25)最新版本3.2.1的详细介绍请移步<jQuery上传插件Uploadify使用详解(3.2.1)> Uploadify是jQuery的一个上传插件,实现的效果非常不错,带进度显示.不过官方提供的实例时php版本的,本文将详细介绍Uploadify在Aspnet中的使用,您也可以点击下面的链接进行演示或下载. 官方下载 官方文档 官方演示 首先按下面的步骤来实现一个简单的

JQuery上传插件Uploadify使用详解及错误处理

转自:http://www.jb51.net/article/43498.htm 关于JQuery上传插件Uploadify使用详解网上一大把,基本上内容都一样.我根据网上的步骤配置完成后,会报一些错误,而我根据这些错误去网上找解决方案,却没有相关资料,所以为了不让更多的朋友走弯路,我把我遇到的一些问题进行汇总,也方便我自己以后查阅. 什么是Uploadify Uploadify是JQuery的一个上传插件,支持多文件上传,实现的效果非常不错,带进度显示. 官网提供的是PHP的DEMO,在这里我

jQuery上传插件Uploadify使用详解(3.2.1)(转载)

jQuery上传插件Uploadify使用详解(3.2.1) Sep 25, 2016 | JQuery | 10733 Hits 六年前,因为工作中使用到 jQuery 的上传组件 Uploadify ,写了一篇<JQuery上传插件Uploadify使用详解>的博客来介绍 Uploadify ,其实只是将官方文档简单翻译了下.几年下来居然有50多万的访问量,而且每天通过各种搜索引擎有大几百的朋友会访问到这篇文章.六年时间 Uploadify 从当时的2.1.0到了现在的3.2.1,变化还是