jQuery.fx.off


version 1.3 以降

解説

アニメーションの有効/無効を切り替えるプロパティです。

true を設定すると、jQuery のすべてのアニメーションが無効になります。その状態で実行すると、即座にアニメーションの最終状態になります。
内部的には、duration オプションを 0 に設定します。

false を設定すれば、jQuery はアニメーションを行うようになります。

アニメーションを無効にすることが望ましい場合があります。

  • 性能の低い端末で、jQueryを動かす場合。jQueryのアニメーション処理によって負荷が高くなる場合など。
  • アニメーションによって、アクセシビリティの問題が起きる場合。

設定値 / 戻り値

  • Boolean: アニメーションが有効の場合はtrue、無効の場合はfalse

例1:「アニメーション on /off 切り替え」ボタンを押すと、jQuery.fx.off の値を切り替えます。アニメーションの on / off がクリックする度に切り替わります。

$("#run").click(function(){
    $("div.block").toggle("slow");
});

// アニメーションの on /off を切り替えます。
$("#toggleAnimation").click(function(){
    jQuery.fx.off = !jQuery.fx.off;
    $("div.block").text("アニメーション " + (jQuery.fx.off ? "off" : "on"));
});

テスト1



アニメーション on