概述 .slideToggle( [duration ] [, complete ] )
返回值:jQuery
描述:用滑动动画显示或隐藏一个匹配元素。
400
)
400
)
swing
)
true
)
.dequeue("queuename")
来启动它。
400
)
swing
)
.slideToggle()
方法将给匹配元素的高度的动画,这会导致页面中,在这个元素下面的内容往下或往上滑。display
属性值保存在jQuery的数据缓存中,所以display
可以方便以后可以恢复到其初始值。如果一个元素的display
属性值为inline
,然后是隐藏和显示,这个元素将再次显示inline
。当一个隐藏动画后,高度值达到0的时候,display
样式属性被设置为none
,以确保该元素不再影响页面布局。
持续时间是以毫秒为单位的,数值越大,动画越慢,不是越快。字符串 'fast'
和 'slow'
分别代表200
和600
毫秒的延时。
我们可以给任何元素做动画,比如一个简单的图片:
<div id="clickme">
Click here
</div>
<img id="book" src="book.png" alt="" width="100" height="123" />
当另一个元素被点击时,.slideToggle()
将被调用:
$('#clickme').click(function() {
$('#book').slideToggle('slow', function() {
// Animation complete.
});
});
从jQuery 1.4.3开始,一个可选的字符串类型的easing参数,用于确定使用的缓冲函数。缓动函数指定用于动画进行中在不同点位的速度。jQuery默认只提供两个缓冲效果:调用 swing
, 在一个恒定的速度进行;调用 linear
. 更多的缓动函数要使用的插件,最显着的是jQuery UI suite。
如果提供回调函数参数,callback
会在动画完成的时候调用。将不同的动画串联在一起按顺序排列执行是非常有用的。这个回调函数不设置任何参数,但是this
会设成将要执行动画的那个DOM元素,如果多个元素一起做动画效果,那么要非常注意,回调函数会在每一个元素执行完动画后都执行一次,而不是这组动画整体才执行一次。
从jQuery 1.6开始,.promise()
方法可以用来配合deferred.done()
方法一起使用,用于当所有匹配的元素执行完各自的动画后,再调用一个回调函数。
.slideToggle()
,都能通过设置jQuery.fx.off = true
全局的关闭,,效果等同于将动画持续时间(duration )参数设置成 0。更多信息查看 jQuery.fx.off
。
.slideDown()
被一个无序列表(<ul>
)调用并且<li>
元素有定位属性(position:relative, absolute, 或者 fixed),这个效果在IE6至IE9以下可能无法正常工作,为了解决这个问题,<ul>
需要触发"haslayout"。ul
元素上添加position: relative;
和zoom: 1;
CSS声明。
示例
让所有的段落滑上或滑下,用时 600 毫秒。
<!DOCTYPE html>
<html>
<head>
<style>
p { width:400px; }
</style>
<script src="http://code.jquery.com/jquery-latest.js"></script>
</head>
<body>
<button>Toggle</button>
<p>
This is the paragraph to end all paragraphs. You
should feel <em>lucky</em> to have seen such a paragraph in
your life. Congratulations!
</p>
<script>
$("button").click(function () {
$("p").slideToggle("slow");
});
</script>
</body>
</html>
让隔开的 div 交替出现或消失。
<!DOCTYPE html>
<html>
<head>
<style>
div { background:#b977d1; margin:3px; width:60px;
height:60px; float:left; }
div.still { background:#345; width:5px; }
div.hider { display:none; }
span { color:red; }
p { clear: left; }</style>
<script src="http://code.jquery.com/jquery-latest.js"></script>
</head>
<body>
<div></div>
<div class="still"></div>
<div style="display:none;">
</div><div class="still"></div>
<div></div>
<div class="still"></div>
<div class="hider"></div>
<div class="still"></div>
<div class="hider"></div>
<div class="still"></div>
<div></div>
<p><button id="aa">Toggle</button> There have been <span>0</span> toggled divs.</p>
<script>
$("#aa").click(function () {
$("div:not(.still)").slideToggle("slow", function () {
var n = parseInt($("span").text(), 10);
$("span").text(n + 1);
});
});
</script>
</body>
</html>