jQuery UI API - .toggle()
所属カテゴリ
エフェクト(Effects) | エフェクトコア(Effects Core) | メソッドオーバーライド(Method Overrides) | メソッド(Methods)
用法
説明:カスタムエフェクトを使用して、一致する要素を表示または非表示にします。
戻り値:jQuery
.toggle( effect [, options ] [, duration ] [, complete ] )
| パラメータ | 型 | 説明 | デフォルト値 |
|---|---|---|---|
| effect | String | 使用する種類を示す文字列エフェクト。 | |
| options | Object | エフェクトの具体的な設定とeasing。 | |
| duration | Number または String | アニメーションの実行時間を指定する文字列または数値。 | 400 |
| complete | Function() | アニメーションが完了したときに呼び出される関数。 |
.toggle( options )
| パラメータ | 型 | 説明 |
|---|---|---|
| options | Object | すべてのアニメーション設定。唯一必須のプロパティは effect です。
|
このプラグインは jQuery 組み込みの.toggle()メソッドを拡張したものです。jQuery UI が読み込まれていない場合、.toggle()メソッドを呼び出しても、そのメソッドは jQuery に存在するため直接失敗しません。ただし、期待される動作は発生しません。
例
折りたたみエフェクト(Fold Effect)を使用して div を切り替えます。
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>.toggle() 演示</title>
<link rel="stylesheet" href="//code.jquery.com/ui/1.10.4/themes/smoothness/jquery-ui.css">
<style>
div {
width: 100px;
height: 100px;
background: #ccc;
border: 1px solid #000;
}
</style>
<script src="//code.jquery.com/jquery-1.10.2.js"></script>
<script src="//code.jquery.com/ui/1.10.4/jquery-ui.js"></script>
</head>
<body>
<button>切换 div</button>
<div></div>
<script>
$( "button" ).click(function() {
$( "div" ).toggle( "fold", 1000 );
});
</script>
</body>
</html>
その他の拡張