jQueryオブジェクトの show() メソッド

jQueryオブジェクトのshowメソッド()メソッドを使うと、HTML文書の要素をアニメーションで徐々に表示することができます。

構文

showメソッドには、同じ名前で引数が異なるオーバーロード(多重定義)された複数のメソッドが存在する。

jQueryObject.show()
jQueryObject.show(duration)
jQueryObject.show(complete)
jQueryObject.show(duration, complete)
jQueryObject.show(options)

引数

以下に示す引数をjQueryオブジェクトのshowメソッドに指定することができる。

duration
アニメーションの時間(ミリ秒)。省略した場合は、アニメーションしない。

jQueryでフェードアウトさせる例を次に示す。

<button id="b1">show</button>
<button id="b2">hide</button>
<img src="portrait.jpg" id="i1" style="display: none">
<script>
  $(function(){
    $('#b1').click(function(){
      $('#i1').show(1000);
    });
    $('#b2').click(function(){
      $('#i1').hide();
    });
  });
</script>

complete
アニメーションが完了したら呼び出されるコールバック関数を指定する。
<button id="b3">show</button>
<img src="portrait.jpg" id="i2" style="display: none">
<script>
  $(function(){
    $('#b3').click(function(){
      $('#i2').show(function(){
        $('#i2').hide();
      });
    });
  });
</script>

options
フェードアウトのオプションをオブジェクトで指定する。
options
キー プロパティ
duration アニメーションの再生時間
easing トランジションに使用するイージング関数
queue アニメーションをエフェクトキューに入れるかどうかを示すブール値
step 各アニメーション要素の各アニメーションプロパティに対して呼び出される関数
progress アニメーションの各ステップの後に呼び出される関数
complete アニメーションが完了した時点で呼び出される関数
start アニメーションが始まるときに呼び出される関数
done アニメーションが完了するときに呼ばれる関数
fail アニメーションが完了しなかったときに呼ばれる関数
always アニメーションが完了したとき、または完了せずに停止したときに呼ばれる関数
<button id="b4">show</button>
<img src="portrait.jpg" id="i3" style="display: none">
<script>
  $(function(){
    $('#b4').click(function(){
      $('#i3').show({
        duration: 1000,
        complete: function(){
          $('#i3').hide();
        }
      });
    });
  });
</script>

参考文献

OpenJS Foundation (2022) .show() | jQuery API Documentation