网站推广.NET

网站推广.NET

jQuery.fadeIn() 函数实例用法详解

来源:互联网

fadein()函数用于显示所有匹配的元素,并带有淡入的过渡动画效果。

淡入的动画效果,即元素的不透明度的比例从0%逐渐增加到100%。

如果元素本身是可见的,则不对其作任何改变。如果元素是隐藏的,则使其可见。

与该函数相对的是fadeOut()函数,用于隐藏所有匹配的元素,并带有淡出的过渡动画效果。

该函数属于jQuery对象(实例)。

语法

jQuery 1.0 新增该函数。fadeIn()函数主要有以下两种形式的用法:

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

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

用法二:

jQueryObject.fadeIn( options )

用法二是用法一的变体。以对象形式指定所需的选项参数(可指定比用法一更多的选项参数)。

参数

参数描述

duration可选/String/Number类型指定过渡动画运行多长时间(毫秒数),默认值为400。该参数也可以为字符串"fast"(=200)或"slow"(=600)。

easing可选/String类型指定使用何种动画效果,默认为"swing",还可以设为"linear"或其他自定义的动画样式的函数名称。

complete可选/Function类型元素显示完毕后需要执行的函数。函数内的this指向当前DOM元素。

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

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

属性属性描述

duration参见参数duration。

easing参见参数easing。

complete参见参数complete。

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

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

返回值

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

示例&说明

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

CodePlayer

专注于编程开发技术分享

淡入的显示效果:

<select id="animation">    <option value="1">fadeIn( )</option>    <option value="2">fadeIn( "slow" )</option>    <option value="3">fadeIn( 3000 )</option>    <option value="4">fadeIn( 2000, complete )</option>    <option value="5">fadeIn( 1000, "linear" )</option>    <option value="6">fadeIn( options )</option></select><input id="btnFadeIn" type="button" value="显示" > <input id="btnHide" type="button" value="隐藏" >

以下是与fadeIn()函数相关的jQuery示例代码,以演示fadeIn()函数的具体用法:

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