描述: 停止当前正在运行的动画,删除所有排队的动画,并完成匹配元素所有的动画。
.finish( [queue ] )
- queue类型:停止动画队列中的名称。
当.finish()
在一个元素上被调用,立即停止当前正在运行的动画和所有排队的动画(如果有的话),并且他们的CSS属性设置为它们的目标值(愚人码头注:就是所有动画的目标值)。所有排队的动画将被删除。
如果第一个参数提供,该字符串表示的队列中的动画将被停止。
.finish()
方法和.stop(true, true)
很相似,.stop(true, true)
将清除队列,并且目前的动画跳转到其最终值。但是,不同的是,.finish()
会导致所有排队的动画的CSS属性跳转到他们的最终值。
动画可能因为全局的$.fx.off
属性设置为 true
而停止。当这样做时,所有动画方法将立即设置元素的css属性为其最终调用后的状态,而不是显示动画效果。
例子:
Click the Go button once to start the animation, and then click the other buttons to see how they affect the current and queued animations.