detach()函数用于从文档中移除匹配的元素。
你还可以使用选择器进一步缩小移除的范围,只移除当前匹配元素中符合指定选择器的部分元素。
与remove()相比,detach()函数不会移除与元素关联绑定的附加数据( data()函数 )和事件处理器等(remove()会移除)。
该函数属于jQuery对象(实例)。
语法
jQueryObject.detach( [ selector ] )
参数
参数 描述
selector 可选/String类型指定的选择器字符串,用于筛选符合该选择器的元素。
如果没有指定selector参数,则移除当前匹配元素中的所有元素。
返回值
detach()函数的返回值为jQuery类型,返回当前jQuery对象本身。
示例&说明
detach()函数用于从文档中移除匹配的元素:
段落文本1item1line2
段落文本2item2line2
段落文本1
段落文本2
以下面这段HTML代码为例:[span#n2]
段落内容 [span#n6][span#n7]
以下jQuery示例代码用于演示detach()函数的具体用法:
var $n6 = $("#n6");
// 移除n6元素
$n6.detach( );
var $p = $("p");
// 移除带有类名"mark"的p元素
var $detachedP = $p.detach( ".mark" ); // $detachedP === $
// 将移除了的n6追加到body元素内的起始位置
// 虽然在前面n6已经从文档中被移除
// 但不会将其从jQuery对象中移除,因此我们还可以使用该jQuery对象,将n6再次放入文档中
$n6.prependTo( "body" );上述代码执行后的完整html代码如下(格式未作任何调整):
[span#n6][span#n7]段落内容
detach()函数会移除文档中匹配的元素,但不会将匹配元素从jQuery对象中移除,而且detach()会保留元素所关联的附加数据和绑定事件等。
请参考下面这段HTML代码:
接着,我们为所有的按钮注册点击事件,然后移除元素n3,再将移除的n3重新追加到n1内部的末尾位置:
var $n3 = $("#n3");
$n3.data("myX", "附加数据");
document.writeln( $n3.data("myX") ); // 附加数据
$n3.trigger("click"); // 弹出提示框信息:按钮2
// 移除元素n3
$n3.detach();
// 移除之后,仍然可以获取附加数据并触发点击事件
// document.writeln( $n3.data("myX") ); // 附加数据
// $n3.trigger("click"); // 弹出提示框信息:按钮2
// 将n3重新追加到n1内部的末尾
$n3.appendTo("#n1");
// 此时,n3的附加数据和绑定的点击事件仍然存在
document.writeln( $n3.data("myX") ); // 附加数据
$n3.trigger("click"); // 弹出提示框信息:按钮2









