.fadeOut()

分類：效果 > 淡出

.fadeOut( [duration ] [, complete ] )傳回：jQuery

說明：透過淡出至透明來隱藏符合的元素。

  • 新增版本：1.0.fadeOut( [duration ] [, complete ] )

    • duration (預設：400)
      類型：數字 或 字串
      決定動畫執行時間的字串或數字。
    • complete
      類型：函式()
      動畫完成後呼叫一次的函式，每個符合的元素呼叫一次。

  • 新增版本：1.0.fadeOut( options )

    • options
      類型：PlainObject
      傳遞給方法的其他選項的對應。
      • duration (預設：400)
        類型：數字 或 字串
        決定動畫執行時間的字串或數字。
      • easing (預設：swing)
        類型：字串
        表示要對轉場使用哪個緩動函式的字串。
      • queue (預設：true)
        類型：布林值 或 字串
        一個布林值，指出是否將動畫置於效果佇列中。如果為 false，動畫將立即開始。自 jQuery 1.7 起，佇列選項也可以接受字串，這種情況下，動畫會新增到該字串所代表的佇列中。當使用自訂佇列名稱時，動畫不會自動開始；您必須呼叫 .dequeue("queuename") 來開始它。
      • specialEasing
        類型：PlainObject
        一個物件，包含由 properties 參數定義的一個或多個 CSS 屬性，以及它們對應的緩動函數。（版本新增：1.4）
      • step
        類型：函數( 數字 now, Tween tween )
        一個函數，會針對每個動畫元素的每個動畫屬性呼叫。此函數提供一個機會來修改 Tween 物件，以在設定屬性值之前變更其值。
      • progress
        類型：函數( 承諾 animation, 數字 progress, 數字 remainingMs )
        一個函數，會在動畫的每個步驟後呼叫，每個動畫元素只呼叫一次，與動畫屬性的數量無關。（版本新增：1.8）
      • complete
        類型：函式()
        一個函數，會在元素上的動畫完成後呼叫一次。
      • start
        類型：函數( 承諾 animation )
        一個函數，會在元素上的動畫開始時呼叫。（版本新增：1.8）
      • done
        類型：函數( 承諾 animation, 布林值 jumpedToEnd )
        一個函數，會在元素上的動畫完成時呼叫（其承諾物件已解決）。（版本新增：1.8）
      • 失敗
        類型：函數( 承諾 animation, 布林值 jumpedToEnd )
        當元素的動畫無法完成時（其 Promise 物件遭到拒絕）要呼叫的函式。（新增版本：1.8）
      • 總是
        類型：函數( 承諾 animation, 布林值 jumpedToEnd )
        當元素的動畫完成或在未完成的情況下停止時（其 Promise 物件已解決或遭到拒絕）要呼叫的函式。（新增版本：1.8）

  • 新增版本：1.4.3.fadeOut( [duration ] [, easing ] [, complete ] )

    • duration (預設：400)
      類型：數字 或 字串
      決定動畫執行時間的字串或數字。
    • easing (預設：swing)
      類型：字串
      表示要對轉場使用哪個緩動函式的字串。
    • complete
      類型：函式()
      動畫完成後呼叫一次的函式，每個符合的元素呼叫一次。

.fadeOut() 方法會對符合條件的元素的不透明度進行動畫處理。一旦不透明度達到 0，display 樣式屬性就會設定為 none，因此元素不再影響頁面的配置。

持續時間以毫秒為單位；較高的值表示較慢的動畫，而不是較快的動畫。字串 '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" ).on( "click", function() {
  $( "#book" ).fadeOut( "slow", function() {
    // Animation complete.
  });
});
圖 1 - fadeOut() 效果的說明

注意：為了避免不必要的 DOM 處理，.fadeOut() 不會隱藏已經被視為隱藏的元素。有關 jQuery 視為隱藏的元素資訊，請參閱 ：隱藏選擇器。

緩動

自 jQuery 1.4.3 起，可以選擇使用命名緩動函式的字串。緩動函式會指定動畫在動畫中不同點的進行速度。jQuery 函式庫中唯一的緩動實作是預設的，稱為 swing，以及以恆定速度進行的 linear。可以使用外掛程式取得更多緩動函式，最著名的是 jQuery UI 套件。

回呼函數

如果提供，動畫完成後會觸發回呼。這對於將不同的動畫串聯在一起很有用。回呼不會傳送任何參數，但 this 會設定為正在播放動畫的 DOM 元素。如果有多個元素播放動畫，請務必注意，回呼會針對每個符合的元素執行一次，而不是針對整個動畫執行一次。

從 jQuery 1.6 開始，.promise() 方法可以與 deferred.done() 方法結合使用，以便在所有符合的元素完成動畫時為整個動畫執行單一回呼（請參閱 .promise() 的範例）。

其他注意事項

  • 所有 jQuery 效果，包括 .fadeOut()，都可以透過設定 jQuery.fx.off = true 來關閉，這會有效地將持續時間設定為 0。如需更多資訊，請參閱 jQuery.fx.off。

範例

播放所有段落的淡出動畫，在 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
 
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>fadeOut demo</title>
  <style>
  p {
    font-size: 150%;
    cursor: pointer;
  }
  </style>
  <script src="https://code.jquery.com/jquery-3.7.0.js"></script>
</head>
<body>
 
<p>
  If you click on this paragraph
  you'll see it just fade away.
</p>
 
<script>
$( "p" ).on( "click", function() {
  $( "p" ).fadeOut( "slow" );
});
</script>
 
</body>
</html>

示範

淡出您按一下的一個區段中的 span。

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
 
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>fadeOut demo</title>
  <style>
  span {
    cursor: pointer;
  }
  span.hilite {
    background: yellow;
  }
  div {
    display: inline;
    color: red;
  }
  </style>
  <script src="https://code.jquery.com/jquery-3.7.0.js"></script>
</head>
<body>
 
<h3>Find the modifiers - <div></div></h3>
<p>
  If you <span>really</span> want to go outside
  <span>in the cold</span> then make sure to wear
  your <span>warm</span> jacket given to you by
  your <span>favorite</span> teacher.
</p>
 
<script>
$( "span" ).on( "click", function() {
  $( this ).fadeOut( 1000, function() {
    $( "div" ).text( "'" + $( this ).text() + "' has faded!" );
    $( this ).remove();
  });
});
$( "span" ).hover(function() {
  $( this ).addClass( "hilite" );
}, function() {
  $( this ).removeClass( "hilite" );
});
</script>
 
</body>
</html>

示範

淡出兩個 div，一個使用「線性」緩動，另一個使用預設的「擺動」緩動。

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
 
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>fadeOut demo</title>
  <style>
  .box,
  button {
    float: left;
    margin: 5px 10px 5px 0;
  }
  .box {
    height: 80px;
    width: 80px;
    background: #090;
  }
  #log {
    clear: left;
  }
  </style>
  <script src="https://code.jquery.com/jquery-3.7.0.js"></script>
</head>
<body>
 
<button id="btn1">fade out</button>
<button id="btn2">show</button>
 
<div id="log"></div>
 
<div id="box1" class="box">linear</div>
<div id="box2" class="box">swing</div>
 
<script>
$( "#btn1" ).on( "click", function() {
  function complete() {
    $( "<div>" ).text( this.id ).appendTo( "#log" );
  }
  $( "#box1" ).fadeOut( 1600, "linear", complete );
  $( "#box2" ).fadeOut( 1600, complete );
});
 
$( "#btn2" ).on( "click", function() {
  $( "div" ).show();
  $( "#log" ).empty();
});
</script>
 
</body>
</html>

示範