jQuery.slideUp() 函數使用詳解

slideUp()函數用於隱藏所有符合的元素，並帶有向上滑動的過渡動畫效果。

向上滑動的動畫效果，即元素可見區域的高度從原有高度逐漸減少到0(向上逐漸收起)。

如果元素本身是隱藏的，則不對其做任何改變。如果元素是可見的，則將其隱藏。

與該函數相對的是slideDown()函數，用於顯示所有匹配的元素，並帶有向下滑動的過渡動畫效果。

該函數屬於jQuery物件(實例)。

語法

jQuery 1.0 新增此函數。 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")來啟動佇列。

此外，jQuery 1.4 和 1.8 也為參數options新增了許多新的選項支持，但這些參數並不常用，此處不再贅述，詳見jQuery官方文件。

傳回值

slideUp()函數的回傳值為jQuery類型，傳回目前jQuery物件本身。

範例&說明

請參考下面這段初始HTML程式碼：

CodePlayer

專注於程式開發技術分享

向上滑動的隱藏效果：

<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 } );   
    }
} );

以上是jQuery.slideUp() 函數使用詳解的詳細內容。更多資訊請關注PHP中文網其他相關文章！