.fadeToggle()
フェード処理での表示・非表示切り替え処理を行います。
.fadeToggle( [duration] [, easing] [, callback] ) 1.4.4追加
戻り値:jQuery
| 引数 | 説明 |
|---|---|
| [duration] | フェードするアニメーション時間を指定します。 |
| [easing] | アニメーションの変化の種類を指定します。 |
| [callback] | アニメーション完了後に実行したい関数を指定します。 |
.fadeToggle( [options] ) 1.4.4追加
戻り値:jQuery
| 引数 | 説明 |
|---|---|
| options |
型： メソッドに渡すオプションのマップになります。 |
解説
.fadeToggle()メソッドは、一致した要素のopacity(不透明度)をアニメーションします。
表示されている要素上でこのメソッドを呼び出してopacityが0に達すると、displayのstyleがnoneに設定されるため、
その要素がページのレイアウトに影響を与えなくなります。
durationへの数値はミリ秒として扱われ、高い値はアニメーションを遅くし、低い値はアニメーションを速めます。
文字列の'fast'と'slow'は、
それぞれ200と600ミリ秒のdurationとして扱われます。
他の文字列が指定された場合、またはdurationパラメーターが省略された場合、
デフォルトの400ミリ秒が使用されます。
イージング(easing)
jQuery 1.4.3からは、イージング(easing)関数の文字列を任意に指定できるようになりました。 イージング関数は、アニメーションの異なるポイントでの進行の速度を指定するものです。
jQueryライブラリで指定できるイージングは、デフォルトのswingと、
一定のペースで進行するlinearのみです。
より多くのイージング関数を使用するにはプラグインが必要で、
特に有名なのはjQuery UIになります。
コールバック関数
指定された場合、アニメーションが完了した際に実行されます。
これは、続けて異なるアニメーションを実行したい際に便利です。
このコールバックは引数を送りませんが、thisにはアニメーションされているDOM要素が設定されています。
もし、複数の要素がアニメーションされている場合、
コールバックは一致した要素ごとに実行されるのであり、アニメーションごとに実行されるわけでは無いことに注意しなければいけません。
jQuery 1.6からは.promise()メソッドを結合して、 deferred.done()メソッドで全ての一致している要素のアニメーションの完了時に、 単一のコールバックを実行することが可能になりました。(.promise()の例を参照)
アニメーションのOFF
-
.fadeToggle()を含む全てのjQueryのエフェクトは、jQuery.fx.off = trueにすることで実際にはdurationを0に設定することで、 グローバル全体でOFFにすることが可能です。 詳細は、jQuery.fx.offを参照してください。
デモ
1つ目のP要素はゆっくりフェードし、2つ目のP要素は素早くフェードし、完了後に"finished"を出力します。 それぞれのボタンのクリックで、フェードインとフェードアウトを交互に繰り返します。
<!DOCTYPE html>
<html>
<head>
<script src="http://code.jquery.com/jquery-latest.js"></script>
</head>
<body>
<button>fadeToggle p1</button>
<button>fadeToggle p2</button>
<p>このP要素はゆっくりフェードします。</p>
<p>このP要素は素早くフェードして、完了後"finished"を出力します。</p>
<div id="log"></div>
<script>
$("button:first").click(function() {
$("p:first").fadeToggle("slow", "linear");
});
$("button:last").click(function () {
$("p:last").fadeToggle("fast", function () {
$("#log").append("<div>finished</div>");
});
});
</script>
</body>
</html>
© 2010 - 2017 STUDIO KINGDOM