UNPKG

163 kBJavaScriptView Raw
1/*!
2 * VERSION: 2.1.3
3 * DATE: 2019-05-17
4 * UPDATES AND DOCS AT: http://greensock.com
5 *
6 * @license Copyright (c) 2008-2019, GreenSock. All rights reserved.
7 * This work is subject to the terms at http://greensock.com/standard-license or for
8 * Club GreenSock members, the software agreement that was issued with your membership.
9 *
10 * @author: Jack Doyle, jack@greensock.com
11 */
12/* eslint-disable */
13
14import TweenLite, { _gsScope, globals, TweenPlugin } from "./TweenLite.js";
15
16 _gsScope._gsDefine("plugins.CSSPlugin", ["plugins.TweenPlugin","TweenLite"], function() {
17
18 /** @constructor **/
19 var CSSPlugin = function() {
20 TweenPlugin.call(this, "css");
21 this._overwriteProps.length = 0;
22 this.setRatio = CSSPlugin.prototype.setRatio; //speed optimization (avoid prototype lookup on this "hot" method)
23 },
24 _globals = _gsScope._gsDefine.globals,
25 _hasPriority, //turns true whenever a CSSPropTween instance is created that has a priority other than 0. This helps us discern whether or not we should spend the time organizing the linked list or not after a CSSPlugin's _onInitTween() method is called.
26 _suffixMap, //we set this in _onInitTween() each time as a way to have a persistent variable we can use in other methods like _parse() without having to pass it around as a parameter and we keep _parse() decoupled from a particular CSSPlugin instance
27 _cs, //computed style (we store this in a shared variable to conserve memory and make minification tighter
28 _overwriteProps, //alias to the currently instantiating CSSPlugin's _overwriteProps array. We use this closure in order to avoid having to pass a reference around from method to method and aid in minification.
29 _specialProps = {},
30 p = CSSPlugin.prototype = new TweenPlugin("css");
31
32 p.constructor = CSSPlugin;
33 CSSPlugin.version = "2.1.3";
34 CSSPlugin.API = 2;
35 CSSPlugin.defaultTransformPerspective = 0;
36 CSSPlugin.defaultSkewType = "compensated";
37 CSSPlugin.defaultSmoothOrigin = true;
38 p = "px"; //we'll reuse the "p" variable to keep file size down
39 CSSPlugin.suffixMap = {top:p, right:p, bottom:p, left:p, width:p, height:p, fontSize:p, padding:p, margin:p, perspective:p, lineHeight:""};
40
41
42 var _numExp = /(?:\-|\.|\b)(\d|\.|e\-)+/g,
43 _relNumExp = /(?:\d|\-\d|\.\d|\-\.\d|\+=\d|\-=\d|\+=.\d|\-=\.\d)+/g,
44 _valuesExp = /(?:\+=|\-=|\-|\b)[\d\-\.]+[a-zA-Z0-9]*(?:%|\b)/gi, //finds all the values that begin with numbers or += or -= and then a number. Includes suffixes. We use this to split complex values apart like "1px 5px 20px rgb(255,102,51)"
45 _valuesExpWithCommas = /(?:\+=|\-=|\-|\b)[\d\-\.]+[a-zA-Z0-9]*(?:%|\b),?/gi, //finds all the values that begin with numbers or += or -= and then a number. Includes suffixes. We use this to split complex values apart like "1px 5px 20px rgb(255,102,51)"
46 _NaNExp = /(?![+-]?\d*\.?\d+|[+-]|e[+-]\d+)[^0-9]/g, //also allows scientific notation and doesn't kill the leading -/+ in -= and +=
47 _suffixExp = /(?:\d|\-|\+|=|#|\.)*/g,
48 _opacityExp = /opacity *= *([^)]*)/i,
49 _opacityValExp = /opacity:([^;]*)/i,
50 _alphaFilterExp = /alpha\(opacity *=.+?\)/i,
51 _rgbhslExp = /^(rgb|hsl)/,
52 _capsExp = /([A-Z])/g,
53 _camelExp = /-([a-z])/gi,
54 _urlExp = /(^(?:url\(\"|url\())|(?:(\"\))$|\)$)/gi, //for pulling out urls from url(...) or url("...") strings (some browsers wrap urls in quotes, some don't when reporting things like backgroundImage)
55 _camelFunc = function(s, g) { return g.toUpperCase(); },
56 _horizExp = /(?:Left|Right|Width)/i,
57 _ieGetMatrixExp = /(M11|M12|M21|M22)=[\d\-\.e]+/gi,
58 _ieSetMatrixExp = /progid\:DXImageTransform\.Microsoft\.Matrix\(.+?\)/i,
59 _commasOutsideParenExp = /,(?=[^\)]*(?:\(|$))/gi, //finds any commas that are not within parenthesis
60 _complexExp = /[\s,\(]/i, //for testing a string to find if it has a space, comma, or open parenthesis (clues that it's a complex value)
61 _DEG2RAD = Math.PI / 180,
62 _RAD2DEG = 180 / Math.PI,
63 _forcePT = {},
64 _dummyElement = {style:{}},
65 _doc = _gsScope.document || {createElement: function() {return _dummyElement;}},
66 _createElement = function(type, ns) {
67 var e = _doc.createElementNS ? _doc.createElementNS(ns || "http://www.w3.org/1999/xhtml", type) : _doc.createElement(type);
68 return e.style ? e : _doc.createElement(type); //some environments won't allow access to the element's style when created with a namespace in which case we default to the standard createElement() to work around the issue. Also note that when GSAP is embedded directly inside an SVG file, createElement() won't allow access to the style object in Firefox (see https://greensock.com/forums/topic/20215-problem-using-tweenmax-in-standalone-self-containing-svg-file-err-cannot-set-property-csstext-of-undefined/).
69 },
70 _tempDiv = _createElement("div"),
71 _tempImg = _createElement("img"),
72 _internals = CSSPlugin._internals = {_specialProps:_specialProps}, //provides a hook to a few internal methods that we need to access from inside other plugins
73 _agent = (_gsScope.navigator || {}).userAgent || "",
74 _autoRound,
75 _reqSafariFix, //we won't apply the Safari transform fix until we actually come across a tween that affects a transform property (to maintain best performance).
76
77 _isSafari,
78 _isFirefox, //Firefox has a bug that causes 3D transformed elements to randomly disappear unless a repaint is forced after each update on each element.
79 _isSafariLT6, //Safari (and Android 4 which uses a flavor of Safari) has a bug that prevents changes to "top" and "left" properties from rendering properly if changed on the same frame as a transform UNLESS we set the element's WebkitBackfaceVisibility to hidden (weird, I know). Doing this for Android 3 and earlier seems to actually cause other problems, though (fun!)
80 _ieVers,
81 _supportsOpacity = (function() { //we set _isSafari, _ieVers, _isFirefox, and _supportsOpacity all in one function here to reduce file size slightly, especially in the minified version.
82 var i = _agent.indexOf("Android"),
83 a = _createElement("a");
84 _isSafari = (_agent.indexOf("Safari") !== -1 && _agent.indexOf("Chrome") === -1 && (i === -1 || parseFloat(_agent.substr(i+8, 2)) > 3));
85 _isSafariLT6 = (_isSafari && (parseFloat(_agent.substr(_agent.indexOf("Version/")+8, 2)) < 6));
86 _isFirefox = (_agent.indexOf("Firefox") !== -1);
87 if ((/MSIE ([0-9]{1,}[\.0-9]{0,})/).exec(_agent) || (/Trident\/.*rv:([0-9]{1,}[\.0-9]{0,})/).exec(_agent)) {
88 _ieVers = parseFloat( RegExp.$1 );
89 }
90 if (!a) {
91 return false;
92 }
93 a.style.cssText = "top:1px;opacity:.55;";
94 return /^0.55/.test(a.style.opacity);
95 }()),
96 _getIEOpacity = function(v) {
97 return (_opacityExp.test( ((typeof(v) === "string") ? v : (v.currentStyle ? v.currentStyle.filter : v.style.filter) || "") ) ? ( parseFloat( RegExp.$1 ) / 100 ) : 1);
98 },
99 _log = function(s) {//for logging messages, but in a way that won't throw errors in old versions of IE.
100 if (_gsScope.console) {
101 console.log(s);
102 }
103 },
104 _target, //when initting a CSSPlugin, we set this variable so that we can access it from within many other functions without having to pass it around as params
105 _index, //when initting a CSSPlugin, we set this variable so that we can access it from within many other functions without having to pass it around as params
106
107 _prefixCSS = "", //the non-camelCase vendor prefix like "-o-", "-moz-", "-ms-", or "-webkit-"
108 _prefix = "", //camelCase vendor prefix like "O", "ms", "Webkit", or "Moz".
109
110 // @private feed in a camelCase property name like "transform" and it will check to see if it is valid as-is or if it needs a vendor prefix. It returns the corrected camelCase property name (i.e. "WebkitTransform" or "MozTransform" or "transform" or null if no such property is found, like if the browser is IE8 or before, "transform" won't be found at all)
111 _checkPropPrefix = function(p, e) {
112 e = e || _tempDiv;
113 var s = e.style,
114 a, i;
115 if (s[p] !== undefined) {
116 return p;
117 }
118 p = p.charAt(0).toUpperCase() + p.substr(1);
119 a = ["O","Moz","ms","Ms","Webkit"];
120 i = 5;
121 while (--i > -1 && s[a[i]+p] === undefined) { }
122 if (i >= 0) {
123 _prefix = (i === 3) ? "ms" : a[i];
124 _prefixCSS = "-" + _prefix.toLowerCase() + "-";
125 return _prefix + p;
126 }
127 return null;
128 },
129
130 _computedStyleScope = (typeof(window) !== "undefined" ? window : _doc.defaultView || {getComputedStyle:function() {}}),
131 _getComputedStyle = function(e) {
132 return _computedStyleScope.getComputedStyle(e); //to avoid errors in Microsoft Edge, we need to call getComputedStyle() from a specific scope, typically window.
133 },
134
135 /**
136 * @private Returns the css style for a particular property of an element. For example, to get whatever the current "left" css value for an element with an ID of "myElement", you could do:
137 * var currentLeft = CSSPlugin.getStyle( document.getElementById("myElement"), "left");
138 *
139 * @param {!Object} t Target element whose style property you want to query
140 * @param {!string} p Property name (like "left" or "top" or "marginTop", etc.)
141 * @param {Object=} cs Computed style object. This just provides a way to speed processing if you're going to get several properties on the same element in quick succession - you can reuse the result of the getComputedStyle() call.
142 * @param {boolean=} calc If true, the value will not be read directly from the element's "style" property (if it exists there), but instead the getComputedStyle() result will be used. This can be useful when you want to ensure that the browser itself is interpreting the value.
143 * @param {string=} dflt Default value that should be returned in the place of null, "none", "auto" or "auto auto".
144 * @return {?string} The current property value
145 */
146 _getStyle = CSSPlugin.getStyle = function(t, p, cs, calc, dflt) {
147 var rv;
148 if (!_supportsOpacity) if (p === "opacity") { //several versions of IE don't use the standard "opacity" property - they use things like filter:alpha(opacity=50), so we parse that here.
149 return _getIEOpacity(t);
150 }
151 if (!calc && t.style[p]) {
152 rv = t.style[p];
153 } else if ((cs = cs || _getComputedStyle(t))) {
154 rv = cs[p] || cs.getPropertyValue(p) || cs.getPropertyValue(p.replace(_capsExp, "-$1").toLowerCase());
155 } else if (t.currentStyle) {
156 rv = t.currentStyle[p];
157 }
158 return (dflt != null && (!rv || rv === "none" || rv === "auto" || rv === "auto auto")) ? dflt : rv;
159 },
160
161 /**
162 * @private Pass the target element, the property name, the numeric value, and the suffix (like "%", "em", "px", etc.) and it will spit back the equivalent pixel number.
163 * @param {!Object} t Target element
164 * @param {!string} p Property name (like "left", "top", "marginLeft", etc.)
165 * @param {!number} v Value
166 * @param {string=} sfx Suffix (like "px" or "%" or "em")
167 * @param {boolean=} recurse If true, the call is a recursive one. In some browsers (like IE7/8), occasionally the value isn't accurately reported initially, but if we run the function again it will take effect.
168 * @return {number} value in pixels
169 */
170 _convertToPixels = _internals.convertToPixels = function(t, p, v, sfx, recurse) {
171 if (sfx === "px" || (!sfx && p !== "lineHeight")) { return v; }
172 if (sfx === "auto" || !v) { return 0; }
173 var horiz = _horizExp.test(p),
174 node = t,
175 style = _tempDiv.style,
176 neg = (v < 0),
177 precise = (v === 1),
178 pix, cache, time;
179 if (neg) {
180 v = -v;
181 }
182 if (precise) {
183 v *= 100;
184 }
185 if (p === "lineHeight" && !sfx) { //special case of when a simple lineHeight (without a unit) is used. Set it to the value, read back the computed value, and then revert.
186 cache = _getComputedStyle(t).lineHeight;
187 t.style.lineHeight = v;
188 pix = parseFloat(_getComputedStyle(t).lineHeight);
189 t.style.lineHeight = cache;
190 } else if (sfx === "%" && p.indexOf("border") !== -1) {
191 pix = (v / 100) * (horiz ? t.clientWidth : t.clientHeight);
192 } else {
193 style.cssText = "border:0 solid red;position:" + _getStyle(t, "position") + ";line-height:0;";
194 if (sfx === "%" || !node.appendChild || sfx.charAt(0) === "v" || sfx === "rem") {
195 node = t.parentNode || _doc.body;
196 if (_getStyle(node, "display").indexOf("flex") !== -1) { //Edge and IE11 have a bug that causes offsetWidth to report as 0 if the container has display:flex and the child is position:relative. Switching to position: absolute solves it.
197 style.position = "absolute";
198 }
199 cache = node._gsCache;
200 time = TweenLite.ticker.frame;
201 if (cache && horiz && cache.time === time) { //performance optimization: we record the width of elements along with the ticker frame so that we can quickly get it again on the same tick (seems relatively safe to assume it wouldn't change on the same tick)
202 return cache.width * v / 100;
203 }
204 style[(horiz ? "width" : "height")] = v + sfx;
205 } else {
206 style[(horiz ? "borderLeftWidth" : "borderTopWidth")] = v + sfx;
207 }
208 node.appendChild(_tempDiv);
209 pix = parseFloat(_tempDiv[(horiz ? "offsetWidth" : "offsetHeight")]);
210 node.removeChild(_tempDiv);
211 if (horiz && sfx === "%" && CSSPlugin.cacheWidths !== false) {
212 cache = node._gsCache = node._gsCache || {};
213 cache.time = time;
214 cache.width = pix / v * 100;
215 }
216 if (pix === 0 && !recurse) {
217 pix = _convertToPixels(t, p, v, sfx, true);
218 }
219 }
220 if (precise) {
221 pix /= 100;
222 }
223 return neg ? -pix : pix;
224 },
225 _calculateOffset = _internals.calculateOffset = function(t, p, cs) { //for figuring out "top" or "left" in px when it's "auto". We need to factor in margin with the offsetLeft/offsetTop
226 if (_getStyle(t, "position", cs) !== "absolute") { return 0; }
227 var dim = ((p === "left") ? "Left" : "Top"),
228 v = _getStyle(t, "margin" + dim, cs);
229 return t["offset" + dim] - (_convertToPixels(t, p, parseFloat(v), v.replace(_suffixExp, "")) || 0);
230 },
231
232 // @private returns at object containing ALL of the style properties in camelCase and their associated values.
233 _getAllStyles = function(t, cs) {
234 var s = {},
235 i, tr, p;
236 if ((cs = cs || _getComputedStyle(t, null))) {
237 if ((i = cs.length)) {
238 while (--i > -1) {
239 p = cs[i];
240 if (p.indexOf("-transform") === -1 || _transformPropCSS === p) { //Some webkit browsers duplicate transform values, one non-prefixed and one prefixed ("transform" and "WebkitTransform"), so we must weed out the extra one here.
241 s[p.replace(_camelExp, _camelFunc)] = cs.getPropertyValue(p);
242 }
243 }
244 } else { //some browsers behave differently - cs.length is always 0, so we must do a for...in loop.
245 for (i in cs) {
246 if (i.indexOf("Transform") === -1 || _transformProp === i) { //Some webkit browsers duplicate transform values, one non-prefixed and one prefixed ("transform" and "WebkitTransform"), so we must weed out the extra one here.
247 s[i] = cs[i];
248 }
249 }
250 }
251 } else if ((cs = t.currentStyle || t.style)) {
252 for (i in cs) {
253 if (typeof(i) === "string" && s[i] === undefined) {
254 s[i.replace(_camelExp, _camelFunc)] = cs[i];
255 }
256 }
257 }
258 if (!_supportsOpacity) {
259 s.opacity = _getIEOpacity(t);
260 }
261 tr = _getTransform(t, cs, false);
262 s.rotation = tr.rotation;
263 s.skewX = tr.skewX;
264 s.scaleX = tr.scaleX;
265 s.scaleY = tr.scaleY;
266 s.x = tr.x;
267 s.y = tr.y;
268 if (_supports3D) {
269 s.z = tr.z;
270 s.rotationX = tr.rotationX;
271 s.rotationY = tr.rotationY;
272 s.scaleZ = tr.scaleZ;
273 }
274 if (s.filters) {
275 delete s.filters;
276 }
277 return s;
278 },
279
280 // @private analyzes two style objects (as returned by _getAllStyles()) and only looks for differences between them that contain tweenable values (like a number or color). It returns an object with a "difs" property which refers to an object containing only those isolated properties and values for tweening, and a "firstMPT" property which refers to the first MiniPropTween instance in a linked list that recorded all the starting values of the different properties so that we can revert to them at the end or beginning of the tween - we don't want the cascading to get messed up. The forceLookup parameter is an optional generic object with properties that should be forced into the results - this is necessary for className tweens that are overwriting others because imagine a scenario where a rollover/rollout adds/removes a class and the user swipes the mouse over the target SUPER fast, thus nothing actually changed yet and the subsequent comparison of the properties would indicate they match (especially when px rounding is taken into consideration), thus no tweening is necessary even though it SHOULD tween and remove those properties after the tween (otherwise the inline styles will contaminate things). See the className SpecialProp code for details.
281 _cssDif = function(t, s1, s2, vars, forceLookup) {
282 var difs = {},
283 style = t.style,
284 val, p, mpt;
285 for (p in s2) {
286 if (p !== "cssText") if (p !== "length") if (isNaN(p)) if (s1[p] !== (val = s2[p]) || (forceLookup && forceLookup[p])) if (p.indexOf("Origin") === -1) if (typeof(val) === "number" || typeof(val) === "string") {
287 difs[p] = (val === "auto" && (p === "left" || p === "top")) ? _calculateOffset(t, p) : ((val === "" || val === "auto" || val === "none") && typeof(s1[p]) === "string" && s1[p].replace(_NaNExp, "") !== "") ? 0 : val; //if the ending value is defaulting ("" or "auto"), we check the starting value and if it can be parsed into a number (a string which could have a suffix too, like 700px), then we swap in 0 for "" or "auto" so that things actually tween.
288 if (style[p] !== undefined) { //for className tweens, we must remember which properties already existed inline - the ones that didn't should be removed when the tween isn't in progress because they were only introduced to facilitate the transition between classes.
289 mpt = new MiniPropTween(style, p, style[p], mpt);
290 }
291 }
292 }
293 if (vars) {
294 for (p in vars) { //copy properties (except className)
295 if (p !== "className") {
296 difs[p] = vars[p];
297 }
298 }
299 }
300 return {difs:difs, firstMPT:mpt};
301 },
302 _dimensions = {width:["Left","Right"], height:["Top","Bottom"]},
303 _margins = ["marginLeft","marginRight","marginTop","marginBottom"],
304
305 /**
306 * @private Gets the width or height of an element
307 * @param {!Object} t Target element
308 * @param {!string} p Property name ("width" or "height")
309 * @param {Object=} cs Computed style object (if one exists). Just a speed optimization.
310 * @return {number} Dimension (in pixels)
311 */
312 _getDimension = function(t, p, cs) {
313 if ((t.nodeName + "").toLowerCase() === "svg") { //Chrome no longer supports offsetWidth/offsetHeight on SVG elements.
314 return (cs || _getComputedStyle(t))[p] || 0;
315 } else if (t.getCTM && _isSVG(t)) {
316 return t.getBBox()[p] || 0;
317 }
318 var v = parseFloat((p === "width") ? t.offsetWidth : t.offsetHeight),
319 a = _dimensions[p],
320 i = a.length;
321 cs = cs || _getComputedStyle(t, null);
322 while (--i > -1) {
323 v -= parseFloat( _getStyle(t, "padding" + a[i], cs, true) ) || 0;
324 v -= parseFloat( _getStyle(t, "border" + a[i] + "Width", cs, true) ) || 0;
325 }
326 return v;
327 },
328
329 // @private Parses position-related complex strings like "top left" or "50px 10px" or "70% 20%", etc. which are used for things like transformOrigin or backgroundPosition. Optionally decorates a supplied object (recObj) with the following properties: "ox" (offsetX), "oy" (offsetY), "oxp" (if true, "ox" is a percentage not a pixel value), and "oxy" (if true, "oy" is a percentage not a pixel value)
330 _parsePosition = function(v, recObj) {
331 if (v === "contain" || v === "auto" || v === "auto auto") { //note: Firefox uses "auto auto" as default whereas Chrome uses "auto".
332 return v + " ";
333 }
334 if (v == null || v === "") {
335 v = "0 0";
336 }
337 var a = v.split(" "),
338 x = (v.indexOf("left") !== -1) ? "0%" : (v.indexOf("right") !== -1) ? "100%" : a[0],
339 y = (v.indexOf("top") !== -1) ? "0%" : (v.indexOf("bottom") !== -1) ? "100%" : a[1],
340 i;
341 if (a.length > 3 && !recObj) { //multiple positions
342 a = v.split(", ").join(",").split(",");
343 v = [];
344 for (i = 0; i < a.length; i++) {
345 v.push(_parsePosition(a[i]));
346 }
347 return v.join(",");
348 }
349 if (y == null) {
350 y = (x === "center") ? "50%" : "0";
351 } else if (y === "center") {
352 y = "50%";
353 }
354 if (x === "center" || (isNaN(parseFloat(x)) && (x + "").indexOf("=") === -1)) { //remember, the user could flip-flop the values and say "bottom center" or "center bottom", etc. "center" is ambiguous because it could be used to describe horizontal or vertical, hence the isNaN(). If there's an "=" sign in the value, it's relative.
355 x = "50%";
356 }
357 v = x + " " + y + ((a.length > 2) ? " " + a[2] : "");
358 if (recObj) {
359 recObj.oxp = (x.indexOf("%") !== -1);
360 recObj.oyp = (y.indexOf("%") !== -1);
361 recObj.oxr = (x.charAt(1) === "=");
362 recObj.oyr = (y.charAt(1) === "=");
363 recObj.ox = parseFloat(x.replace(_NaNExp, ""));
364 recObj.oy = parseFloat(y.replace(_NaNExp, ""));
365 recObj.v = v;
366 }
367 return recObj || v;
368 },
369
370 /**
371 * @private Takes an ending value (typically a string, but can be a number) and a starting value and returns the change between the two, looking for relative value indicators like += and -= and it also ignores suffixes (but make sure the ending value starts with a number or +=/-= and that the starting value is a NUMBER!)
372 * @param {(number|string)} e End value which is typically a string, but could be a number
373 * @param {(number|string)} b Beginning value which is typically a string but could be a number
374 * @return {number} Amount of change between the beginning and ending values (relative values that have a "+=" or "-=" are recognized)
375 */
376 _parseChange = function(e, b) {
377 if (typeof(e) === "function") {
378 e = e(_index, _target);
379 }
380 return (typeof(e) === "string" && e.charAt(1) === "=") ? parseInt(e.charAt(0) + "1", 10) * parseFloat(e.substr(2)) : (parseFloat(e) - parseFloat(b)) || 0;
381 },
382
383 /**
384 * @private Takes a value and a default number, checks if the value is relative, null, or numeric and spits back a normalized number accordingly. Primarily used in the _parseTransform() function.
385 * @param {Object} v Value to be parsed
386 * @param {!number} d Default value (which is also used for relative calculations if "+=" or "-=" is found in the first parameter)
387 * @return {number} Parsed value
388 */
389 _parseVal = function(v, d) {
390 if (typeof(v) === "function") {
391 v = v(_index, _target);
392 }
393 var isRelative = (typeof(v) === "string" && v.charAt(1) === "=");
394 if (typeof(v) === "string" && v.charAt(v.length - 2) === "v") { //convert vw and vh into px-equivalents.
395 v = (isRelative ? v.substr(0, 2) : 0) + (window["inner" + ((v.substr(-2) === "vh") ? "Height" : "Width")] * (parseFloat(isRelative ? v.substr(2) : v) / 100));
396 }
397 return (v == null) ? d : isRelative ? parseInt(v.charAt(0) + "1", 10) * parseFloat(v.substr(2)) + d : parseFloat(v) || 0;
398 },
399
400 /**
401 * @private Translates strings like "40deg" or "40" or 40rad" or "+=40deg" or "270_short" or "-90_cw" or "+=45_ccw" to a numeric radian angle. Of course a starting/default value must be fed in too so that relative values can be calculated properly.
402 * @param {Object} v Value to be parsed
403 * @param {!number} d Default value (which is also used for relative calculations if "+=" or "-=" is found in the first parameter)
404 * @param {string=} p property name for directionalEnd (optional - only used when the parsed value is directional ("_short", "_cw", or "_ccw" suffix). We need a way to store the uncompensated value so that at the end of the tween, we set it to exactly what was requested with no directional compensation). Property name would be "rotation", "rotationX", or "rotationY"
405 * @param {Object=} directionalEnd An object that will store the raw end values for directional angles ("_short", "_cw", or "_ccw" suffix). We need a way to store the uncompensated value so that at the end of the tween, we set it to exactly what was requested with no directional compensation.
406 * @return {number} parsed angle in radians
407 */
408 _parseAngle = function(v, d, p, directionalEnd) {
409 var min = 0.000001,
410 cap, split, dif, result, isRelative;
411 if (typeof(v) === "function") {
412 v = v(_index, _target);
413 }
414 if (v == null) {
415 result = d;
416 } else if (typeof(v) === "number") {
417 result = v;
418 } else {
419 cap = 360;
420 split = v.split("_");
421 isRelative = (v.charAt(1) === "=");
422 dif = (isRelative ? parseInt(v.charAt(0) + "1", 10) * parseFloat(split[0].substr(2)) : parseFloat(split[0])) * ((v.indexOf("rad") === -1) ? 1 : _RAD2DEG) - (isRelative ? 0 : d);
423 if (split.length) {
424 if (directionalEnd) {
425 directionalEnd[p] = d + dif;
426 }
427 if (v.indexOf("short") !== -1) {
428 dif = dif % cap;
429 if (dif !== dif % (cap / 2)) {
430 dif = (dif < 0) ? dif + cap : dif - cap;
431 }
432 }
433 if (v.indexOf("_cw") !== -1 && dif < 0) {
434 dif = ((dif + cap * 9999999999) % cap) - ((dif / cap) | 0) * cap;
435 } else if (v.indexOf("ccw") !== -1 && dif > 0) {
436 dif = ((dif - cap * 9999999999) % cap) - ((dif / cap) | 0) * cap;
437 }
438 }
439 result = d + dif;
440 }
441 if (result < min && result > -min) {
442 result = 0;
443 }
444 return result;
445 },
446
447 _colorLookup = {aqua:[0,255,255],
448 lime:[0,255,0],
449 silver:[192,192,192],
450 black:[0,0,0],
451 maroon:[128,0,0],
452 teal:[0,128,128],
453 blue:[0,0,255],
454 navy:[0,0,128],
455 white:[255,255,255],
456 fuchsia:[255,0,255],
457 olive:[128,128,0],
458 yellow:[255,255,0],
459 orange:[255,165,0],
460 gray:[128,128,128],
461 purple:[128,0,128],
462 green:[0,128,0],
463 red:[255,0,0],
464 pink:[255,192,203],
465 cyan:[0,255,255],
466 transparent:[255,255,255,0]},
467
468 _hue = function(h, m1, m2) {
469 h = (h < 0) ? h + 1 : (h > 1) ? h - 1 : h;
470 return ((((h * 6 < 1) ? m1 + (m2 - m1) * h * 6 : (h < 0.5) ? m2 : (h * 3 < 2) ? m1 + (m2 - m1) * (2 / 3 - h) * 6 : m1) * 255) + 0.5) | 0;
471 },
472
473 /**
474 * @private Parses a color (like #9F0, #FF9900, rgb(255,51,153) or hsl(108, 50%, 10%)) into an array with 3 elements for red, green, and blue or if toHSL parameter is true, it will populate the array with hue, saturation, and lightness values. If a relative value is found in an hsl() or hsla() string, it will preserve those relative prefixes and all the values in the array will be strings instead of numbers (in all other cases it will be populated with numbers).
475 * @param {(string|number)} v The value the should be parsed which could be a string like #9F0 or rgb(255,102,51) or rgba(255,0,0,0.5) or it could be a number like 0xFF00CC or even a named color like red, blue, purple, etc.
476 * @param {(boolean)} toHSL If true, an hsl() or hsla() value will be returned instead of rgb() or rgba()
477 * @return {Array.<number>} An array containing red, green, and blue (and optionally alpha) in that order, or if the toHSL parameter was true, the array will contain hue, saturation and lightness (and optionally alpha) in that order. Always numbers unless there's a relative prefix found in an hsl() or hsla() string and toHSL is true.
478 */
479 _parseColor = CSSPlugin.parseColor = function(v, toHSL) {
480 var a, r, g, b, h, s, l, max, min, d, wasHSL;
481 if (!v) {
482 a = _colorLookup.black;
483 } else if (typeof(v) === "number") {
484 a = [v >> 16, (v >> 8) & 255, v & 255];
485 } else {
486 if (v.charAt(v.length - 1) === ",") { //sometimes a trailing comma is included and we should chop it off (typically from a comma-delimited list of values like a textShadow:"2px 2px 2px blue, 5px 5px 5px rgb(255,0,0)" - in this example "blue," has a trailing comma. We could strip it out inside parseComplex() but we'd need to do it to the beginning and ending values plus it wouldn't provide protection from other potential scenarios like if the user passes in a similar value.
487 v = v.substr(0, v.length - 1);
488 }
489 if (_colorLookup[v]) {
490 a = _colorLookup[v];
491 } else if (v.charAt(0) === "#") {
492 if (v.length === 4) { //for shorthand like #9F0
493 r = v.charAt(1);
494 g = v.charAt(2);
495 b = v.charAt(3);
496 v = "#" + r + r + g + g + b + b;
497 }
498 v = parseInt(v.substr(1), 16);
499 a = [v >> 16, (v >> 8) & 255, v & 255];
500 } else if (v.substr(0, 3) === "hsl") {
501 a = wasHSL = v.match(_numExp);
502 if (!toHSL) {
503 h = (Number(a[0]) % 360) / 360;
504 s = Number(a[1]) / 100;
505 l = Number(a[2]) / 100;
506 g = (l <= 0.5) ? l * (s + 1) : l + s - l * s;
507 r = l * 2 - g;
508 if (a.length > 3) {
509 a[3] = Number(a[3]);
510 }
511 a[0] = _hue(h + 1 / 3, r, g);
512 a[1] = _hue(h, r, g);
513 a[2] = _hue(h - 1 / 3, r, g);
514 } else if (v.indexOf("=") !== -1) { //if relative values are found, just return the raw strings with the relative prefixes in place.
515 return v.match(_relNumExp);
516 }
517 } else {
518 a = v.match(_numExp) || _colorLookup.transparent;
519 }
520 a[0] = Number(a[0]);
521 a[1] = Number(a[1]);
522 a[2] = Number(a[2]);
523 if (a.length > 3) {
524 a[3] = Number(a[3]);
525 }
526 }
527 if (toHSL && !wasHSL) {
528 r = a[0] / 255;
529 g = a[1] / 255;
530 b = a[2] / 255;
531 max = Math.max(r, g, b);
532 min = Math.min(r, g, b);
533 l = (max + min) / 2;
534 if (max === min) {
535 h = s = 0;
536 } else {
537 d = max - min;
538 s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
539 h = (max === r) ? (g - b) / d + (g < b ? 6 : 0) : (max === g) ? (b - r) / d + 2 : (r - g) / d + 4;
540 h *= 60;
541 }
542 a[0] = (h + 0.5) | 0;
543 a[1] = (s * 100 + 0.5) | 0;
544 a[2] = (l * 100 + 0.5) | 0;
545 }
546 return a;
547 },
548 _formatColors = function(s, toHSL) {
549 var colors = s.match(_colorExp) || [],
550 charIndex = 0,
551 parsed = "",
552 i, color, temp;
553 if (!colors.length) {
554 return s;
555 }
556 for (i = 0; i < colors.length; i++) {
557 color = colors[i];
558 temp = s.substr(charIndex, s.indexOf(color, charIndex)-charIndex);
559 charIndex += temp.length + color.length;
560 color = _parseColor(color, toHSL);
561 if (color.length === 3) {
562 color.push(1);
563 }
564 parsed += temp + (toHSL ? "hsla(" + color[0] + "," + color[1] + "%," + color[2] + "%," + color[3] : "rgba(" + color.join(",")) + ")";
565 }
566 return parsed + s.substr(charIndex);
567 },
568 _colorExp = "(?:\\b(?:(?:rgb|rgba|hsl|hsla)\\(.+?\\))|\\B#(?:[0-9a-f]{3}){1,2}\\b"; //we'll dynamically build this Regular Expression to conserve file size. After building it, it will be able to find rgb(), rgba(), # (hexadecimal), and named color values like red, blue, purple, etc.
569
570 for (p in _colorLookup) {
571 _colorExp += "|" + p + "\\b";
572 }
573 _colorExp = new RegExp(_colorExp+")", "gi");
574
575 CSSPlugin.colorStringFilter = function(a) {
576 var combined = a[0] + " " + a[1],
577 toHSL;
578 if (_colorExp.test(combined)) {
579 toHSL = (combined.indexOf("hsl(") !== -1 || combined.indexOf("hsla(") !== -1);
580 a[0] = _formatColors(a[0], toHSL);
581 a[1] = _formatColors(a[1], toHSL);
582 }
583 _colorExp.lastIndex = 0;
584 };
585
586 if (!TweenLite.defaultStringFilter) {
587 TweenLite.defaultStringFilter = CSSPlugin.colorStringFilter;
588 }
589
590 /**
591 * @private Returns a formatter function that handles taking a string (or number in some cases) and returning a consistently formatted one in terms of delimiters, quantity of values, etc. For example, we may get boxShadow values defined as "0px red" or "0px 0px 10px rgb(255,0,0)" or "0px 0px 20px 20px #F00" and we need to ensure that what we get back is described with 4 numbers and a color. This allows us to feed it into the _parseComplex() method and split the values up appropriately. The neat thing about this _getFormatter() function is that the dflt defines a pattern as well as a default, so for example, _getFormatter("0px 0px 0px 0px #777", true) not only sets the default as 0px for all distances and #777 for the color, but also sets the pattern such that 4 numbers and a color will always get returned.
592 * @param {!string} dflt The default value and pattern to follow. So "0px 0px 0px 0px #777" will ensure that 4 numbers and a color will always get returned.
593 * @param {boolean=} clr If true, the values should be searched for color-related data. For example, boxShadow values typically contain a color whereas borderRadius don't.
594 * @param {boolean=} collapsible If true, the value is a top/left/right/bottom style one that acts like margin or padding, where if only one value is received, it's used for all 4; if 2 are received, the first is duplicated for 3rd (bottom) and the 2nd is duplicated for the 4th spot (left), etc.
595 * @return {Function} formatter function
596 */
597 var _getFormatter = function(dflt, clr, collapsible, multi) {
598 if (dflt == null) {
599 return function(v) {return v;};
600 }
601 var dColor = clr ? (dflt.match(_colorExp) || [""])[0] : "",
602 dVals = dflt.split(dColor).join("").match(_valuesExp) || [],
603 pfx = dflt.substr(0, dflt.indexOf(dVals[0])),
604 sfx = (dflt.charAt(dflt.length - 1) === ")") ? ")" : "",
605 delim = (dflt.indexOf(" ") !== -1) ? " " : ",",
606 numVals = dVals.length,
607 dSfx = (numVals > 0) ? dVals[0].replace(_numExp, "") : "",
608 formatter;
609 if (!numVals) {
610 return function(v) {return v;};
611 }
612 if (clr) {
613 formatter = function(v) {
614 var color, vals, i, a;
615 if (typeof(v) === "number") {
616 v += dSfx;
617 } else if (multi && _commasOutsideParenExp.test(v)) {
618 a = v.replace(_commasOutsideParenExp, "|").split("|");
619 for (i = 0; i < a.length; i++) {
620 a[i] = formatter(a[i]);
621 }
622 return a.join(",");
623 }
624 color = (v.match(_colorExp) || [dColor])[0];
625 vals = v.split(color).join("").match(_valuesExp) || [];
626 i = vals.length;
627 if (numVals > i--) {
628 while (++i < numVals) {
629 vals[i] = collapsible ? vals[(((i - 1) / 2) | 0)] : dVals[i];
630 }
631 }
632 return pfx + vals.join(delim) + delim + color + sfx + (v.indexOf("inset") !== -1 ? " inset" : "");
633 };
634 return formatter;
635
636 }
637 formatter = function(v) {
638 var vals, a, i;
639 if (typeof(v) === "number") {
640 v += dSfx;
641 } else if (multi && _commasOutsideParenExp.test(v)) {
642 a = v.replace(_commasOutsideParenExp, "|").split("|");
643 for (i = 0; i < a.length; i++) {
644 a[i] = formatter(a[i]);
645 }
646 return a.join(",");
647 }
648 vals = v.match(delim === "," ? _valuesExp : _valuesExpWithCommas) || [];
649 i = vals.length;
650 if (numVals > i--) {
651 while (++i < numVals) {
652 vals[i] = collapsible ? vals[(((i - 1) / 2) | 0)] : dVals[i];
653 }
654 }
655 return ((pfx && v !== "none") ? v.substr(0, v.indexOf(vals[0])) || pfx : pfx) + vals.join(delim) + sfx; //note: prefix might be different, like for clipPath it could start with inset( or polygon(
656 };
657 return formatter;
658 },
659
660 /**
661 * @private returns a formatter function that's used for edge-related values like marginTop, marginLeft, paddingBottom, paddingRight, etc. Just pass a comma-delimited list of property names related to the edges.
662 * @param {!string} props a comma-delimited list of property names in order from top to left, like "marginTop,marginRight,marginBottom,marginLeft"
663 * @return {Function} a formatter function
664 */
665 _getEdgeParser = function(props) {
666 props = props.split(",");
667 return function(t, e, p, cssp, pt, plugin, vars) {
668 var a = (e + "").split(" "),
669 i;
670 vars = {};
671 for (i = 0; i < 4; i++) {
672 vars[props[i]] = a[i] = a[i] || a[(((i - 1) / 2) >> 0)];
673 }
674 return cssp.parse(t, vars, pt, plugin);
675 };
676 },
677
678 // @private used when other plugins must tween values first, like BezierPlugin or ThrowPropsPlugin, etc. That plugin's setRatio() gets called first so that the values are updated, and then we loop through the MiniPropTweens which handle copying the values into their appropriate slots so that they can then be applied correctly in the main CSSPlugin setRatio() method. Remember, we typically create a proxy object that has a bunch of uniquely-named properties that we feed to the sub-plugin and it does its magic normally, and then we must interpret those values and apply them to the css because often numbers must get combined/concatenated, suffixes added, etc. to work with css, like boxShadow could have 4 values plus a color.
679 _setPluginRatio = _internals._setPluginRatio = function(v) {
680 this.plugin.setRatio(v);
681 var d = this.data,
682 proxy = d.proxy,
683 mpt = d.firstMPT,
684 min = 0.000001,
685 val, pt, i, str, p;
686 while (mpt) {
687 val = proxy[mpt.v];
688 if (mpt.r) {
689 val = mpt.r(val);
690 } else if (val < min && val > -min) {
691 val = 0;
692 }
693 mpt.t[mpt.p] = val;
694 mpt = mpt._next;
695 }
696 if (d.autoRotate) {
697 d.autoRotate.rotation = d.mod ? d.mod.call(this._tween, proxy.rotation, this.t, this._tween) : proxy.rotation; //special case for ModifyPlugin to hook into an auto-rotating bezier
698 }
699 //at the end, we must set the CSSPropTween's "e" (end) value dynamically here because that's what is used in the final setRatio() method. Same for "b" at the beginning.
700 if (v === 1 || v === 0) {
701 mpt = d.firstMPT;
702 p = (v === 1) ? "e" : "b";
703 while (mpt) {
704 pt = mpt.t;
705 if (!pt.type) {
706 pt[p] = pt.s + pt.xs0;
707 } else if (pt.type === 1) {
708 str = pt.xs0 + pt.s + pt.xs1;
709 for (i = 1; i < pt.l; i++) {
710 str += pt["xn"+i] + pt["xs"+(i+1)];
711 }
712 pt[p] = str;
713 }
714 mpt = mpt._next;
715 }
716 }
717 },
718
719 /**
720 * @private @constructor Used by a few SpecialProps to hold important values for proxies. For example, _parseToProxy() creates a MiniPropTween instance for each property that must get tweened on the proxy, and we record the original property name as well as the unique one we create for the proxy, plus whether or not the value needs to be rounded plus the original value.
721 * @param {!Object} t target object whose property we're tweening (often a CSSPropTween)
722 * @param {!string} p property name
723 * @param {(number|string|object)} v value
724 * @param {MiniPropTween=} next next MiniPropTween in the linked list
725 * @param {boolean=} r if true, the tweened value should be rounded to the nearest integer
726 */
727 MiniPropTween = function(t, p, v, next, r) {
728 this.t = t;
729 this.p = p;
730 this.v = v;
731 this.r = r;
732 if (next) {
733 next._prev = this;
734 this._next = next;
735 }
736 },
737
738 /**
739 * @private Most other plugins (like BezierPlugin and ThrowPropsPlugin and others) can only tween numeric values, but CSSPlugin must accommodate special values that have a bunch of extra data (like a suffix or strings between numeric values, etc.). For example, boxShadow has values like "10px 10px 20px 30px rgb(255,0,0)" which would utterly confuse other plugins. This method allows us to split that data apart and grab only the numeric data and attach it to uniquely-named properties of a generic proxy object ({}) so that we can feed that to virtually any plugin to have the numbers tweened. However, we must also keep track of which properties from the proxy go with which CSSPropTween values and instances. So we create a linked list of MiniPropTweens. Each one records a target (the original CSSPropTween), property (like "s" or "xn1" or "xn2") that we're tweening and the unique property name that was used for the proxy (like "boxShadow_xn1" and "boxShadow_xn2") and whether or not they need to be rounded. That way, in the _setPluginRatio() method we can simply copy the values over from the proxy to the CSSPropTween instance(s). Then, when the main CSSPlugin setRatio() method runs and applies the CSSPropTween values accordingly, they're updated nicely. So the external plugin tweens the numbers, _setPluginRatio() copies them over, and setRatio() acts normally, applying css-specific values to the element.
740 * This method returns an object that has the following properties:
741 * - proxy: a generic object containing the starting values for all the properties that will be tweened by the external plugin. This is what we feed to the external _onInitTween() as the target
742 * - end: a generic object containing the ending values for all the properties that will be tweened by the external plugin. This is what we feed to the external plugin's _onInitTween() as the destination values
743 * - firstMPT: the first MiniPropTween in the linked list
744 * - pt: the first CSSPropTween in the linked list that was created when parsing. If shallow is true, this linked list will NOT attach to the one passed into the _parseToProxy() as the "pt" (4th) parameter.
745 * @param {!Object} t target object to be tweened
746 * @param {!(Object|string)} vars the object containing the information about the tweening values (typically the end/destination values) that should be parsed
747 * @param {!CSSPlugin} cssp The CSSPlugin instance
748 * @param {CSSPropTween=} pt the next CSSPropTween in the linked list
749 * @param {TweenPlugin=} plugin the external TweenPlugin instance that will be handling tweening the numeric values
750 * @param {boolean=} shallow if true, the resulting linked list from the parse will NOT be attached to the CSSPropTween that was passed in as the "pt" (4th) parameter.
751 * @return An object containing the following properties: proxy, end, firstMPT, and pt (see above for descriptions)
752 */
753 _parseToProxy = _internals._parseToProxy = function(t, vars, cssp, pt, plugin, shallow) {
754 var bpt = pt,
755 start = {},
756 end = {},
757 transform = cssp._transform,
758 oldForce = _forcePT,
759 i, p, xp, mpt, firstPT;
760 cssp._transform = null;
761 _forcePT = vars;
762 pt = firstPT = cssp.parse(t, vars, pt, plugin);
763 _forcePT = oldForce;
764 //break off from the linked list so the new ones are isolated.
765 if (shallow) {
766 cssp._transform = transform;
767 if (bpt) {
768 bpt._prev = null;
769 if (bpt._prev) {
770 bpt._prev._next = null;
771 }
772 }
773 }
774 while (pt && pt !== bpt) {
775 if (pt.type <= 1) {
776 p = pt.p;
777 end[p] = pt.s + pt.c;
778 start[p] = pt.s;
779 if (!shallow) {
780 mpt = new MiniPropTween(pt, "s", p, mpt, pt.r);
781 pt.c = 0;
782 }
783 if (pt.type === 1) {
784 i = pt.l;
785 while (--i > 0) {
786 xp = "xn" + i;
787 p = pt.p + "_" + xp;
788 end[p] = pt.data[xp];
789 start[p] = pt[xp];
790 if (!shallow) {
791 mpt = new MiniPropTween(pt, xp, p, mpt, pt.rxp[xp]);
792 }
793 }
794 }
795 }
796 pt = pt._next;
797 }
798 return {proxy:start, end:end, firstMPT:mpt, pt:firstPT};
799 },
800
801
802
803 /**
804 * @constructor Each property that is tweened has at least one CSSPropTween associated with it. These instances store important information like the target, property, starting value, amount of change, etc. They can also optionally have a number of "extra" strings and numeric values named xs1, xn1, xs2, xn2, xs3, xn3, etc. where "s" indicates string and "n" indicates number. These can be pieced together in a complex-value tween (type:1) that has alternating types of data like a string, number, string, number, etc. For example, boxShadow could be "5px 5px 8px rgb(102, 102, 51)". In that value, there are 6 numbers that may need to tween and then pieced back together into a string again with spaces, suffixes, etc. xs0 is special in that it stores the suffix for standard (type:0) tweens, -OR- the first string (prefix) in a complex-value (type:1) CSSPropTween -OR- it can be the non-tweening value in a type:-1 CSSPropTween. We do this to conserve memory.
805 * CSSPropTweens have the following optional properties as well (not defined through the constructor):
806 * - l: Length in terms of the number of extra properties that the CSSPropTween has (default: 0). For example, for a boxShadow we may need to tween 5 numbers in which case l would be 5; Keep in mind that the start/end values for the first number that's tweened are always stored in the s and c properties to conserve memory. All additional values thereafter are stored in xn1, xn2, etc.
807 * - xfirst: The first instance of any sub-CSSPropTweens that are tweening properties of this instance. For example, we may split up a boxShadow tween so that there's a main CSSPropTween of type:1 that has various xs* and xn* values associated with the h-shadow, v-shadow, blur, color, etc. Then we spawn a CSSPropTween for each of those that has a higher priority and runs BEFORE the main CSSPropTween so that the values are all set by the time it needs to re-assemble them. The xfirst gives us an easy way to identify the first one in that chain which typically ends at the main one (because they're all prepende to the linked list)
808 * - plugin: The TweenPlugin instance that will handle the tweening of any complex values. For example, sometimes we don't want to use normal subtweens (like xfirst refers to) to tween the values - we might want ThrowPropsPlugin or BezierPlugin some other plugin to do the actual tweening, so we create a plugin instance and store a reference here. We need this reference so that if we get a request to round values or disable a tween, we can pass along that request.
809 * - data: Arbitrary data that needs to be stored with the CSSPropTween. Typically if we're going to have a plugin handle the tweening of a complex-value tween, we create a generic object that stores the END values that we're tweening to and the CSSPropTween's xs1, xs2, etc. have the starting values. We store that object as data. That way, we can simply pass that object to the plugin and use the CSSPropTween as the target.
810 * - setRatio: Only used for type:2 tweens that require custom functionality. In this case, we call the CSSPropTween's setRatio() method and pass the ratio each time the tween updates. This isn't quite as efficient as doing things directly in the CSSPlugin's setRatio() method, but it's very convenient and flexible.
811 * @param {!Object} t Target object whose property will be tweened. Often a DOM element, but not always. It could be anything.
812 * @param {string} p Property to tween (name). For example, to tween element.width, p would be "width".
813 * @param {number} s Starting numeric value
814 * @param {number} c Change in numeric value over the course of the entire tween. For example, if element.width starts at 5 and should end at 100, c would be 95.
815 * @param {CSSPropTween=} next The next CSSPropTween in the linked list. If one is defined, we will define its _prev as the new instance, and the new instance's _next will be pointed at it.
816 * @param {number=} type The type of CSSPropTween where -1 = a non-tweening value, 0 = a standard simple tween, 1 = a complex value (like one that has multiple numbers in a comma- or space-delimited string like border:"1px solid red"), and 2 = one that uses a custom setRatio function that does all of the work of applying the values on each update.
817 * @param {string=} n Name of the property that should be used for overwriting purposes which is typically the same as p but not always. For example, we may need to create a subtween for the 2nd part of a "clip:rect(...)" tween in which case "p" might be xs1 but "n" is still "clip"
818 * @param {boolean=} r If true, the value(s) should be rounded
819 * @param {number=} pr Priority in the linked list order. Higher priority CSSPropTweens will be updated before lower priority ones. The default priority is 0.
820 * @param {string=} b Beginning value. We store this to ensure that it is EXACTLY what it was when the tween began without any risk of interpretation issues.
821 * @param {string=} e Ending value. We store this to ensure that it is EXACTLY what the user defined at the end of the tween without any risk of interpretation issues.
822 */
823 CSSPropTween = _internals.CSSPropTween = function(t, p, s, c, next, type, n, r, pr, b, e) {
824 this.t = t; //target
825 this.p = p; //property
826 this.s = s; //starting value
827 this.c = c; //change value
828 this.n = n || p; //name that this CSSPropTween should be associated to (usually the same as p, but not always - n is what overwriting looks at)
829 if (!(t instanceof CSSPropTween)) {
830 _overwriteProps.push(this.n);
831 }
832 this.r = !r ? r : (typeof(r) === "function") ? r : Math.round; //round (boolean)
833 this.type = type || 0; //0 = normal tween, -1 = non-tweening (in which case xs0 will be applied to the target's property, like tp.t[tp.p] = tp.xs0), 1 = complex-value SpecialProp, 2 = custom setRatio() that does all the work
834 if (pr) {
835 this.pr = pr;
836 _hasPriority = true;
837 }
838 this.b = (b === undefined) ? s : b;
839 this.e = (e === undefined) ? s + c : e;
840 if (next) {
841 this._next = next;
842 next._prev = this;
843 }
844 },
845
846 _addNonTweeningNumericPT = function(target, prop, start, end, next, overwriteProp) { //cleans up some code redundancies and helps minification. Just a fast way to add a NUMERIC non-tweening CSSPropTween
847 var pt = new CSSPropTween(target, prop, start, end - start, next, -1, overwriteProp);
848 pt.b = start;
849 pt.e = pt.xs0 = end;
850 return pt;
851 },
852
853 /**
854 * Takes a target, the beginning value and ending value (as strings) and parses them into a CSSPropTween (possibly with child CSSPropTweens) that accommodates multiple numbers, colors, comma-delimited values, etc. For example:
855 * sp.parseComplex(element, "boxShadow", "5px 10px 20px rgb(255,102,51)", "0px 0px 0px red", true, "0px 0px 0px rgb(0,0,0,0)", pt);
856 * It will walk through the beginning and ending values (which should be in the same format with the same number and type of values) and figure out which parts are numbers, what strings separate the numeric/tweenable values, and then create the CSSPropTweens accordingly. If a plugin is defined, no child CSSPropTweens will be created. Instead, the ending values will be stored in the "data" property of the returned CSSPropTween like: {s:-5, xn1:-10, xn2:-20, xn3:255, xn4:0, xn5:0} so that it can be fed to any other plugin and it'll be plain numeric tweens but the recomposition of the complex value will be handled inside CSSPlugin's setRatio().
857 * If a setRatio is defined, the type of the CSSPropTween will be set to 2 and recomposition of the values will be the responsibility of that method.
858 *
859 * @param {!Object} t Target whose property will be tweened
860 * @param {!string} p Property that will be tweened (its name, like "left" or "backgroundColor" or "boxShadow")
861 * @param {string} b Beginning value
862 * @param {string} e Ending value
863 * @param {boolean} clrs If true, the value could contain a color value like "rgb(255,0,0)" or "#F00" or "red". The default is false, so no colors will be recognized (a performance optimization)
864 * @param {(string|number|Object)} dflt The default beginning value that should be used if no valid beginning value is defined or if the number of values inside the complex beginning and ending values don't match
865 * @param {?CSSPropTween} pt CSSPropTween instance that is the current head of the linked list (we'll prepend to this).
866 * @param {number=} pr Priority in the linked list order. Higher priority properties will be updated before lower priority ones. The default priority is 0.
867 * @param {TweenPlugin=} plugin If a plugin should handle the tweening of extra properties, pass the plugin instance here. If one is defined, then NO subtweens will be created for any extra properties (the properties will be created - just not additional CSSPropTween instances to tween them) because the plugin is expected to do so. However, the end values WILL be populated in the "data" property, like {s:100, xn1:50, xn2:300}
868 * @param {function(number)=} setRatio If values should be set in a custom function instead of being pieced together in a type:1 (complex-value) CSSPropTween, define that custom function here.
869 * @return {CSSPropTween} The first CSSPropTween in the linked list which includes the new one(s) added by the parseComplex() call.
870 */
871 _parseComplex = CSSPlugin.parseComplex = function(t, p, b, e, clrs, dflt, pt, pr, plugin, setRatio) {
872 //DEBUG: _log("parseComplex: "+p+", b: "+b+", e: "+e);
873 b = b || dflt || "";
874 if (typeof(e) === "function") {
875 e = e(_index, _target);
876 }
877 pt = new CSSPropTween(t, p, 0, 0, pt, (setRatio ? 2 : 1), null, false, pr, b, e);
878 e += ""; //ensures it's a string
879 if (clrs && _colorExp.test(e + b)) { //if colors are found, normalize the formatting to rgba() or hsla().
880 e = [b, e];
881 CSSPlugin.colorStringFilter(e);
882 b = e[0];
883 e = e[1];
884 }
885 var ba = b.split(", ").join(",").split(" "), //beginning array
886 ea = e.split(", ").join(",").split(" "), //ending array
887 l = ba.length,
888 autoRound = (_autoRound !== false),
889 i, xi, ni, bv, ev, bnums, enums, bn, hasAlpha, temp, cv, str, useHSL;
890 if (e.indexOf(",") !== -1 || b.indexOf(",") !== -1) {
891 if ((e + b).indexOf("rgb") !== -1 || (e + b).indexOf("hsl") !== -1) { //keep rgb(), rgba(), hsl(), and hsla() values together! (remember, we're splitting on spaces)
892 ba = ba.join(" ").replace(_commasOutsideParenExp, ", ").split(" ");
893 ea = ea.join(" ").replace(_commasOutsideParenExp, ", ").split(" ");
894 } else {
895 ba = ba.join(" ").split(",").join(", ").split(" ");
896 ea = ea.join(" ").split(",").join(", ").split(" ");
897 }
898 l = ba.length;
899 }
900 if (l !== ea.length) {
901 //DEBUG: _log("mismatched formatting detected on " + p + " (" + b + " vs " + e + ")");
902 ba = (dflt || "").split(" ");
903 l = ba.length;
904 }
905 pt.plugin = plugin;
906 pt.setRatio = setRatio;
907 _colorExp.lastIndex = 0;
908 for (i = 0; i < l; i++) {
909 bv = ba[i];
910 ev = ea[i] + "";
911 bn = parseFloat(bv);
912 //if the value begins with a number (most common). It's fine if it has a suffix like px
913 if (bn || bn === 0) {
914 pt.appendXtra("", bn, _parseChange(ev, bn), ev.replace(_relNumExp, ""), (autoRound && ev.indexOf("px") !== -1) ? Math.round : false, true);
915
916 //if the value is a color
917 } else if (clrs && _colorExp.test(bv)) {
918 str = ev.indexOf(")") + 1;
919 str = ")" + (str ? ev.substr(str) : ""); //if there's a comma or ) at the end, retain it.
920 useHSL = (ev.indexOf("hsl") !== -1 && _supportsOpacity);
921 temp = ev; //original string value so we can look for any prefix later.
922 bv = _parseColor(bv, useHSL);
923 ev = _parseColor(ev, useHSL);
924 hasAlpha = (bv.length + ev.length > 6);
925 if (hasAlpha && !_supportsOpacity && ev[3] === 0) { //older versions of IE don't support rgba(), so if the destination alpha is 0, just use "transparent" for the end color
926 pt["xs" + pt.l] += pt.l ? " transparent" : "transparent";
927 pt.e = pt.e.split(ea[i]).join("transparent");
928 } else {
929 if (!_supportsOpacity) { //old versions of IE don't support rgba().
930 hasAlpha = false;
931 }
932 if (useHSL) {
933 pt.appendXtra(temp.substr(0, temp.indexOf("hsl")) + (hasAlpha ? "hsla(" : "hsl("), bv[0], _parseChange(ev[0], bv[0]), ",", false, true)
934 .appendXtra("", bv[1], _parseChange(ev[1], bv[1]), "%,", false)
935 .appendXtra("", bv[2], _parseChange(ev[2], bv[2]), (hasAlpha ? "%," : "%" + str), false);
936 } else {
937 pt.appendXtra(temp.substr(0, temp.indexOf("rgb")) + (hasAlpha ? "rgba(" : "rgb("), bv[0], ev[0] - bv[0], ",", Math.round, true)
938 .appendXtra("", bv[1], ev[1] - bv[1], ",", Math.round)
939 .appendXtra("", bv[2], ev[2] - bv[2], (hasAlpha ? "," : str), Math.round);
940 }
941
942 if (hasAlpha) {
943 bv = (bv.length < 4) ? 1 : bv[3];
944 pt.appendXtra("", bv, ((ev.length < 4) ? 1 : ev[3]) - bv, str, false);
945 }
946 }
947 _colorExp.lastIndex = 0; //otherwise the test() on the RegExp could move the lastIndex and taint future results.
948
949 } else {
950 bnums = bv.match(_numExp); //gets each group of numbers in the beginning value string and drops them into an array
951
952 //if no number is found, treat it as a non-tweening value and just append the string to the current xs.
953 if (!bnums) {
954 pt["xs" + pt.l] += (pt.l || pt["xs" + pt.l]) ? " " + ev : ev;
955
956 //loop through all the numbers that are found and construct the extra values on the pt.
957 } else {
958 enums = ev.match(_relNumExp); //get each group of numbers in the end value string and drop them into an array. We allow relative values too, like +=50 or -=.5
959 if (!enums || enums.length !== bnums.length) {
960 //DEBUG: _log("mismatched formatting detected on " + p + " (" + b + " vs " + e + ")");
961 return pt;
962 }
963 ni = 0;
964 for (xi = 0; xi < bnums.length; xi++) {
965 cv = bnums[xi];
966 temp = bv.indexOf(cv, ni);
967 pt.appendXtra(bv.substr(ni, temp - ni), Number(cv), _parseChange(enums[xi], cv), "", (autoRound && bv.substr(temp + cv.length, 2) === "px") ? Math.round : false, (xi === 0));
968 ni = temp + cv.length;
969 }
970 pt["xs" + pt.l] += bv.substr(ni);
971 }
972 }
973 }
974 //if there are relative values ("+=" or "-=" prefix), we need to adjust the ending value to eliminate the prefixes and combine the values properly.
975 if (e.indexOf("=") !== -1) if (pt.data) {
976 str = pt.xs0 + pt.data.s;
977 for (i = 1; i < pt.l; i++) {
978 str += pt["xs" + i] + pt.data["xn" + i];
979 }
980 pt.e = str + pt["xs" + i];
981 }
982 if (!pt.l) {
983 pt.type = -1;
984 pt.xs0 = pt.e;
985 }
986 return pt.xfirst || pt;
987 },
988 i = 9;
989
990
991 p = CSSPropTween.prototype;
992 p.l = p.pr = 0; //length (number of extra properties like xn1, xn2, xn3, etc.
993 while (--i > 0) {
994 p["xn" + i] = 0;
995 p["xs" + i] = "";
996 }
997 p.xs0 = "";
998 p._next = p._prev = p.xfirst = p.data = p.plugin = p.setRatio = p.rxp = null;
999
1000
1001 /**
1002 * Appends and extra tweening value to a CSSPropTween and automatically manages any prefix and suffix strings. The first extra value is stored in the s and c of the main CSSPropTween instance, but thereafter any extras are stored in the xn1, xn2, xn3, etc. The prefixes and suffixes are stored in the xs0, xs1, xs2, etc. properties. For example, if I walk through a clip value like "rect(10px, 5px, 0px, 20px)", the values would be stored like this:
1003 * xs0:"rect(", s:10, xs1:"px, ", xn1:5, xs2:"px, ", xn2:0, xs3:"px, ", xn3:20, xn4:"px)"
1004 * And they'd all get joined together when the CSSPlugin renders (in the setRatio() method).
1005 * @param {string=} pfx Prefix (if any)
1006 * @param {!number} s Starting value
1007 * @param {!number} c Change in numeric value over the course of the entire tween. For example, if the start is 5 and the end is 100, the change would be 95.
1008 * @param {string=} sfx Suffix (if any)
1009 * @param {boolean=} r Round (if true).
1010 * @param {boolean=} pad If true, this extra value should be separated by the previous one by a space. If there is no previous extra and pad is true, it will automatically drop the space.
1011 * @return {CSSPropTween} returns itself so that multiple methods can be chained together.
1012 */
1013 p.appendXtra = function(pfx, s, c, sfx, r, pad) {
1014 var pt = this,
1015 l = pt.l;
1016 pt["xs" + l] += (pad && (l || pt["xs" + l])) ? " " + pfx : pfx || "";
1017 if (!c) if (l !== 0 && !pt.plugin) { //typically we'll combine non-changing values right into the xs to optimize performance, but we don't combine them when there's a plugin that will be tweening the values because it may depend on the values being split apart, like for a bezier, if a value doesn't change between the first and second iteration but then it does on the 3rd, we'll run into trouble because there's no xn slot for that value!
1018 pt["xs" + l] += s + (sfx || "");
1019 return pt;
1020 }
1021 pt.l++;
1022 pt.type = pt.setRatio ? 2 : 1;
1023 pt["xs" + pt.l] = sfx || "";
1024 if (l > 0) {
1025 pt.data["xn" + l] = s + c;
1026 pt.rxp["xn" + l] = r; //round extra property (we need to tap into this in the _parseToProxy() method)
1027 pt["xn" + l] = s;
1028 if (!pt.plugin) {
1029 pt.xfirst = new CSSPropTween(pt, "xn" + l, s, c, pt.xfirst || pt, 0, pt.n, r, pt.pr);
1030 pt.xfirst.xs0 = 0; //just to ensure that the property stays numeric which helps modern browsers speed up processing. Remember, in the setRatio() method, we do pt.t[pt.p] = val + pt.xs0 so if pt.xs0 is "" (the default), it'll cast the end value as a string. When a property is a number sometimes and a string sometimes, it prevents the compiler from locking in the data type, slowing things down slightly.
1031 }
1032 return pt;
1033 }
1034 pt.data = {s:s + c};
1035 pt.rxp = {};
1036 pt.s = s;
1037 pt.c = c;
1038 pt.r = r;
1039 return pt;
1040 };
1041
1042 /**
1043 * @constructor A SpecialProp is basically a css property that needs to be treated in a non-standard way, like if it may contain a complex value like boxShadow:"5px 10px 15px rgb(255, 102, 51)" or if it is associated with another plugin like ThrowPropsPlugin or BezierPlugin. Every SpecialProp is associated with a particular property name like "boxShadow" or "throwProps" or "bezier" and it will intercept those values in the vars object that's passed to the CSSPlugin and handle them accordingly.
1044 * @param {!string} p Property name (like "boxShadow" or "throwProps")
1045 * @param {Object=} options An object containing any of the following configuration options:
1046 * - defaultValue: the default value
1047 * - parser: A function that should be called when the associated property name is found in the vars. This function should return a CSSPropTween instance and it should ensure that it is properly inserted into the linked list. It will receive 4 paramters: 1) The target, 2) The value defined in the vars, 3) The CSSPlugin instance (whose _firstPT should be used for the linked list), and 4) A computed style object if one was calculated (this is a speed optimization that allows retrieval of starting values quicker)
1048 * - formatter: a function that formats any value received for this special property (for example, boxShadow could take "5px 5px red" and format it to "5px 5px 0px 0px red" so that both the beginning and ending values have a common order and quantity of values.)
1049 * - prefix: if true, we'll determine whether or not this property requires a vendor prefix (like Webkit or Moz or ms or O)
1050 * - color: set this to true if the value for this SpecialProp may contain color-related values like rgb(), rgba(), etc.
1051 * - priority: priority in the linked list order. Higher priority SpecialProps will be updated before lower priority ones. The default priority is 0.
1052 * - multi: if true, the formatter should accommodate a comma-delimited list of values, like boxShadow could have multiple boxShadows listed out.
1053 * - collapsible: if true, the formatter should treat the value like it's a top/right/bottom/left value that could be collapsed, like "5px" would apply to all, "5px, 10px" would use 5px for top/bottom and 10px for right/left, etc.
1054 * - keyword: a special keyword that can [optionally] be found inside the value (like "inset" for boxShadow). This allows us to validate beginning/ending values to make sure they match (if the keyword is found in one, it'll be added to the other for consistency by default).
1055 */
1056 var SpecialProp = function(p, options) {
1057 options = options || {};
1058 this.p = options.prefix ? _checkPropPrefix(p) || p : p;
1059 _specialProps[p] = _specialProps[this.p] = this;
1060 this.format = options.formatter || _getFormatter(options.defaultValue, options.color, options.collapsible, options.multi);
1061 if (options.parser) {
1062 this.parse = options.parser;
1063 }
1064 this.clrs = options.color;
1065 this.multi = options.multi;
1066 this.keyword = options.keyword;
1067 this.dflt = options.defaultValue;
1068 this.allowFunc = options.allowFunc;
1069 this.pr = options.priority || 0;
1070 },
1071
1072 //shortcut for creating a new SpecialProp that can accept multiple properties as a comma-delimited list (helps minification). dflt can be an array for multiple values (we don't do a comma-delimited list because the default value may contain commas, like rect(0px,0px,0px,0px)). We attach this method to the SpecialProp class/object instead of using a private _createSpecialProp() method so that we can tap into it externally if necessary, like from another plugin.
1073 _registerComplexSpecialProp = _internals._registerComplexSpecialProp = function(p, options, defaults) {
1074 if (typeof(options) !== "object") {
1075 options = {parser:defaults}; //to make backwards compatible with older versions of BezierPlugin and ThrowPropsPlugin
1076 }
1077 var a = p.split(","),
1078 d = options.defaultValue,
1079 i, temp;
1080 defaults = defaults || [d];
1081 for (i = 0; i < a.length; i++) {
1082 options.prefix = (i === 0 && options.prefix);
1083 options.defaultValue = defaults[i] || d;
1084 temp = new SpecialProp(a[i], options);
1085 }
1086 },
1087
1088 //creates a placeholder special prop for a plugin so that the property gets caught the first time a tween of it is attempted, and at that time it makes the plugin register itself, thus taking over for all future tweens of that property. This allows us to not mandate that things load in a particular order and it also allows us to log() an error that informs the user when they attempt to tween an external plugin-related property without loading its .js file.
1089 _registerPluginProp = _internals._registerPluginProp = function(p) {
1090 if (!_specialProps[p]) {
1091 var pluginName = p.charAt(0).toUpperCase() + p.substr(1) + "Plugin";
1092 _registerComplexSpecialProp(p, {parser:function(t, e, p, cssp, pt, plugin, vars) {
1093 var pluginClass = _globals.com.greensock.plugins[pluginName];
1094 if (!pluginClass) {
1095 _log("Error: " + pluginName + " js file not loaded.");
1096 return pt;
1097 }
1098 pluginClass._cssRegister();
1099 return _specialProps[p].parse(t, e, p, cssp, pt, plugin, vars);
1100 }});
1101 }
1102 };
1103
1104
1105 p = SpecialProp.prototype;
1106
1107 /**
1108 * Alias for _parseComplex() that automatically plugs in certain values for this SpecialProp, like its property name, whether or not colors should be sensed, the default value, and priority. It also looks for any keyword that the SpecialProp defines (like "inset" for boxShadow) and ensures that the beginning and ending values have the same number of values for SpecialProps where multi is true (like boxShadow and textShadow can have a comma-delimited list)
1109 * @param {!Object} t target element
1110 * @param {(string|number|object)} b beginning value
1111 * @param {(string|number|object)} e ending (destination) value
1112 * @param {CSSPropTween=} pt next CSSPropTween in the linked list
1113 * @param {TweenPlugin=} plugin If another plugin will be tweening the complex value, that TweenPlugin instance goes here.
1114 * @param {function=} setRatio If a custom setRatio() method should be used to handle this complex value, that goes here.
1115 * @return {CSSPropTween=} First CSSPropTween in the linked list
1116 */
1117 p.parseComplex = function(t, b, e, pt, plugin, setRatio) {
1118 var kwd = this.keyword,
1119 i, ba, ea, l, bi, ei;
1120 //if this SpecialProp's value can contain a comma-delimited list of values (like boxShadow or textShadow), we must parse them in a special way, and look for a keyword (like "inset" for boxShadow) and ensure that the beginning and ending BOTH have it if the end defines it as such. We also must ensure that there are an equal number of values specified (we can't tween 1 boxShadow to 3 for example)
1121 if (this.multi) if (_commasOutsideParenExp.test(e) || _commasOutsideParenExp.test(b)) {
1122 ba = b.replace(_commasOutsideParenExp, "|").split("|");
1123 ea = e.replace(_commasOutsideParenExp, "|").split("|");
1124 } else if (kwd) {
1125 ba = [b];
1126 ea = [e];
1127 }
1128 if (ea) {
1129 l = (ea.length > ba.length) ? ea.length : ba.length;
1130 for (i = 0; i < l; i++) {
1131 b = ba[i] = ba[i] || this.dflt;
1132 e = ea[i] = ea[i] || this.dflt;
1133 if (kwd) {
1134 bi = b.indexOf(kwd);
1135 ei = e.indexOf(kwd);
1136 if (bi !== ei) {
1137 if (ei === -1) { //if the keyword isn't in the end value, remove it from the beginning one.
1138 ba[i] = ba[i].split(kwd).join("");
1139 } else if (bi === -1) { //if the keyword isn't in the beginning, add it.
1140 ba[i] += " " + kwd;
1141 }
1142 }
1143 }
1144 }
1145 b = ba.join(", ");
1146 e = ea.join(", ");
1147 }
1148 return _parseComplex(t, this.p, b, e, this.clrs, this.dflt, pt, this.pr, plugin, setRatio);
1149 };
1150
1151 /**
1152 * Accepts a target and end value and spits back a CSSPropTween that has been inserted into the CSSPlugin's linked list and conforms with all the conventions we use internally, like type:-1, 0, 1, or 2, setting up any extra property tweens, priority, etc. For example, if we have a boxShadow SpecialProp and call:
1153 * this._firstPT = sp.parse(element, "5px 10px 20px rgb(2550,102,51)", "boxShadow", this);
1154 * It should figure out the starting value of the element's boxShadow, compare it to the provided end value and create all the necessary CSSPropTweens of the appropriate types to tween the boxShadow. The CSSPropTween that gets spit back should already be inserted into the linked list (the 4th parameter is the current head, so prepend to that).
1155 * @param {!Object} t Target object whose property is being tweened
1156 * @param {Object} e End value as provided in the vars object (typically a string, but not always - like a throwProps would be an object).
1157 * @param {!string} p Property name
1158 * @param {!CSSPlugin} cssp The CSSPlugin instance that should be associated with this tween.
1159 * @param {?CSSPropTween} pt The CSSPropTween that is the current head of the linked list (we'll prepend to it)
1160 * @param {TweenPlugin=} plugin If a plugin will be used to tween the parsed value, this is the plugin instance.
1161 * @param {Object=} vars Original vars object that contains the data for parsing.
1162 * @return {CSSPropTween} The first CSSPropTween in the linked list which includes the new one(s) added by the parse() call.
1163 */
1164 p.parse = function(t, e, p, cssp, pt, plugin, vars) {
1165 return this.parseComplex(t.style, this.format(_getStyle(t, this.p, _cs, false, this.dflt)), this.format(e), pt, plugin);
1166 };
1167
1168 /**
1169 * Registers a special property that should be intercepted from any "css" objects defined in tweens. This allows you to handle them however you want without CSSPlugin doing it for you. The 2nd parameter should be a function that accepts 3 parameters:
1170 * 1) Target object whose property should be tweened (typically a DOM element)
1171 * 2) The end/destination value (could be a string, number, object, or whatever you want)
1172 * 3) The tween instance (you probably don't need to worry about this, but it can be useful for looking up information like the duration)
1173 *
1174 * Then, your function should return a function which will be called each time the tween gets rendered, passing a numeric "ratio" parameter to your function that indicates the change factor (usually between 0 and 1). For example:
1175 *
1176 * CSSPlugin.registerSpecialProp("myCustomProp", function(target, value, tween) {
1177 * var start = target.style.width;
1178 * return function(ratio) {
1179 * target.style.width = (start + value * ratio) + "px";
1180 * console.log("set width to " + target.style.width);
1181 * }
1182 * }, 0);
1183 *
1184 * Then, when I do this tween, it will trigger my special property:
1185 *
1186 * TweenLite.to(element, 1, {css:{myCustomProp:100}});
1187 *
1188 * In the example, of course, we're just changing the width, but you can do anything you want.
1189 *
1190 * @param {!string} name Property name (or comma-delimited list of property names) that should be intercepted and handled by your function. For example, if I define "myCustomProp", then it would handle that portion of the following tween: TweenLite.to(element, 1, {css:{myCustomProp:100}})
1191 * @param {!function(Object, Object, Object, string):function(number)} onInitTween The function that will be called when a tween of this special property is performed. The function will receive 4 parameters: 1) Target object that should be tweened, 2) Value that was passed to the tween, 3) The tween instance itself (rarely used), and 4) The property name that's being tweened. Your function should return a function that should be called on every update of the tween. That function will receive a single parameter that is a "change factor" value (typically between 0 and 1) indicating the amount of change as a ratio. You can use this to determine how to set the values appropriately in your function.
1192 * @param {number=} priority Priority that helps the engine determine the order in which to set the properties (default: 0). Higher priority properties will be updated before lower priority ones.
1193 */
1194 CSSPlugin.registerSpecialProp = function(name, onInitTween, priority) {
1195 _registerComplexSpecialProp(name, {parser:function(t, e, p, cssp, pt, plugin, vars) {
1196 var rv = new CSSPropTween(t, p, 0, 0, pt, 2, p, false, priority);
1197 rv.plugin = plugin;
1198 rv.setRatio = onInitTween(t, e, cssp._tween, p);
1199 return rv;
1200 }, priority:priority});
1201 };
1202
1203
1204
1205
1206
1207
1208 //transform-related methods and properties
1209 CSSPlugin.useSVGTransformAttr = true; //Safari and Firefox both have some rendering bugs when applying CSS transforms to SVG elements, so default to using the "transform" attribute instead (users can override this).
1210 var _transformProps = ("scaleX,scaleY,scaleZ,x,y,z,skewX,skewY,rotation,rotationX,rotationY,perspective,xPercent,yPercent").split(","),
1211 _transformProp = _checkPropPrefix("transform"), //the Javascript (camelCase) transform property, like msTransform, WebkitTransform, MozTransform, or OTransform.
1212 _transformPropCSS = _prefixCSS + "transform",
1213 _transformOriginProp = _checkPropPrefix("transformOrigin"),
1214 _supports3D = (_checkPropPrefix("perspective") !== null),
1215 Transform = _internals.Transform = function() {
1216 this.perspective = parseFloat(CSSPlugin.defaultTransformPerspective) || 0;
1217 this.force3D = (CSSPlugin.defaultForce3D === false || !_supports3D) ? false : CSSPlugin.defaultForce3D || "auto";
1218 },
1219 _SVGElement = _gsScope.SVGElement,
1220 _useSVGTransformAttr,
1221 //Some browsers (like Firefox and IE) don't honor transform-origin properly in SVG elements, so we need to manually adjust the matrix accordingly. We feature detect here rather than always doing the conversion for certain browsers because they may fix the problem at some point in the future.
1222
1223 _createSVG = function(type, container, attributes) {
1224 var element = _doc.createElementNS("http://www.w3.org/2000/svg", type),
1225 reg = /([a-z])([A-Z])/g,
1226 p;
1227 for (p in attributes) {
1228 element.setAttributeNS(null, p.replace(reg, "$1-$2").toLowerCase(), attributes[p]);
1229 }
1230 container.appendChild(element);
1231 return element;
1232 },
1233 _docElement = _doc.documentElement || {},
1234 _forceSVGTransformAttr = (function() {
1235 //IE and Android stock don't support CSS transforms on SVG elements, so we must write them to the "transform" attribute. We populate this variable in the _parseTransform() method, and only if/when we come across an SVG element
1236 var force = _ieVers || (/Android/i.test(_agent) && !_gsScope.chrome),
1237 svg, rect, width;
1238 if (_doc.createElementNS && _docElement.appendChild && !force) { //IE8 and earlier doesn't support SVG anyway
1239 svg = _createSVG("svg", _docElement);
1240 rect = _createSVG("rect", svg, {width:100, height:50, x:100});
1241 width = rect.getBoundingClientRect().width;
1242 rect.style[_transformOriginProp] = "50% 50%";
1243 rect.style[_transformProp] = "scaleX(0.5)";
1244 force = (width === rect.getBoundingClientRect().width && !(_isFirefox && _supports3D)); //note: Firefox fails the test even though it does support CSS transforms in 3D. Since we can't push 3D stuff into the transform attribute, we force Firefox to pass the test here (as long as it does truly support 3D).
1245 _docElement.removeChild(svg);
1246 }
1247 return force;
1248 })(),
1249 _parseSVGOrigin = function(e, local, decoratee, absolute, smoothOrigin, skipRecord) {
1250 var tm = e._gsTransform,
1251 m = _getMatrix(e, true),
1252 v, x, y, xOrigin, yOrigin, a, b, c, d, tx, ty, determinant, xOriginOld, yOriginOld;
1253 if (tm) {
1254 xOriginOld = tm.xOrigin; //record the original values before we alter them.
1255 yOriginOld = tm.yOrigin;
1256 }
1257 if (!absolute || (v = absolute.split(" ")).length < 2) {
1258 b = e.getBBox();
1259 if (b.x === 0 && b.y === 0 && b.width + b.height === 0) { //some browsers (like Firefox) misreport the bounds if the element has zero width and height (it just assumes it's at x:0, y:0), thus we need to manually grab the position in that case.
1260 b = {x: parseFloat(e.hasAttribute("x") ? e.getAttribute("x") : e.hasAttribute("cx") ? e.getAttribute("cx") : 0) || 0, y: parseFloat(e.hasAttribute("y") ? e.getAttribute("y") : e.hasAttribute("cy") ? e.getAttribute("cy") : 0) || 0, width:0, height:0};
1261 }
1262 local = _parsePosition(local).split(" ");
1263 v = [(local[0].indexOf("%") !== -1 ? parseFloat(local[0]) / 100 * b.width : parseFloat(local[0])) + b.x,
1264 (local[1].indexOf("%") !== -1 ? parseFloat(local[1]) / 100 * b.height : parseFloat(local[1])) + b.y];
1265 }
1266 decoratee.xOrigin = xOrigin = parseFloat(v[0]);
1267 decoratee.yOrigin = yOrigin = parseFloat(v[1]);
1268 if (absolute && m !== _identity2DMatrix) { //if svgOrigin is being set, we must invert the matrix and determine where the absolute point is, factoring in the current transforms. Otherwise, the svgOrigin would be based on the element's non-transformed position on the canvas.
1269 a = m[0];
1270 b = m[1];
1271 c = m[2];
1272 d = m[3];
1273 tx = m[4];
1274 ty = m[5];
1275 determinant = (a * d - b * c);
1276 if (determinant) { //if it's zero (like if scaleX and scaleY are zero), skip it to avoid errors with dividing by zero.
1277 x = xOrigin * (d / determinant) + yOrigin * (-c / determinant) + ((c * ty - d * tx) / determinant);
1278 y = xOrigin * (-b / determinant) + yOrigin * (a / determinant) - ((a * ty - b * tx) / determinant);
1279 xOrigin = decoratee.xOrigin = v[0] = x;
1280 yOrigin = decoratee.yOrigin = v[1] = y;
1281 }
1282 }
1283 if (tm) { //avoid jump when transformOrigin is changed - adjust the x/y values accordingly
1284 if (skipRecord) {
1285 decoratee.xOffset = tm.xOffset;
1286 decoratee.yOffset = tm.yOffset;
1287 tm = decoratee;
1288 }
1289 if (smoothOrigin || (smoothOrigin !== false && CSSPlugin.defaultSmoothOrigin !== false)) {
1290 x = xOrigin - xOriginOld;
1291 y = yOrigin - yOriginOld;
1292 //originally, we simply adjusted the x and y values, but that would cause problems if, for example, you created a rotational tween part-way through an x/y tween. Managing the offset in a separate variable gives us ultimate flexibility.
1293 //tm.x -= x - (x * m[0] + y * m[2]);
1294 //tm.y -= y - (x * m[1] + y * m[3]);
1295 tm.xOffset += (x * m[0] + y * m[2]) - x;
1296 tm.yOffset += (x * m[1] + y * m[3]) - y;
1297 } else {
1298 tm.xOffset = tm.yOffset = 0;
1299 }
1300 }
1301 if (!skipRecord) {
1302 e.setAttribute("data-svg-origin", v.join(" "));
1303 }
1304 },
1305 _getBBoxHack = function(swapIfPossible) { //works around issues in some browsers (like Firefox) that don't correctly report getBBox() on SVG elements inside a <defs> element and/or <mask>. We try creating an SVG, adding it to the documentElement and toss the element in there so that it's definitely part of the rendering tree, then grab the bbox and if it works, we actually swap out the original getBBox() method for our own that does these extra steps whenever getBBox is needed. This helps ensure that performance is optimal (only do all these extra steps when absolutely necessary...most elements don't need it).
1306 var svg = _createElement("svg", (this.ownerSVGElement && this.ownerSVGElement.getAttribute("xmlns")) || "http://www.w3.org/2000/svg"),
1307 oldParent = this.parentNode,
1308 oldSibling = this.nextSibling,
1309 oldCSS = this.style.cssText,
1310 bbox;
1311 _docElement.appendChild(svg);
1312 svg.appendChild(this);
1313 this.style.display = "block";
1314 if (swapIfPossible) {
1315 try {
1316 bbox = this.getBBox();
1317 this._originalGetBBox = this.getBBox;
1318 this.getBBox = _getBBoxHack;
1319 } catch (e) { }
1320 } else if (this._originalGetBBox) {
1321 bbox = this._originalGetBBox();
1322 }
1323 if (oldSibling) {
1324 oldParent.insertBefore(this, oldSibling);
1325 } else {
1326 oldParent.appendChild(this);
1327 }
1328 _docElement.removeChild(svg);
1329 this.style.cssText = oldCSS;
1330 return bbox;
1331 },
1332 _getBBox = function(e) {
1333 try {
1334 return e.getBBox(); //Firefox throws errors if you try calling getBBox() on an SVG element that's not rendered (like in a <symbol> or <defs>). https://bugzilla.mozilla.org/show_bug.cgi?id=612118
1335 } catch (error) {
1336 return _getBBoxHack.call(e, true);
1337 }
1338 },
1339 _isSVG = function(e) { //reports if the element is an SVG on which getBBox() actually works
1340 return !!(_SVGElement && e.getCTM && (!e.parentNode || e.ownerSVGElement) && _getBBox(e));
1341 },
1342 _identity2DMatrix = [1,0,0,1,0,0],
1343 _getMatrix = function(e, force2D) {
1344 var tm = e._gsTransform || new Transform(),
1345 rnd = 100000,
1346 style = e.style,
1347 isDefault, s, m, n, dec, nextSibling, parent;
1348 if (_transformProp) {
1349 s = _getStyle(e, _transformPropCSS, null, true);
1350 } else if (e.currentStyle) {
1351 //for older versions of IE, we need to interpret the filter portion that is in the format: progid:DXImageTransform.Microsoft.Matrix(M11=6.123233995736766e-17, M12=-1, M21=1, M22=6.123233995736766e-17, sizingMethod='auto expand') Notice that we need to swap b and c compared to a normal matrix.
1352 s = e.currentStyle.filter.match(_ieGetMatrixExp);
1353 s = (s && s.length === 4) ? [s[0].substr(4), Number(s[2].substr(4)), Number(s[1].substr(4)), s[3].substr(4), (tm.x || 0), (tm.y || 0)].join(",") : "";
1354 }
1355 isDefault = (!s || s === "none" || s === "matrix(1, 0, 0, 1, 0, 0)");
1356 if (_transformProp && isDefault && !e.offsetParent && e !== _docElement) { //note: if offsetParent is null, that means the element isn't in the normal document flow, like if it has display:none or one of its ancestors has display:none). Firefox returns null for getComputedStyle() if the element is in an iframe that has display:none. https://bugzilla.mozilla.org/show_bug.cgi?id=548397
1357 //browsers don't report transforms accurately unless the element is in the DOM and has a display value that's not "none". Firefox and Microsoft browsers have a partial bug where they'll report transforms even if display:none BUT not any percentage-based values like translate(-50%, 8px) will be reported as if it's translate(0, 8px).
1358 n = style.display;
1359 style.display = "block";
1360 parent = e.parentNode;
1361 if (!parent || !e.offsetParent) {
1362 dec = 1; //flag
1363 nextSibling = e.nextSibling;
1364 _docElement.appendChild(e); //we must add it to the DOM in order to get values properly
1365 }
1366 s = _getStyle(e, _transformPropCSS, null, true);
1367 isDefault = (!s || s === "none" || s === "matrix(1, 0, 0, 1, 0, 0)");
1368 if (n) {
1369 style.display = n;
1370 } else {
1371 _removeProp(style, "display");
1372 }
1373 if (dec) {
1374 if (nextSibling) {
1375 parent.insertBefore(e, nextSibling);
1376 } else if (parent) {
1377 parent.appendChild(e);
1378 } else {
1379 _docElement.removeChild(e);
1380 }
1381 }
1382 }
1383 if (tm.svg || (e.getCTM && _isSVG(e))) {
1384 if (isDefault && (style[_transformProp] + "").indexOf("matrix") !== -1) { //some browsers (like Chrome 40) don't correctly report transforms that are applied inline on an SVG element (they don't get included in the computed style), so we double-check here and accept matrix values
1385 s = style[_transformProp];
1386 isDefault = 0;
1387 }
1388 m = e.getAttribute("transform");
1389 if (isDefault && m) {
1390 m = e.transform.baseVal.consolidate().matrix; //ensures that even complex values like "translate(50,60) rotate(135,0,0)" are parsed because it mashes it into a matrix.
1391 s = "matrix(" + m.a + "," + m.b + "," + m.c + "," + m.d + "," + m.e + "," + m.f + ")";
1392 isDefault = 0;
1393 }
1394 }
1395 if (isDefault) {
1396 return _identity2DMatrix;
1397 }
1398 //split the matrix values out into an array (m for matrix)
1399 m = (s || "").match(_numExp) || [];
1400 i = m.length;
1401 while (--i > -1) {
1402 n = Number(m[i]);
1403 m[i] = (dec = n - (n |= 0)) ? ((dec * rnd + (dec < 0 ? -0.5 : 0.5)) | 0) / rnd + n : n; //convert strings to Numbers and round to 5 decimal places to avoid issues with tiny numbers. Roughly 20x faster than Number.toFixed(). We also must make sure to round before dividing so that values like 0.9999999999 become 1 to avoid glitches in browser rendering and interpretation of flipped/rotated 3D matrices. And don't just multiply the number by rnd, floor it, and then divide by rnd because the bitwise operations max out at a 32-bit signed integer, thus it could get clipped at a relatively low value (like 22,000.00000 for example).
1404 }
1405 return (force2D && m.length > 6) ? [m[0], m[1], m[4], m[5], m[12], m[13]] : m;
1406 },
1407
1408 /**
1409 * Parses the transform values for an element, returning an object with x, y, z, scaleX, scaleY, scaleZ, rotation, rotationX, rotationY, skewX, and skewY properties. Note: by default (for performance reasons), all skewing is combined into skewX and rotation but skewY still has a place in the transform object so that we can record how much of the skew is attributed to skewX vs skewY. Remember, a skewY of 10 looks the same as a rotation of 10 and skewX of -10.
1410 * @param {!Object} t target element
1411 * @param {Object=} cs computed style object (optional)
1412 * @param {boolean=} rec if true, the transform values will be recorded to the target element's _gsTransform object, like target._gsTransform = {x:0, y:0, z:0, scaleX:1...}
1413 * @param {boolean=} parse if true, we'll ignore any _gsTransform values that already exist on the element, and force a reparsing of the css (calculated style)
1414 * @return {object} object containing all of the transform properties/values like {x:0, y:0, z:0, scaleX:1...}
1415 */
1416 _getTransform = _internals.getTransform = function(t, cs, rec, parse) {
1417 if (t._gsTransform && rec && !parse) {
1418 return t._gsTransform; //if the element already has a _gsTransform, use that. Note: some browsers don't accurately return the calculated style for the transform (particularly for SVG), so it's almost always safest to just use the values we've already applied rather than re-parsing things.
1419 }
1420 var tm = rec ? t._gsTransform || new Transform() : new Transform(),
1421 invX = (tm.scaleX < 0), //in order to interpret things properly, we need to know if the user applied a negative scaleX previously so that we can adjust the rotation and skewX accordingly. Otherwise, if we always interpret a flipped matrix as affecting scaleY and the user only wants to tween the scaleX on multiple sequential tweens, it would keep the negative scaleY without that being the user's intent.
1422 min = 0.00002,
1423 rnd = 100000,
1424 zOrigin = _supports3D ? parseFloat(_getStyle(t, _transformOriginProp, cs, false, "0 0 0").split(" ")[2]) || tm.zOrigin || 0 : 0,
1425 defaultTransformPerspective = parseFloat(CSSPlugin.defaultTransformPerspective) || 0,
1426 m, i, scaleX, scaleY, rotation, skewX;
1427
1428 tm.svg = !!(t.getCTM && _isSVG(t));
1429 if (tm.svg) {
1430 _parseSVGOrigin(t, _getStyle(t, _transformOriginProp, cs, false, "50% 50%") + "", tm, t.getAttribute("data-svg-origin"));
1431 _useSVGTransformAttr = CSSPlugin.useSVGTransformAttr || _forceSVGTransformAttr;
1432 }
1433 m = _getMatrix(t);
1434 if (m !== _identity2DMatrix) {
1435
1436 if (m.length === 16) {
1437 //we'll only look at these position-related 6 variables first because if x/y/z all match, it's relatively safe to assume we don't need to re-parse everything which risks losing important rotational information (like rotationX:180 plus rotationY:180 would look the same as rotation:180 - there's no way to know for sure which direction was taken based solely on the matrix3d() values)
1438 var a11 = m[0], a21 = m[1], a31 = m[2], a41 = m[3],
1439 a12 = m[4], a22 = m[5], a32 = m[6], a42 = m[7],
1440 a13 = m[8], a23 = m[9], a33 = m[10],
1441 a14 = m[12], a24 = m[13], a34 = m[14],
1442 a43 = m[11],
1443 angle = Math.atan2(a32, a33),
1444 t1, t2, t3, t4, cos, sin;
1445 //we manually compensate for non-zero z component of transformOrigin to work around bugs in Safari
1446 if (tm.zOrigin) {
1447 a34 = -tm.zOrigin;
1448 a14 = a13*a34-m[12];
1449 a24 = a23*a34-m[13];
1450 a34 = a33*a34+tm.zOrigin-m[14];
1451 }
1452 //note for possible future consolidation: rotationX: Math.atan2(a32, a33), rotationY: Math.atan2(-a31, Math.sqrt(a33 * a33 + a32 * a32)), rotation: Math.atan2(a21, a11), skew: Math.atan2(a12, a22). However, it doesn't seem to be quite as reliable as the full-on backwards rotation procedure.
1453 tm.rotationX = angle * _RAD2DEG;
1454 //rotationX
1455 if (angle) {
1456 cos = Math.cos(-angle);
1457 sin = Math.sin(-angle);
1458 t1 = a12*cos+a13*sin;
1459 t2 = a22*cos+a23*sin;
1460 t3 = a32*cos+a33*sin;
1461 a13 = a12*-sin+a13*cos;
1462 a23 = a22*-sin+a23*cos;
1463 a33 = a32*-sin+a33*cos;
1464 a43 = a42*-sin+a43*cos;
1465 a12 = t1;
1466 a22 = t2;
1467 a32 = t3;
1468 }
1469 //rotationY
1470 angle = Math.atan2(-a31, a33);
1471 tm.rotationY = angle * _RAD2DEG;
1472 if (angle) {
1473 cos = Math.cos(-angle);
1474 sin = Math.sin(-angle);
1475 t1 = a11*cos-a13*sin;
1476 t2 = a21*cos-a23*sin;
1477 t3 = a31*cos-a33*sin;
1478 a23 = a21*sin+a23*cos;
1479 a33 = a31*sin+a33*cos;
1480 a43 = a41*sin+a43*cos;
1481 a11 = t1;
1482 a21 = t2;
1483 a31 = t3;
1484 }
1485 //rotationZ
1486 angle = Math.atan2(a21, a11);
1487 tm.rotation = angle * _RAD2DEG;
1488 if (angle) {
1489 cos = Math.cos(angle);
1490 sin = Math.sin(angle);
1491 t1 = a11*cos+a21*sin;
1492 t2 = a12*cos+a22*sin;
1493 t3 = a13*cos+a23*sin;
1494 a21 = a21*cos-a11*sin;
1495 a22 = a22*cos-a12*sin;
1496 a23 = a23*cos-a13*sin;
1497 a11 = t1;
1498 a12 = t2;
1499 a13 = t3;
1500 }
1501
1502 if (tm.rotationX && Math.abs(tm.rotationX) + Math.abs(tm.rotation) > 359.9) { //when rotationY is set, it will often be parsed as 180 degrees different than it should be, and rotationX and rotation both being 180 (it looks the same), so we adjust for that here.
1503 tm.rotationX = tm.rotation = 0;
1504 tm.rotationY = 180 - tm.rotationY;
1505 }
1506
1507 //skewX
1508 angle = Math.atan2(a12, a22);
1509
1510 //scales
1511 tm.scaleX = ((Math.sqrt(a11 * a11 + a21 * a21 + a31 * a31) * rnd + 0.5) | 0) / rnd;
1512 tm.scaleY = ((Math.sqrt(a22 * a22 + a32 * a32) * rnd + 0.5) | 0) / rnd;
1513 tm.scaleZ = ((Math.sqrt(a13 * a13 + a23 * a23 + a33 * a33) * rnd + 0.5) | 0) / rnd;
1514 a11 /= tm.scaleX;
1515 a12 /= tm.scaleY;
1516 a21 /= tm.scaleX;
1517 a22 /= tm.scaleY;
1518 if (Math.abs(angle) > min) {
1519 tm.skewX = angle * _RAD2DEG;
1520 a12 = 0; //unskews
1521 if (tm.skewType !== "simple") {
1522 tm.scaleY *= 1 / Math.cos(angle); //by default, we compensate the scale based on the skew so that the element maintains a similar proportion when skewed, so we have to alter the scaleY here accordingly to match the default (non-adjusted) skewing that CSS does (stretching more and more as it skews).
1523 }
1524
1525 } else {
1526 tm.skewX = 0;
1527 }
1528
1529 /* //for testing purposes
1530 var transform = "matrix3d(",
1531 comma = ",",
1532 zero = "0";
1533 a13 /= tm.scaleZ;
1534 a23 /= tm.scaleZ;
1535 a31 /= tm.scaleX;
1536 a32 /= tm.scaleY;
1537 a33 /= tm.scaleZ;
1538 transform += ((a11 < min && a11 > -min) ? zero : a11) + comma + ((a21 < min && a21 > -min) ? zero : a21) + comma + ((a31 < min && a31 > -min) ? zero : a31);
1539 transform += comma + ((a41 < min && a41 > -min) ? zero : a41) + comma + ((a12 < min && a12 > -min) ? zero : a12) + comma + ((a22 < min && a22 > -min) ? zero : a22);
1540 transform += comma + ((a32 < min && a32 > -min) ? zero : a32) + comma + ((a42 < min && a42 > -min) ? zero : a42) + comma + ((a13 < min && a13 > -min) ? zero : a13);
1541 transform += comma + ((a23 < min && a23 > -min) ? zero : a23) + comma + ((a33 < min && a33 > -min) ? zero : a33) + comma + ((a43 < min && a43 > -min) ? zero : a43) + comma;
1542 transform += a14 + comma + a24 + comma + a34 + comma + (tm.perspective ? (1 + (-a34 / tm.perspective)) : 1) + ")";
1543 console.log(transform);
1544 document.querySelector(".test").style[_transformProp] = transform;
1545 */
1546
1547 tm.perspective = a43 ? 1 / ((a43 < 0) ? -a43 : a43) : 0;
1548 tm.x = a14;
1549 tm.y = a24;
1550 tm.z = a34;
1551 if (tm.svg) {
1552 tm.x -= tm.xOrigin - (tm.xOrigin * a11 - tm.yOrigin * a12);
1553 tm.y -= tm.yOrigin - (tm.yOrigin * a21 - tm.xOrigin * a22);
1554 }
1555
1556 } else if ((!_supports3D || parse || !m.length || tm.x !== m[4] || tm.y !== m[5] || (!tm.rotationX && !tm.rotationY))) { //sometimes a 6-element matrix is returned even when we performed 3D transforms, like if rotationX and rotationY are 180. In cases like this, we still need to honor the 3D transforms. If we just rely on the 2D info, it could affect how the data is interpreted, like scaleY might get set to -1 or rotation could get offset by 180 degrees. For example, do a TweenLite.to(element, 1, {css:{rotationX:180, rotationY:180}}) and then later, TweenLite.to(element, 1, {css:{rotationX:0}}) and without this conditional logic in place, it'd jump to a state of being unrotated when the 2nd tween starts. Then again, we need to honor the fact that the user COULD alter the transforms outside of CSSPlugin, like by manually applying new css, so we try to sense that by looking at x and y because if those changed, we know the changes were made outside CSSPlugin and we force a reinterpretation of the matrix values. Also, in Webkit browsers, if the element's "display" is "none", its calculated style value will always return empty, so if we've already recorded the values in the _gsTransform object, we'll just rely on those.
1557 var k = (m.length >= 6),
1558 a = k ? m[0] : 1,
1559 b = m[1] || 0,
1560 c = m[2] || 0,
1561 d = k ? m[3] : 1;
1562 tm.x = m[4] || 0;
1563 tm.y = m[5] || 0;
1564 scaleX = Math.sqrt(a * a + b * b);
1565 scaleY = Math.sqrt(d * d + c * c);
1566 rotation = (a || b) ? Math.atan2(b, a) * _RAD2DEG : tm.rotation || 0; //note: if scaleX is 0, we cannot accurately measure rotation. Same for skewX with a scaleY of 0. Therefore, we default to the previously recorded value (or zero if that doesn't exist).
1567 skewX = (c || d) ? Math.atan2(c, d) * _RAD2DEG + rotation : tm.skewX || 0;
1568 tm.scaleX = scaleX;
1569 tm.scaleY = scaleY;
1570 tm.rotation = rotation;
1571 tm.skewX = skewX;
1572 if (_supports3D) {
1573 tm.rotationX = tm.rotationY = tm.z = 0;
1574 tm.perspective = defaultTransformPerspective;
1575 tm.scaleZ = 1;
1576 }
1577 if (tm.svg) {
1578 tm.x -= tm.xOrigin - (tm.xOrigin * a + tm.yOrigin * c);
1579 tm.y -= tm.yOrigin - (tm.xOrigin * b + tm.yOrigin * d);
1580 }
1581 }
1582 if (Math.abs(tm.skewX) > 90 && Math.abs(tm.skewX) < 270) {
1583 if (invX) {
1584 tm.scaleX *= -1;
1585 tm.skewX += (tm.rotation <= 0) ? 180 : -180;
1586 tm.rotation += (tm.rotation <= 0) ? 180 : -180;
1587 } else {
1588 tm.scaleY *= -1;
1589 tm.skewX += (tm.skewX <= 0) ? 180 : -180;
1590 }
1591 }
1592 tm.zOrigin = zOrigin;
1593 //some browsers have a hard time with very small values like 2.4492935982947064e-16 (notice the "e-" towards the end) and would render the object slightly off. So we round to 0 in these cases. The conditional logic here is faster than calling Math.abs(). Also, browsers tend to render a SLIGHTLY rotated object in a fuzzy way, so we need to snap to exactly 0 when appropriate.
1594 for (i in tm) {
1595 if (tm[i] < min) if (tm[i] > -min) {
1596 tm[i] = 0;
1597 }
1598 }
1599 }
1600 //DEBUG: _log("parsed rotation of " + t.getAttribute("id")+": "+(tm.rotationX)+", "+(tm.rotationY)+", "+(tm.rotation)+", scale: "+tm.scaleX+", "+tm.scaleY+", "+tm.scaleZ+", position: "+tm.x+", "+tm.y+", "+tm.z+", perspective: "+tm.perspective+ ", origin: "+ tm.xOrigin+ ","+ tm.yOrigin);
1601 if (rec) {
1602 t._gsTransform = tm; //record to the object's _gsTransform which we use so that tweens can control individual properties independently (we need all the properties to accurately recompose the matrix in the setRatio() method)
1603 if (tm.svg) { //if we're supposed to apply transforms to the SVG element's "transform" attribute, make sure there aren't any CSS transforms applied or they'll override the attribute ones. Also clear the transform attribute if we're using CSS, just to be clean.
1604 if (_useSVGTransformAttr && t.style[_transformProp]) {
1605 TweenLite.delayedCall(0.001, function(){ //if we apply this right away (before anything has rendered), we risk there being no transforms for a brief moment and it also interferes with adjusting the transformOrigin in a tween with immediateRender:true (it'd try reading the matrix and it wouldn't have the appropriate data in place because we just removed it).
1606 _removeProp(t.style, _transformProp);
1607 });
1608 } else if (!_useSVGTransformAttr && t.getAttribute("transform")) {
1609 TweenLite.delayedCall(0.001, function(){
1610 t.removeAttribute("transform");
1611 });
1612 }
1613 }
1614 }
1615 return tm;
1616 },
1617
1618 //for setting 2D transforms in IE6, IE7, and IE8 (must use a "filter" to emulate the behavior of modern day browser transforms)
1619 _setIETransformRatio = function(v) {
1620 var t = this.data, //refers to the element's _gsTransform object
1621 ang = -t.rotation * _DEG2RAD,
1622 skew = ang + t.skewX * _DEG2RAD,
1623 rnd = 100000,
1624 a = ((Math.cos(ang) * t.scaleX * rnd) | 0) / rnd,
1625 b = ((Math.sin(ang) * t.scaleX * rnd) | 0) / rnd,
1626 c = ((Math.sin(skew) * -t.scaleY * rnd) | 0) / rnd,
1627 d = ((Math.cos(skew) * t.scaleY * rnd) | 0) / rnd,
1628 style = this.t.style,
1629 cs = this.t.currentStyle,
1630 filters, val;
1631 if (!cs) {
1632 return;
1633 }
1634 val = b; //just for swapping the variables an inverting them (reused "val" to avoid creating another variable in memory). IE's filter matrix uses a non-standard matrix configuration (angle goes the opposite way, and b and c are reversed and inverted)
1635 b = -c;
1636 c = -val;
1637 filters = cs.filter;
1638 style.filter = ""; //remove filters so that we can accurately measure offsetWidth/offsetHeight
1639 var w = this.t.offsetWidth,
1640 h = this.t.offsetHeight,
1641 clip = (cs.position !== "absolute"),
1642 m = "progid:DXImageTransform.Microsoft.Matrix(M11=" + a + ", M12=" + b + ", M21=" + c + ", M22=" + d,
1643 ox = t.x + (w * t.xPercent / 100),
1644 oy = t.y + (h * t.yPercent / 100),
1645 dx, dy;
1646
1647 //if transformOrigin is being used, adjust the offset x and y
1648 if (t.ox != null) {
1649 dx = ((t.oxp) ? w * t.ox * 0.01 : t.ox) - w / 2;
1650 dy = ((t.oyp) ? h * t.oy * 0.01 : t.oy) - h / 2;
1651 ox += dx - (dx * a + dy * b);
1652 oy += dy - (dx * c + dy * d);
1653 }
1654
1655 if (!clip) {
1656 m += ", sizingMethod='auto expand')";
1657 } else {
1658 dx = (w / 2);
1659 dy = (h / 2);
1660 //translate to ensure that transformations occur around the correct origin (default is center).
1661 m += ", Dx=" + (dx - (dx * a + dy * b) + ox) + ", Dy=" + (dy - (dx * c + dy * d) + oy) + ")";
1662 }
1663 if (filters.indexOf("DXImageTransform.Microsoft.Matrix(") !== -1) {
1664 style.filter = filters.replace(_ieSetMatrixExp, m);
1665 } else {
1666 style.filter = m + " " + filters; //we must always put the transform/matrix FIRST (before alpha(opacity=xx)) to avoid an IE bug that slices part of the object when rotation is applied with alpha.
1667 }
1668
1669 //at the end or beginning of the tween, if the matrix is normal (1, 0, 0, 1) and opacity is 100 (or doesn't exist), remove the filter to improve browser performance.
1670 if (v === 0 || v === 1) if (a === 1) if (b === 0) if (c === 0) if (d === 1) if (!clip || m.indexOf("Dx=0, Dy=0") !== -1) if (!_opacityExp.test(filters) || parseFloat(RegExp.$1) === 100) if (filters.indexOf("gradient(" && filters.indexOf("Alpha")) === -1) {
1671 style.removeAttribute("filter");
1672 }
1673
1674 //we must set the margins AFTER applying the filter in order to avoid some bugs in IE8 that could (in rare scenarios) cause them to be ignored intermittently (vibration).
1675 if (!clip) {
1676 var mult = (_ieVers < 8) ? 1 : -1, //in Internet Explorer 7 and before, the box model is broken, causing the browser to treat the width/height of the actual rotated filtered image as the width/height of the box itself, but Microsoft corrected that in IE8. We must use a negative offset in IE8 on the right/bottom
1677 marg, prop, dif;
1678 dx = t.ieOffsetX || 0;
1679 dy = t.ieOffsetY || 0;
1680 t.ieOffsetX = Math.round((w - ((a < 0 ? -a : a) * w + (b < 0 ? -b : b) * h)) / 2 + ox);
1681 t.ieOffsetY = Math.round((h - ((d < 0 ? -d : d) * h + (c < 0 ? -c : c) * w)) / 2 + oy);
1682 for (i = 0; i < 4; i++) {
1683 prop = _margins[i];
1684 marg = cs[prop];
1685 //we need to get the current margin in case it is being tweened separately (we want to respect that tween's changes)
1686 val = (marg.indexOf("px") !== -1) ? parseFloat(marg) : _convertToPixels(this.t, prop, parseFloat(marg), marg.replace(_suffixExp, "")) || 0;
1687 if (val !== t[prop]) {
1688 dif = (i < 2) ? -t.ieOffsetX : -t.ieOffsetY; //if another tween is controlling a margin, we cannot only apply the difference in the ieOffsets, so we essentially zero-out the dx and dy here in that case. We record the margin(s) later so that we can keep comparing them, making this code very flexible.
1689 } else {
1690 dif = (i < 2) ? dx - t.ieOffsetX : dy - t.ieOffsetY;
1691 }
1692 style[prop] = (t[prop] = Math.round( val - dif * ((i === 0 || i === 2) ? 1 : mult) )) + "px";
1693 }
1694 }
1695 },
1696
1697 /* translates a super small decimal to a string WITHOUT scientific notation
1698 _safeDecimal = function(n) {
1699 var s = (n < 0 ? -n : n) + "",
1700 a = s.split("e-");
1701 return (n < 0 ? "-0." : "0.") + new Array(parseInt(a[1], 10) || 0).join("0") + a[0].split(".").join("");
1702 },
1703 */
1704
1705 _setTransformRatio = _internals.set3DTransformRatio = _internals.setTransformRatio = function(v) {
1706 var t = this.data, //refers to the element's _gsTransform object
1707 style = this.t.style,
1708 angle = t.rotation,
1709 rotationX = t.rotationX,
1710 rotationY = t.rotationY,
1711 sx = t.scaleX,
1712 sy = t.scaleY,
1713 sz = t.scaleZ,
1714 x = t.x,
1715 y = t.y,
1716 z = t.z,
1717 isSVG = t.svg,
1718 perspective = t.perspective,
1719 force3D = t.force3D,
1720 skewY = t.skewY,
1721 skewX = t.skewX,
1722 t1, a11, a12, a13, a21, a22, a23, a31, a32, a33, a41, a42, a43,
1723 zOrigin, min, cos, sin, t2, transform, comma, zero, skew, rnd;
1724 if (skewY) { //for performance reasons, we combine all skewing into the skewX and rotation values. Remember, a skewY of 10 degrees looks the same as a rotation of 10 degrees plus a skewX of 10 degrees.
1725 skewX += skewY;
1726 angle += skewY;
1727 }
1728
1729 //check to see if we should render as 2D (and SVGs must use 2D when _useSVGTransformAttr is true)
1730 if (((((v === 1 || v === 0) && force3D === "auto" && (this.tween._totalTime === this.tween._totalDuration || !this.tween._totalTime)) || !force3D) && !z && !perspective && !rotationY && !rotationX && sz === 1) || (_useSVGTransformAttr && isSVG) || !_supports3D) { //on the final render (which could be 0 for a from tween), if there are no 3D aspects, render in 2D to free up memory and improve performance especially on mobile devices. Check the tween's totalTime/totalDuration too in order to make sure it doesn't happen between repeats if it's a repeating tween.
1731
1732 //2D
1733 if (angle || skewX || isSVG) {
1734 angle *= _DEG2RAD;
1735 skew = skewX * _DEG2RAD;
1736 rnd = 100000;
1737 a11 = Math.cos(angle) * sx;
1738 a21 = Math.sin(angle) * sx;
1739 a12 = Math.sin(angle - skew) * -sy;
1740 a22 = Math.cos(angle - skew) * sy;
1741 if (skew && t.skewType === "simple") { //by default, we compensate skewing on the other axis to make it look more natural, but you can set the skewType to "simple" to use the uncompensated skewing that CSS does
1742 t1 = Math.tan(skew - skewY * _DEG2RAD);
1743 t1 = Math.sqrt(1 + t1 * t1);
1744 a12 *= t1;
1745 a22 *= t1;
1746 if (skewY) {
1747 t1 = Math.tan(skewY * _DEG2RAD);
1748 t1 = Math.sqrt(1 + t1 * t1);
1749 a11 *= t1;
1750 a21 *= t1;
1751 }
1752 }
1753 if (isSVG) {
1754 x += t.xOrigin - (t.xOrigin * a11 + t.yOrigin * a12) + t.xOffset;
1755 y += t.yOrigin - (t.xOrigin * a21 + t.yOrigin * a22) + t.yOffset;
1756 if (_useSVGTransformAttr && (t.xPercent || t.yPercent)) { //The SVG spec doesn't support percentage-based translation in the "transform" attribute, so we merge it into the matrix to simulate it.
1757 min = this.t.getBBox();
1758 x += t.xPercent * 0.01 * min.width;
1759 y += t.yPercent * 0.01 * min.height;
1760 }
1761 min = 0.000001;
1762 if (x < min) if (x > -min) {
1763 x = 0;
1764 }
1765 if (y < min) if (y > -min) {
1766 y = 0;
1767 }
1768 }
1769 transform = (((a11 * rnd) | 0) / rnd) + "," + (((a21 * rnd) | 0) / rnd) + "," + (((a12 * rnd) | 0) / rnd) + "," + (((a22 * rnd) | 0) / rnd) + "," + x + "," + y + ")";
1770 if (isSVG && _useSVGTransformAttr) {
1771 this.t.setAttribute("transform", "matrix(" + transform);
1772 } else {
1773 //some browsers have a hard time with very small values like 2.4492935982947064e-16 (notice the "e-" towards the end) and would render the object slightly off. So we round to 5 decimal places.
1774 style[_transformProp] = ((t.xPercent || t.yPercent) ? "translate(" + t.xPercent + "%," + t.yPercent + "%) matrix(" : "matrix(") + transform;
1775 }
1776 } else {
1777 style[_transformProp] = ((t.xPercent || t.yPercent) ? "translate(" + t.xPercent + "%," + t.yPercent + "%) matrix(" : "matrix(") + sx + ",0,0," + sy + "," + x + "," + y + ")";
1778 }
1779 return;
1780
1781 }
1782 if (_isFirefox) { //Firefox has a bug (at least in v25) that causes it to render the transparent part of 32-bit PNG images as black when displayed inside an iframe and the 3D scale is very small and doesn't change sufficiently enough between renders (like if you use a Power4.easeInOut to scale from 0 to 1 where the beginning values only change a tiny amount to begin the tween before accelerating). In this case, we force the scale to be 0.00002 instead which is visually the same but works around the Firefox issue.
1783 min = 0.0001;
1784 if (sx < min && sx > -min) {
1785 sx = sz = 0.00002;
1786 }
1787 if (sy < min && sy > -min) {
1788 sy = sz = 0.00002;
1789 }
1790 if (perspective && !t.z && !t.rotationX && !t.rotationY) { //Firefox has a bug that causes elements to have an odd super-thin, broken/dotted black border on elements that have a perspective set but aren't utilizing 3D space (no rotationX, rotationY, or z).
1791 perspective = 0;
1792 }
1793 }
1794 if (angle || skewX) {
1795 angle *= _DEG2RAD;
1796 cos = a11 = Math.cos(angle);
1797 sin = a21 = Math.sin(angle);
1798 if (skewX) {
1799 angle -= skewX * _DEG2RAD;
1800 cos = Math.cos(angle);
1801 sin = Math.sin(angle);
1802 if (t.skewType === "simple") { //by default, we compensate skewing on the other axis to make it look more natural, but you can set the skewType to "simple" to use the uncompensated skewing that CSS does
1803 t1 = Math.tan((skewX - skewY) * _DEG2RAD);
1804 t1 = Math.sqrt(1 + t1 * t1);
1805 cos *= t1;
1806 sin *= t1;
1807 if (t.skewY) {
1808 t1 = Math.tan(skewY * _DEG2RAD);
1809 t1 = Math.sqrt(1 + t1 * t1);
1810 a11 *= t1;
1811 a21 *= t1;
1812 }
1813 }
1814 }
1815 a12 = -sin;
1816 a22 = cos;
1817
1818 } else if (!rotationY && !rotationX && sz === 1 && !perspective && !isSVG) { //if we're only translating and/or 2D scaling, this is faster...
1819 style[_transformProp] = ((t.xPercent || t.yPercent) ? "translate(" + t.xPercent + "%," + t.yPercent + "%) translate3d(" : "translate3d(") + x + "px," + y + "px," + z +"px)" + ((sx !== 1 || sy !== 1) ? " scale(" + sx + "," + sy + ")" : "");
1820 return;
1821 } else {
1822 a11 = a22 = 1;
1823 a12 = a21 = 0;
1824 }
1825 // KEY INDEX AFFECTS a[row][column]
1826 // a11 0 rotation, rotationY, scaleX
1827 // a21 1 rotation, rotationY, scaleX
1828 // a31 2 rotationY, scaleX
1829 // a41 3 rotationY, scaleX
1830 // a12 4 rotation, skewX, rotationX, scaleY
1831 // a22 5 rotation, skewX, rotationX, scaleY
1832 // a32 6 rotationX, scaleY
1833 // a42 7 rotationX, scaleY
1834 // a13 8 rotationY, rotationX, scaleZ
1835 // a23 9 rotationY, rotationX, scaleZ
1836 // a33 10 rotationY, rotationX, scaleZ
1837 // a43 11 rotationY, rotationX, perspective, scaleZ
1838 // a14 12 x, zOrigin, svgOrigin
1839 // a24 13 y, zOrigin, svgOrigin
1840 // a34 14 z, zOrigin
1841 // a44 15
1842 // rotation: Math.atan2(a21, a11)
1843 // rotationY: Math.atan2(a13, a33) (or Math.atan2(a13, a11))
1844 // rotationX: Math.atan2(a32, a33)
1845 a33 = 1;
1846 a13 = a23 = a31 = a32 = a41 = a42 = 0;
1847 a43 = (perspective) ? -1 / perspective : 0;
1848 zOrigin = t.zOrigin;
1849 min = 0.000001; //threshold below which browsers use scientific notation which won't work.
1850 comma = ",";
1851 zero = "0";
1852 angle = rotationY * _DEG2RAD;
1853 if (angle) {
1854 cos = Math.cos(angle);
1855 sin = Math.sin(angle);
1856 a31 = -sin;
1857 a41 = a43*-sin;
1858 a13 = a11*sin;
1859 a23 = a21*sin;
1860 a33 = cos;
1861 a43 *= cos;
1862 a11 *= cos;
1863 a21 *= cos;
1864 }
1865 angle = rotationX * _DEG2RAD;
1866 if (angle) {
1867 cos = Math.cos(angle);
1868 sin = Math.sin(angle);
1869 t1 = a12*cos+a13*sin;
1870 t2 = a22*cos+a23*sin;
1871 a32 = a33*sin;
1872 a42 = a43*sin;
1873 a13 = a12*-sin+a13*cos;
1874 a23 = a22*-sin+a23*cos;
1875 a33 = a33*cos;
1876 a43 = a43*cos;
1877 a12 = t1;
1878 a22 = t2;
1879 }
1880 if (sz !== 1) {
1881 a13*=sz;
1882 a23*=sz;
1883 a33*=sz;
1884 a43*=sz;
1885 }
1886 if (sy !== 1) {
1887 a12*=sy;
1888 a22*=sy;
1889 a32*=sy;
1890 a42*=sy;
1891 }
1892 if (sx !== 1) {
1893 a11*=sx;
1894 a21*=sx;
1895 a31*=sx;
1896 a41*=sx;
1897 }
1898
1899 if (zOrigin || isSVG) {
1900 if (zOrigin) {
1901 x += a13*-zOrigin;
1902 y += a23*-zOrigin;
1903 z += a33*-zOrigin+zOrigin;
1904 }
1905 if (isSVG) { //due to bugs in some browsers, we need to manage the transform-origin of SVG manually
1906 x += t.xOrigin - (t.xOrigin * a11 + t.yOrigin * a12) + t.xOffset;
1907 y += t.yOrigin - (t.xOrigin * a21 + t.yOrigin * a22) + t.yOffset;
1908 }
1909 if (x < min && x > -min) {
1910 x = zero;
1911 }
1912 if (y < min && y > -min) {
1913 y = zero;
1914 }
1915 if (z < min && z > -min) {
1916 z = 0; //don't use string because we calculate perspective later and need the number.
1917 }
1918 }
1919
1920 //optimized way of concatenating all the values into a string. If we do it all in one shot, it's slower because of the way browsers have to create temp strings and the way it affects memory. If we do it piece-by-piece with +=, it's a bit slower too. We found that doing it in these sized chunks works best overall:
1921 transform = ((t.xPercent || t.yPercent) ? "translate(" + t.xPercent + "%," + t.yPercent + "%) matrix3d(" : "matrix3d(");
1922 transform += ((a11 < min && a11 > -min) ? zero : a11) + comma + ((a21 < min && a21 > -min) ? zero : a21) + comma + ((a31 < min && a31 > -min) ? zero : a31);
1923 transform += comma + ((a41 < min && a41 > -min) ? zero : a41) + comma + ((a12 < min && a12 > -min) ? zero : a12) + comma + ((a22 < min && a22 > -min) ? zero : a22);
1924 if (rotationX || rotationY || sz !== 1) { //performance optimization (often there's no rotationX or rotationY, so we can skip these calculations)
1925 transform += comma + ((a32 < min && a32 > -min) ? zero : a32) + comma + ((a42 < min && a42 > -min) ? zero : a42) + comma + ((a13 < min && a13 > -min) ? zero : a13);
1926 transform += comma + ((a23 < min && a23 > -min) ? zero : a23) + comma + ((a33 < min && a33 > -min) ? zero : a33) + comma + ((a43 < min && a43 > -min) ? zero : a43) + comma;
1927 } else {
1928 transform += ",0,0,0,0,1,0,";
1929 }
1930 transform += x + comma + y + comma + z + comma + (perspective ? (1 + (-z / perspective)) : 1) + ")";
1931
1932 style[_transformProp] = transform;
1933 };
1934
1935 p = Transform.prototype;
1936 p.x = p.y = p.z = p.skewX = p.skewY = p.rotation = p.rotationX = p.rotationY = p.zOrigin = p.xPercent = p.yPercent = p.xOffset = p.yOffset = 0;
1937 p.scaleX = p.scaleY = p.scaleZ = 1;
1938
1939 _registerComplexSpecialProp("transform,scale,scaleX,scaleY,scaleZ,x,y,z,rotation,rotationX,rotationY,rotationZ,skewX,skewY,shortRotation,shortRotationX,shortRotationY,shortRotationZ,transformOrigin,svgOrigin,transformPerspective,directionalRotation,parseTransform,force3D,skewType,xPercent,yPercent,smoothOrigin", {parser:function(t, e, parsingProp, cssp, pt, plugin, vars) {
1940 if (cssp._lastParsedTransform === vars) { return pt; } //only need to parse the transform once, and only if the browser supports it.
1941 cssp._lastParsedTransform = vars;
1942 var scaleFunc = (vars.scale && typeof(vars.scale) === "function") ? vars.scale : 0; //if there's a function-based "scale" value, swap in the resulting numeric value temporarily. Otherwise, if it's called for both scaleX and scaleY independently, they may not match (like if the function uses Math.random()).
1943 if (scaleFunc) {
1944 vars.scale = scaleFunc(_index, t);
1945 }
1946 var originalGSTransform = t._gsTransform,
1947 style = t.style,
1948 min = 0.000001,
1949 i = _transformProps.length,
1950 v = vars,
1951 endRotations = {},
1952 transformOriginString = "transformOrigin",
1953 m1 = _getTransform(t, _cs, true, v.parseTransform),
1954 orig = v.transform && ((typeof(v.transform) === "function") ? v.transform(_index, _target) : v.transform),
1955 m2, copy, has3D, hasChange, dr, x, y, matrix, p;
1956 m1.skewType = v.skewType || m1.skewType || CSSPlugin.defaultSkewType;
1957 cssp._transform = m1;
1958 if ("rotationZ" in v) {
1959 v.rotation = v.rotationZ;
1960 }
1961 if (orig && typeof(orig) === "string" && _transformProp) { //for values like transform:"rotate(60deg) scale(0.5, 0.8)"
1962 copy = _tempDiv.style; //don't use the original target because it might be SVG in which case some browsers don't report computed style correctly.
1963 copy[_transformProp] = orig;
1964 copy.display = "block"; //if display is "none", the browser often refuses to report the transform properties correctly.
1965 copy.position = "absolute";
1966 if (orig.indexOf("%") !== -1) { //%-based translations will fail unless we set the width/height to match the original target...
1967 copy.width = _getStyle(t, "width");
1968 copy.height = _getStyle(t, "height");
1969 }
1970 _doc.body.appendChild(_tempDiv);
1971 m2 = _getTransform(_tempDiv, null, false);
1972 if (m1.skewType === "simple") { //the default _getTransform() reports the skewX/scaleY as if skewType is "compensated", thus we need to adjust that here if skewType is "simple".
1973 m2.scaleY *= Math.cos(m2.skewX * _DEG2RAD);
1974 }
1975 if (m1.svg) { //if it's an SVG element, x/y part of the matrix will be affected by whatever we use as the origin and the offsets, so compensate here...
1976 x = m1.xOrigin;
1977 y = m1.yOrigin;
1978 m2.x -= m1.xOffset;
1979 m2.y -= m1.yOffset;
1980 if (v.transformOrigin || v.svgOrigin) { //if this tween is altering the origin, we must factor that in here. The actual work of recording the transformOrigin values and setting up the PropTween is done later (still inside this function) so we cannot leave the changes intact here - we only want to update the x/y accordingly.
1981 orig = {};
1982 _parseSVGOrigin(t, _parsePosition(v.transformOrigin), orig, v.svgOrigin, v.smoothOrigin, true);
1983 x = orig.xOrigin;
1984 y = orig.yOrigin;
1985 m2.x -= orig.xOffset - m1.xOffset;
1986 m2.y -= orig.yOffset - m1.yOffset;
1987 }
1988 if (x || y) {
1989 matrix = _getMatrix(_tempDiv, true);
1990 m2.x -= x - (x * matrix[0] + y * matrix[2]);
1991 m2.y -= y - (x * matrix[1] + y * matrix[3]);
1992 }
1993 }
1994 _doc.body.removeChild(_tempDiv);
1995 if (!m2.perspective) {
1996 m2.perspective = m1.perspective; //tweening to no perspective gives very unintuitive results - just keep the same perspective in that case.
1997 }
1998 if (v.xPercent != null) {
1999 m2.xPercent = _parseVal(v.xPercent, m1.xPercent);
2000 }
2001 if (v.yPercent != null) {
2002 m2.yPercent = _parseVal(v.yPercent, m1.yPercent);
2003 }
2004 } else if (typeof(v) === "object") { //for values like scaleX, scaleY, rotation, x, y, skewX, and skewY or transform:{...} (object)
2005 m2 = {scaleX:_parseVal((v.scaleX != null) ? v.scaleX : v.scale, m1.scaleX),
2006 scaleY:_parseVal((v.scaleY != null) ? v.scaleY : v.scale, m1.scaleY),
2007 scaleZ:_parseVal(v.scaleZ, m1.scaleZ),
2008 x:_parseVal(v.x, m1.x),
2009 y:_parseVal(v.y, m1.y),
2010 z:_parseVal(v.z, m1.z),
2011 xPercent:_parseVal(v.xPercent, m1.xPercent),
2012 yPercent:_parseVal(v.yPercent, m1.yPercent),
2013 perspective:_parseVal(v.transformPerspective, m1.perspective)};
2014 dr = v.directionalRotation;
2015 if (dr != null) {
2016 if (typeof(dr) === "object") {
2017 for (copy in dr) {
2018 v[copy] = dr[copy];
2019 }
2020 } else {
2021 v.rotation = dr;
2022 }
2023 }
2024 if (typeof(v.x) === "string" && v.x.indexOf("%") !== -1) {
2025 m2.x = 0;
2026 m2.xPercent = _parseVal(v.x, m1.xPercent);
2027 }
2028 if (typeof(v.y) === "string" && v.y.indexOf("%") !== -1) {
2029 m2.y = 0;
2030 m2.yPercent = _parseVal(v.y, m1.yPercent);
2031 }
2032
2033 m2.rotation = _parseAngle(("rotation" in v) ? v.rotation : ("shortRotation" in v) ? v.shortRotation + "_short" : m1.rotation, m1.rotation, "rotation", endRotations);
2034 if (_supports3D) {
2035 m2.rotationX = _parseAngle(("rotationX" in v) ? v.rotationX : ("shortRotationX" in v) ? v.shortRotationX + "_short" : m1.rotationX || 0, m1.rotationX, "rotationX", endRotations);
2036 m2.rotationY = _parseAngle(("rotationY" in v) ? v.rotationY : ("shortRotationY" in v) ? v.shortRotationY + "_short" : m1.rotationY || 0, m1.rotationY, "rotationY", endRotations);
2037 }
2038 m2.skewX = _parseAngle(v.skewX, m1.skewX);
2039 m2.skewY = _parseAngle(v.skewY, m1.skewY);
2040 }
2041 if (_supports3D && v.force3D != null) {
2042 m1.force3D = v.force3D;
2043 hasChange = true;
2044 }
2045
2046 has3D = (m1.force3D || m1.z || m1.rotationX || m1.rotationY || m2.z || m2.rotationX || m2.rotationY || m2.perspective);
2047 if (!has3D && v.scale != null) {
2048 m2.scaleZ = 1; //no need to tween scaleZ.
2049 }
2050
2051 while (--i > -1) {
2052 p = _transformProps[i];
2053 orig = m2[p] - m1[p];
2054 if (orig > min || orig < -min || v[p] != null || _forcePT[p] != null) {
2055 hasChange = true;
2056 pt = new CSSPropTween(m1, p, m1[p], orig, pt);
2057 if (p in endRotations) {
2058 pt.e = endRotations[p]; //directional rotations typically have compensated values during the tween, but we need to make sure they end at exactly what the user requested
2059 }
2060 pt.xs0 = 0; //ensures the value stays numeric in setRatio()
2061 pt.plugin = plugin;
2062 cssp._overwriteProps.push(pt.n);
2063 }
2064 }
2065
2066 orig = (typeof(v.transformOrigin) === "function") ? v.transformOrigin(_index, _target) : v.transformOrigin;
2067 if (m1.svg && (orig || v.svgOrigin)) {
2068 x = m1.xOffset; //when we change the origin, in order to prevent things from jumping we adjust the x/y so we must record those here so that we can create PropTweens for them and flip them at the same time as the origin
2069 y = m1.yOffset;
2070 _parseSVGOrigin(t, _parsePosition(orig), m2, v.svgOrigin, v.smoothOrigin);
2071 pt = _addNonTweeningNumericPT(m1, "xOrigin", (originalGSTransform ? m1 : m2).xOrigin, m2.xOrigin, pt, transformOriginString); //note: if there wasn't a transformOrigin defined yet, just start with the destination one; it's wasteful otherwise, and it causes problems with fromTo() tweens. For example, TweenLite.to("#wheel", 3, {rotation:180, transformOrigin:"50% 50%", delay:1}); TweenLite.fromTo("#wheel", 3, {scale:0.5, transformOrigin:"50% 50%"}, {scale:1, delay:2}); would cause a jump when the from values revert at the beginning of the 2nd tween.
2072 pt = _addNonTweeningNumericPT(m1, "yOrigin", (originalGSTransform ? m1 : m2).yOrigin, m2.yOrigin, pt, transformOriginString);
2073 if (x !== m1.xOffset || y !== m1.yOffset) {
2074 pt = _addNonTweeningNumericPT(m1, "xOffset", (originalGSTransform ? x : m1.xOffset), m1.xOffset, pt, transformOriginString);
2075 pt = _addNonTweeningNumericPT(m1, "yOffset", (originalGSTransform ? y : m1.yOffset), m1.yOffset, pt, transformOriginString);
2076 }
2077 orig = "0px 0px"; //certain browsers (like firefox) completely botch transform-origin, so we must remove it to prevent it from contaminating transforms. We manage it ourselves with xOrigin and yOrigin
2078 }
2079 if (orig || (_supports3D && has3D && m1.zOrigin)) { //if anything 3D is happening and there's a transformOrigin with a z component that's non-zero, we must ensure that the transformOrigin's z-component is set to 0 so that we can manually do those calculations to get around Safari bugs. Even if the user didn't specifically define a "transformOrigin" in this particular tween (maybe they did it via css directly).
2080 if (_transformProp) {
2081 hasChange = true;
2082 p = _transformOriginProp;
2083 if (!orig) {
2084 orig = (_getStyle(t, p, _cs, false, "50% 50%") + "").split(" ");
2085 orig = orig[0] + " " + orig[1] + " " + m1.zOrigin + "px";
2086 }
2087 orig += "";
2088 pt = new CSSPropTween(style, p, 0, 0, pt, -1, transformOriginString);
2089 pt.b = style[p];
2090 pt.plugin = plugin;
2091 if (_supports3D) {
2092 copy = m1.zOrigin;
2093 orig = orig.split(" ");
2094 m1.zOrigin = ((orig.length > 2) ? parseFloat(orig[2]) : copy) || 0; //Safari doesn't handle the z part of transformOrigin correctly, so we'll manually handle it in the _set3DTransformRatio() method.
2095 pt.xs0 = pt.e = orig[0] + " " + (orig[1] || "50%") + " 0px"; //we must define a z value of 0px specifically otherwise iOS 5 Safari will stick with the old one (if one was defined)!
2096 pt = new CSSPropTween(m1, "zOrigin", 0, 0, pt, -1, pt.n); //we must create a CSSPropTween for the _gsTransform.zOrigin so that it gets reset properly at the beginning if the tween runs backward (as opposed to just setting m1.zOrigin here)
2097 pt.b = copy;
2098 pt.xs0 = pt.e = m1.zOrigin;
2099 } else {
2100 pt.xs0 = pt.e = orig;
2101 }
2102
2103 //for older versions of IE (6-8), we need to manually calculate things inside the setRatio() function. We record origin x and y (ox and oy) and whether or not the values are percentages (oxp and oyp).
2104 } else {
2105 _parsePosition(orig + "", m1);
2106 }
2107 }
2108 if (hasChange) {
2109 cssp._transformType = (!(m1.svg && _useSVGTransformAttr) && (has3D || this._transformType === 3)) ? 3 : 2; //quicker than calling cssp._enableTransforms();
2110 }
2111 if (scaleFunc) {
2112 vars.scale = scaleFunc;
2113 }
2114 return pt;
2115 }, allowFunc:true, prefix:true});
2116
2117 _registerComplexSpecialProp("boxShadow", {defaultValue:"0px 0px 0px 0px #999", prefix:true, color:true, multi:true, keyword:"inset"});
2118 _registerComplexSpecialProp("clipPath", {defaultValue:"inset(0%)", prefix:true, multi:true, formatter:_getFormatter("inset(0% 0% 0% 0%)", false, true)});
2119
2120 _registerComplexSpecialProp("borderRadius", {defaultValue:"0px", parser:function(t, e, p, cssp, pt, plugin) {
2121 e = this.format(e);
2122 var props = ["borderTopLeftRadius","borderTopRightRadius","borderBottomRightRadius","borderBottomLeftRadius"],
2123 style = t.style,
2124 ea1, i, es2, bs2, bs, es, bn, en, w, h, esfx, bsfx, rel, hn, vn, em;
2125 w = parseFloat(t.offsetWidth);
2126 h = parseFloat(t.offsetHeight);
2127 ea1 = e.split(" ");
2128 for (i = 0; i < props.length; i++) { //if we're dealing with percentages, we must convert things separately for the horizontal and vertical axis!
2129 if (this.p.indexOf("border")) { //older browsers used a prefix
2130 props[i] = _checkPropPrefix(props[i]);
2131 }
2132 bs = bs2 = _getStyle(t, props[i], _cs, false, "0px");
2133 if (bs.indexOf(" ") !== -1) {
2134 bs2 = bs.split(" ");
2135 bs = bs2[0];
2136 bs2 = bs2[1];
2137 }
2138 es = es2 = ea1[i];
2139 bn = parseFloat(bs);
2140 bsfx = bs.substr((bn + "").length);
2141 rel = (es.charAt(1) === "=");
2142 if (rel) {
2143 en = parseInt(es.charAt(0)+"1", 10);
2144 es = es.substr(2);
2145 en *= parseFloat(es);
2146 esfx = es.substr((en + "").length - (en < 0 ? 1 : 0)) || "";
2147 } else {
2148 en = parseFloat(es);
2149 esfx = es.substr((en + "").length);
2150 }
2151 if (esfx === "") {
2152 esfx = _suffixMap[p] || bsfx;
2153 }
2154 if (esfx !== bsfx) {
2155 hn = _convertToPixels(t, "borderLeft", bn, bsfx); //horizontal number (we use a bogus "borderLeft" property just because the _convertToPixels() method searches for the keywords "Left", "Right", "Top", and "Bottom" to determine of it's a horizontal or vertical property, and we need "border" in the name so that it knows it should measure relative to the element itself, not its parent.
2156 vn = _convertToPixels(t, "borderTop", bn, bsfx); //vertical number
2157 if (esfx === "%") {
2158 bs = (hn / w * 100) + "%";
2159 bs2 = (vn / h * 100) + "%";
2160 } else if (esfx === "em") {
2161 em = _convertToPixels(t, "borderLeft", 1, "em");
2162 bs = (hn / em) + "em";
2163 bs2 = (vn / em) + "em";
2164 } else {
2165 bs = hn + "px";
2166 bs2 = vn + "px";
2167 }
2168 if (rel) {
2169 es = (parseFloat(bs) + en) + esfx;
2170 es2 = (parseFloat(bs2) + en) + esfx;
2171 }
2172 }
2173 pt = _parseComplex(style, props[i], bs + " " + bs2, es + " " + es2, false, "0px", pt);
2174 }
2175 return pt;
2176 }, prefix:true, formatter:_getFormatter("0px 0px 0px 0px", false, true)});
2177 _registerComplexSpecialProp("borderBottomLeftRadius,borderBottomRightRadius,borderTopLeftRadius,borderTopRightRadius", {defaultValue:"0px", parser:function(t, e, p, cssp, pt, plugin) {
2178 return _parseComplex(t.style, p, this.format(_getStyle(t, p, _cs, false, "0px 0px")), this.format(e), false, "0px", pt);
2179 }, prefix:true, formatter:_getFormatter("0px 0px", false, true)});
2180 _registerComplexSpecialProp("backgroundPosition", {defaultValue:"0 0", parser:function(t, e, p, cssp, pt, plugin) {
2181 var bp = "background-position",
2182 cs = (_cs || _getComputedStyle(t, null)),
2183 bs = this.format( ((cs) ? _ieVers ? cs.getPropertyValue(bp + "-x") + " " + cs.getPropertyValue(bp + "-y") : cs.getPropertyValue(bp) : t.currentStyle.backgroundPositionX + " " + t.currentStyle.backgroundPositionY) || "0 0"), //Internet Explorer doesn't report background-position correctly - we must query background-position-x and background-position-y and combine them (even in IE10). Before IE9, we must do the same with the currentStyle object and use camelCase
2184 es = this.format(e),
2185 ba, ea, i, pct, overlap, src;
2186 if ((bs.indexOf("%") !== -1) !== (es.indexOf("%") !== -1) && es.split(",").length < 2) {
2187 src = _getStyle(t, "backgroundImage").replace(_urlExp, "");
2188 if (src && src !== "none") {
2189 ba = bs.split(" ");
2190 ea = es.split(" ");
2191 _tempImg.setAttribute("src", src); //set the temp IMG's src to the background-image so that we can measure its width/height
2192 i = 2;
2193 while (--i > -1) {
2194 bs = ba[i];
2195 pct = (bs.indexOf("%") !== -1);
2196 if (pct !== (ea[i].indexOf("%") !== -1)) {
2197 overlap = (i === 0) ? t.offsetWidth - _tempImg.width : t.offsetHeight - _tempImg.height;
2198 ba[i] = pct ? (parseFloat(bs) / 100 * overlap) + "px" : (parseFloat(bs) / overlap * 100) + "%";
2199 }
2200 }
2201 bs = ba.join(" ");
2202 }
2203 }
2204 return this.parseComplex(t.style, bs, es, pt, plugin);
2205 }, formatter:_parsePosition});
2206 _registerComplexSpecialProp("backgroundSize", {defaultValue:"0 0", formatter:function(v) {
2207 v += ""; //ensure it's a string
2208 return (v.substr(0,2) === "co") ? v : _parsePosition(v.indexOf(" ") === -1 ? v + " " + v : v); //if set to something like "100% 100%", Safari typically reports the computed style as just "100%" (no 2nd value), but we should ensure that there are two values, so copy the first one. Otherwise, it'd be interpreted as "100% 0" (wrong). Also remember that it could be "cover" or "contain" which we can't tween but should be able to set.
2209 }});
2210 _registerComplexSpecialProp("perspective", {defaultValue:"0px", prefix:true});
2211 _registerComplexSpecialProp("perspectiveOrigin", {defaultValue:"50% 50%", prefix:true});
2212 _registerComplexSpecialProp("transformStyle", {prefix:true});
2213 _registerComplexSpecialProp("backfaceVisibility", {prefix:true});
2214 _registerComplexSpecialProp("userSelect", {prefix:true});
2215 _registerComplexSpecialProp("margin", {parser:_getEdgeParser("marginTop,marginRight,marginBottom,marginLeft")});
2216 _registerComplexSpecialProp("padding", {parser:_getEdgeParser("paddingTop,paddingRight,paddingBottom,paddingLeft")});
2217 _registerComplexSpecialProp("clip", {defaultValue:"rect(0px,0px,0px,0px)", parser:function(t, e, p, cssp, pt, plugin){
2218 var b, cs, delim;
2219 if (_ieVers < 9) { //IE8 and earlier don't report a "clip" value in the currentStyle - instead, the values are split apart into clipTop, clipRight, clipBottom, and clipLeft. Also, in IE7 and earlier, the values inside rect() are space-delimited, not comma-delimited.
2220 cs = t.currentStyle;
2221 delim = _ieVers < 8 ? " " : ",";
2222 b = "rect(" + cs.clipTop + delim + cs.clipRight + delim + cs.clipBottom + delim + cs.clipLeft + ")";
2223 e = this.format(e).split(",").join(delim);
2224 } else {
2225 b = this.format(_getStyle(t, this.p, _cs, false, this.dflt));
2226 e = this.format(e);
2227 }
2228 return this.parseComplex(t.style, b, e, pt, plugin);
2229 }});
2230 _registerComplexSpecialProp("textShadow", {defaultValue:"0px 0px 0px #999", color:true, multi:true});
2231 _registerComplexSpecialProp("autoRound,strictUnits", {parser:function(t, e, p, cssp, pt) {return pt;}}); //just so that we can ignore these properties (not tween them)
2232 _registerComplexSpecialProp("border", {defaultValue:"0px solid #000", parser:function(t, e, p, cssp, pt, plugin) {
2233 var bw = _getStyle(t, "borderTopWidth", _cs, false, "0px"),
2234 end = this.format(e).split(" "),
2235 esfx = end[0].replace(_suffixExp, "");
2236 if (esfx !== "px") { //if we're animating to a non-px value, we need to convert the beginning width to that unit.
2237 bw = (parseFloat(bw) / _convertToPixels(t, "borderTopWidth", 1, esfx)) + esfx;
2238 }
2239 return this.parseComplex(t.style, this.format(bw + " " + _getStyle(t, "borderTopStyle", _cs, false, "solid") + " " + _getStyle(t, "borderTopColor", _cs, false, "#000")), end.join(" "), pt, plugin);
2240 }, color:true, formatter:function(v) {
2241 var a = v.split(" ");
2242 return a[0] + " " + (a[1] || "solid") + " " + (v.match(_colorExp) || ["#000"])[0];
2243 }});
2244 _registerComplexSpecialProp("borderWidth", {parser:_getEdgeParser("borderTopWidth,borderRightWidth,borderBottomWidth,borderLeftWidth")}); //Firefox doesn't pick up on borderWidth set in style sheets (only inline).
2245 _registerComplexSpecialProp("float,cssFloat,styleFloat", {parser:function(t, e, p, cssp, pt, plugin) {
2246 var s = t.style,
2247 prop = ("cssFloat" in s) ? "cssFloat" : "styleFloat";
2248 return new CSSPropTween(s, prop, 0, 0, pt, -1, p, false, 0, s[prop], e);
2249 }});
2250
2251 //opacity-related
2252 var _setIEOpacityRatio = function(v) {
2253 var t = this.t, //refers to the element's style property
2254 filters = t.filter || _getStyle(this.data, "filter") || "",
2255 val = (this.s + this.c * v) | 0,
2256 skip;
2257 if (val === 100) { //for older versions of IE that need to use a filter to apply opacity, we should remove the filter if opacity hits 1 in order to improve performance, but make sure there isn't a transform (matrix) or gradient in the filters.
2258 if (filters.indexOf("atrix(") === -1 && filters.indexOf("radient(") === -1 && filters.indexOf("oader(") === -1) {
2259 t.removeAttribute("filter");
2260 skip = (!_getStyle(this.data, "filter")); //if a class is applied that has an alpha filter, it will take effect (we don't want that), so re-apply our alpha filter in that case. We must first remove it and then check.
2261 } else {
2262 t.filter = filters.replace(_alphaFilterExp, "");
2263 skip = true;
2264 }
2265 }
2266 if (!skip) {
2267 if (this.xn1) {
2268 t.filter = filters = filters || ("alpha(opacity=" + val + ")"); //works around bug in IE7/8 that prevents changes to "visibility" from being applied properly if the filter is changed to a different alpha on the same frame.
2269 }
2270 if (filters.indexOf("pacity") === -1) { //only used if browser doesn't support the standard opacity style property (IE 7 and 8). We omit the "O" to avoid case-sensitivity issues
2271 if (val !== 0 || !this.xn1) { //bugs in IE7/8 won't render the filter properly if opacity is ADDED on the same frame/render as "visibility" changes (this.xn1 is 1 if this tween is an "autoAlpha" tween)
2272 t.filter = filters + " alpha(opacity=" + val + ")"; //we round the value because otherwise, bugs in IE7/8 can prevent "visibility" changes from being applied properly.
2273 }
2274 } else {
2275 t.filter = filters.replace(_opacityExp, "opacity=" + val);
2276 }
2277 }
2278 };
2279 _registerComplexSpecialProp("opacity,alpha,autoAlpha", {defaultValue:"1", parser:function(t, e, p, cssp, pt, plugin) {
2280 var b = parseFloat(_getStyle(t, "opacity", _cs, false, "1")),
2281 style = t.style,
2282 isAutoAlpha = (p === "autoAlpha");
2283 if (typeof(e) === "string" && e.charAt(1) === "=") {
2284 e = ((e.charAt(0) === "-") ? -1 : 1) * parseFloat(e.substr(2)) + b;
2285 }
2286 if (isAutoAlpha && b === 1 && _getStyle(t, "visibility", _cs) === "hidden" && e !== 0) { //if visibility is initially set to "hidden", we should interpret that as intent to make opacity 0 (a convenience)
2287 b = 0;
2288 }
2289 if (_supportsOpacity) {
2290 pt = new CSSPropTween(style, "opacity", b, e - b, pt);
2291 } else {
2292 pt = new CSSPropTween(style, "opacity", b * 100, (e - b) * 100, pt);
2293 pt.xn1 = isAutoAlpha ? 1 : 0; //we need to record whether or not this is an autoAlpha so that in the setRatio(), we know to duplicate the setting of the alpha in order to work around a bug in IE7 and IE8 that prevents changes to "visibility" from taking effect if the filter is changed to a different alpha(opacity) at the same time. Setting it to the SAME value first, then the new value works around the IE7/8 bug.
2294 style.zoom = 1; //helps correct an IE issue.
2295 pt.type = 2;
2296 pt.b = "alpha(opacity=" + pt.s + ")";
2297 pt.e = "alpha(opacity=" + (pt.s + pt.c) + ")";
2298 pt.data = t;
2299 pt.plugin = plugin;
2300 pt.setRatio = _setIEOpacityRatio;
2301 }
2302 if (isAutoAlpha) { //we have to create the "visibility" PropTween after the opacity one in the linked list so that they run in the order that works properly in IE8 and earlier
2303 pt = new CSSPropTween(style, "visibility", 0, 0, pt, -1, null, false, 0, ((b !== 0) ? "inherit" : "hidden"), ((e === 0) ? "hidden" : "inherit"));
2304 pt.xs0 = "inherit";
2305 cssp._overwriteProps.push(pt.n);
2306 cssp._overwriteProps.push(p);
2307 }
2308 return pt;
2309 }});
2310
2311
2312 var _removeProp = function(s, p) {
2313 if (p) {
2314 if (s.removeProperty) {
2315 if (p.substr(0,2) === "ms" || p.substr(0,6) === "webkit") { //Microsoft and some Webkit browsers don't conform to the standard of capitalizing the first prefix character, so we adjust so that when we prefix the caps with a dash, it's correct (otherwise it'd be "ms-transform" instead of "-ms-transform" for IE9, for example)
2316 p = "-" + p;
2317 }
2318 s.removeProperty(p.replace(_capsExp, "-$1").toLowerCase());
2319 } else { //note: old versions of IE use "removeAttribute()" instead of "removeProperty()"
2320 s.removeAttribute(p);
2321 }
2322 }
2323 },
2324 _setClassNameRatio = function(v) {
2325 this.t._gsClassPT = this;
2326 if (v === 1 || v === 0) {
2327 this.t.setAttribute("class", (v === 0) ? this.b : this.e);
2328 var mpt = this.data, //first MiniPropTween
2329 s = this.t.style;
2330 while (mpt) {
2331 if (!mpt.v) {
2332 _removeProp(s, mpt.p);
2333 } else {
2334 s[mpt.p] = mpt.v;
2335 }
2336 mpt = mpt._next;
2337 }
2338 if (v === 1 && this.t._gsClassPT === this) {
2339 this.t._gsClassPT = null;
2340 }
2341 } else if (this.t.getAttribute("class") !== this.e) {
2342 this.t.setAttribute("class", this.e);
2343 }
2344 };
2345 _registerComplexSpecialProp("className", {parser:function(t, e, p, cssp, pt, plugin, vars) {
2346 var b = t.getAttribute("class") || "", //don't use t.className because it doesn't work consistently on SVG elements; getAttribute("class") and setAttribute("class", value") is more reliable.
2347 cssText = t.style.cssText,
2348 difData, bs, cnpt, cnptLookup, mpt;
2349 pt = cssp._classNamePT = new CSSPropTween(t, p, 0, 0, pt, 2);
2350 pt.setRatio = _setClassNameRatio;
2351 pt.pr = -11;
2352 _hasPriority = true;
2353 pt.b = b;
2354 bs = _getAllStyles(t, _cs);
2355 //if there's a className tween already operating on the target, force it to its end so that the necessary inline styles are removed and the class name is applied before we determine the end state (we don't want inline styles interfering that were there just for class-specific values)
2356 cnpt = t._gsClassPT;
2357 if (cnpt) {
2358 cnptLookup = {};
2359 mpt = cnpt.data; //first MiniPropTween which stores the inline styles - we need to force these so that the inline styles don't contaminate things. Otherwise, there's a small chance that a tween could start and the inline values match the destination values and they never get cleaned.
2360 while (mpt) {
2361 cnptLookup[mpt.p] = 1;
2362 mpt = mpt._next;
2363 }
2364 cnpt.setRatio(1);
2365 }
2366 t._gsClassPT = pt;
2367 pt.e = (e.charAt(1) !== "=") ? e : b.replace(new RegExp("(?:\\s|^)" + e.substr(2) + "(?![\\w-])"), "") + ((e.charAt(0) === "+") ? " " + e.substr(2) : "");
2368 t.setAttribute("class", pt.e);
2369 difData = _cssDif(t, bs, _getAllStyles(t), vars, cnptLookup);
2370 t.setAttribute("class", b);
2371 pt.data = difData.firstMPT;
2372 if (t.style.cssText !== cssText) { //only apply if things change. Otherwise, in cases like a background-image that's pulled dynamically, it could cause a refresh. See https://greensock.com/forums/topic/20368-possible-gsap-bug-switching-classnames-in-chrome/.
2373 t.style.cssText = cssText; //we recorded cssText before we swapped classes and ran _getAllStyles() because in cases when a className tween is overwritten, we remove all the related tweening properties from that class change (otherwise class-specific stuff can't override properties we've directly set on the target's style object due to specificity).
2374 }
2375 pt = pt.xfirst = cssp.parse(t, difData.difs, pt, plugin); //we record the CSSPropTween as the xfirst so that we can handle overwriting propertly (if "className" gets overwritten, we must kill all the properties associated with the className part of the tween, so we can loop through from xfirst to the pt itself)
2376 return pt;
2377 }});
2378
2379
2380 var _setClearPropsRatio = function(v) {
2381 if (v === 1 || v === 0) if (this.data._totalTime === this.data._totalDuration && this.data.data !== "isFromStart") { //this.data refers to the tween. Only clear at the END of the tween (remember, from() tweens make the ratio go from 1 to 0, so we can't just check that and if the tween is the zero-duration one that's created internally to render the starting values in a from() tween, ignore that because otherwise, for example, from(...{height:100, clearProps:"height", delay:1}) would wipe the height at the beginning of the tween and after 1 second, it'd kick back in).
2382 var s = this.t.style,
2383 transformParse = _specialProps.transform.parse,
2384 a, p, i, clearTransform, transform;
2385 if (this.e === "all") {
2386 s.cssText = "";
2387 clearTransform = true;
2388 } else {
2389 a = this.e.split(" ").join("").split(",");
2390 i = a.length;
2391 while (--i > -1) {
2392 p = a[i];
2393 if (_specialProps[p]) {
2394 if (_specialProps[p].parse === transformParse) {
2395 clearTransform = true;
2396 } else {
2397 p = (p === "transformOrigin") ? _transformOriginProp : _specialProps[p].p; //ensures that special properties use the proper browser-specific property name, like "scaleX" might be "-webkit-transform" or "boxShadow" might be "-moz-box-shadow"
2398 }
2399 }
2400 _removeProp(s, p);
2401 }
2402 }
2403 if (clearTransform) {
2404 _removeProp(s, _transformProp);
2405 transform = this.t._gsTransform;
2406 if (transform) {
2407 if (transform.svg) {
2408 this.t.removeAttribute("data-svg-origin");
2409 this.t.removeAttribute("transform");
2410 }
2411 delete this.t._gsTransform;
2412 }
2413 }
2414
2415 }
2416 };
2417 _registerComplexSpecialProp("clearProps", {parser:function(t, e, p, cssp, pt) {
2418 pt = new CSSPropTween(t, p, 0, 0, pt, 2);
2419 pt.setRatio = _setClearPropsRatio;
2420 pt.e = e;
2421 pt.pr = -10;
2422 pt.data = cssp._tween;
2423 _hasPriority = true;
2424 return pt;
2425 }});
2426
2427 p = "bezier,throwProps,physicsProps,physics2D".split(",");
2428 i = p.length;
2429 while (i--) {
2430 _registerPluginProp(p[i]);
2431 }
2432
2433
2434
2435
2436
2437
2438
2439
2440 p = CSSPlugin.prototype;
2441 p._firstPT = p._lastParsedTransform = p._transform = null;
2442
2443 //gets called when the tween renders for the first time. This kicks everything off, recording start/end values, etc.
2444 p._onInitTween = function(target, vars, tween, index) {
2445 if (!target.nodeType) { //css is only for dom elements
2446 return false;
2447 }
2448 this._target = _target = target;
2449 this._tween = tween;
2450 this._vars = vars;
2451 _index = index;
2452 _autoRound = vars.autoRound;
2453 _hasPriority = false;
2454 _suffixMap = vars.suffixMap || CSSPlugin.suffixMap;
2455 _cs = _getComputedStyle(target, "");
2456 _overwriteProps = this._overwriteProps;
2457 var style = target.style,
2458 v, pt, pt2, first, last, next, zIndex, tpt, threeD;
2459 if (_reqSafariFix) if (style.zIndex === "") {
2460 v = _getStyle(target, "zIndex", _cs);
2461 if (v === "auto" || v === "") {
2462 //corrects a bug in [non-Android] Safari that prevents it from repainting elements in their new positions if they don't have a zIndex set. We also can't just apply this inside _parseTransform() because anything that's moved in any way (like using "left" or "top" instead of transforms like "x" and "y") can be affected, so it is best to ensure that anything that's tweening has a z-index. Setting "WebkitPerspective" to a non-zero value worked too except that on iOS Safari things would flicker randomly. Plus zIndex is less memory-intensive.
2463 this._addLazySet(style, "zIndex", 0);
2464 }
2465 }
2466
2467 if (typeof(vars) === "string") {
2468 first = style.cssText;
2469 v = _getAllStyles(target, _cs);
2470 style.cssText = first + ";" + vars;
2471 v = _cssDif(target, v, _getAllStyles(target)).difs;
2472 if (!_supportsOpacity && _opacityValExp.test(vars)) {
2473 v.opacity = parseFloat( RegExp.$1 );
2474 }
2475 vars = v;
2476 style.cssText = first;
2477 }
2478
2479 if (vars.className) { //className tweens will combine any differences they find in the css with the vars that are passed in, so {className:"myClass", scale:0.5, left:20} would work.
2480 this._firstPT = pt = _specialProps.className.parse(target, vars.className, "className", this, null, null, vars);
2481 } else {
2482 this._firstPT = pt = this.parse(target, vars, null);
2483 }
2484
2485 if (this._transformType) {
2486 threeD = (this._transformType === 3);
2487 if (!_transformProp) {
2488 style.zoom = 1; //helps correct an IE issue.
2489 } else if (_isSafari) {
2490 _reqSafariFix = true;
2491 //if zIndex isn't set, iOS Safari doesn't repaint things correctly sometimes (seemingly at random).
2492 if (style.zIndex === "") {
2493 zIndex = _getStyle(target, "zIndex", _cs);
2494 if (zIndex === "auto" || zIndex === "") {
2495 this._addLazySet(style, "zIndex", 0);
2496 }
2497 }
2498 //Setting WebkitBackfaceVisibility corrects 3 bugs:
2499 // 1) [non-Android] Safari skips rendering changes to "top" and "left" that are made on the same frame/render as a transform update.
2500 // 2) iOS Safari sometimes neglects to repaint elements in their new positions. Setting "WebkitPerspective" to a non-zero value worked too except that on iOS Safari things would flicker randomly.
2501 // 3) Safari sometimes displayed odd artifacts when tweening the transform (or WebkitTransform) property, like ghosts of the edges of the element remained. Definitely a browser bug.
2502 //Note: we allow the user to override the auto-setting by defining WebkitBackfaceVisibility in the vars of the tween.
2503 if (_isSafariLT6) {
2504 this._addLazySet(style, "WebkitBackfaceVisibility", this._vars.WebkitBackfaceVisibility || (threeD ? "visible" : "hidden"));
2505 }
2506 }
2507 pt2 = pt;
2508 while (pt2 && pt2._next) {
2509 pt2 = pt2._next;
2510 }
2511 tpt = new CSSPropTween(target, "transform", 0, 0, null, 2);
2512 this._linkCSSP(tpt, null, pt2);
2513 tpt.setRatio = _transformProp ? _setTransformRatio : _setIETransformRatio;
2514 tpt.data = this._transform || _getTransform(target, _cs, true);
2515 tpt.tween = tween;
2516 tpt.pr = -1; //ensures that the transforms get applied after the components are updated.
2517 _overwriteProps.pop(); //we don't want to force the overwrite of all "transform" tweens of the target - we only care about individual transform properties like scaleX, rotation, etc. The CSSPropTween constructor automatically adds the property to _overwriteProps which is why we need to pop() here.
2518 }
2519
2520 if (_hasPriority) {
2521 //reorders the linked list in order of pr (priority)
2522 while (pt) {
2523 next = pt._next;
2524 pt2 = first;
2525 while (pt2 && pt2.pr > pt.pr) {
2526 pt2 = pt2._next;
2527 }
2528 if ((pt._prev = pt2 ? pt2._prev : last)) {
2529 pt._prev._next = pt;
2530 } else {
2531 first = pt;
2532 }
2533 if ((pt._next = pt2)) {
2534 pt2._prev = pt;
2535 } else {
2536 last = pt;
2537 }
2538 pt = next;
2539 }
2540 this._firstPT = first;
2541 }
2542 return true;
2543 };
2544
2545
2546 p.parse = function(target, vars, pt, plugin) {
2547 var style = target.style,
2548 p, sp, bn, en, bs, es, bsfx, esfx, isStr, rel;
2549 for (p in vars) {
2550 es = vars[p]; //ending value string
2551 sp = _specialProps[p]; //SpecialProp lookup.
2552 if (typeof(es) === "function" && !(sp && sp.allowFunc)) {
2553 es = es(_index, _target);
2554 }
2555 if (sp) {
2556 pt = sp.parse(target, es, p, this, pt, plugin, vars);
2557 } else if (p.substr(0,2) === "--") { //for tweening CSS variables (which always start with "--"). To maximize performance and simplicity, we bypass CSSPlugin altogether and just add a normal property tween to the tween instance itself.
2558 this._tween._propLookup[p] = this._addTween.call(this._tween, target.style, "setProperty", _getComputedStyle(target).getPropertyValue(p) + "", es + "", p, false, p);
2559 continue;
2560 } else {
2561 bs = _getStyle(target, p, _cs) + "";
2562 isStr = (typeof(es) === "string");
2563 if (p === "color" || p === "fill" || p === "stroke" || p.indexOf("Color") !== -1 || (isStr && _rgbhslExp.test(es))) { //Opera uses background: to define color sometimes in addition to backgroundColor:
2564 if (!isStr) {
2565 es = _parseColor(es);
2566 es = ((es.length > 3) ? "rgba(" : "rgb(") + es.join(",") + ")";
2567 }
2568 pt = _parseComplex(style, p, bs, es, true, "transparent", pt, 0, plugin);
2569
2570 } else if (isStr && _complexExp.test(es)) {
2571 pt = _parseComplex(style, p, bs, es, true, null, pt, 0, plugin);
2572
2573 } else {
2574 bn = parseFloat(bs);
2575 bsfx = (bn || bn === 0) ? bs.substr((bn + "").length) : ""; //remember, bs could be non-numeric like "normal" for fontWeight, so we should default to a blank suffix in that case.
2576
2577 if (bs === "" || bs === "auto") {
2578 if (p === "width" || p === "height") {
2579 bn = _getDimension(target, p, _cs);
2580 bsfx = "px";
2581 } else if (p === "left" || p === "top") {
2582 bn = _calculateOffset(target, p, _cs);
2583 bsfx = "px";
2584 } else {
2585 bn = (p !== "opacity") ? 0 : 1;
2586 bsfx = "";
2587 }
2588 }
2589
2590 rel = (isStr && es.charAt(1) === "=");
2591 if (rel) {
2592 en = parseInt(es.charAt(0) + "1", 10);
2593 es = es.substr(2);
2594 en *= parseFloat(es);
2595 esfx = es.replace(_suffixExp, "");
2596 } else {
2597 en = parseFloat(es);
2598 esfx = isStr ? es.replace(_suffixExp, "") : "";
2599 }
2600
2601 if (esfx === "") {
2602 esfx = (p in _suffixMap) ? _suffixMap[p] : bsfx; //populate the end suffix, prioritizing the map, then if none is found, use the beginning suffix.
2603 }
2604
2605 es = (en || en === 0) ? (rel ? en + bn : en) + esfx : vars[p]; //ensures that any += or -= prefixes are taken care of. Record the end value before normalizing the suffix because we always want to end the tween on exactly what they intended even if it doesn't match the beginning value's suffix.
2606 //if the beginning/ending suffixes don't match, normalize them...
2607 if (bsfx !== esfx) if (esfx !== "" || p === "lineHeight") if (en || en === 0) if (bn) { //note: if the beginning value (bn) is 0, we don't need to convert units!
2608 bn = _convertToPixels(target, p, bn, bsfx);
2609 if (esfx === "%") {
2610 bn /= _convertToPixels(target, p, 100, "%") / 100;
2611 if (vars.strictUnits !== true) { //some browsers report only "px" values instead of allowing "%" with getComputedStyle(), so we assume that if we're tweening to a %, we should start there too unless strictUnits:true is defined. This approach is particularly useful for responsive designs that use from() tweens.
2612 bs = bn + "%";
2613 }
2614
2615 } else if (esfx === "em" || esfx === "rem" || esfx === "vw" || esfx === "vh") {
2616 bn /= _convertToPixels(target, p, 1, esfx);
2617
2618 //otherwise convert to pixels.
2619 } else if (esfx !== "px") {
2620 en = _convertToPixels(target, p, en, esfx);
2621 esfx = "px"; //we don't use bsfx after this, so we don't need to set it to px too.
2622 }
2623 if (rel) if (en || en === 0) {
2624 es = (en + bn) + esfx; //the changes we made affect relative calculations, so adjust the end value here.
2625 }
2626 }
2627
2628 if (rel) {
2629 en += bn;
2630 }
2631
2632 if ((bn || bn === 0) && (en || en === 0)) { //faster than isNaN(). Also, previously we required en !== bn but that doesn't really gain much performance and it prevents _parseToProxy() from working properly if beginning and ending values match but need to get tweened by an external plugin anyway. For example, a bezier tween where the target starts at left:0 and has these points: [{left:50},{left:0}] wouldn't work properly because when parsing the last point, it'd match the first (current) one and a non-tweening CSSPropTween would be recorded when we actually need a normal tween (type:0) so that things get updated during the tween properly.
2633 pt = new CSSPropTween(style, p, bn, en - bn, pt, 0, p, (_autoRound !== false && (esfx === "px" || p === "zIndex")), 0, bs, es);
2634 pt.xs0 = esfx;
2635 //DEBUG: _log("tween "+p+" from "+pt.b+" ("+bn+esfx+") to "+pt.e+" with suffix: "+pt.xs0);
2636 } else if (style[p] === undefined || !es && (es + "" === "NaN" || es == null)) {
2637 _log("invalid " + p + " tween value: " + vars[p]);
2638 } else {
2639 pt = new CSSPropTween(style, p, en || bn || 0, 0, pt, -1, p, false, 0, bs, es);
2640 pt.xs0 = (es === "none" && (p === "display" || p.indexOf("Style") !== -1)) ? bs : es; //intermediate value should typically be set immediately (end value) except for "display" or things like borderTopStyle, borderBottomStyle, etc. which should use the beginning value during the tween.
2641 //DEBUG: _log("non-tweening value "+p+": "+pt.xs0);
2642 }
2643 }
2644 }
2645 if (plugin) if (pt && !pt.plugin) {
2646 pt.plugin = plugin;
2647 }
2648 }
2649 return pt;
2650 };
2651
2652
2653 //gets called every time the tween updates, passing the new ratio (typically a value between 0 and 1, but not always (for example, if an Elastic.easeOut is used, the value can jump above 1 mid-tween). It will always start and 0 and end at 1.
2654 p.setRatio = function(v) {
2655 var pt = this._firstPT,
2656 min = 0.000001,
2657 val, str, i;
2658 //at the end of the tween, we set the values to exactly what we received in order to make sure non-tweening values (like "position" or "float" or whatever) are set and so that if the beginning/ending suffixes (units) didn't match and we normalized to px, the value that the user passed in is used here. We check to see if the tween is at its beginning in case it's a from() tween in which case the ratio will actually go from 1 to 0 over the course of the tween (backwards).
2659 if (v === 1 && (this._tween._time === this._tween._duration || this._tween._time === 0)) {
2660 while (pt) {
2661 if (pt.type !== 2) {
2662 if (pt.r && pt.type !== -1) {
2663 val = pt.r(pt.s + pt.c);
2664 if (!pt.type) {
2665 pt.t[pt.p] = val + pt.xs0;
2666 } else if (pt.type === 1) { //complex value (one that typically has multiple numbers inside a string, like "rect(5px,10px,20px,25px)"
2667 i = pt.l;
2668 str = pt.xs0 + val + pt.xs1;
2669 for (i = 1; i < pt.l; i++) {
2670 str += pt["xn"+i] + pt["xs"+(i+1)];
2671 }
2672 pt.t[pt.p] = str;
2673 }
2674 } else {
2675 pt.t[pt.p] = pt.e;
2676 }
2677 } else {
2678 pt.setRatio(v);
2679 }
2680 pt = pt._next;
2681 }
2682
2683 } else if (v || !(this._tween._time === this._tween._duration || this._tween._time === 0) || this._tween._rawPrevTime === -0.000001) {
2684 while (pt) {
2685 val = pt.c * v + pt.s;
2686 if (pt.r) {
2687 val = pt.r(val);
2688 } else if (val < min) if (val > -min) {
2689 val = 0;
2690 }
2691 if (!pt.type) {
2692 pt.t[pt.p] = val + pt.xs0;
2693 } else if (pt.type === 1) { //complex value (one that typically has multiple numbers inside a string, like "rect(5px,10px,20px,25px)"
2694 i = pt.l;
2695 if (i === 2) {
2696 pt.t[pt.p] = pt.xs0 + val + pt.xs1 + pt.xn1 + pt.xs2;
2697 } else if (i === 3) {
2698 pt.t[pt.p] = pt.xs0 + val + pt.xs1 + pt.xn1 + pt.xs2 + pt.xn2 + pt.xs3;
2699 } else if (i === 4) {
2700 pt.t[pt.p] = pt.xs0 + val + pt.xs1 + pt.xn1 + pt.xs2 + pt.xn2 + pt.xs3 + pt.xn3 + pt.xs4;
2701 } else if (i === 5) {
2702 pt.t[pt.p] = pt.xs0 + val + pt.xs1 + pt.xn1 + pt.xs2 + pt.xn2 + pt.xs3 + pt.xn3 + pt.xs4 + pt.xn4 + pt.xs5;
2703 } else {
2704 str = pt.xs0 + val + pt.xs1;
2705 for (i = 1; i < pt.l; i++) {
2706 str += pt["xn"+i] + pt["xs"+(i+1)];
2707 }
2708 pt.t[pt.p] = str;
2709 }
2710
2711 } else if (pt.type === -1) { //non-tweening value
2712 pt.t[pt.p] = pt.xs0;
2713
2714 } else if (pt.setRatio) { //custom setRatio() for things like SpecialProps, external plugins, etc.
2715 pt.setRatio(v);
2716 }
2717 pt = pt._next;
2718 }
2719
2720 //if the tween is reversed all the way back to the beginning, we need to restore the original values which may have different units (like % instead of px or em or whatever).
2721 } else {
2722 while (pt) {
2723 if (pt.type !== 2) {
2724 pt.t[pt.p] = pt.b;
2725 } else {
2726 pt.setRatio(v);
2727 }
2728 pt = pt._next;
2729 }
2730 }
2731 };
2732
2733 /**
2734 * @private
2735 * Forces rendering of the target's transforms (rotation, scale, etc.) whenever the CSSPlugin's setRatio() is called.
2736 * Basically, this tells the CSSPlugin to create a CSSPropTween (type 2) after instantiation that runs last in the linked
2737 * list and calls the appropriate (3D or 2D) rendering function. We separate this into its own method so that we can call
2738 * it from other plugins like BezierPlugin if, for example, it needs to apply an autoRotation and this CSSPlugin
2739 * doesn't have any transform-related properties of its own. You can call this method as many times as you
2740 * want and it won't create duplicate CSSPropTweens.
2741 *
2742 * @param {boolean} threeD if true, it should apply 3D tweens (otherwise, just 2D ones are fine and typically faster)
2743 */
2744 p._enableTransforms = function(threeD) {
2745 this._transform = this._transform || _getTransform(this._target, _cs, true); //ensures that the element has a _gsTransform property with the appropriate values.
2746 this._transformType = (!(this._transform.svg && _useSVGTransformAttr) && (threeD || this._transformType === 3)) ? 3 : 2;
2747 };
2748
2749 var lazySet = function(v) {
2750 this.t[this.p] = this.e;
2751 this.data._linkCSSP(this, this._next, null, true); //we purposefully keep this._next even though it'd make sense to null it, but this is a performance optimization, as this happens during the while (pt) {} loop in setRatio() at the bottom of which it sets pt = pt._next, so if we null it, the linked list will be broken in that loop.
2752 };
2753 /** @private Gives us a way to set a value on the first render (and only the first render). **/
2754 p._addLazySet = function(t, p, v) {
2755 var pt = this._firstPT = new CSSPropTween(t, p, 0, 0, this._firstPT, 2);
2756 pt.e = v;
2757 pt.setRatio = lazySet;
2758 pt.data = this;
2759 };
2760
2761 /** @private **/
2762 p._linkCSSP = function(pt, next, prev, remove) {
2763 if (pt) {
2764 if (next) {
2765 next._prev = pt;
2766 }
2767 if (pt._next) {
2768 pt._next._prev = pt._prev;
2769 }
2770 if (pt._prev) {
2771 pt._prev._next = pt._next;
2772 } else if (this._firstPT === pt) {
2773 this._firstPT = pt._next;
2774 remove = true; //just to prevent resetting this._firstPT 5 lines down in case pt._next is null. (optimized for speed)
2775 }
2776 if (prev) {
2777 prev._next = pt;
2778 } else if (!remove && this._firstPT === null) {
2779 this._firstPT = pt;
2780 }
2781 pt._next = next;
2782 pt._prev = prev;
2783 }
2784 return pt;
2785 };
2786
2787 p._mod = function(lookup) {
2788 var pt = this._firstPT;
2789 while (pt) {
2790 if (typeof(lookup[pt.p]) === "function") { //only gets called by RoundPropsPlugin (ModifyPlugin manages all the rendering internally for CSSPlugin properties that need modification). Remember, we handle rounding a bit differently in this plugin for performance reasons, leveraging "r" as an indicator that the value should be rounded internally.
2791 pt.r = lookup[pt.p];
2792 }
2793 pt = pt._next;
2794 }
2795 };
2796
2797 //we need to make sure that if alpha or autoAlpha is killed, opacity is too. And autoAlpha affects the "visibility" property.
2798 p._kill = function(lookup) {
2799 var copy = lookup,
2800 pt, p, xfirst;
2801 if (lookup.autoAlpha || lookup.alpha) {
2802 copy = {};
2803 for (p in lookup) { //copy the lookup so that we're not changing the original which may be passed elsewhere.
2804 copy[p] = lookup[p];
2805 }
2806 copy.opacity = 1;
2807 if (copy.autoAlpha) {
2808 copy.visibility = 1;
2809 }
2810 }
2811 if (lookup.className && (pt = this._classNamePT)) { //for className tweens, we need to kill any associated CSSPropTweens too; a linked list starts at the className's "xfirst".
2812 xfirst = pt.xfirst;
2813 if (xfirst && xfirst._prev) {
2814 this._linkCSSP(xfirst._prev, pt._next, xfirst._prev._prev); //break off the prev
2815 } else if (xfirst === this._firstPT) {
2816 this._firstPT = pt._next;
2817 }
2818 if (pt._next) {
2819 this._linkCSSP(pt._next, pt._next._next, xfirst._prev);
2820 }
2821 this._classNamePT = null;
2822 }
2823 pt = this._firstPT;
2824 while (pt) {
2825 if (pt.plugin && pt.plugin !== p && pt.plugin._kill) { //for plugins that are registered with CSSPlugin, we should notify them of the kill.
2826 pt.plugin._kill(lookup);
2827 p = pt.plugin;
2828 }
2829 pt = pt._next;
2830 }
2831 return TweenPlugin.prototype._kill.call(this, copy);
2832 };
2833
2834
2835
2836 //used by cascadeTo() for gathering all the style properties of each child element into an array for comparison.
2837 var _getChildStyles = function(e, props, targets) {
2838 var children, i, child, type;
2839 if (e.slice) {
2840 i = e.length;
2841 while (--i > -1) {
2842 _getChildStyles(e[i], props, targets);
2843 }
2844 return;
2845 }
2846 children = e.childNodes;
2847 i = children.length;
2848 while (--i > -1) {
2849 child = children[i];
2850 type = child.type;
2851 if (child.style) {
2852 props.push(_getAllStyles(child));
2853 if (targets) {
2854 targets.push(child);
2855 }
2856 }
2857 if ((type === 1 || type === 9 || type === 11) && child.childNodes.length) {
2858 _getChildStyles(child, props, targets);
2859 }
2860 }
2861 };
2862
2863 /**
2864 * Typically only useful for className tweens that may affect child elements, this method creates a TweenLite
2865 * and then compares the style properties of all the target's child elements at the tween's start and end, and
2866 * if any are different, it also creates tweens for those and returns an array containing ALL of the resulting
2867 * tweens (so that you can easily add() them to a TimelineLite, for example). The reason this functionality is
2868 * wrapped into a separate static method of CSSPlugin instead of being integrated into all regular className tweens
2869 * is because it creates entirely new tweens that may have completely different targets than the original tween,
2870 * so if they were all lumped into the original tween instance, it would be inconsistent with the rest of the API
2871 * and it would create other problems. For example:
2872 * - If I create a tween of elementA, that tween instance may suddenly change its target to include 50 other elements (unintuitive if I specifically defined the target I wanted)
2873 * - We can't just create new independent tweens because otherwise, what happens if the original/parent tween is reversed or pause or dropped into a TimelineLite for tight control? You'd expect that tween's behavior to affect all the others.
2874 * - Analyzing every style property of every child before and after the tween is an expensive operation when there are many children, so this behavior shouldn't be imposed on all className tweens by default, especially since it's probably rare that this extra functionality is needed.
2875 *
2876 * @param {Object} target object to be tweened
2877 * @param {number} Duration in seconds (or frames for frames-based tweens)
2878 * @param {Object} Object containing the end values, like {className:"newClass", ease:Linear.easeNone}
2879 * @return {Array} An array of TweenLite instances
2880 */
2881 CSSPlugin.cascadeTo = function(target, duration, vars) {
2882 var tween = TweenLite.to(target, duration, vars),
2883 results = [tween],
2884 b = [],
2885 e = [],
2886 targets = [],
2887 _reservedProps = TweenLite._internals.reservedProps,
2888 i, difs, p, from;
2889 target = tween._targets || tween.target;
2890 _getChildStyles(target, b, targets);
2891 tween.render(duration, true, true);
2892 _getChildStyles(target, e);
2893 tween.render(0, true, true);
2894 tween._enabled(true);
2895 i = targets.length;
2896 while (--i > -1) {
2897 difs = _cssDif(targets[i], b[i], e[i]);
2898 if (difs.firstMPT) {
2899 difs = difs.difs;
2900 for (p in vars) {
2901 if (_reservedProps[p]) {
2902 difs[p] = vars[p];
2903 }
2904 }
2905 from = {};
2906 for (p in difs) {
2907 from[p] = b[i][p];
2908 }
2909 results.push(TweenLite.fromTo(targets[i], duration, from, difs));
2910 }
2911 }
2912 return results;
2913 };
2914
2915 TweenPlugin.activate([CSSPlugin]);
2916 return CSSPlugin;
2917
2918 }, true);
2919
2920export var CSSPlugin = globals.CSSPlugin;
2921export { CSSPlugin as default };
\No newline at end of file