toggle( duration, easing, callback )

jQuery API の toggle( duration, easing, callback ) は、duration に指定した速度で、easing に指定したイージング関数名のアニメーションで、指定した要素の表示・非表示を切り替え、その後、callback に指定した関数を実行するメソッド。

記述方法

「セレクター」の要素が非表示の場合、「セレクター」の要素を、「速度」に指定した速度の「イージング関数名」で指定したアニメーションで表示し、その後、「コールバック関数」に指定した関数を実行する。

「セレクター」の要素が表示されている場合、「セレクター」の要素を、「速度」に指定した速度の「イージング関数名」で指定したアニメーションで非表示にし、その後、「コールバック関数」に指定した関数を実行する。

「速度」は、ミリ秒単位の数字、もしくは、'slow'、'normal'、'fast' の文字列で指定できる。

「イージング関数名」は、'linear'、'swing' の文字列で指定できる。イージング関数は、加速度を加味したような動作パターン。jQuery にデフォルトで用意されているのは、linear と swing のシンプルな動作パターンだけだが、jQuery Easing Plugin などの jQuery プラグインを導入することで、使える動作パターンを増やすことができる。

実装例（サンプル）

toggle( duration, easing, callback )

toggle( duration, easing, callback ) ボタンをクリックすると:

黄色のボックスを表示しました。

実装例（サンプル）の動作について

1. 「 toggle( duration, easing, callback ) 」ボタンをクリックすると、「toggle( duration, easing, callback ) ボタンをクリックすると: 」の下側に、黄色のボックスを、２秒間のアニメーションで表示する。その後、「黄色のボックスを表示しました。」という赤色のテキストを、１秒間のアニメーションで表示する。
2. 「 toggle( duration, easing, callback ) 」ボタンを再度クリックすると、黄色のボックスを、２秒間のアニメーションで非表示にする。その後、「黄色のボックスを表示しました。」という赤色のテキストを、１秒間のアニメーションで非表示にする。

実装例（サンプル）のソースコード

JavaScript

CSS

HTML