.toggle()

.toggle( [ duration ], [ callback ] ) 官网原E文: jQuery

描述: 显示或隐藏匹配元素。

  • version added: 1.0.toggle( [ duration ], [ callback ] )

    duration一个字符串或者数字决定动画将运行多久。

    callback在动画完成时执行的函数。

  • version added: 1.4.3.toggle( [ duration ], [ easing ], [ callback ] )

    duration一个字符串或者数字决定动画将运行多久。

    easing一个用来表示使用哪个缓冲函数来过渡的字符串。

    callback在动画完成时执行的函数。

  • version added: 1.3.toggle( showOrHide )

    showOrHide一个布尔值指示是否显示或隐藏的元素。

如果没有参数,.toggle()方法是最简单的方法来切换一个元素可见性:

$('.target').toggle();

通过改变CSS的display属性,匹配的元素将被立即显示或隐藏,没有动画。如果元素是最初显示,它会被隐藏,如果隐藏的,它会显示出来。display属性将被储存并且需要的时候可以恢复。如果一个元素的display值为inline,然后是隐藏和显示,这个元素将再次显示inline

当提供一个持续时间参数, .toggle()成为一个动画方法。.toggle()方法将为匹配元素的宽度,高度,以及不透明度,同时进行动画。当一个隐藏动画后,高度值达到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 .toggle() to be called when another element is clicked:

$('#clickme').click(function() {
  $('#book').toggle('slow', function() {
    // Animation complete.
  });
});

随着最初显示的元素,我们可以在第一次点击的时候将其缓慢隐藏:

第二次单击将再次显示元素:

该方法的第二个版本接受一个布尔参数。如果这个参数为true ,那么匹配的元素将显示;如果false ,元素是隐藏的。从本质上讲,语句:

$('#foo').toggle(showOrHide);

is equivalent to:

if (showOrHide) {
  $('#foo').show();
} else {
  $('#foo').hide();
}

Examples:

Example: Toggles all paragraphs.

<!DOCTYPE html>
<html>
<head>
  <script src="http://code.jquery.com/jquery-latest.min.js"></script>
</head>
<body>
  <button>Toggle</button>
<p>Hello</p>
<p style="display: none">Good Bye</p>
<script>

$("button").click(function () {
$("p").toggle();
});
</script>

</body>
</html>

Demo:

Example: Animates all paragraphs to be shown if they are hidden and hidden if they are visible, completing the animation within 600 milliseconds.

<!DOCTYPE html>
<html>
<head>
  <style>
p { background:#dad;
font-weight:bold;
font-size:16px; }
</style>
  <script src="http://code.jquery.com/jquery-latest.min.js"></script>
</head>
<body>
  <button>Toggle 'em</button>

<p>Hiya</p>
<p>Such interesting text, eh?</p>
<script>
$("button").click(function () {
$("p").toggle("slow");
});    
</script>

</body>
</html>

Demo:

Example: Shows all paragraphs, then hides them all, back and forth.

<!DOCTYPE html>
<html>
<head>
  <script src="http://code.jquery.com/jquery-latest.min.js"></script>
</head>
<body>
  <button>Toggle</button>
<p>Hello</p>
<p style="display: none">Good Bye</p>
<script>

var flip = 0;
$("button").click(function () {
$("p").toggle( flip++ % 2 == 0 );
});
</script>

</body>
</html>

Demo:

jQuery 1.6 API 中文版Clove整理、修订