Famo.us - 记录“曲线”功能[关闭]答案

【问题标题】：Famo.us - Documenting a 'curve' function [closed]Famo.us - 记录“曲线”功能[关闭]
【发布时间】：2014-06-22 05:23:30
【问题描述】：

我有一个函数fadeOpacity，它基本上设置了一个StateModifier，具有开始不透明度、结束不透明度、过渡和回调函数。

我在自己的代码中使用 JSDoc，只是想知道我应该调用什么类型的 transition

在famo.us在Easing.js中预制曲线的源码中，曲线的创建方式如下：

var Easing = {
    inQuad: function(t) {
        return t*t;
    },

    ...

我的 fadeOpacity 的 JSDoc 块是这样的：

     /**
     * [fadeOpacity description]
     * @param  {!number}   startOpacity [description]
     * @param  {!number}   endOpacity   [description]
     * @param  {function}   transition  [description] <= the param in question...
     * @param  {function} callback      [description]
     * @return {StateModifier}          [description]
     */

transition 的类型是否正确？

【问题讨论】：

标签： javascript documentation javadoc jsdoc famo.us

【解决方案1】：

查看 Lightbox.js，看起来转换的类型只是 Transition..

例如。 Lightbox.js 的第 32 行

* @param {Transition} [options.inTransition=true] The transition in charge of showing a renderable.

如果您要为不透明度设置动画，我假设您希望用户或 OP（或您自己；））像另一个 famo.us 函数一样进行交互。在 Easing.inOutQuad 肯定是一个函数的地方，它没有描述过渡的持续时间。您可能希望您的函数进行过渡，可以是缓动曲线、物理曲线或可过渡的。

希望这会有所帮助！

【讨论】：

【解决方案2】：

是的。转换是一个函数，它接收从 0 到 1 的数字 t，并返回一个数字（通常介于 0 和 1 之间，负值表示下冲，大于 1 的值表示过冲）。转换也可以是一个字符串，它只是一个注册函数的键。默认情况下，Famo.us 带有其中的一些，例如“linear”和“easeIn”等。

例如，线性转换可以用

表示

function linearTransition(t) { return t; }

这不应该与过渡定义混淆，看起来像

{
    transition : linearTransition,
    duration : 500,
    callback : function myCallback(){}
}

【讨论】：