.slideDown()
.slideDown( [duration ] [, complete ] )
描述:用滑移动作显示匹配的元素。
- duration (默认值:
400
)一个字符串或数字,用来确定动画运行多长时间。 - complete类型:Function()一个函数,在动画一旦结束时调用它,对每个匹配的元素调用一次。
- options类型:PlainObject传递给该方法的一个额外选项的映射。
- duration (默认值:
400
)一个字符串或数字,用来确定动画运行多长时间。 - easing (默认值:
swing
)类型:String一个字符串,标明为过渡使用哪种缓动函数。 - queue (默认值:
true
)一个布尔值,标明是否要把动画放到效果队列中。如果是false,动画将立即开始。自从jQuery 1.7,queue选项可以接受一个字符串,那样的话,动画将加到以那个字符串代表的队列中。如果使用了一个自定义队列名,动画不会自动开始;你必须调用.dequeue("queuename")
来启动它。 - specialEasing类型:PlainObject一个对象,包含了一个或更多的用属性参数和它们对应的缓动函数定义的CSS属性。(加入于1.4)
- step一个函数,每个变动的元素的每个变动的CSS属性都会调用它。这个函数提供了一个改变Tween对象的机会,可以在该属性被设置之前改变该属性的值。
- progress一个函数,在每个动画阶结束时调用它,只对每个变动的元素调用一次,无论有多少个变动的属性。(加入于1.8)
- complete类型:Function()一个函数,在动画一旦结束时调用它。
- start一个函数,每个元素上的动画开始时都会调用它一次。(加入于1.8)
- done一个函数,每个元素上的动画结束时都会调用它一次(它的Promise对象被解决了)。(加入于1.8)
- fail一个函数,每个元素上的动画结束时都会调用它一次(它的Promise对象被拒绝了)。(加入于1.8)
- always一个函数,在某个元素上的动画,或者在没结束时停止的时候(该元素的Promise对象要么是被解决要么是被拒绝)调用它。(加入于1.8)
.slideDown()
方法变动了匹配元素的高度。这会导致页面的下面部分滑下去,显露出的项目。
持续时间用毫秒数指定;更大的数字表示更慢的动画,而不是更快的动画。字符串'fast'
表示200
毫秒的持续时间,'slow'
表示800
毫秒的持续时间。如果提供了别的字符串,或者如果省略了duration
参数,就会使用duration的默认值400
毫秒。
我们可以变动任何元素,比如说一个图像:
<div id="clickme"> Click here </div> <img id="book" src="book.png" alt="" width="100" height="123">
先隐藏掉元素,我们可以慢慢显示它:
$( "#clickme" ).click(function() { $( "#book" ).slideDown( "slow", function() { // 动画完成。 }); });
缓动
自从jQuery 1.4.3,可以使用一个可选的字符串,它命名了一个缓动函数。缓动函数指定了在动画过程内不同的时点上动画推进的速度。在jQuery库内只有两个缓动实现器,一个是默认情况下,称为swing
,另一个是以恒定的节奏推进,称为linear
。更多的缓动函数要用插件才能使用,特别是使用jQuery UI suite插件。
回调函数
如果提供了,一旦动画结束时,会引发回调函数。这可以用来将不同的动画串成一个事件序列。回调函数并不发送任何参数,但是this
被设置为执行动画的DOM元素。如果变动了多个元素,需要注意:回调函数会在每个匹配的元素上各执行一次,不是针对整个动画执行一次。
自从jQuery 1.6,.promise()
方法可以与deferred.done()
方法配合使用,以当所有的匹配元素都结束它们的动画时,对动画的整体执行一个回调函数(参见example for .promise())。
其它说明
- 所有的动画效果,包括
.slideDown()
可以全局性地关闭,只要设置jQuery.fx.off=true
,它会有效地把duration设置为0。要了解更多关于它的信息,参见jQuery.fx.off。 - 如果在一个无序列表(
<ul>
)上调用.slideDown()
,而且它的<li>
元素有定位(position:relative
、position:absolute
或者position:fixed
),在IE6、IE7、IE8、IE9中,效果可能不起作用,除非<ul>
具有“布局”。为了解决这个问题,请给<ul>添加CSS声明position: relative; zoom: 1;
。
示例
变动所有的div,让它们向下滑移,在600毫秒内结束动画。
<!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <title>slideDown demo</title> <style> div { background: #de9a44; margin: 3px; width: 80px; height: 40px; display: none; float: left; } </style> <script src="https://code.jquery.com/jquery-1.10.2.js"></script> </head> <body> Click me! <div></div> <div></div> <div></div> <script> $( document.body ).click(function () { if ( $( "div:first" ).is( ":hidden" ) ) { $( "div" ).slideDown( "slow" ); } else { $( "div" ).hide(); } }); </script> </body> </html>
演示结果
变动所有的输入框让它向下滑移,在1000毫秒内结束动画。一旦动画完成时,输入框看起来有变化,特是如果中间的输入框得到了焦点的话。
<!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <title>slideDown demo</title> <style> div { background: #cfd; margin: 3px; width: 50px; text-align: center; float: left; cursor: pointer; border: 2px outset black; font-weight: bolder; } input { display: none; width: 120px; float: left; margin: 10px; } </style> <script src="https://code.jquery.com/jquery-1.10.2.js"></script> </head> <body> <div>Push!</div> <input type="text"> <input type="text" class="middle"> <input type="text"> <script> $( "div" ).click(function() { $( this ).css({ borderStyle: "inset", cursor: "wait" }); $( "input" ).slideDown( 1000, function() { $( this ) .css( "border", "2px red inset" ) .filter( ".middle" ) .css( "background", "yellow" ) .focus(); $( "div" ).css( "visibility", "hidden" ); }); }); </script> </body> </html>
演示结果