.slideToggle()
.slideToggle( [ duration ], [ callback ] ) 返回: jQuery
描述: 用滑动动画显示或隐藏一个匹配元素。
-
version added: 1.0.slideToggle( [ duration ], [ callback ] )
duration一个字符串或者数字决定动画将运行多久。
callback在动画完成时执行的函数。
-
version added: 1.4.3.slideToggle( [ duration ], [ easing ], [ callback ] )
duration一个字符串或者数字决定动画将运行多久。
easing一个用来表示使用哪个缓冲函数来过渡的字符串。
callback在动画完成时执行的函数。
.slideToggle()
方法将给匹配元素的高度的动画,这会导致页面的下面部分滑下去或滑上来,看似透露或隐瞒的项目。display
属性将被储存并且需要的时候可以恢复。如果一个元素的display
值为inline
,然后是隐藏和显示,这个元素将再次显示inline
.。当一个隐藏动画后,高度值达到0的时候,display
样式属性被设置为none
,以确保该元素不再影响页面布局。
持续时间是以毫秒为单位的,数值越大,动画越慢,不是越快。字符串 'fast'
和 'slow'
分别代表200和600毫秒的延时。
如果提供回调函数参数,回调函数会在动画完成的时候调用。这个对于将不同的动画串联在一起按顺序排列是非常有用的。这个回调函数不设置任何参数,但是this
是存在动画的DOM元素,如果多个元素一起做动画效果,值得注意的是每执行一次回调匹配的元素,而不是作为一个整体的动画一次。
我们可以给任何元素做动画,比如一个简单的图片:
<div id="clickme"> Click here </div> <img id="book" src="book.png" alt="" width="100" height="123" />
We will cause .slideToggle()
to be called when another element is clicked:
$('#clickme').click(function() { $('#book').slideToggle('slow', function() { // Animation complete. }); });
随着最初显示的元素,我们可以在第一次点击的时候将其缓慢隐藏:
第二次单击将再次显示元素:
注意:
- 所有的jQuery效果,包括
.slideToggle()
,能使用jQuery.fx.off = true
关闭全局性。更多信息请查看jQuery.fx.off。
Examples:
Example: 所有段落动画向上或向下滑动,600毫秒内完成的动画。
<!DOCTYPE html>
<html>
<head>
<style>
p { width:400px; }
</style>
<script src="http://code.jquery.com/jquery-latest.min.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>
Demo:
Example: 进行动画的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.min.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>