CodePlayer

finish()函数用于立即完成队列中的所有动画。

finish()会停止当前正在运行的动画，删除所有队列中的动画，并完成匹配元素的所有动画。

该函数属于jQuery对象(实例)。

语法

jQuery 1.9 新增该函数。

jQueryObject.finish( [ queueName ] )

参数

返回值

finish()函数的返回值为jQuery类型，返回当前jQuery对象本身。

示例&说明

请参考下面这段初始HTML代码：

<p>
	<input id="exec" type="button" value="执行动画" >
	<input id="finish" type="button" value="立即完成所有动画" >
</p>
<div id="myDiv" style="width:300px; height: 100px; background-color: #eee;" >CodePlayer</div>

以下是与finish()函数相关的jQuery示例代码，以演示finish()函数的具体用法：

$("#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 );        
} );

$("#finish").click( function(){
	// 无论当前动画执行到什么状态，立即完成所有动画
	// div的CSS属性直接回到动画执行完毕的最终状态(width:200px; height:100px)
    $("#myDiv").finish( );
} );

运行代码