.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.jquery.com/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.jquery.com/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.jquery.com/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>

示範