src/cm/media/js/lib/yui/yui3-3.15.0/build/anim-base/anim-base.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
                }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   186
                return node;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   187
            }
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
         * The length of the animation.  Defaults to "1" (second).
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   192
         * @attribute duration
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   193
         * @type NUM
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   194
         */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   195
        duration: {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   196
            value: 1
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   197
        },
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
         * The method that will provide values to the attribute(s) during the animation.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   201
         * Defaults to "Easing.easeNone".
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   202
         * @attribute easing
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   203
         * @type Function
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   204
         */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   205
        easing: {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   206
            value: Y.Anim.DEFAULT_EASING,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   207
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   208
            setter: function(val) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   209
                if (typeof val === 'string' && Y.Easing) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   210
                    return Y.Easing[val];
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   211
                }
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
         * The starting values for the animated properties.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   217
         *
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   218
         * Fields may be strings, numbers, or functions.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   219
         * If a function is used, the return value becomes the from value.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   220
         * If no from value is specified, the DEFAULT_GETTER will be used.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   221
         * Supports any unit, provided it matches the "to" (or default)
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   222
         * unit (e.g. `{width: '10em', color: 'rgb(0, 0, 0)', borderColor: '#ccc'}`).
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   223
         *
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   224
         * If using the default ('px' for length-based units), the unit may be omitted
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   225
         * (e.g. `{width: 100}, borderColor: 'ccc'}`, which defaults to pixels
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   226
         * and hex, respectively).
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   227
         *
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   228
         * @attribute from
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   229
         * @type Object
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   230
         */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   231
        from: {},
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   232
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   233
        /**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   234
         * The ending values for the animated properties.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   235
         *
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   236
         * Fields may be strings, numbers, or functions.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   237
         * Supports any unit, provided it matches the "from" (or default)
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   238
         * unit (e.g. `{width: '50%', color: 'red', borderColor: '#ccc'}`).
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   239
         *
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   240
         * If using the default ('px' for length-based units), the unit may be omitted
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   241
         * (e.g. `{width: 100, borderColor: 'ccc'}`, which defaults to pixels
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   242
         * and hex, respectively).
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   243
         *
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   244
         * @attribute to
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   245
         * @type Object
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   246
         */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   247
        to: {},
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   248
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   249
        /**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   250
         * Date stamp for the first frame of the animation.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   251
         * @attribute startTime
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   252
         * @type Int
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   253
         * @default 0
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   254
         * @readOnly
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   255
         */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   256
        startTime: {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   257
            value: 0,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   258
            readOnly: true
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   259
        },
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
         * Current time the animation has been running.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   263
         * @attribute elapsedTime
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   264
         * @type Int
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   265
         * @default 0
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   266
         * @readOnly
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   267
         */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   268
        elapsedTime: {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   269
            value: 0,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   270
            readOnly: true
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   271
        },
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
         * Whether or not the animation is currently running.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   275
         * @attribute running
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   276
         * @type Boolean
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   277
         * @default false
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   278
         * @readOnly
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   279
         */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   280
        running: {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   281
            getter: function() {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   282
                return !!_running[Y.stamp(this)];
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   283
            },
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   284
            value: false,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   285
            readOnly: true
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   286
        },
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
         * The number of times the animation should run
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   290
         * @attribute iterations
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   291
         * @type Int
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   292
         * @default 1
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   293
         */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   294
        iterations: {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   295
            value: 1
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   296
        },
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
         * The number of iterations that have occurred.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   300
         * Resets when an animation ends (reaches iteration count or stop() called).
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   301
         * @attribute iterationCount
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   302
         * @type Int
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   303
         * @default 0
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   304
         * @readOnly
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   305
         */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   306
        iterationCount: {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   307
            value: 0,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   308
            readOnly: true
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   309
        },
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
         * How iterations of the animation should behave.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   313
         * Possible values are "normal" and "alternate".
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   314
         * Normal will repeat the animation, alternate will reverse on every other pass.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   315
         *
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   316
         * @attribute direction
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   317
         * @type String
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   318
         * @default "normal"
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   319
         */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   320
        direction: {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   321
            value: 'normal' // | alternate (fwd on odd, rev on even per spec)
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   322
        },
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
         * Whether or not the animation is currently paused.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   326
         * @attribute paused
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   327
         * @type Boolean
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   328
         * @default false
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   329
         * @readOnly
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   330
         */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   331
        paused: {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   332
            readOnly: true,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   333
            value: false
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   334
        },
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
         * If true, the `from` and `to` attributes are swapped, 
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   338
         * and the animation is then run starting from `from`.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   339
         * @attribute reverse
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   340
         * @type Boolean
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   341
         * @default false
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   342
         */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   343
        reverse: {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   344
            value: false
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   345
        }
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
     * Runs all animation instances.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   352
     * @method run
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   353
     * @static
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   354
     */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   355
    Y.Anim.run = function() {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   356
        var instances = Y.Anim._instances,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   357
            i;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   358
        for (i in instances) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   359
            if (instances[i].run) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   360
                instances[i].run();
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   361
            }
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
     * Pauses all animation instances.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   367
     * @method pause
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   368
     * @static
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   369
     */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   370
    Y.Anim.pause = function() {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   371
        for (var i in _running) { // stop timer if nothing running
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   372
            if (_running[i].pause) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   373
                _running[i].pause();
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   374
            }
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
        Y.Anim._stopTimer();
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   378
    };
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
     * Stops all animation instances.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   382
     * @method stop
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   383
     * @static
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   384
     */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   385
    Y.Anim.stop = function() {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   386
        for (var i in _running) { // stop timer if nothing running
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   387
            if (_running[i].stop) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   388
                _running[i].stop();
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   389
            }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   390
        }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   391
        Y.Anim._stopTimer();
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   392
    };
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   393
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   394
    Y.Anim._startTimer = function() {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   395
        if (!_timer) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   396
            _timer = setInterval(Y.Anim._runFrame, Y.Anim._intervalTime);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   397
        }
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
    Y.Anim._stopTimer = function() {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   401
        clearInterval(_timer);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   402
        _timer = 0;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   403
    };
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
     * Called per Interval to handle each animation frame.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   407
     * @method _runFrame
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   408
     * @private
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   409
     * @static
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   410
     */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   411
    Y.Anim._runFrame = function() {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   412
        var done = true,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   413
            anim;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   414
        for (anim in _running) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   415
            if (_running[anim]._runFrame) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   416
                done = false;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   417
                _running[anim]._runFrame();
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   418
            }
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
        if (done) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   422
            Y.Anim._stopTimer();
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   423
        }
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
    Y.Anim.RE_UNITS = /^(-?\d*\.?\d*){1}(em|ex|px|in|cm|mm|pt|pc|%)*$/;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   427
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   428
    var proto = {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   429
        /**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   430
         * Starts or resumes an animation.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   431
         * @method run
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   432
         * @chainable
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   433
         */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   434
        run: function() {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   435
            if (this.get(PAUSED)) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   436
                this._resume();
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   437
            } else if (!this.get(RUNNING)) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   438
                this._start();
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   439
            }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   440
            return this;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   441
        },
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
         * Pauses the animation and
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   445
         * freezes it in its current state and time.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   446
         * Calling run() will continue where it left off.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   447
         * @method pause
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   448
         * @chainable
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   449
         */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   450
        pause: function() {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   451
            if (this.get(RUNNING)) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   452
                this._pause();
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   453
            }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   454
            return this;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   455
        },
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
         * Stops the animation and resets its time.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   459
         * @method stop
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   460
         * @param {Boolean} finish If true, the animation will move to the last frame
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   461
         * @chainable
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   462
         */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   463
        stop: function(finish) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   464
            if (this.get(RUNNING) || this.get(PAUSED)) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   465
                this._end(finish);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   466
            }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   467
            return this;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   468
        },
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   469
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   470
        _added: false,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   471
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   472
        _start: function() {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   473
            this._set(START_TIME, new Date() - this.get(ELAPSED_TIME));
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   474
            this._actualFrames = 0;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   475
            if (!this.get(PAUSED)) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   476
                this._initAnimAttr();
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   477
            }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   478
            _running[Y.stamp(this)] = this;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   479
            Y.Anim._startTimer();
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   480
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   481
            this.fire(START);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   482
        },
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   483
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   484
        _pause: function() {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   485
            this._set(START_TIME, null);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   486
            this._set(PAUSED, true);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   487
            delete _running[Y.stamp(this)];
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   488
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   489
            /**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   490
            * @event pause
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   491
            * @description fires when an animation is paused.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   492
            * @param {Event} ev The pause event.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   493
            * @type Event.Custom
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   494
            */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   495
            this.fire('pause');
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   496
        },
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   497
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   498
        _resume: function() {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   499
            this._set(PAUSED, false);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   500
            _running[Y.stamp(this)] = this;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   501
            this._set(START_TIME, new Date() - this.get(ELAPSED_TIME));
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   502
            Y.Anim._startTimer();
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   503
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   504
            /**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   505
            * @event resume
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   506
            * @description fires when an animation is resumed (run from pause).
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   507
            * @param {Event} ev The pause event.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   508
            * @type Event.Custom
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   509
            */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   510
            this.fire('resume');
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   511
        },
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   512
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   513
        _end: function(finish) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   514
            var duration = this.get('duration') * 1000;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   515
            if (finish) { // jump to last frame
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   516
                this._runAttrs(duration, duration, this.get(REVERSE));
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   517
            }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   518
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   519
            this._set(START_TIME, null);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   520
            this._set(ELAPSED_TIME, 0);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   521
            this._set(PAUSED, false);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   522
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   523
            delete _running[Y.stamp(this)];
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   524
            this.fire(END, {elapsed: this.get(ELAPSED_TIME)});
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   525
        },
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   526
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   527
        _runFrame: function() {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   528
            var d = this._runtimeAttr.duration,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   529
                t = new Date() - this.get(START_TIME),
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   530
                reverse = this.get(REVERSE),
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   531
                done = (t >= d);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   532
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   533
            this._runAttrs(t, d, reverse);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   534
            this._actualFrames += 1;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   535
            this._set(ELAPSED_TIME, t);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   536
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   537
            this.fire(TWEEN);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   538
            if (done) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   539
                this._lastFrame();
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   540
            }
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
        _runAttrs: function(t, d, reverse) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   544
            var attr = this._runtimeAttr,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   545
                customAttr = Y.Anim.behaviors,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   546
                easing = attr.easing,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   547
                lastFrame = d,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   548
                done = false,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   549
                attribute,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   550
                setter,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   551
                i;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   552
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   553
            if (t >= d) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   554
                done = true;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   555
            }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   556
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   557
            if (reverse) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   558
                t = d - t;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   559
                lastFrame = 0;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   560
            }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   561
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   562
            for (i in attr) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   563
                if (attr[i].to) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   564
                    attribute = attr[i];
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   565
                    setter = (i in customAttr && 'set' in customAttr[i]) ?
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   566
                            customAttr[i].set : Y.Anim.DEFAULT_SETTER;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   567
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   568
                    if (!done) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   569
                        setter(this, i, attribute.from, attribute.to, t, d, easing, attribute.unit);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   570
                    } else {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   571
                        setter(this, i, attribute.from, attribute.to, lastFrame, d, easing, attribute.unit);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   572
                    }
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
        _lastFrame: function() {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   580
            var iter = this.get('iterations'),
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   581
                iterCount = this.get(ITERATION_COUNT);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   582
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   583
            iterCount += 1;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   584
            if (iter === 'infinite' || iterCount < iter) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   585
                if (this.get('direction') === 'alternate') {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   586
                    this.set(REVERSE, !this.get(REVERSE)); // flip it
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   587
                }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   588
                /**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   589
                * @event iteration
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   590
                * @description fires when an animation begins an iteration.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   591
                * @param {Event} ev The iteration event.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   592
                * @type Event.Custom
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   593
                */
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   594
                this.fire('iteration');
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   595
            } else {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   596
                iterCount = 0;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   597
                this._end();
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   598
            }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   599
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   600
            this._set(START_TIME, new Date());
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   601
            this._set(ITERATION_COUNT, iterCount);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   602
        },
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   603
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   604
        _initAnimAttr: function() {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   605
            var from = this.get('from') || {},
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   606
                to = this.get('to') || {},
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   607
                attr = {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   608
                    duration: this.get('duration') * 1000,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   609
                    easing: this.get('easing')
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   610
                },
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   611
                customAttr = Y.Anim.behaviors,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   612
                node = this.get(NODE), // implicit attr init
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   613
                unit, begin, end;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   614
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   615
            Y.each(to, function(val, name) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   616
                if (typeof val === 'function') {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   617
                    val = val.call(this, node);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   618
                }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   619
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   620
                begin = from[name];
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   621
                if (begin === undefined) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   622
                    begin = (name in customAttr && 'get' in customAttr[name])  ?
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   623
                            customAttr[name].get(this, name) : Y.Anim.DEFAULT_GETTER(this, name);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   624
                } else if (typeof begin === 'function') {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   625
                    begin = begin.call(this, node);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   626
                }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   627
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   628
                var mFrom = Y.Anim.RE_UNITS.exec(begin),
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   629
                    mTo = Y.Anim.RE_UNITS.exec(val);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   630
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   631
                begin = mFrom ? mFrom[1] : begin;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   632
                end = mTo ? mTo[1] : val;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   633
                unit = mTo ? mTo[2] : mFrom ?  mFrom[2] : ''; // one might be zero TODO: mixed units
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   634
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   635
                if (!unit && Y.Anim.RE_DEFAULT_UNIT.test(name)) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   636
                    unit = Y.Anim.DEFAULT_UNIT;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   637
                }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   638
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   639
                if (!begin || !end) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   640
                    Y.error('invalid "from" or "to" for "' + name + '"', 'Anim');
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   641
                    return;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   642
                }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   643
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   644
                attr[name] = {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   645
                    from: Y.Lang.isObject(begin) ? Y.clone(begin) : begin,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   646
                    to: end,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   647
                    unit: unit
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   648
                };
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   649
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   650
            }, this);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   651
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   652
            this._runtimeAttr = attr;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   653
        },
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
        // TODO: move to computedStyle? (browsers dont agree on default computed offsets)
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   657
        _getOffset: function(attr) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   658
            var node = this._node,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   659
                val = node.getComputedStyle(attr),
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   660
                get = (attr === 'left') ? 'getX': 'getY',
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   661
                set = (attr === 'left') ? 'setX': 'setY',
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   662
                position;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   663
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   664
            if (val === 'auto') {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   665
                position = node.getStyle('position');
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   666
                if (position === 'absolute' || position === 'fixed') {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   667
                    val = node[get]();
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   668
                    node[set](val);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   669
                } else {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   670
                    val = 0;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   671
                }
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
            return val;
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   675
        },
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   676
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   677
        destructor: function() {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   678
            delete Y.Anim._instances[Y.stamp(this)];
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   679
        }
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
    Y.extend(Y.Anim, Y.Base, proto);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   683
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   684
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
   685
}, '@VERSION@', {"requires": ["base-base", "node-style"]});