src/cm/media/js/lib/yui/yui3-3.15.0/build/anim-base/anim-base-debug.js
author gibus
Mon, 10 Mar 2014 15:19:48 +0100
changeset 602 e16a97fb364a
permissions -rw-r--r--
Use YUI 3.15
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
602
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
     1
YUI.add('anim-base', function (Y, NAME) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
     2
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
     3
/**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
     4
* The Animation Utility provides an API for creating advanced transitions.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
     5
* @module anim
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
     6
*/
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
     7
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
     8
/**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
     9
* Provides the base Anim class, for animating numeric properties.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    10
*
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    11
* @module anim
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    12
* @submodule anim-base
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    13
*/
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    14
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    15
    /**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    16
     * A class for constructing animation instances.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    17
     * @class Anim
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    18
     * @for Anim
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    19
     * @constructor
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    20
     * @extends Base
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    21
     */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    22
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    23
    var RUNNING = 'running',
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    24
        START_TIME = 'startTime',
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    25
        ELAPSED_TIME = 'elapsedTime',
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    26
        /**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    27
        * @for Anim
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    28
        * @event start
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    29
        * @description fires when an animation begins.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    30
        * @param {Event} ev The start event.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    31
        * @type Event.Custom
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    32
        */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    33
        START = 'start',
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    34
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    35
        /**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    36
        * @event tween
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    37
        * @description fires every frame of the animation.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    38
        * @param {Event} ev The tween event.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    39
        * @type Event.Custom
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    40
        */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    41
        TWEEN = 'tween',
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    42
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    43
        /**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    44
        * @event end
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    45
        * @description fires after the animation completes.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    46
        * @param {Event} ev The end event.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    47
        * @type Event.Custom
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    48
        */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    49
        END = 'end',
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    50
        NODE = 'node',
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    51
        PAUSED = 'paused',
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    52
        REVERSE = 'reverse', // TODO: cleanup
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    53
        ITERATION_COUNT = 'iterationCount',
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    54
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    55
        NUM = Number;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    56
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    57
    var _running = {},
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    58
        _timer;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    59
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    60
    Y.Anim = function() {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    61
        Y.Anim.superclass.constructor.apply(this, arguments);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    62
        Y.Anim._instances[Y.stamp(this)] = this;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    63
    };
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    64
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    65
    Y.Anim.NAME = 'anim';
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    66
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    67
    Y.Anim._instances = {};
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    68
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    69
    /**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    70
     * Regex of properties that should use the default unit.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    71
     *
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    72
     * @property RE_DEFAULT_UNIT
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    73
     * @static
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    74
     */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    75
    Y.Anim.RE_DEFAULT_UNIT = /^width|height|top|right|bottom|left|margin.*|padding.*|border.*$/i;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    76
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    77
    /**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    78
     * The default unit to use with properties that pass the RE_DEFAULT_UNIT test.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    79
     *
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    80
     * @property DEFAULT_UNIT
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    81
     * @static
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    82
     */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    83
    Y.Anim.DEFAULT_UNIT = 'px';
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    84
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    85
    Y.Anim.DEFAULT_EASING = function (t, b, c, d) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    86
        return c * t / d + b; // linear easing
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    87
    };
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    88
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    89
    /**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    90
     * Time in milliseconds passed to setInterval for frame processing
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    91
     *
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    92
     * @property intervalTime
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    93
     * @default 20
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    94
     * @static
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    95
     */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    96
    Y.Anim._intervalTime = 20;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    97
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    98
    /**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    99
     * Bucket for custom getters and setters
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   100
     *
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   101
     * @property behaviors
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   102
     * @static
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   103
     */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   104
    Y.Anim.behaviors = {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   105
        left: {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   106
            get: function(anim, attr) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   107
                return anim._getOffset(attr);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   108
            }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   109
        }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   110
    };
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   111
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   112
    Y.Anim.behaviors.top = Y.Anim.behaviors.left;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   113
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   114
    /**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   115
     * The default setter to use when setting object properties.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   116
     *
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   117
     * @property DEFAULT_SETTER
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   118
     * @static
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   119
     */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   120
    Y.Anim.DEFAULT_SETTER = function(anim, att, from, to, elapsed, duration, fn, unit) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   121
        var node = anim._node,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   122
            domNode = node._node,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   123
            val = fn(elapsed, NUM(from), NUM(to) - NUM(from), duration);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   124
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   125
        if (domNode) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   126
            if ('style' in domNode && (att in domNode.style || att in Y.DOM.CUSTOM_STYLES)) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   127
                unit = unit || '';
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   128
                node.setStyle(att, val + unit);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   129
            } else if ('attributes' in domNode && att in domNode.attributes) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   130
                node.setAttribute(att, val);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   131
            } else if (att in domNode) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   132
                domNode[att] = val;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   133
            }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   134
        } else if (node.set) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   135
            node.set(att, val);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   136
        } else if (att in node) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   137
            node[att] = val;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   138
        }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   139
    };
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   140
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   141
    /**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   142
     * The default getter to use when getting object properties.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   143
     *
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   144
     * @property DEFAULT_GETTER
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   145
     * @static
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   146
     */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   147
    Y.Anim.DEFAULT_GETTER = function(anim, att) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   148
        var node = anim._node,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   149
            domNode = node._node,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   150
            val = '';
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   151
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   152
        if (domNode) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   153
            if ('style' in domNode && (att in domNode.style || att in Y.DOM.CUSTOM_STYLES)) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   154
                val = node.getComputedStyle(att);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   155
            } else if ('attributes' in domNode && att in domNode.attributes) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   156
                val = node.getAttribute(att);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   157
            } else if (att in domNode) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   158
                val = domNode[att];
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   159
            }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   160
        } else if (node.get) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   161
            val = node.get(att);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   162
        } else if (att in node) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   163
            val = node[att];
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   164
        }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   165
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   166
        return val;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   167
    };
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   168
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   169
    Y.Anim.ATTRS = {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   170
        /**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   171
         * The object to be animated.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   172
         * @attribute node
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   173
         * @type Node
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   174
         */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   175
        node: {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   176
            setter: function(node) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   177
                if (node) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   178
                    if (typeof node === 'string' || node.nodeType) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   179
                        node = Y.one(node);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   180
                    }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   181
                }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   182
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   183
                this._node = node;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   184
                if (!node) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   185
                    Y.log(node + ' is not a valid node', 'warn', 'Anim');
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   186
                }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   187
                return node;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   188
            }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   189
        },
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   190
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   191
        /**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   192
         * The length of the animation.  Defaults to "1" (second).
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   193
         * @attribute duration
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   194
         * @type NUM
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   195
         */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   196
        duration: {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   197
            value: 1
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   198
        },
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   199
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   200
        /**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   201
         * The method that will provide values to the attribute(s) during the animation.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   202
         * Defaults to "Easing.easeNone".
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   203
         * @attribute easing
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   204
         * @type Function
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   205
         */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   206
        easing: {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   207
            value: Y.Anim.DEFAULT_EASING,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   208
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   209
            setter: function(val) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   210
                if (typeof val === 'string' && Y.Easing) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   211
                    return Y.Easing[val];
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   212
                }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   213
            }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   214
        },
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   215
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   216
        /**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   217
         * The starting values for the animated properties.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   218
         *
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   219
         * Fields may be strings, numbers, or functions.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   220
         * If a function is used, the return value becomes the from value.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   221
         * If no from value is specified, the DEFAULT_GETTER will be used.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   222
         * Supports any unit, provided it matches the "to" (or default)
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   223
         * unit (e.g. `{width: '10em', color: 'rgb(0, 0, 0)', borderColor: '#ccc'}`).
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   224
         *
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   225
         * If using the default ('px' for length-based units), the unit may be omitted
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   226
         * (e.g. `{width: 100}, borderColor: 'ccc'}`, which defaults to pixels
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   227
         * and hex, respectively).
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   228
         *
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   229
         * @attribute from
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   230
         * @type Object
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   231
         */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   232
        from: {},
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   233
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   234
        /**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   235
         * The ending values for the animated properties.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   236
         *
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   237
         * Fields may be strings, numbers, or functions.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   238
         * Supports any unit, provided it matches the "from" (or default)
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   239
         * unit (e.g. `{width: '50%', color: 'red', borderColor: '#ccc'}`).
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   240
         *
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   241
         * If using the default ('px' for length-based units), the unit may be omitted
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   242
         * (e.g. `{width: 100, borderColor: 'ccc'}`, which defaults to pixels
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   243
         * and hex, respectively).
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   244
         *
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   245
         * @attribute to
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   246
         * @type Object
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   247
         */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   248
        to: {},
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   249
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   250
        /**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   251
         * Date stamp for the first frame of the animation.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   252
         * @attribute startTime
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   253
         * @type Int
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   254
         * @default 0
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   255
         * @readOnly
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   256
         */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   257
        startTime: {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   258
            value: 0,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   259
            readOnly: true
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   260
        },
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   261
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   262
        /**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   263
         * Current time the animation has been running.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   264
         * @attribute elapsedTime
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   265
         * @type Int
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   266
         * @default 0
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   267
         * @readOnly
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   268
         */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   269
        elapsedTime: {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   270
            value: 0,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   271
            readOnly: true
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   272
        },
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   273
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   274
        /**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   275
         * Whether or not the animation is currently running.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   276
         * @attribute running
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   277
         * @type Boolean
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   278
         * @default false
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   279
         * @readOnly
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   280
         */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   281
        running: {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   282
            getter: function() {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   283
                return !!_running[Y.stamp(this)];
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   284
            },
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   285
            value: false,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   286
            readOnly: true
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   287
        },
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   288
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   289
        /**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   290
         * The number of times the animation should run
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   291
         * @attribute iterations
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   292
         * @type Int
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   293
         * @default 1
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   294
         */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   295
        iterations: {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   296
            value: 1
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   297
        },
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   298
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   299
        /**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   300
         * The number of iterations that have occurred.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   301
         * Resets when an animation ends (reaches iteration count or stop() called).
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   302
         * @attribute iterationCount
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   303
         * @type Int
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   304
         * @default 0
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   305
         * @readOnly
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   306
         */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   307
        iterationCount: {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   308
            value: 0,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   309
            readOnly: true
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   310
        },
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   311
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   312
        /**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   313
         * How iterations of the animation should behave.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   314
         * Possible values are "normal" and "alternate".
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   315
         * Normal will repeat the animation, alternate will reverse on every other pass.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   316
         *
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   317
         * @attribute direction
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   318
         * @type String
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   319
         * @default "normal"
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   320
         */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   321
        direction: {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   322
            value: 'normal' // | alternate (fwd on odd, rev on even per spec)
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   323
        },
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   324
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   325
        /**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   326
         * Whether or not the animation is currently paused.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   327
         * @attribute paused
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   328
         * @type Boolean
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   329
         * @default false
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   330
         * @readOnly
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   331
         */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   332
        paused: {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   333
            readOnly: true,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   334
            value: false
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   335
        },
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   336
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   337
        /**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   338
         * If true, the `from` and `to` attributes are swapped, 
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   339
         * and the animation is then run starting from `from`.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   340
         * @attribute reverse
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   341
         * @type Boolean
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   342
         * @default false
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   343
         */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   344
        reverse: {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   345
            value: false
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   346
        }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   347
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   348
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   349
    };
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   350
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   351
    /**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   352
     * Runs all animation instances.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   353
     * @method run
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   354
     * @static
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   355
     */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   356
    Y.Anim.run = function() {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   357
        var instances = Y.Anim._instances,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   358
            i;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   359
        for (i in instances) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   360
            if (instances[i].run) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   361
                instances[i].run();
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   362
            }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   363
        }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   364
    };
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   365
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   366
    /**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   367
     * Pauses all animation instances.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   368
     * @method pause
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   369
     * @static
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   370
     */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   371
    Y.Anim.pause = function() {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   372
        for (var i in _running) { // stop timer if nothing running
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   373
            if (_running[i].pause) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   374
                _running[i].pause();
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   375
            }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   376
        }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   377
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   378
        Y.Anim._stopTimer();
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   379
    };
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   380
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   381
    /**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   382
     * Stops all animation instances.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   383
     * @method stop
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   384
     * @static
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   385
     */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   386
    Y.Anim.stop = function() {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   387
        for (var i in _running) { // stop timer if nothing running
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   388
            if (_running[i].stop) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   389
                _running[i].stop();
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   390
            }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   391
        }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   392
        Y.Anim._stopTimer();
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   393
    };
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   394
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   395
    Y.Anim._startTimer = function() {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   396
        if (!_timer) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   397
            _timer = setInterval(Y.Anim._runFrame, Y.Anim._intervalTime);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   398
        }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   399
    };
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   400
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   401
    Y.Anim._stopTimer = function() {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   402
        clearInterval(_timer);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   403
        _timer = 0;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   404
    };
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   405
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   406
    /**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   407
     * Called per Interval to handle each animation frame.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   408
     * @method _runFrame
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   409
     * @private
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   410
     * @static
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   411
     */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   412
    Y.Anim._runFrame = function() {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   413
        var done = true,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   414
            anim;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   415
        for (anim in _running) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   416
            if (_running[anim]._runFrame) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   417
                done = false;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   418
                _running[anim]._runFrame();
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   419
            }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   420
        }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   421
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   422
        if (done) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   423
            Y.Anim._stopTimer();
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   424
        }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   425
    };
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   426
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   427
    Y.Anim.RE_UNITS = /^(-?\d*\.?\d*){1}(em|ex|px|in|cm|mm|pt|pc|%)*$/;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   428
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   429
    var proto = {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   430
        /**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   431
         * Starts or resumes an animation.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   432
         * @method run
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   433
         * @chainable
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   434
         */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   435
        run: function() {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   436
            if (this.get(PAUSED)) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   437
                this._resume();
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   438
            } else if (!this.get(RUNNING)) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   439
                this._start();
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   440
            }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   441
            return this;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   442
        },
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   443
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   444
        /**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   445
         * Pauses the animation and
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   446
         * freezes it in its current state and time.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   447
         * Calling run() will continue where it left off.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   448
         * @method pause
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   449
         * @chainable
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   450
         */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   451
        pause: function() {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   452
            if (this.get(RUNNING)) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   453
                this._pause();
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   454
            }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   455
            return this;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   456
        },
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   457
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   458
        /**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   459
         * Stops the animation and resets its time.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   460
         * @method stop
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   461
         * @param {Boolean} finish If true, the animation will move to the last frame
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   462
         * @chainable
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   463
         */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   464
        stop: function(finish) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   465
            if (this.get(RUNNING) || this.get(PAUSED)) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   466
                this._end(finish);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   467
            }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   468
            return this;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   469
        },
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   470
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   471
        _added: false,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   472
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   473
        _start: function() {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   474
            this._set(START_TIME, new Date() - this.get(ELAPSED_TIME));
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   475
            this._actualFrames = 0;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   476
            if (!this.get(PAUSED)) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   477
                this._initAnimAttr();
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   478
            }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   479
            _running[Y.stamp(this)] = this;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   480
            Y.Anim._startTimer();
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   481
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   482
            this.fire(START);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   483
        },
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   484
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   485
        _pause: function() {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   486
            this._set(START_TIME, null);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   487
            this._set(PAUSED, true);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   488
            delete _running[Y.stamp(this)];
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   489
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   490
            /**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   491
            * @event pause
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   492
            * @description fires when an animation is paused.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   493
            * @param {Event} ev The pause event.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   494
            * @type Event.Custom
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   495
            */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   496
            this.fire('pause');
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   497
        },
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   498
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   499
        _resume: function() {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   500
            this._set(PAUSED, false);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   501
            _running[Y.stamp(this)] = this;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   502
            this._set(START_TIME, new Date() - this.get(ELAPSED_TIME));
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   503
            Y.Anim._startTimer();
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   504
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   505
            /**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   506
            * @event resume
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   507
            * @description fires when an animation is resumed (run from pause).
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   508
            * @param {Event} ev The pause event.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   509
            * @type Event.Custom
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   510
            */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   511
            this.fire('resume');
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   512
        },
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   513
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   514
        _end: function(finish) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   515
            var duration = this.get('duration') * 1000;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   516
            if (finish) { // jump to last frame
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   517
                this._runAttrs(duration, duration, this.get(REVERSE));
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   518
            }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   519
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   520
            this._set(START_TIME, null);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   521
            this._set(ELAPSED_TIME, 0);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   522
            this._set(PAUSED, false);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   523
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   524
            delete _running[Y.stamp(this)];
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   525
            this.fire(END, {elapsed: this.get(ELAPSED_TIME)});
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   526
        },
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   527
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   528
        _runFrame: function() {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   529
            var d = this._runtimeAttr.duration,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   530
                t = new Date() - this.get(START_TIME),
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   531
                reverse = this.get(REVERSE),
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   532
                done = (t >= d);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   533
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   534
            this._runAttrs(t, d, reverse);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   535
            this._actualFrames += 1;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   536
            this._set(ELAPSED_TIME, t);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   537
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   538
            this.fire(TWEEN);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   539
            if (done) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   540
                this._lastFrame();
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   541
            }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   542
        },
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   543
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   544
        _runAttrs: function(t, d, reverse) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   545
            var attr = this._runtimeAttr,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   546
                customAttr = Y.Anim.behaviors,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   547
                easing = attr.easing,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   548
                lastFrame = d,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   549
                done = false,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   550
                attribute,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   551
                setter,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   552
                i;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   553
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   554
            if (t >= d) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   555
                done = true;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   556
            }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   557
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   558
            if (reverse) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   559
                t = d - t;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   560
                lastFrame = 0;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   561
            }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   562
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   563
            for (i in attr) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   564
                if (attr[i].to) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   565
                    attribute = attr[i];
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   566
                    setter = (i in customAttr && 'set' in customAttr[i]) ?
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   567
                            customAttr[i].set : Y.Anim.DEFAULT_SETTER;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   568
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   569
                    if (!done) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   570
                        setter(this, i, attribute.from, attribute.to, t, d, easing, attribute.unit);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   571
                    } else {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   572
                        setter(this, i, attribute.from, attribute.to, lastFrame, d, easing, attribute.unit);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   573
                    }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   574
                }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   575
            }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   576
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   577
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   578
        },
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   579
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   580
        _lastFrame: function() {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   581
            var iter = this.get('iterations'),
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   582
                iterCount = this.get(ITERATION_COUNT);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   583
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   584
            iterCount += 1;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   585
            if (iter === 'infinite' || iterCount < iter) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   586
                if (this.get('direction') === 'alternate') {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   587
                    this.set(REVERSE, !this.get(REVERSE)); // flip it
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   588
                }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   589
                /**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   590
                * @event iteration
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   591
                * @description fires when an animation begins an iteration.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   592
                * @param {Event} ev The iteration event.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   593
                * @type Event.Custom
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   594
                */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   595
                this.fire('iteration');
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   596
            } else {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   597
                iterCount = 0;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   598
                this._end();
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   599
            }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   600
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   601
            this._set(START_TIME, new Date());
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   602
            this._set(ITERATION_COUNT, iterCount);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   603
        },
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   604
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   605
        _initAnimAttr: function() {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   606
            var from = this.get('from') || {},
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   607
                to = this.get('to') || {},
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   608
                attr = {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   609
                    duration: this.get('duration') * 1000,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   610
                    easing: this.get('easing')
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   611
                },
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   612
                customAttr = Y.Anim.behaviors,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   613
                node = this.get(NODE), // implicit attr init
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   614
                unit, begin, end;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   615
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   616
            Y.each(to, function(val, name) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   617
                if (typeof val === 'function') {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   618
                    val = val.call(this, node);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   619
                }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   620
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   621
                begin = from[name];
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   622
                if (begin === undefined) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   623
                    begin = (name in customAttr && 'get' in customAttr[name])  ?
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   624
                            customAttr[name].get(this, name) : Y.Anim.DEFAULT_GETTER(this, name);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   625
                } else if (typeof begin === 'function') {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   626
                    begin = begin.call(this, node);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   627
                }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   628
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   629
                var mFrom = Y.Anim.RE_UNITS.exec(begin),
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   630
                    mTo = Y.Anim.RE_UNITS.exec(val);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   631
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   632
                begin = mFrom ? mFrom[1] : begin;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   633
                end = mTo ? mTo[1] : val;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   634
                unit = mTo ? mTo[2] : mFrom ?  mFrom[2] : ''; // one might be zero TODO: mixed units
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   635
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   636
                if (!unit && Y.Anim.RE_DEFAULT_UNIT.test(name)) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   637
                    unit = Y.Anim.DEFAULT_UNIT;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   638
                }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   639
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   640
                if (!begin || !end) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   641
                    Y.error('invalid "from" or "to" for "' + name + '"', 'Anim');
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   642
                    return;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   643
                }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   644
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   645
                attr[name] = {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   646
                    from: Y.Lang.isObject(begin) ? Y.clone(begin) : begin,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   647
                    to: end,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   648
                    unit: unit
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   649
                };
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   650
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   651
            }, this);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   652
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   653
            this._runtimeAttr = attr;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   654
        },
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   655
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   656
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   657
        // TODO: move to computedStyle? (browsers dont agree on default computed offsets)
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   658
        _getOffset: function(attr) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   659
            var node = this._node,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   660
                val = node.getComputedStyle(attr),
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   661
                get = (attr === 'left') ? 'getX': 'getY',
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   662
                set = (attr === 'left') ? 'setX': 'setY',
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   663
                position;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   664
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   665
            if (val === 'auto') {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   666
                position = node.getStyle('position');
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   667
                if (position === 'absolute' || position === 'fixed') {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   668
                    val = node[get]();
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   669
                    node[set](val);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   670
                } else {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   671
                    val = 0;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   672
                }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   673
            }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   674
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   675
            return val;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   676
        },
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   677
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   678
        destructor: function() {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   679
            delete Y.Anim._instances[Y.stamp(this)];
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   680
        }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   681
    };
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   682
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   683
    Y.extend(Y.Anim, Y.Base, proto);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   684
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   685
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   686
}, '@VERSION@', {"requires": ["base-base", "node-style"]});