fadeout()函数用于隐藏所有匹配的元素,并带有淡出的过渡动画效果。
所谓淡出的动画效果,即元素的不透明度的比例从100%逐渐减小到0%。
如果元素本身是隐藏的,则不对其作任何改变。如果元素是可见的,则将其隐藏。
与该函数相对的是fadein()函数,用于显示所有匹配的元素,并带有淡入的过渡动画效果。
该函数属于jquery对象(实例)。
语法
jquery 1.0 新增该函数。fadeout()函数主要有以下两种形式的用法:
用法一:jquery 1.4.3 新增支持参数easing。
jqueryobject.fadeout( [ duration ] [, easing ] [, complete ] )
用法二:
jqueryobject.fadeout( 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官方文档。
返回值
fadeout()函数的返回值为jquery类型,返回当前jquery对象本身。
示例&说明
请参考下面这段初始html代码:
e388a4556c0f65e1904146cc1a846beecodeplayer94b3e26ee717c64999d7867364b1b4a3
e388a4556c0f65e1904146cc1a846bee专注于编程开发技术分享94b3e26ee717c64999d7867364b1b4a3
淡出的隐藏效果:
<select id="animation">
<option value="1">fadeout( )</option>
<option value="2">fadeout( "slow" )</option>
<option value="3">fadeout( 3000 )</option>
<option value="4">fadeout( 1000, complete )</option>
<option value="5">fadeout( 1000, "linear" )</option>
<option value="6">fadeout( options )</option>
</select>
<input id="btnshow" type="button" value="显示" />
<input id="btnfadeout" type="button" value="隐藏" />
以下是与fadeout()函数相关的jquery示例代码,以演示fadeout()函数的具体用法:
//【显示】按钮
$("#btnshow").click( function(){
$("p").show( );
} );
//【隐藏】按钮
$("#btnfadeout").click( function(){
var v = $("#animation").val();
if( v == "1" ){
$("p").fadeout( );
}else if(v == "2"){
$("p").fadeout( "slow" );
}else if(v == "3"){
$("p").fadeout( 3000 );
}else if(v == "4"){
$("p").fadeout( 2000, function(){
alert("隐藏完毕!");
} );
}else if(v == "5"){
$("p").fadeout( 1000, "linear" );
}else if(v == "6"){
$("p").fadeout( { duration: 1000 } );
}
} );
以上就是jquery.fadeout() 函数实例用法详解的详细内容。