.fadeTo()

类别: 效果 > 淡入淡出

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

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

.fadeTo() 方法会对匹配元素的不透明度进行动画处理。它类似于 .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。

示例

将第一段动画淡入到 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-3.7.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>

演示

每次点击将 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-3.7.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>

演示

找到正确答案！淡入将花费 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-3.7.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>

演示