fadeToggle()函數用於切換所有匹配的元素,並帶有淡入/淡出的過渡動畫效果。
所謂"切換",即如果元素目前是可見的,則將其隱藏(淡出);如果元素目前是隱藏的,則使其顯示(淡入)。
此函數屬於jQuery物件(實例)。
語法
jQuery 1.0 新增此函數。 fadeToggle()函數主要有以下兩種形式的用法:
用法一:jQuery 1.4.3 新增支援參數easing。
jQueryObject.fadeToggle( [ duration ] [, easing ] [, complete ] )
用法二:
jQueryObject.fadeToggle( 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官方文件。 ######傳回值######fadeToggle()###函數的回傳值###為jQuery類型,傳回目前jQuery物件本身。 ######範例&說明######請參考下面這段初始HTML程式碼:######e388a4556c0f65e1904146cc1a846beeCodePlayer94b3e26ee717c64999d7867364b1b4a3######e388a4556c0f65e1904146cc1a846bee專注於程式開發技術分享94b3e26ee717c64999d7867364b1b4a3######淡入淡出的切換效果:###<select id="animation"> <option value="1">fadeToggle( )</option> <option value="2">fadeToggle( "slow" )</option> <option value="3">fadeToggle( 3000 )</option> <option value="4">fadeToggle( 1000, complete )</option> <option value="5">fadeToggle( 1000, "linear" )</option> <option value="6">fadeToggle( options )</option> </select> <input id="btnFadeSwitch" type="button" value="切换显示/隐藏" >###以下是與fadeToggle()函數相關的jQuery範例程式碼,以示範fadeToggle()函數的具體用法:###
//【切换显示/隐藏】按钮 $("#btnFadeSwitch").click( function(){ var v = $("#animation").val(); if( v == "1" ){ $("p").fadeToggle( ); }else if(v == "2"){ $("p").fadeToggle( "slow" ); }else if(v == "3"){ $("p").fadeToggle( 3000 ); }else if(v == "4"){ $("p").fadeToggle( 1000, function(){ alert("切换完毕!"); } ); }else if(v == "5"){ $("p").fadeToggle( 1000, "linear" ); }else if(v == "6"){ $("p").fadeToggle( { duration: 1000 } ); } } );
以上是jQuery.fadeToggle() 函數使用詳解的詳細內容。更多資訊請關注PHP中文網其他相關文章!