toggle( duration )

jQuery API の toggle( duration ) は、指定した要素が非表示の場合、その要素を、duration に指定した速度のアニメーションで表示し、指定した要素が表示されている場合、その要素を、duration に指定した速度のアニメーションで非表示にするメソッド。

記述方法

jQuery( セレクター ) . toggle( 速度 );

「セレクター」の要素が非表示の場合、「セレクター」の要素を、「速度」に指定した速度のアニメーションで表示する。

「セレクター」の要素が表示されている場合、「セレクター」の要素を、「速度」に指定した速度のアニメーションで非表示にする。

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

実装例(サンプル)①

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

2秒間のアニメーションで表示/非表示切替

実装例(サンプル)①の動作について

  1. 「 toggle( duration ) 」ボタンをクリックすると、「toggle( duration ) ボタンをクリックすると: 」の下側に、「2秒間のアニメーションで表示/非表示切替」という赤色のテキストを、2秒間のアニメーションで表示する。
  2. 「 toggle( duration ) 」ボタンを再度クリックすると、「toggle( duration ) ボタンをクリックすると: 」の下側の「2秒間のアニメーションで表示/非表示切替」という赤色のテキストを、2秒間のアニメーションで非表示にする。

実装例(サンプル)①のソースコード

JavaScript

<script>
<!--
jQuery( function() {
    jQuery( '#jquery-api-toggle' ) . click( function() {
        jQuery( '#jquery-api-toggle-contents' ) . toggle( 2000 );
    } );
} );
// -->
</script>

CSS

<style>
<!--
#jquery-api-toggle-contents {
    display: none;
    color: red;
}
-->
</style>

HTML

<p><button id="jquery-api-toggle">toggle( duration )</button></p>
<p>toggle( duration ) ボタンをクリックすると:</p>
<p id="jquery-api-toggle-contents">2秒間のアニメーションで表示/非表示切替</p>

実装例(サンプル)②

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

2秒間のアニメーションで表示切替Ⅰ

2秒間のアニメーションで表示切替Ⅱ

実装例(サンプル)②の動作について

  1. 「 toggle( duration ) 」ボタンをクリックすると、「toggle( duration ) ボタンをクリックすると: 」の下側の「2秒間のアニメーションで表示切替Ⅰ」という赤色のテキストを、「2秒間のアニメーションで表示切替Ⅱ」という青色のテキストに切り替える。
  2. 「 toggle( duration ) 」ボタンを再度クリックすると、「toggle( duration ) ボタンをクリックすると: 」の下側の「2秒間のアニメーションで表示切替Ⅰ」という赤色のテキストを、「2秒間のアニメーションで表示切替Ⅱ」という青色のテキストに切り替える。

実装例(サンプル)②のソースコード

JavaScript

<script>
<!--
jQuery( function() {
    jQuery( '#jquery-api-toggle-2' ) . click( function() {
        jQuery( '.jquery-api-toggle-2-contents' ) . toggle( 2000 );
    } );
} );
// -->
</script>

CSS

<style>
<!--
#jquery-api-toggle-2-contents-red {
    padding: 10px;
    color: red;
    background-color: lightblue;
}
#jquery-api-toggle-2-contents-blue {
    display: none;
    padding: 10px;
    color: blue;
    background-color: pink;
}
-->
</style>

HTML

<p><button id="jquery-api-toggle-2">toggle( duration )</button></p>
<p>toggle( duration ) ボタンをクリックすると:</p>
<p id="jquery-api-toggle-2-contents-red" class="jquery-api-toggle-2-contents">2秒間のアニメーションで表示切替Ⅰ</p>
<p id="jquery-api-toggle-2-contents-blue" class="jquery-api-toggle-2-contents">2秒間のアニメーションで表示切替Ⅱ</p>

スポンサード リンク

カテゴリー: API, JavaScript, jQuery, エフェクト, 基本 タグ: パーマリンク