// Copyright 2014 The Closure Library Authors. All Rights Reserved.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS-IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
/**
* @fileoverview Utility methods to deal with CSS3 transforms programmatically.
*/
goog.provide('goog.style.transform');
goog.require('goog.functions');
goog.require('goog.math.Coordinate');
goog.require('goog.math.Coordinate3');
goog.require('goog.style');
goog.require('goog.userAgent');
goog.require('goog.userAgent.product.isVersion');
/**
* Whether CSS3 transform translate() is supported. IE 9 supports 2D transforms
* and IE 10 supports 3D transforms. IE 8 supports neither.
* @return {boolean} Whether the current environment supports CSS3 transforms.
*/
goog.style.transform.isSupported = goog.functions.cacheReturnValue(function() {
return !goog.userAgent.IE || goog.userAgent.product.isVersion(9);
});
/**
* Whether CSS3 transform translate3d() is supported. If the current browser
* supports this transform strategy.
* @return {boolean} Whether the current environment supports CSS3 transforms.
*/
goog.style.transform.is3dSupported =
goog.functions.cacheReturnValue(function() {
return goog.userAgent.WEBKIT ||
(goog.userAgent.GECKO && goog.userAgent.product.isVersion(10)) ||
(goog.userAgent.IE && goog.userAgent.product.isVersion(10));
});
/**
* Returns the x,y translation component of any CSS transforms applied to the
* element, in pixels.
*
* @param {!Element} element The element to get the translation of.
* @return {!goog.math.Coordinate} The CSS translation of the element in px.
*/
goog.style.transform.getTranslation = function(element) {
var transform = goog.style.getComputedTransform(element);
var matrixConstructor = goog.style.transform.matrixConstructor_();
if (transform && matrixConstructor) {
var matrix = new matrixConstructor(transform);
if (matrix) {
return new goog.math.Coordinate(matrix.m41, matrix.m42);
}
}
return new goog.math.Coordinate(0, 0);
};
/**
* Translates an element's position using the CSS3 transform property.
* NOTE: This replaces all other transforms already defined on the element.
* @param {Element} element The element to translate.
* @param {number} x The horizontal translation.
* @param {number} y The vertical translation.
* @return {boolean} Whether the CSS translation was set.
*/
goog.style.transform.setTranslation = function(element, x, y) {
if (!goog.style.transform.isSupported()) {
return false;
}
// TODO(user): After http://crbug.com/324107 is fixed, it will be faster to
// use something like: translation = new CSSMatrix().translate(x, y, 0);
var translation = goog.style.transform.is3dSupported() ?
'translate3d(' + x + 'px,' + y + 'px,' + '0px)' :
'translate(' + x + 'px,' + y + 'px)';
goog.style.setStyle(element,
goog.style.transform.getTransformProperty_(), translation);
return true;
};
/**
* Returns the scale of the x, y and z dimensions of CSS transforms applied to
* the element.
*
* @param {!Element} element The element to get the scale of.
* @return {!goog.math.Coordinate3} The scale of the element.
*/
goog.style.transform.getScale = function(element) {
var transform = goog.style.getComputedTransform(element);
var matrixConstructor = goog.style.transform.matrixConstructor_();
if (transform && matrixConstructor) {
var matrix = new matrixConstructor(transform);
if (matrix) {
return new goog.math.Coordinate3(matrix.m11, matrix.m22, matrix.m33);
}
}
return new goog.math.Coordinate3(0, 0, 0);
};
/**
* Scales an element using the CSS3 transform property.
* NOTE: This replaces all other transforms already defined on the element.
* @param {!Element} element The element to scale.
* @param {number} x The horizontal scale.
* @param {number} y The vertical scale.
* @param {number} z The depth scale.
* @return {boolean} Whether the CSS scale was set.
*/
goog.style.transform.setScale = function(element, x, y, z) {
if (!goog.style.transform.isSupported()) {
return false;
}
var scale = goog.style.transform.is3dSupported() ?
'scale3d(' + x + ',' + y + ',' + z + ')' :
'scale(' + x + ',' + y + ')';
goog.style.setStyle(element,
goog.style.transform.getTransformProperty_(), scale);
return true;
};
/**
* A cached value of the transform property depending on whether the useragent
* is IE9.
* @return {string} The transform property depending on whether the useragent
* is IE9.
* @private
*/
goog.style.transform.getTransformProperty_ =
goog.functions.cacheReturnValue(function() {
return goog.userAgent.IE && goog.userAgent.DOCUMENT_MODE == 9 ?
'-ms-transform' : 'transform';
});
/**
* Gets the constructor for a CSSMatrix object.
* @return {function(new:CSSMatrix, string)?} A constructor for a CSSMatrix
* object (or null).
* @private
*/
goog.style.transform.matrixConstructor_ =
goog.functions.cacheReturnValue(function() {
if (goog.isDef(goog.global['WebKitCSSMatrix'])) {
return goog.global['WebKitCSSMatrix'];
}
if (goog.isDef(goog.global['MSCSSMatrix'])) {
return goog.global['MSCSSMatrix'];
}
if (goog.isDef(goog.global['CSSMatrix'])) {
return goog.global['CSSMatrix'];
}
return null;
});