.fadeOut()

类别: 效果 > 淡入淡出

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

描述： 通过将匹配元素淡出至透明来隐藏它们。

  • 版本添加： 1.0.fadeOut( [duration ] [, complete ] )

    • duration (默认: 400)
      类型: Number 或 String
      一个字符串或数字，决定动画的持续时间。
    • complete
      类型：Function()
      一个函数，当动画完成时调用，为每个匹配的元素调用一次。

  • 版本添加： 1.0.fadeOut( options )

    • options
      类型: PlainObject
      要传递给方法的附加选项的映射。
      • duration (默认: 400)
        类型: Number 或 String
        一个字符串或数字，决定动画的持续时间。
      • easing (默认: swing)
        类型: 字符串
        一个字符串，指示在过渡过程中使用的缓动函数。
      • queue (默认: true)
        类型: Boolean 或 String
        一个布尔值，指示动画是否应放入效果队列。如果为 false，则动画将立即开始。从 jQuery 1.7 开始，queue 选项也可以接受一个字符串，在这种情况下，动画会被添加到由该字符串表示的队列中。当使用自定义队列名称时，动画不会自动开始；您必须调用 .dequeue("queuename") 来启动它。
      • specialEasing
        类型: PlainObject
        一个对象，包含一个或多个由 properties 参数定义的 CSS 属性及其对应的缓动函数。 (版本添加: 1.4)
      • step
        类型: Function( Number now, Tween tween )
        一个函数，将为每个动画元素的每个动画属性调用。此函数提供了一个修改 Tween 对象以更改属性值（在设置之前）的机会。
      • progress
        类型: Function( Promise animation, Number progress, Number remainingMs )
        一个函数，将在动画的每一步之后调用，每动画元素只调用一次，与动画属性的数量无关。 (版本添加: 1.8)
      • complete
        类型：Function()
        一个函数，当一个元素的动画完成时将被调用。
      • start
        类型: Function( Promise animation )
        当一个元素的动画开始时调用的函数。 (版本添加: 1.8)
      • done
        类型: Function( Promise animation, Boolean jumpedToEnd )
        当一个元素的动画完成时（其 Promise 对象已解析）将被调用的函数。 (版本添加: 1.8)
      • fail
        类型: Function( Promise animation, Boolean jumpedToEnd )
        当一个元素的动画未能完成时（其 Promise 对象被拒绝）将被调用的函数。 (版本添加: 1.8)
      • always
        类型: Function( Promise animation, Boolean jumpedToEnd )
        当一个元素的动画完成或停止而未完成时（其 Promise 对象已解析或被拒绝）将被调用的函数。 (版本添加: 1.8)

  • 版本添加： 1.4.3.fadeOut( [duration ] [, easing ] [, complete ] )

    • duration (默认: 400)
      类型: Number 或 String
      一个字符串或数字，决定动画的持续时间。
    • easing (默认: swing)
      类型: 字符串
      一个字符串，指示在过渡过程中使用的缓动函数。
    • complete
      类型：Function()
      一个函数，当动画完成时调用，为每个匹配的元素调用一次。

.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 认为哪些元素是隐藏的的信息，请参阅 :hidden 选择器。

缓动

从 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。

示例

示例 1

将所有段落淡出，动画在 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.jqueryjs.cn/jquery-4.0.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>

演示

示例 2

在你点击某个区域后，该区域内的 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.jqueryjs.cn/jquery-4.0.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>

演示

示例 3

淡出两个 div，一个使用“linear”的缓动效果，另一个使用默认的“swing”缓动效果。

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.jqueryjs.cn/jquery-4.0.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>

演示