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()函数不会复制某些表单元素的动态，例如用户在4750256ae76b6b9d804861d8f69e79d3输入的内容、用户在221f08282418e2996498697df914ce4e中选择的选项。不过d5fd7aea971a85678ba271703566ebfd元素的动态将会被复制，例如用户在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

Atas ialah kandungan terperinci jQuery.clone() 函数实例详解. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!