您的浏览器过于古老 & 陈旧。为了更好的访问体验, 请 升级你的浏览器
Ready 发布于2014年09月06日 08:18

原创 jQuery.toggle() 函数详解

1364 次浏览 读完需要≈ 11 分钟

内容目录

toggle()函数用于切换所有匹配的元素。此外,你还可以指定元素切换的过渡动画效果。

所谓"切换",也就是如果元素当前是可见的,则将其隐藏;如果元素当前是隐藏的,则使其显示(可见)。

这里介绍的toggle()函数用于切换元素的显示/隐藏。jQuery还有一个同名的事件函数toggle(),用于绑定click事件并在触发时轮流切换执行不同的事件处理函数。

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

语法

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

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

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

用法二

jQueryObject.toggle( options )

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

用法三:jQuery 1.3 新增支持该用法。

jQueryObject.toggle( showOrHide )

通过布尔值showOrHide来指定是显示还是隐藏元素。

参数

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

如果没有为toggle()指定任何参数,则将以最快方式直接显示/隐藏元素,不使用动画效果。

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

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

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

返回值

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

示例&说明

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

<p>CodePlayer</p>
<p>专注于编程开发技术分享</p>
切换效果:
<select id="animation">
	<option value="1">toggle( )</option>
	<option value="2">toggle( "slow" )</option>
	<option value="3">toggle( 3000 )</option>
	<option value="4">toggle( 1000, complete )</option>
	<option value="5">toggle( 1000, "linear" )</option>
	<option value="6">toggle( options )</option>
	<option value="7">toggle( true )</option>
	<option value="8">toggle( false )</option>
</select>
<input id="btnSwitch" type="button" value="切换显示/隐藏" >

以下是与toggle()函数相关的jQuery示例代码,以演示toggle()函数的具体用法:

//【切换显示/隐藏】按钮
$("#btnSwitch").click( function(){
	var v = $("#animation").val();
	if( v == "1" ){
		$("p").toggle( );		
	}else if(v == "2"){
		$("p").toggle( "slow" );	
	}else if(v == "3"){
		$("p").toggle( 3000 );	
	}else if(v == "4"){
		$("p").toggle( 1000, function(){
			alert("切换完毕!");
		} );
	}else if(v == "5"){
		$("p").toggle( 1000, "linear" );	
	}else if(v == "6"){
		$("p").toggle( { duration: 1000 } );	
	}else if(v == "7"){
		$("p").toggle( true ); // 相当于$("p").show();	
	}else if(v == "8"){
		$("p").toggle( false );	 // 相当于$("p").hide();
	}
} );

运行代码

  • CodePlayer技术交流群1
  • CodePlayer技术交流群2

0 条评论

撰写评论

打开导航菜单