【jQuery】slideUp()和slideDown()函数

slideUp()

• slideUp()函数用于隐藏所有匹配的元素，并带有向上滑动的过渡动画效果。
• 向上滑动的动画效果，即元素可见区域的高度从原有高度逐渐减小到0(向上逐渐收起)。
• 如果元素本身是隐藏的，则不对其作任何改变。如果元素是可见的，则将其隐藏。
• 与该函数相对的是slideDown()函数，用于显示所有匹配的元素，并带有向下滑动的过渡动画效果。

语法

slideUp()函数主要有以下两种形式的用法：

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

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

用法二：

jQueryObject.slideUp( 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”)来启动队列。

返回值

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

示例&说明

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

<p>CodePlayer</p>
<p>专注于编程开发技术分享</p>
向上滑动的隐藏效果：
<select id="animation">
    <option value="1">slideUp( )</option>
    <option value="2">slideUp( "slow" )</option>
    <option value="3">slideUp( 3000 )</option>
    <option value="4">slideUp( 1000, complete )</option>
    <option value="5">slideUp( 1000, "linear" )</option>
    <option value="6">slideUp( options )</option>
</select>
<input id="btnShow" type="button" value="显示" />
<input id="btnSlideUp" type="button" value="隐藏" />

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

//【显示】按钮
$("#btnShow").click( function(){
    $("p").show( );
} );

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