jQuery.slideToggle() 函数使用详解

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元素。

options Object类型指定的选项参数对象。

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

属性 属性描述

duration 参见参数duration。

easing 参见参数easing。

complete 参见参数complete。

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

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

返回值

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

示例&说明

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

e388a4556c0f65e1904146cc1a846beeCodePlayer94b3e26ee717c64999d7867364b1b4a3

e388a4556c0f65e1904146cc1a846bee专注于编程开发技术分享94b3e26ee717c64999d7867364b1b4a3

滑动的切换效果：

8665051fbf0339e553446f638e54a41b

    22d7eb427e1a7079cd01008d37a3299cslideToggle( )4afa15d3069109ac30911f04c56f3338

    322198af320e7a8efa4225cf241d8ccfslideToggle( "slow" )4afa15d3069109ac30911f04c56f3338

    a688be232412df86bf3476f30a3e6aceslideToggle( 3000 )4afa15d3069109ac30911f04c56f3338

    356120105a7128f711831b9c623e6cdfslideToggle( 1000, complete )4afa15d3069109ac30911f04c56f3338

    b4f80bcf7196e7c9b35946ce9e6561f8slideToggle( 1000, "linear" )4afa15d3069109ac30911f04c56f3338

    ce69f43318a99cb57ef71c5a10e51afeslideToggle( options )4afa15d3069109ac30911f04c56f3338

18bb6ffaf0152bbe49cd8a3620346341

37646f68dcce08ffd3f39cf16ce5cec6

以下是与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 } );   
    }
} );

以上是jQuery.slideToggle() 函数使用详解的详细内容。更多信息请关注PHP中文网其他相关文章！