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();
}
} );
以上就是jquery.toggle() 函数用法实例详解的详细内容。