描述: 通过淡入的方式显示匹配元素。

.fadeIn( [duration ] [, complete ] )

• duration (默认:

  400)
  类型: or
  一个字符串或者数字决定动画将运行多久。
• complete
  类型: ()
  在动画完成时执行的函数。

.fadeIn( options )

• options
  类型:
  一组包含动画选项的值的集合。 支持的选项:
  • duration (default:

    400)
    Type: or
    一个字符串或者数字决定动画将运行多久。（愚人码头注：默认值: "normal"， 三种预定速度的字符串("slow", "normal", 或 "fast")或表示动画时长的毫秒数值(如：1000) ）
  • easing (default:

    swing)
    Type:
    一个字符串，表示过渡使用哪种缓动函数。（愚人码头注：jQuery自身提供"linear" 和 "swing"，其他效果可以使用 插件）
  • queue (default:

    true)
    Type: or
    一个布尔值，指示是否将动画放置在效果队列中。如果为false时，将立即开始动画。

    从jQuery1.7开始，队列选项也可以接受一个字符串，在这种情况下，在动画被添加到由该字符串表示的队列中。当一个自定义的队列名称被使用，动画不会自动启动;你必须调用

    .dequeue("queuename")来启动它。
  • specialEasing
    Type:
    一组一个或多个通过相应的参数和相对简单函数定义的CSS属性 ( 新增)
  • step
    Type: ( now, tween )
    每个动画元素的每个动画属性将调用的函数。这个函数为修改Tween 对象提供了一个机会来改变设置中得属性值。
  • progress
    Type: ( animation, progress, remainingMs )
    每一步动画完成后调用的一个函数，无论动画属性有多少，每个动画元素都执行单独的函数。

    (version added: )
  • complete
    Type: ()
    在动画完成时执行的函数。
  • done
    Type: ( animation, jumpedToEnd )
    在动画完成时执行的函数。 (他的Promise对象状态已完成).

    (version added: )
  • fail
    Type: ( animation, jumpedToEnd )
    动画失败完成时执行的函数。(他的Promise对象状态未完成)。

    (version added: )
  • always
    Type: ( animation, jumpedToEnd )
    在动画完成或未完成情况下停止时执行的函数。(他的Promise对象状态已完成或未完成)。

    (version added: )

   

.fadeIn( [duration ] [, easing ] [, complete ] )

• duration (默认:

  400)
  类型: or
  一个字符串或者数字决定动画将运行多久。
• easing (默认:

  swing)
  类型:
  一个字符串，表示过渡使用哪种缓动函数。（译者注：jQuery自身提供"linear" 和 "swing"，其他可以使用相关的插件）
• complete
  类型: ()
  在动画完成时执行的函数。

.fadeIn()方法通过匹配元素的不透明度做动画效果。这是一个和类似的方法，但那个方法不会隐藏的元素并可以指定最后的透明度值。

duration（延时时间）参数是以毫秒为单位的，数值越大，动画越慢，不是越快。字符串 'fast' 和 'slow' 分别代表200和600毫秒的延时。如果提供任何其他字符串，或者这个duration参数被省略，那么默认使用400毫秒的延时

我们可以给任何元素做动画，比如一个简单的图片：

    
     Click here
    
With the element initially hidden, we can show it slowly:$('#clickme').click(function() {$('#book').fadeIn('slow', function() {// Animation complete});});

Easing（缓冲函数）

从jQuery 1.4.3开始,增加了一个字符串命名的可选的参数，用于确定使用的缓动函数。一个缓动函数指定用于动画进行中在不同点位的速度。 在jQuery库中easing默认的是调用 swing, 如果想要在一个恒定的速度进行动画，那么调用 linear. 更多的缓动函数要使用的插件，最显着的是（译者注：或插件）。

Callback Function（回调函数）

如果提供回调函数，这个 callback 函数将在动画完成后被执行一次。这个能用来将不同的动画串联起来组成一个事件序列。这个回调函数不设置任何参数，但是this指向执行动画的DOM元素。如果多个元素一起做动画效果，值得注意的是这个回调函数在每个匹配元素上执行一次。这个动画不是作为一个整体。

从jQuery 1.6开始，方法可以用来配合 方法作为一个整体，当所有匹配的元素已经完成各自的动画后，再执行一个回调的动画。 ( 查看 )。

Additional Notes:(其他注意事项：)

Click here...
     
     
     

Let it be known that the party of the first partand the party of the second part are henceforthand hereto directed to assess the allegationsfor factual correctness... (click!)
     
      CENSORED!