## 返回值:jQueryanimate(params,[speed],[easing],[fn])

### 概述

用于创建自定义动画的函数。

这个函数的关键在于指定动画形式及结果样式属性对象。这个对象中每个属性都表示一个可以变化的样式属性（如“height”、“top”或“opacity”）。注意：所有指定的属性必须用骆驼形式，比如用marginLeft代替margin-left.

而每个属性的值表示这个样式属性到多少时动画结束。如果是一个数值，样式属性就会从当前的值渐变到指定的值。如果使用的是“hide”、“show”或“toggle”这样的字符串值，则会为该属性调用默认的动画形式。

在 jQuery 1.2 中，你可以使用 em 和 % 单位。另外，在 jQuery 1.2 中，你可以通过在属性值前面指定 "<em>+=</em>" 或 "<em>-=</em>" 来让元素做相对运动。

jQuery 1.3中，如果duration设为0则直接完成动画。而在以前版本中则会执行默认动画。

jQuery 1.8中，当你使用CSS属性在css()或animate()中，我们将根据浏览器自动加上前缀(在适当的时候)，比如("user-select", "none"); 在Chrome/Safari浏览器中我们将设置为"-webkit-user-select", Firefox会使用"-moz-user-select", IE10将使用"-ms-user-select".

### 参数

#### params,[speed],[easing],[fn]Options,Number/String,String,Function V1.0

params:一组包含作为动画属性和终值的样式属性和及其值的集合

speed:三种预定速度之一的字符串("slow","normal", or "fast")或表示动画时长的毫秒数值(如：1000)

easing:要使用的擦除效果的名称(需要插件支持).默认jQuery提供"linear" 和 "swing".

fn:在动画完成时执行的函数，每个元素执行一次。

#### params,options String,String V1.0

params::一组包含作为动画属性和终值的样式属性和及其值的集合

options:动画的额外选项。如：speed - 设置动画的速度,easing - 规定要使用的 easing 函数,callback - 规定动画完成之后要执行的函数,step - 规定动画的每一步完成之后要执行的函数,queue - 布尔值。指示是否在效果队列中放置动画。如果为 false，则动画将立即开始,specialEasing - 来自 styles 参数的一个或多个 CSS 属性的映射，以及它们的对应 easing 函数

### 示例

#### 描述:

点击按钮后div元素的几个不同属性一同变化

##### HTML 代码:

    <button id="go"> Run</button>
    <div id="block">Hello!</div>

##### jQuery 代码:

    // 在一个动画中同时应用三种类型的效果
    $("#go").click(function(){
      $("#block").animate({
        width: "90%",
        height: "100%",
        fontSize: "10em",
        borderWidth: 10
      }, 1000 );
    });

#### 描述:

让指定元素左右移动

##### HTML 代码:

    <button id="left">«</button> <button id="right">»</button>
    <div class="block"></div>

##### jQuery 代码:

    $("#right").click(function(){
      $(".block").animate({left: '+50px'}, "slow");
    });

    $("#left").click(function(){
      $(".block").animate({left: '-50px'}, "slow");
    });

#### 描述:

在600毫秒内切换段落的高度和透明度

##### jQuery 代码:

    $("p").animate({
       height: 'toggle', opacity: 'toggle'
     }, "slow");

#### 描述:

用500毫秒将段落移到left为50的地方并且完全清晰显示出来（透明度为1）

##### jQuery 代码:

    $("p").animate({
       left: 50, opacity: 'show'
     }, 500);

#### 描述:

一个使用“easein”函数提供不同动画样式的例子。只有使用了插件来提供这个“easein”函数，这个参数才起作用。

##### jQuery 代码:

    $("p").animate({
       opacity: 'show'
     }, "slow", "easein");