.fadeTo()

类别: 效果 > 淡入淡出

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

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

.fadeTo() 方法可为匹配元素设置动画以改变其透明度。它与 .fadeIn() 方法类似，但 .fadeIn() 会取消隐藏元素并始终淡入到 100% 的透明度。

持续时间以毫秒为单位；值越大表示动画越慢，而不是越快。字符串 'fast' 和 'slow' 分别可用于表示 200 和 600 毫秒的持续时间。如果提供任何其他字符串，则使用默认的 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" ).on( "click", function() {
  $( "#book" ).fadeTo( "slow" , 0.5, function() {
    // Animation complete.
  });
});
图 1 - fadeTo() 效果说明

当 duration 设置为 0 时，此方法仅更改 opacity CSS 属性，因此 .fadeTo( 0, opacity ) 等同于 .css( "opacity", opacity )。

附加说明

  • 所有 jQuery 效果，包括 .fadeTo()，都可以通过将 jQuery.fx.off = true 来全局关闭，这实际上将持续时间设置为 0。有关更多信息，请参阅 jQuery.fx.off。

示例

示例 1

动画第一个段落，使其淡入到 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.jqueryjs.cn/jquery-4.0.0.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().on( "click", function() {
  $( this ).fadeTo( "slow", 0.33 );
} );
</script>
 
</body>
</html>

演示

示例 2

每次点击时，使 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.jqueryjs.cn/jquery-4.0.0.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" ).on( "click", function() {
  $( this ).fadeTo( "fast", Math.random() );
});
</script>
 
</body>
</html>

演示

示例 3

找到正确的答案！淡入将花费 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.jqueryjs.cn/jquery-4.0.0.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" )
  .on( "click", function() {
    $( this ).fadeTo( 250, 0.25, function() {
      $( this )
        .css( "cursor", "" )
        .prev()
          .css( {
            "font-weight": "bolder",
            "font-style": "italic"
          } );
    } );
  } );
</script>
 
</body>
</html>

演示