jQuery UI API - .toggle()

所屬類(lèi)別

特效（Effects） | 特效核心（Effects Core） | 方法重載（Method Overrides） | 方法（Methods）

用法

描述：使用自定義效果來(lái)顯示或隱藏匹配的元素。

返回：jQuery

.toggle( effect [, options ] [, duration ] [, complete ] )

參數(shù) 類(lèi)型 描述 默認(rèn)值
effect String 一個(gè)字符串，指示要使用哪一種特效。
options Object 特效具體的設(shè)置和 easing。
duration Number 或 String 一個(gè)字符串或一個(gè)數(shù)字，指定動(dòng)畫(huà)將運(yùn)行多久。 400
complete Function() 一旦動(dòng)畫(huà)完成時(shí)要調(diào)用的函數(shù)。

.toggle( options )

參數(shù) 類(lèi)型 描述
options Object 所有的動(dòng)畫(huà)設(shè)置。唯一一個(gè)必需的屬性是 effect。
  • effect
    類(lèi)型：String
    描述：一個(gè)字符串，指示要使用哪一種特效。
  • easing（默認(rèn)值："swing"）
    類(lèi)型：String
    描述：一個(gè)字符串，指示要使用的 easing 函數(shù)。
  • duration（默認(rèn)值：400）
    類(lèi)型：Number 或 String
    描述：一個(gè)字符串或一個(gè)數(shù)字，指定動(dòng)畫(huà)將運(yùn)行多久。
  • complete
    類(lèi)型：Function()
    描述：一旦動(dòng)畫(huà)完成時(shí)要調(diào)用的函數(shù)。
  • queue（默認(rèn)值：true）
    類(lèi)型：Boolean 或 String
    描述：一個(gè)布爾值，指示是否將動(dòng)畫(huà)放在特效隊(duì)列中。如果是 false，動(dòng)畫(huà)將立即開(kāi)始。自 jQuery 1.7 起，queue 選項(xiàng)也接受一個(gè)字符串，在這種情況下，動(dòng)畫(huà)添加到由字符串表示的隊(duì)列中。

該插件擴(kuò)展自 jQuery 內(nèi)置的 .toggle() 方法。如果 jQuery UI 未加載，調(diào)用 .toggle() 方法不會(huì)直接失敗，因?yàn)樵摲椒ㄔ?jQuery 中存在。但是不會(huì)發(fā)生預(yù)期的行為。

實(shí)例

使用折疊特效（Fold Effect）切換一個(gè) div。

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>.toggle() 演示</title>
  <link rel="stylesheet"  rel="external nofollow" target="_blank" >
  <style>
  div {
    width: 100px;
    height: 100px;
    background: #ccc;
    border: 1px solid #000;
  }
  </style>
  <script src="http://code.jquery.com/jquery-1.10.2.js" rel="external nofollow" ></script>
  <script src="http://code.jquery.com/ui/1.10.4/jquery-ui.js" rel="external nofollow" ></script>
</head>
<body>
 
<button>切換 div</button>
<div></div>
 
<script>
$( "button" ).click(function() {
  $( "div" ).toggle( "fold", 1000 );
});
</script>
 
</body>
</html>

查看演示