jQuery.speed

分类: Effects > Custom

jQuery.speed( [duration ] [, settings ] )返回: PlainObject

描述: 创建一个包含一组属性的对象，准备用于定义自定义动画。

  • 添加的版本： 1.0jQuery.speed( [duration ] [, settings ] )

    • duration (默认： 400)
      类型： Number 或者 String
      一个字符串或数字决定动画将运行多久。(注：默认值: "normal"， 三种预定速度的字符串("slow", "normal", 或 "fast")或表示动画时长的毫秒数值(如：1000))
    • settings
      类型： PlainObject
      • easing (默认： swing)
        类型： String
        一个字符串，表示过渡使用哪种缓动函数。（注：jQuery自身提供"linear" 和 "swing"，其他效果可以使用jQuery Easing Plugin插件）
      • complete
        类型： Function()
        动画完成时调用的函数。

  • 添加的版本： 1.1jQuery.speed( [duration ] [, easing ] [, complete ] )

    • duration (默认： 400)
      类型： Number 或者 String
      一个字符串或数字决定动画将运行多久。(注：默认值: "normal"， 三种预定速度的字符串("slow", "normal", 或 "fast")或表示动画时长的毫秒数值(如：1000))
    • easing (默认： swing)
      类型： String
      一个字符串，表示过渡使用哪种缓动函数。（注：jQuery自身提供"linear" 和 "swing"，其他效果可以使用jQuery Easing Plugin插件）
    • complete
      类型： Function()
      动画完成时调用的函数,每个匹配元素上调用一次。

  • 添加的版本： 1.1jQuery.speed( settings )

    • settings
      类型： PlainObject
      • duration (默认： 400)
        类型： Number or String
        一个字符串或数字决定动画将运行多久。(注：默认值: "normal"， 三种预定速度的字符串("slow", "normal", 或 "fast")或表示动画时长的毫秒数值(如：1000))
      • easing (默认： swing)
        类型： String
        一个字符串，表示过渡使用哪种缓动函数。（注：jQuery自身提供"linear" 和 "swing"，其他效果可以使用jQuery Easing Plugin插件）
      • complete
        类型： Function()
        动画完成时调用的函数。

$.speed()方法提供了一种方式来定义属性，如duration, easing, 和 queue， 用于自定义动画。 使用它，你不必自己实现缺省值和可选参数所涉及的逻辑。

这种方法意图为插件开发者提供新的动画方法。 让$.speed()为你处理所有的参数缺省值和规范化， 而不用你自己复制逻辑， 使您的工作更简单。 使用的例子可以在jQuery UI的.addClass()的动画形式中找到。