CodePlayer

remove()函数用于从文档中移除匹配的元素。

你还可以使用选择器进一步缩小移除的范围，只移除当前匹配元素中符合指定选择器的部分元素。

与detach()相比，remove()函数会同时移除与元素关联绑定的附加数据( data()函数 )和事件处理器等(detach()会保留)。

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

语法

jQueryObject.remove( [ selector ] )

参数

如果没有指定selector参数，则移除当前匹配元素中的所有元素。

返回值

remove()函数的返回值为jQuery类型，返回当前jQuery对象本身。

示例&说明

remove()函数用于从文档中移除匹配的元素：

<p>段落文本1<span>item1<i>line2<i></span></p>
<p>段落文本2<span>item2<i>line2<i></span></p>

<!--以上是jQuery代码执行前的html内容-->
<script type="text/javascript">
$("span").remove( );
</script>
<!--以下是jQuery代码执行后的html内容-->

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

以下面这段HTML代码为例：

<p id="n1" class="mark">
	<span id="n2">[span#n2]</span>    
</p>
<p id="n3" class="mark">
	<label id="n4" class="move">[label#n4]</label>
</p>
<p id="n5">
	段落内容
	<span id="n6">[span#n6]<span id="n7">[span#n7]</span></span>	
</p>

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

var $n6 = $("#n6");
// 移除n6元素
$n6.remove( );

var $p = $("p");
// 移除带有类名"mark"的p元素
var $removedP = $p.remove( ".mark" ); // $removedP === $p


// 将移除了的n6追加到body元素内的起始位置
// 虽然在前面n6已经从文档中被移除
// 但不会将其从jQuery对象中移除，因此我们还可以使用该jQuery对象，将n6再次放入文档中
$n6.prependTo( "body" );

运行代码(其他代码请自行复制到演示页面运行)

上述代码执行后的完整html代码如下(格式未作任何调整)：

<span id="n6">[span#n6]<span id="n7">[span#n7]</span></span>


<p id="n5">
	段落内容
		
</p>

remove()函数会移除文档中匹配的元素，但不会将匹配元素从jQuery对象中移除，不过remove()只会保留元素本身，其他的诸如元素所关联的附加数据和绑定事件等都会被移除。

请参考下面这段HTML代码：

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

接着，我们为所有的按钮注册点击事件，然后移除元素n3，再将移除的n3重新追加到n1内部的末尾位置：

var $n3 = $("#n3");
$n3.data("myX", "附加数据");


document.writeln( $n3.data("myX") ); // 附加数据
$n3.trigger("click"); // 弹出提示框信息：按钮2

// 移除元素n3
$n3.remove();
// 将n3重新追加到n1内部的末尾
$n3.appendTo("#n1");

// 此时，n3的附加数据和绑定的点击事件都已被移除

document.writeln( $n3.data("myX") ); // undefined
$n3.trigger("click"); // 无任何事件响应

如果点击事件是直接在元素节点中以内联属性的形式注册的，则remove()无法移除这种形式的注册事件：

<input id="n3" type="button" value="按钮2" onclick="alert('无法移除该点击事件');" />