返回值:jQueryfadeToggle([duration], [easing], [callback])

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

.fadeToggle() 方法对匹配元素的透明度生成动画效果。当透明度变成 0 之后，再把 display 样式属性设置成 none 以确保这个元素不再对页面布局产生影响。

duration 参数可以提供一个毫秒数，代表动画运行的时间，时间越长动画越慢。还可以提供字符串 'fast' 和 'slow' ，分别对应了 200 和 600 毫秒。如果没有设置 duration 参数，或者设置成其他无法识别的字符串，就会使用默认值 400 毫秒。

缓冲函数

缓冲函数确定了动画在不同位置的速度。jQuery默认只提供两个缓冲效果：swing（默认值） 和 线性缓冲效果linear。更多特效需要使用插件。可以访问 jQuery UI 网站 来获得更多信息。

回调函数

如果提供了回调函数，那么当动画结束时，会调用这个函数。通常用来按顺序执行一组不同的动画。这个函数不接受任何参数，但是 this 会设成将要执行动画的那个元素。如果对多个元素设置动画，那么要非常注意，回调函数会在每一个元素执行完动画后都执行一次，而不是这组动画整体才执行一次。

截止 jQuery 1.6, .promise() 方法可以和 deferred.done() 方法一起使用，用于当所有匹配的元素执行完各自的动画后，再调用一个回调函数。 ( 参见 .promise() 例子 )。

补充说明:

  • 所有的 jQuery 动画, 包括 .fadeToggle(), 都可以被关闭，通过全局设置 jQuery.fx.off = true, 效果等同于将动画时间 duration 设置成 0. 可以访问 jQuery.fx.off 来获得更多信息。

示例:

第一段落渐隐或渐显，用时 600 毫秒，并且是线性缓冲效果。而最后一个段落渐隐渐显用时 200 毫秒, 并且在每次动画完成后插入一个 "finished"。

<!DOCTYPE html>
<html>
<head>
<script src="jquery.min.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").click(function() {
  $("p:first").fadeToggle("slow", "linear");
});
$("button:last").click(function () {
  $("p:last").fadeToggle("fast", function () {
    $("#log").append("<div>finished</div>");
  });
});


</script>
</body>
</html>

演示: