CodePlayer

fadeOut()函数用于隐藏所有匹配的元素，并带有淡出的过渡动画效果。

所谓"淡出"的动画效果，即元素的不透明度的比例从100%逐渐减小到0%。

如果元素本身是隐藏的，则不对其作任何改变。如果元素是可见的，则将其隐藏。

与该函数相对的是fadeIn()函数，用于显示所有匹配的元素，并带有淡入的过渡动画效果。

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

语法

jQuery 1.0 新增该函数。fadeOut()函数主要有以下两种形式的用法：

用法一：jQuery 1.4.3 新增支持参数easing。

jQueryObject.fadeOut( [ duration ] [, easing ] [, complete ] )

用法二：

jQueryObject.fadeOut( options )

用法二是用法一的变体。以对象形式指定所需的选项参数(可指定比用法一更多的选项参数)。

参数

参数options对象可以识别如下的属性(以下属性均是可选的)：

此外，jQuery 1.4 和 1.8 还为参数options新增了许多新的选项支持，但这些参数并不常用，此处不再赘述，详见jQuery官方文档。

返回值

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

示例&说明

请参考下面这段初始HTML代码：

<p>CodePlayer</p>
<p>专注于编程开发技术分享</p>
淡出的隐藏效果：
<select id="animation">
	<option value="1">fadeOut( )</option>
	<option value="2">fadeOut( "slow" )</option>
	<option value="3">fadeOut( 3000 )</option>
	<option value="4">fadeOut( 1000, complete )</option>
	<option value="5">fadeOut( 1000, "linear" )</option>
	<option value="6">fadeOut( options )</option>
</select>
<input id="btnShow" type="button" value="显示" />
<input id="btnFadeOut" type="button" value="隐藏" />

以下是与fadeOut()函数相关的jQuery示例代码，以演示fadeOut()函数的具体用法：

//【显示】按钮
$("#btnShow").click( function(){
	$("p").show( );
} );

//【隐藏】按钮
$("#btnFadeOut").click( function(){
	var v = $("#animation").val();
	if( v == "1" ){
		$("p").fadeOut( );		
	}else if(v == "2"){
		$("p").fadeOut( "slow" );	
	}else if(v == "3"){
		$("p").fadeOut( 3000 );	
	}else if(v == "4"){
		$("p").fadeOut( 2000, function(){
			alert("隐藏完毕!");
		} );	
	}else if(v == "5"){
		$("p").fadeOut( 1000, "linear" );	
	}else if(v == "6"){
		$("p").fadeOut( { duration: 1000 } );	
	}
} );

运行代码