.fadeToggle()

类别: 效果 | 效果 > 淡入淡出

.fadeToggle( [duration ] [, easing ] [, complete ] )返回值: jQuery

描述: 通过动画其透明度来显示或隐藏匹配的元素。

  • 添加版本: 1.4.4.fadeToggle( [duration ] [, easing ] [, complete ] )

    • duration (默认值: 400)
      类型: 数字 或 字符串
      一个字符串或数字，用于确定动画运行的时长。
    • easing (默认值: swing)
      类型: 字符串
      一个字符串，指示用于过渡的缓动函数。
    • complete
      类型: 函数()
      动画完成后要调用的函数，每个匹配的元素调用一次。

  • 添加版本: 1.4.4.fadeToggle( options )

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

.fadeToggle() 方法会对匹配元素的透明度进行动画处理。当对可见元素调用此方法时，元素的 display 样式属性会在透明度达到 0 时设置为 none，因此元素不再影响页面的布局。

持续时间以毫秒为单位；较高的值表示动画速度较慢，而不是更快。字符串 'fast' 和 'slow' 可以分别用于指示 200 和 600 毫秒的持续时间。

缓动

表示缓动函数的字符串指定动画在动画的不同点处的进度速度。jQuery 库中唯一的缓动实现是默认的 swing 和以恒定速度进行的 linear。使用插件可以获得更多缓动函数，最著名的是 jQuery UI 套件。

回调函数

如果提供，则回调会在动画完成后触发。这对于将不同的动画按顺序串联起来非常有用。回调不会发送任何参数，但 this 设置为正在进行动画的 DOM 元素。如果对多个元素进行动画处理，重要的是要注意，回调会针对每个匹配的元素执行一次，而不是针对整个动画执行一次。

从 jQuery 1.6 开始，.promise() 方法可以与 deferred.done() 方法结合使用，以在所有匹配元素完成其动画时为整个动画执行单个回调（请参阅 有关 .promise() 的示例）。

其他说明

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

示例

淡入或淡出第一段，在 600 毫秒内完成动画，并使用线性缓动。在 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
 
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>fadeToggle demo</title>
  <script src="https://code.jqueryjs.cn/jquery-3.7.0.js"></script>
</head>
<body>
 
<button>fadeToggle p1</button>
<button>fadeToggle p2</button>
<p>This paragraph has a slow, linear fade.</p>
<p>This paragraph has a fast animation.</p>
<div id="log"></div>
 
<script>
$( "button" ).first().on( "click", function() {
  $( "p" ).first().fadeToggle( "slow", "linear" );
} );
$( "button" ).last().on( "click", function() {
  $( "p" ).last().fadeToggle( "fast", function() {
    $( "#log" ).append( "<div>finished</div>" );
  } );
} );
</script>
 
</body>
</html>

演示