.fadeTo()

类别：效果 > 褪色

.fadeTo( duration, opacity [, complete ] )返回类型：jQuery

描述：调整匹配元素的不透明度。

.fadeTo()变动了匹配的元素的不透明度。它类似于.fadeIn()方法，但是那个方法匹配非隐藏元素，始终褪色到100%不透明度。

持续时间以毫秒数给出；更高的值指示更慢的动画，而不是更快的动画。字符串'fast'和'slow'分别指示持续时间200毫秒和600毫秒。如果提供了其它字符串，或者如果省略了duration参数，就用默认持续时间400毫秒。与其它效果方法不同的是，.fadeTo()需要明确指定duration。

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

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

1
2
3
4
5
6
7
8
9
10
 
<div id="clickme">
  Click here
</div>
<img id="book" src="book.png" alt="" width="100" height="123">
// With the element initially shown, we can dim it slowly:
$( "#clickme" ).click(function() {
  $( "#book" ).fadeTo( "slow" , 0.5, function() {
    // Animation complete.
  });
});
插图 1 - 演示fadeTo()的效果

将duration设置为0，此方法仅仅改变CSS属性opacity，所以.fadeTo( 0, opacity )等同于.css( "opacity", opacity )。

补充说明：

  • 所有的jQuery效果，包括.fadeTo()，可以通过全局地设置jQuery.fx.off = true来关闭，它有效地将持续时间设置为0。欲进一步了解，请参阅jQuery.fx.off。

示例：

变动第一个段落，把它褪色到不透明度为0.33（33%，三分之一可见性），在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
 
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>fadeTo demo</title>
  <script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
 
<p>
Click this paragraph to see it fade.
</p>
 
<p>
Compare to this one that won't fade.
</p>
 
<script>
$( "p:first" ).click(function() {
  $( this ).fadeTo( "slow", 0.33 );
});
</script>
 
</body>
</html>

演示：

每次点击，把<div>褪色到随机不透明度，在200毫秒内完成此动画。

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
 
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>fadeTo demo</title>
  <style>
  p {
    width: 80px;
    margin: 0;
    padding: 5px;
  }
  div {
    width: 40px;
    height: 40px;
    position: absolute;
  }
  #one {
    top: 0;
    left: 0;
    background: #f00;
  }
  #two {
    top: 20px;
    left: 20px;
    background: #0f0;
  }
  #three {
    top: 40px;
    left:40px;
    background:#00f;
  }
  </style>
  <script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
 
<p>And this is the library that John built...</p>
 
<div id="one"></div>
<div id="two"></div>
<div id="three"></div>
 
<script>
$( "div" ).click(function() {
  $( this ).fadeTo( "fast", Math.random() );
});
</script>
 
</body>
</html>

演示：

找到右边的答案。褪色将耗时250毫秒，当它完成时，改变各种样式。

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
53
54
55
56
57
58
59
60
61
62
63
64
 
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>fadeTo demo</title>
  <style>
  div, p {
    width: 80px;
    height: 40px;
    top: 0;
    margin: 0;
    position: absolute;
    padding-top: 8px;
  }
  p {
    background: #fcc;
    text-align: center;
  }
  div {
    background: blue;
  }
  </style>
  <script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
 
<p>Wrong</p>
<div></div>
<p>Wrong</p>
<div></div>
<p>Right!</p>
<div></div>
 
<script>
var getPos = function( n ) {
  return (Math.floor( n ) * 90) + "px";
};
$( "p" ).each(function( n ) {
  var r = Math.floor( Math.random() * 3 );
  var tmp = $( this ).text();
  $( this ).text( $( "p:eq(" + r + ")" ).text() );
  $( "p:eq(" + r + ")" ).text( tmp );
  $( this ).css( "left", getPos( n ) );
});
$( "div" )
  .each(function( n ) {
    $( this ).css( "left", getPos( n ) );
  })
  .css( "cursor", "pointer" )
  .click( function() {
    $( this ).fadeTo( 250, 0.25, function() {
      $( this )
        .css( "cursor", "" )
        .prev()
          .css({
            "font-weight": "bolder",
            "font-style": "italic"
          });
    });
  });
</script>
 
</body>
</html>

演示：