jQuery 效果 - toggle() 方法

实例

切换 <p> 元素的显示与隐藏状态:

  1. $(".btn1").click(function(){
  2. $("p").hide();
  3. });

定义和用法

toggle() 方法切换元素的可见状态。

如果被选元素可见,则隐藏这些元素,如果被选元素隐藏,则显示这些元素。

语法

  1. $(selector).toggle(speed,callback,switch)
参数 描述
speed 可选。规定元素从可见到隐藏的速度(或者相反)。默认为 "0"。 可能的值:
毫秒 (比如 1500)
"slow"
"normal"
"fast"
在设置速度的情况下,元素从可见到隐藏的过程中,会逐渐地改变其高度、宽度、外边距、内边距和透明度。 如果设置此参数,则无法使用 switch 参数。
callback 可选。toggle 函数执行完之后,要执行的函数。 如需学习更多有关 callback 的内容,请访问我们的 jQuery Callback 这一章。 除非设置了 speed 参数,否则不能设置该参数。
switch 可选。布尔值。规定 toggle 是否隐藏或显示所有被选元素。
True - 显示所有元素
False - 隐藏所有元素
如果设置此参数,则无法使用 speed 和 callback 参数。

提示和注释

注释:该效果适用于通过 jQuery 隐藏的元素,或在 CSS 中声明 display:none 的元素(但不适用于 visibility:hidden 的元素)。

实例

使用 speed 参数

使用 speed 参数来隐藏和显示元素。

  1. <html>
  2. <head>
  3. <script type="text/javascript" src="/jquery/jquery.js"></script>
  4. <script type="text/javascript">
  5. $(document).ready(function(){
  6. $(".btn1").click(function(){
  7. $("p").toggle(1000);
  8. });
  9. });
  10. </script>
  11. </head>
  12. <body>
  13. <p>This is a paragraph.</p>
  14. <button class="btn1">Toggle</button>
  15. </body>
  16. </html>

使用 switch 参数

使用 switch 参数来显示所有隐藏的段落。

  1. <html>
  2. <head>
  3. <script type="text/javascript" src="/jquery/jquery.js"></script>
  4. <script type="text/javascript">
  5. $(document).ready(function(){
  6. $(".btn1").click(function(){
  7. $("p").toggle(true);
  8. });
  9. });
  10. </script>
  11. </head>
  12. <body>
  13. <p>This is a paragraph.</p>
  14. <p style="display:none">This is another paragraph.</p>
  15. <p>把 switch 参数设置为 false,可以隐藏所有段落。</p>
  16. <button class="btn1">显示所有 p 元素</button>
  17. </body>
  18. </html>