当前位置: 首页 > 中文手册 > jQuery.clone() 函数详解

jQuery.clone() 函数详解

clone()函数用于克隆当前匹配元素集合的一个副本,并以jQuery对象的形式返回。你也可以简单地理解为:克隆当前jQuery对象。

你还可以指定是否复制这些匹配元素(甚至它们的子元素)的附加数据( data()函数 )和绑定事件。

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

语法

jQueryObject.clone( withDataAndEvents [, deepWithDataAndEvents ] )

参数

参数描述
withDataAndEvents可选/Boolean类型是否同时复制元素的附加数据和绑定事件,默认为false
deepWithDataAndEvents可选/Boolean类型是否同时复制元素的所有子元素的附加数据和绑定事件,默认值即为参数withDataAndEvents的值。

clone()主要用于克隆当前jQuery对象的一个副本。

jQuery 1.5 新增支持:clone()支持第二个参数deepWithDataAndEvents。该参数指示是否同时复制被克隆元素的所有子元素的附加数据和绑定事件。

注意
1、在jQuery 1.4之前clone()函数只额外复制元素的绑定事件,从1.4版本开始,才开始支持复制元素的附加数据。

2、1.5.0版本时(只有1.5.0),参数withDataAndEvents的默认值被错误地设定为true,从1.5.1开始,其默认值才被改回false

返回值

clone()函数的返回值为jQuery类型,返回当前jQuery对象的一个克隆副本。

注意:出于性能原因考虑,clone()函数不会复制某些表单元素的动态,例如用户在<textarea>输入的内容、用户在<select>中选择的选项。不过<input>元素的动态将会被复制,例如用户在text中输入的内容、用户对checkbox的选中状态。

示例&说明

clone()函数用于克隆当前jQuery对象。请参考下面这段HTML代码为例:

<p id="n1">
	<input id="n2" type="button" value="按钮1" />
	<input id="n3" type="button" value="按钮2" />
</p>

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

// 当前jQuery版本:1.11.1

$(":button").click( function(){
	document.writeln( this.value );
} );
var $n2 = $("#n2");
$n2.data("myData", "附加数据");

//没有克隆附加数据和绑定事件
var $clonedN2 = $n2.clone(); // 两个参数均默认为false
document.writeln( $clonedN2.data("myData") ); // undefined
$clonedN2.trigger("click"); // (没有绑定的点击事件,无响应输出)

//同时克隆附加数据和绑定事件
var $clonedN2WithCopy = $n2.clone( true ); // 两个参数:true、true(第二个参数不设置,默认为第一个参数的值)
document.writeln( $clonedN2WithCopy.data("myData") ); // 附加数据
$clonedN2WithCopy.trigger("click"); // 按钮1

运行代码

52 8
我们认为: 用户的主要目的,是为了获取有用的信息,而不是来点击广告的。因此本站将竭力做好内容,并将广告和内容进行分离,确保所有广告不会影响到用户的正常阅读体验。用户仅凭个人意愿和兴趣爱好点击广告。
我们坚信:只有给用户带来价值,用户才会给我们以回报。
CodePlayer技术交流群1CodePlayer技术交流群1

帮朋友打一个硬广告:

P2P网贷系统(Java版本) 新年低价大促销,多年P2P技术积累,系统功能完善(可按需定制,可支持第三方存管、银行存管),架构稳定灵活、性能优异、二次开发快速简单。 另可提供二次开发、安装部署、售后维护、安全培训等一条龙服务。

外行看热闹,内行看门道。可以自信地认为,在系统设计上,比市面上的晓风、迪蒙、方维、绿麻雀、国融信、金和盛等P2P系统要好。
深圳地区支持自带技术人员现场考察源代码、了解主要技术架构,货比三家,再决定是否购买。

也可推荐他人购买,一旦完全成交,推荐人可获得实际售价 10% 的返现。
有意向者,详情请 点击这里 联系,工作时间立即回复。