返回值:jQueryfadeTo(duration, opacity, [callback])
调整匹配元素的透明度。
-
1.0 新增fadeTo(duration, opacity, [callback])
duration (String,Number) 字符串("slow"或 "fast")或表示动画时长的毫秒数值。opacity (Number) 0 到 1 之间的数字,表示将要达到的透明度。0 表示是完全透明。callback (Callback) 可选参数,在动画完成时执行的函数。 -
1.4.3 新增fadeTo(duration, opacity, [easing], [callback])
duration (String,Number) 字符串("slow"或 "fast")或表示动画时长的毫秒数值。opacity (Number) 0 到 1 之间的数字,表示将要达到的透明度。0 表示是完全透明。easing (String) 可选参数,要使用的缓冲效果的名称,默认值是 "swing"。jQuery 内置提供 "linear" 和 "swing" 两种效果,如果要使用更多缓冲效果,需要插件支持。callback (Callback) 可选参数,在动画完成时执行的函数。
.fadeTo()
方法对匹配元素的透明度生成动画效果。
duration 参数可以提供一个毫秒数,代表动画运行的时间,时间越长动画越慢。还可以提供字符串 'fast'
和 'slow'
,分别对应了 200
和 600
毫秒。如果没有设置 duration
参数,或者设置成其他无法识别的字符串,就会使用默认值 400 毫秒。
如果提供了回调函数,那么当动画结束时,会调用这个函数。通常用来按顺序执行一组不同的动画。这个函数不接受任何参数,但是 this
会设成将要执行动画的那个元素。如果对多个元素设置动画,那么要非常注意,回调函数会在每一个元素执行完动画后都执行一次,而不是这组动画整体才执行一次。
我们可以对任何元素应用动画,比如下面这个例子,对图片应用动画:
<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').click(function() { $('#book').fadeTo('slow', 0.5, function() { // Animation complete. }); });
如果 duration
参数设置成 0
,那么这个方法仅修改 opacity
的 CSS 属性。所以 .fadeTo(0, opacity)
等价于 .css('opacity', opacity)
。
补充说明:
- 所有的 jQuery 动画, 包括
.fadeTo()
, 都可以被关闭,通过全局设置jQuery.fx.off = true
, 效果等同于将动画时间 duration 设置成 0. 可以访问 jQuery.fx.off 来获得更多信息。 由于requestAnimationFrame()
特性的原因,绝对不要在setInterval
或setTimeout
方法中设置动画队列。 为了保护CPU资源, 支持requestAnimationFrame
的浏览器在当前窗口或标签失去焦点时,是不更新动画的。如果你通过setInterval
或setTimeout
方法在动画暂停时,持续向队列里添加动画,那么在窗口或标签重新获得焦点时,所有在队列中的动画都会被播放。 为了避免这个潜在的问题,可以在循环时,利用最后一个动画的回调函数,或者给元素添加.queue()
方法来避免这个问题,实现动画的继续播放。
示例:
把第一个段落的透明度渐变成 0.33 (33%,大约三分之一透明度), 用时 600 毫秒。
<!DOCTYPE html>
<html>
<head>
<script src="jquery.min.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").click(function () {
$(this).fadeTo("slow", 0.33);
});
</script>
</body>
</html>
演示:
示例:
每次点击后把 div 渐变成随机透明度,用时 200 毫秒。
<!DOCTYPE html>
<html>
<head>
<style>
p { width:80px; margin:0; padding:5px; }
div { width:40px; height:40px; position:absolute; }
div#one { top:0; left:0; background:#f00; }
div#two { top:20px; left:20px; background:#0f0; }
div#three { top:40px; left:40px; background:#00f; }
</style>
<script src="jquery.min.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").click(function () {
$(this).fadeTo("fast", Math.random());
});
</script>
</body>
</html>
演示:
示例:
找到正确答案!渐变耗时 250 毫秒,并且在完成后改变字体样式。
<!DOCTYPE html>
<html>
<head>
<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="jquery.min.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")
.click(function () {
$(this).fadeTo(250, 0.25, function () {
$(this).css("cursor", "")
.prev().css({"font-weight": "bolder",
"font-style": "italic"});
});
});
</script>
</body>
</html>