CodePlayer

jQuery.fx.off属性用于设置或返回是否全局性地禁用所有动画。

如果不对该属性设置值，则返回表示是否全局性地禁用了动画效果的布尔值。

如果将该属性设为true，将全局性地禁用所有动画。所有正在执行的动画队列不会受到影响。尚未执行的任何动画队列都会在执行时立即完成，而不再带有动画效果。

如果将该属性设为false，将全局性地启用动画效果。

你可以在遇到以下情况时，需要禁用动画效果。

• 你在配置比较低的电脑上使用jQuery。
• 某些用户可能由于动画效果而遇到了可访问性问题。

该属性属于全局的jQuery对象(也可理解为静态属性)。

语法

jQuery 1.3 新增该 静态属性。

jQuery.fx.off

返回值

jQuery.fx.off属性的返回值是Boolean类型，返回表示是否全局性地禁用了动画效果的布尔值。如果已禁用就返回true，否则返回false。

默认情况下，该属性的返回值为false。

示例&说明

请参考下面这段HTML示例代码：

<p>
	<input id="exec" type="button" value="执行动画" />
    <input id="switch" type="button" value="禁用动画效果" />
</p>
<div id="myDiv" style="width:300px; height: 100px; background-color: #eee;" >CodePlayer</div>

与jQuery.fx.off属性相关的jQuery示例代码如下：

$("#exec").click( function(){
    var $myDiv = $("#myDiv");
    // 在现有高度的基础上增加300px (如果原来是100px，增加后就是400px)
    $myDiv.animate( { height: "+=300px" }, 2000 ); 
    $myDiv.animate( { width: "50%" }, 1000 );       
    $myDiv.animate( { width: "200px", height: "100px" }, 1000 );        
} );

$("#switch").click( function(){
    // 使用jQuery.fx.off或$.fx.off均可(如果变量$是jQuery在使用的话)
	if( $.fx.off ){
		jQuery.fx.off = false; // 启用动画效果
		this.value = "禁用动画效果";
	}else{
		$.fx.off = true; // 禁用动画效果
		this.value = "启用动画效果";
	}
} );

运行代码