jQuery.fadeToggle() 函数详解 - CodePlayer

原创 jQuery.fadeToggle() 函数详解

4720 次浏览读完需要≈ 9 分钟

内容目录

语法
参数
返回值
示例&说明

fadeToggle()函数用于切换所有匹配的元素，并带有淡入/淡出的过渡动画效果。

所谓"切换"，即如果元素当前是可见的，则将其隐藏(淡出)；如果元素当前是隐藏的，则使其显示(淡入)。

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

语法

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

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

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

用法二：

jQueryObject.fadeToggle( options )

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

参数

参数	描述
duration	可选/String/Number类型指定过渡动画运行多长时间(毫秒数)，默认值为400。该参数也可以为字符串"fast"(=200)或"slow"(=600)。
easing	可选/String类型指定使用何种动画效果，默认为"swing"，还可以设为"linear"或其他自定义的动画样式的函数名称。
complete	可选/Function类型元素显示完毕后需要执行的函数。函数内的`this`指向当前DOM元素。
options	Object类型指定的选项参数对象。

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

属性	属性描述
duration	参见参数`duration`。
easing	参见参数`easing`。
complete	参见参数`complete`。
queue	Boolean类型指示是否将动画放入效果队列中，默认为`true`。从1.7版本开始，该参数可以为字符串，用于放入指定名称的效果队列。如果你指定的队列不会自动开始，你需要手动调用dequeue("queueName")来启动队列。

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

返回值

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

示例&说明

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

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

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

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

运行代码

CodePlayer 技术交流群1（已满）：
CodePlayer 技术交流群2：

原创 jQuery.fadeToggle() 函数详解

内容目录

语法

参数

返回值

示例&说明

0 条评论

撰写评论