jQuery animate() 方法

❮ jQuery 效果方法

实例

通过改变元素的高度,对元素应用动画:

$("button").click(function(){
  $("#box").animate({height: "300px"});
});
亲自试一试 »

定义和用法

animate() 方法执行 CSS 属性集的自定义动画。

该方法通过 CSS 样式将元素从一个状态改变为另一个状态。CSS属性值是逐渐改变的,这样就可以创建动画效果。

只有数字值可创建动画(比如 "margin:30px")。字符串值无法创建动画(比如 "background-color:red")。

提示: 请使用 "+=" 或 "-=" 来创建相对动画。


语法

(selector).animate({styles},speed,easing,callback)

参数 描述
styles 必需。规定产生动画效果的一个或多个 CSS 属性/值。

注意: 当与 animate() 方法一起使用时,该属性名称必须是驼峰写法: 您必须使用 paddingLeft 代替 padding-left,marginRight 代替 margin-right,依此类推。

可以应用动画的属性:


只有数值可以动画化(例如"margin:30px")。 除了字符串"show"、"hide"和"toggle"之外,字符串值不能被动画化(如"background-color:red")。 这些值允许隐藏和显示动画元素。
speed 可选。规定动画的速度。

可能的值:

  • 毫秒 (如 100, 1000, 5000 等)
  • "slow"
  • "fast"
easing 可选。规定在动画的不同点中元素的速度。默认值是 "swing"。

可能的值:

  • "swing" - 在开头/结尾移动慢,在中间移动快
  • "linear" - 匀速移动
提示: 扩展插件中提供更多可用的 easing 函数。
callback 可选。animate 函数执行完之后,要执行的函数。

如需学习更多有关 callback 的内容,请访问我们的 jQuery Callback 这一章。


Alternate 语法

(selector).animate({styles},{options})

参数 描述
styles 必需。规定产生动画效果的一个或多个 CSS 属性/值(同上)。
options 可选。规定动画的额外选项。

可能的值:

  • duration - 设置动画的速度
  • easing - 规定要使用的 easing 函数
  • callback - 规定动画完成之后要执行的函数
  • complete - 规定动画完成后要执行的函数
  • step - 规定动画的每一步完成之后要执行的函数
  • progress - 规定动画中每个步骤后要执行的函数
  • queue - 布尔值。指示是否在效果队列中放置动画。如果为 false,则动画将立即开始。
  • specialEasing - 来自 styles 参数的一个或多个 CSS 属性的映射,以及它们的对应 easing 函数
  • start - 规定动画开始时要执行的函数
  • done - 规定动画结束时要执行的函数
  • fail - 规定动画未能完成时要执行的函数
  • always - 规定在动画停止而未完成时要执行的函数

更多实例

使用带有回调函数的 animate()
如何将 animate() 与重复动画的回调函数一起使用。

替代语法示例
使用替代语法来指定多个动画样式和选项。

使用 animate() 创建进度条
如何使用 animate() 方法创建进度条。

向页面锚点添加平滑滚动
如何使用 animate() 为链接添加平滑滚动。


❮ jQuery 效果方法