/********************************************************************** * * * **********************************************************************/ define(function(require){ var module = {} //var DEBUG = DEBUG != null ? DEBUG : true var object = require('lib/object') /*********************************************************************/ // convert JS arguments to Array... var args2array = module.args2array = function(args){ //return Array.apply(null, args) return [].slice.call(args) } // Quote a string and convert to RegExp to match self literally. var quoteRegExp = module.quoteRegExp = function(str){ return str.replace(/([\.\\\/\(\)\[\]\$\*\+\-\{\}\@\^\&\?\<\>])/g, '\\$1') } // XXX do we need to quote anything else??? var path2url = module.path2url = function(path){ // test if we have a schema, and if yes return as-is... if(/^(http|https|file|[\w-]*):[\\\/]{2}/.test(path)){ return path } // skip encoding windows drives... var drive = path.split(/^([a-z]:[\\\/])/i) path = drive.pop() drive = drive.pop() || '' return drive + (path .split(/[\\\/]/g) // XXX these are too aggressive... //.map(encodeURI) //.map(encodeURIComponent) .join('/') // NOTE: keep '%' the first... //.replace(/%/g, '%25') .replace(/#/g, '%23') .replace(/&/g, '%26')) } // NOTE: we are not using node's path module as we need this to work in // all contexts, not only node... (???) var normalizePath = module.normalizePath = function(path){ return typeof(path) == typeof('str') ? path // normalize the slashes... .replace(/(\/)/g, '/') // remove duplicate '/' .replace(/(\/)\1+/g, '/') // remove trailing '/' .replace(/\/+$/, '') // take care of . .replace(/\/\.\//g, '/') .replace(/\/\.$/, '') // take care of .. .replace(/\/[^\/]+\/\.\.\//g, '/') .replace(/\/[^\/]+\/\.\.$/, '') : path } /*********************************************************************/ // convert a transform string to an object... // // Format: // { // : [, ...], // ... // } // // NOTE: this does not care about the semantics of the format, just the // general structure... var transform2obj = function(str){ var res = {} str = str || '' // parse the string... str // split functions... .split(/(\w+\([^\)]*)\)/) // remove empty strings... .filter(function(e){ return e.trim().length > 0}) // split each function... .map(function(e){ return e // split args... .split(/\s*[\(,\s]\s*/) // cleanup... .filter(function(e){ return e.trim().length > 0 }) }) // build the structure... .forEach(function(data){ var func = data.shift() var args = data res[func] = data }) return res } // Convert the object similar in structure to the produced by // transform2obj(..) to a transform string... // // NOTE: this does not care about the actual semantics of the format, // e.g. argument units or function names... var obj2transform = function(obj, filter){ filter = filter || [] var keep = filter .filter(function(f){ return f[0] != '-' }) var remove = filter .filter(function(f){ return f[0] == '-' }) .map(function(f){ return f.slice(1) }) return Object.keys(obj) // keep... .filter(function(func){ return keep.length == 0 || keep.indexOf(func) >= 0 }) // remove... .filter(function(func){ return remove.indexOf(func) < 0 }) .map(function(func){ return func +'('+ obj[func].join(', ') + ')' }) .join(' ') } // XXX BUG: passing '' to an alias will clear ALL the aliased functions... // ...should clear only full matches... // XXX BUG: passing '' to a multi-arg function will clear the args but // still keep the function... // XXX BUG: setting a single arg alias will return string results... // .x(123) -> ['123px'] -> must be [123] // .x() -> [123] // .translate3d(1,2,3) // -> [1, 2, 3] // NOTE: both set data correctly... // XXX move the grammar out of this... // XXX need: // - a way to minimize this, i.e. get only full and minimal functions... // - a way to get what was defined as-is... // XXX might be a good idea to use aliases for getting stuff and not // just setting stuff... // .x(123) -> set all the aliases // .x() -> search only the first match // XXX not critical yet but will need to support for completeness... // - transformStyle // - prespective // - prespectiveOrigin // - backfaceVisibility // XXX add transitions... // XXX add support for vendor tags... var transformEditor = function(){ var editor = { // data set... data: {}, // function that directly edit the data... __direct: {}, // methods... toString: function(){ return obj2transform(this.data, args2array(arguments)) }, // NOTE: this will not build the alias data... fromString: function(str){ this.data = transform2obj(str) return this }, // XXX need to simplify first... // XXX use vendor prefix... toElem: function(elem){ var origin = this.data.origin || '' var transform = this.toString('-origin') elem = elem instanceof jQuery ? elem.toArray() : elem instanceof Array ? elem : [elem] // XXX simplify state... // XXX elem.forEach(function(e){ e.style.transformOrigin = origin.join ? origin.join(' ') : origin e.style.transform = transform }) return this }, get: function(){ var that = this var attrs = arguments[0] instanceof Array ? arguments[0] : args2array(arguments) var res = {} attrs.forEach(function(a){ if(!(a in that)){ return } var v = that[a]() v = v.length == 1 ? v.pop() : v.length == 0 ? undefined : v res[a] = v }) if(attrs.length == 1){ return res[attrs[0]] } return res }, // XXX also load origin... // XXX use vendor prefix... __init__: function(str){ this.data = {} if(str != null){ if(str instanceof jQuery){ str = str[0] } if(str instanceof HTMLElement){ var origin = str.style.transformOrigin origin = origin.length > 0 ? ' origin('+ origin +')' : '' str = str.style.transform + origin } this.fromString(str) } }, } var func = function(name, args){ args = args || [] editor.__direct[name] = function(val){ var that = this // set... if(val != null && val != ''){ val = val instanceof Array ? val : [val] var res = this.data[name] = this.data[name] || [] // add units and general processing... val.map(function(arg, i){ // special case, if an arg is undefined do not change it... if(arg === undefined){ return } var unit = args[i] || '' res[i] = typeof(arg) == typeof(123) || (typeof(arg) == typeof('str') && /^[0-9\.]+$/.test(arg)) ? arg + unit : arg }) return res // delete... } else if(val == ''){ delete this.data[name] // get... } else { var res = (this.data[name] || []) // remove default unit... .map(function(arg, i){ var unit = args[i] || '' return arg.slice(-unit.length) == unit || /^[0-9\.]+$/.test(arg)? parseFloat(arg) : arg }) return res } } } var alias = function(spec){ // alias runner... var handler = function(alias, args){ var that = this // we only care for the source argument and only it will get // passed next... // NOTE: this is the name of the called alias... var arg = args[spec[alias]] // XXX get the correct return value... return Object.keys(spec).map(function(k){ var i = spec[k] if(args.length == 0){ return k in that.__direct ? that.__direct[k].call(that) : null } var a = [] a[i] = arg return k in that.__direct ? that.__direct[k].call(that, a) : null }) .filter(function(e){ return e != null }) .slice(-1)[0] } // setup the aliases... Object.keys(spec).forEach(function(k){ var i = spec[k] var func = i instanceof Function ? i : handler // NOTE: we will pass the called alias name to the handler // via 'this'... var f = editor[k] editor[k] = f ? // wrap the original alias... function(){ var args = args2array(arguments) // XXX do a full search through the alias values... if(args.length == 0 && k in this.__direct){ return this.__direct[k].call(this) } var a = f.apply(this, args) var b = func.call(this, k, args) if(k in this.__direct){ return this.__direct[k].call(this) } return b } : function(){ var args = args2array(arguments) return func.call(this, k, args) } }) } // XXX get these from grammar... func('translate', ['px', 'px']) func('translate3d', ['px', 'px', 'px']) func('translateX', ['px']) func('translateY', ['px']) func('translateZ', ['px']) alias({ translate3d: 0, translate: 0, translateX: 0, x: 0 }) alias({ translate3d: 1, translate: 1, translateY: 0, y: 0, }) alias({ translate3d: 2, translateZ: 0, z: 0, }) func('scale', ['', '']) func('scale3d', ['', '', '']) func('scaleX') func('scaleY') //func('scaleZ') alias({ scale: 0, scale3d: 0, scaleX: 0, }) alias({ scale: 1, scale3d: 1, scaleY: 0, }) alias({ scale3d: 2, scaleZ: 0, }) // special case: single arg scale: scale(n) -> scale(n, n) editor._scale = editor.scale editor.scale = function(){ if(arguments.length == 1 && arguments[0] != '' && arguments[0] != '='){ return this._scale.call(this, arguments[0], arguments[0]) } return this._scale.apply(this, arguments) } func('rotate', ['deg']) func('rotate3d', ['px', 'px', 'px', 'deg']) func('rotateX', ['deg']) func('rotateY', ['deg']) func('rotateZ', ['deg']) func('matrix') // XXX ??? func('matrix3d', [ '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', ]) func('skew', ['', '']) func('skewX') func('skewY') alias({skewX: 0, skew: 0}) alias({skewY: 0, skew: 1}) func('perspective') // non-transform functions... func('origin', ['px', 'px', 'px']) // proxy the undefined in aliases functions... Object.keys(editor.__direct).forEach(function(k){ if(!(k in editor)){ editor[k] = function(){ var args = args2array(arguments) editor.__direct[k].apply(this, args.length > 0 ? [args]: []) return editor.__direct[k].call(this) } } }) return editor } var TransformEditor = module.TransformEditor = object.makeConstructor('TransformEditor', transformEditor()) // XXX STUB: for testing only... window.transformEditor = TransformEditor // jQuery API for the TransformEditor... jQuery.fn.transform = function(){ var that = this var elem = $(this)[0] var args = args2array(arguments) // normalize... args = args.length == 0 || typeof(args[0]) == typeof('str') ? args : args[0].constructor === Array || args.length == 1 ? args[0] : args // load the current state... var transform = TransformEditor(elem) // get state... if(args.constructor === Array){ if(args.length == 0){ // XXX get all attrs... // XXX return } // get requested attrs... return transform.get(args) // set state... } else { // load user inputs... Object.keys(args).forEach(function(k){ if(!(k in transform)){ return } transform[k].apply(transform, args[k] instanceof Array ? args[k] : [args[k]]) }) transform.toElem(this) } return $(this) } // shorthands... jQuery.fn.scale = function(value){ if(value){ return $(this).transform({scale: value}) } else { return $(this).transform('scale') } } jQuery.fn.origin = function(a, b, c){ if(a != null && b != null){ return $(this).transform({origin: [a, b, c == null ? 0 : c]}) } else if(a == '' || a instanceof Array){ return $(this).transform({origin: a}) } else { return $(this).transform('origin') } } /********************************************************************** * vim:set ts=4 sw=4 : */ return module })