slidetoggle()函数用于切换所有匹配的元素,并带有滑动的过渡动画效果。
所谓"切换",也就是如果元素当前是可见的,则将其隐藏(向上滑动);如果元素当前是隐藏的,则使其显示(向下滑动)。
该函数属于jQuery对象(实例)。
语法
jQuery 1.0 新增该函数。slideToggle()函数主要有以下两种形式的用法:
用法一:jQuery 1.4.3 新增支持参数easing。
jQueryObject.slideToggle( [ duration ] [, easing ] [, complete ] )
用法二:
jQueryObject.slideToggle( options )
用法二是用法一的变体。以对象形式指定所需的选项参数(可指定比用法一更多的选项参数)。
参数
参数描述
duration可选/String/Number类型指定过渡动画运行多长时间(毫秒数),默认值为400。该参数也可以为字符串"fast"(=200)或"slow"(=600)。
easing可选/String类型指定使用何种动画效果,默认为"swing",还可以设为"linear"或其他自定义的动画样式的函数名称。
complete可选/Function类型元素显示完毕后需要执行的函数。函数内的this指向当前DOM元素。
optionsObject类型指定的选项参数对象。
参数options对象可以识别如下的属性(以下属性均是可选的):
属性属性描述
duration参见参数duration。
easing参见参数easing。
complete参见参数complete。
queueBoolean类型指示是否将动画放入效果队列中,默认为true。从1.7版本开始,该参数可以为字符串,用于放入指定名称的效果队列。如果你指定的队列不会自动开始,你需要手动调用dequeue("queueName")来启动队列。
此外,jQuery 1.4 和 1.8 还为参数options新增了许多新的选项支持,但这些参数并不常用,此处不再赘述,详见jQuery官方文档。
返回值
slideToggle()函数的返回值为jQuery类型,返回当前jQuery对象本身。
示例&说明
请参考下面这段初始HTML代码:
CodePlayer
专注于编程开发技术分享
滑动的切换效果:
<select >select>
Switch" type="button" value="切换显示/隐藏" >
以下是与slideToggle()函数相关的jQuery示例代码,以演示slideToggle()函数的具体用法:
//【切换显示/隐藏】按钮$("#btnSlideSwitch").click( function(){ var v = $("#animation").val(); if( v == "1" ){ $("p").slideToggle( ); }else if(v == "2"){ $("p").slideToggle( "slow" ); }else if(v == "3"){ $("p").slideToggle( 3000 ); }else if(v == "4"){ $("p").slideToggle( 1000, function(){ alert("切换完毕!"); } ); }else if(v == "5"){ $("p").slideToggle( 1000, "linear" ); }else if(v == "6"){ $("p").slideToggle( { duration: 1000 } ); }} );