.slideDown()

.slideDown( [duration ] [, complete ] )返回类型:jQuery

描述:用一个滑动动画显示匹配的元素。

  • 增补版本:1.0.slideDown( [duration ] [, complete ] )

    • duration (默认值: 400)
      类型:Number or String
      一个字符串或数字,决定了动画将运行多长时间。
    • complete
      类型:Function()
      每当动画完成时要调用的函数,针对每个匹配的元素调用一次。
  • 增补版本:1.0.slideDown( options )

    • options
      类型:PlainObject
      要传递给此方法的额外选项的映射。
      • duration (默认值: 400)
        类型:Number or String
        一个字符串或数字,决定了动画将运行多长时间。
      • easing (默认值: swing)
        类型:String
        一个字符串,指示要对过渡所用的渐进函数。
      • queue (默认值: true)
        类型:Boolean or String
        一个布尔值,指示是否要把动画放到效果队列中。如果是false,它会立即开始。自从jQuery 1.7以来,队列选择也可以接受一个字符串,它导致动画可以添加到用字符串表示的队列中。如果队列名所用的动画还没有自动开始,你必须调用.dequeue("queuename")来启动它。
      • specialEasing
        类型:PlainObject
        一个对象,包含了一个或多个CSS属性,则属性参数和它们对应的渐进函数定义。 (增补版本:1.4)
      • step
        类型:Function( Number now, Tween tween )
        一个函数,针对每个变动的元素的每个变动属性调用此函数。此函数为修改补间对象提供了机会,以在设置属性值之前先修改此属性值。
      • progress
        类型:Function( Promise animation, Number progress, Number remainingMs )
        在动画的每一步骤后面要调用的函数,无论变动的属性的数目是多少,对每个变动的元素只执行一次。 (增补版本:1.8)
      • complete
        类型:Function()
        一个函数,每当动画在一个元素上结束时,就调用它一次。
      • start
        类型:Function( Promise animation )
        当动画在一个元素上开始时要调用的函数。 (增补版本:1.8)
      • done
        类型:Function( Promise animation, Boolean jumpedToEnd )
        当动画在一个元素上完成时要调用的函数(它的应答对象已被解决)。 (增补版本:1.8)
      • fail
        类型:Function( Promise animation, Boolean jumpedToEnd )
        当某个元素上的动画失败而完成了的时候(它的应答对象被拒绝了)要调用的函数。 (增补版本:1.8)
      • always
        类型:Function( Promise animation, Boolean jumpedToEnd )
        当某对象上的动画完成,或未完成就停止了的时候(它的应答对象要么被解决了要么被拒绝了)要调用的函数。 (增补版本:1.8)
  • 增补版本:1.4.3.slideDown( [duration ] [, easing ] [, complete ] )

    • duration (默认值: 400)
      类型:Number or String
      一个字符串或数字,决定了动画将运行多长时间。
    • easing (默认值: swing)
      类型:String
      一个字符串,指示要对过渡所用的渐进函数。
    • complete
      类型:Function()
      每当动画完成时要调用的函数,针对每个匹配的元素调用一次。

.slideDown()方法变动了匹配珠元素的高度。这导致网页下面部分向下滑动,为显露出来的项让路。

持续时间以毫秒数给出;更高的值指示更慢的动画,而不是更快的动画。字符串'fast''slow'分别指示持续时间200毫秒和600毫秒。如果提供了其它字符串,或者如果省略了duration参数,就用默认持续时间400毫秒。

我们可以变动任意元素,譬如变动一个图像:

1
2
3
4
<div id="clickme">
Click here
</div>
<img id="book" src="book.png" alt="" width="100" height="123">

元素最初是隐藏的,我们可以慢慢显露它:

1
2
3
4
5
$( "#clickme" ).click(function() {
$( "#book" ).slideDown( "slow", function() {
// Animation complete.
});
});
插图 1 - slideDown()效果的演示

渐进

自从jQuery 1.4.3以来,可以使用任何可选的字符串命名一个渐进函数。渐进函数指定了动画内部,在动画进程的不同点上的速率。jQuery库中仅有的渐进实现器是默认值,称为swing,以及以不变的速率前进的渐进实现器,称为linear。更多的渐进函数可以通过插件来实现,请注意jQuery UI套件

回调函数

如果提供了回调函数,它会在动画结束时引发一次。这可以用来把不同的动画串列在一个顺序中。回调函数不能发送任何参数,但是this被设置为被变动的DOM元素。如变动了多个元素,请注意回调函数是对每个匹配的元素执行一次,而不是针对整个动画执行一次。

自从jQuery 1.6以来.promise()方法可以用来与deferred.done()方法结合,以在所有匹配的元素完成它们的动画时,针对整个动画执行一个回调函数(请参阅example for .promise())。

补充说明:

  • 所有的jQuery效果,包括.slideDown()可以通过设置jQuery.fx.off = true来全局地关闭,它有效地将持续时间设置为0。欲进一步了解,请参阅jQuery.fx.off
  • 如果在一个无序列表(<ul>)上调用.slideDown(),而且它的<li>元素具有定位(相对的、绝对的、固定的定位),在IE6到IE9中此效果可能不能正确工作,除非<ul>具有“布局”。若要解决此问题,请对<ul>添加position: relative;zoom: 1; CSS声明。

示例:

变动所有的<div>向下滑,在600毫秒内显示它们。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
<!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毫秒内结束动画。一旦动画完成,输入控件的外观就会变化,尤其是中间那个输入控件得到了焦点。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
<!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>

演示: