您的浏览器过于古老 & 陈旧。为了更好的访问体验, 请 升级你的浏览器
Ready 发布于2014年08月31日 09:38

原创 jQuery.clone() 函数详解

1031 次浏览 读完需要≈ 7 分钟

内容目录

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

运行代码

  • CodePlayer技术交流群1
  • CodePlayer技术交流群2

0 条评论

撰写评论

打开导航菜单