/** * Hilo * Copyright 2015 alibaba.com * Licensed under the MIT License */ var win = window, doc = document, docElem = doc.documentElement, uid = 0; var hasWarnedDict = {}; /** * @namespace Hilo The underlying core set of methods. * @static * @module hilo/core/Hilo * @requires hilo/util/browser * @requires hilo/util/util */ var Hilo = { /** * Hilo version * @type String */ version: '{{$version}}', /** * Gets a globally unique id. Such as Stage1, Bitmap2 etc. * @param {String} prefix Generated id's prefix. * @returns {String} Globally unique id. */ getUid: function(prefix) { var id = ++uid; if (prefix) { var charCode = prefix.charCodeAt(prefix.length - 1); if (charCode >= 48 && charCode <= 57) prefix += "_"; //0至9之间添加下划线 return prefix + id; } return id; }, /** * Generates a string representation that contains a path to the specified visual object. Such as Stage1.Container2.Bitmap3. * @param {View} view Specified visual object. * @returns {String} String representation of the visual object. */ viewToString: function(view) { var result, obj = view; while (obj) { result = result ? (obj.id + '.' + result) : obj.id; obj = obj.parent; } return result; }, /** * Simple shallow copy objects. * @deprecated use Hilo.util.copy instead * @param {Object} target Target object to copy to. * @param {Object} source Source object to copy. * @param {Boolean} strict Indicates whether replication is undefined property, default is false, i.e., undefined attributes are not copied. * @returns {Object} Object after copying. */ copy: function(target, source, strict) { util.copy(target, source, strict); if (!hasWarnedDict.copy) { hasWarnedDict.copy = true; console.warn('Hilo.copy has been Deprecated! Use Hilo.util.copy instead.'); } return target; }, /** * Browser feature set includes: * @see browser */ browser: browser, /** * Event enumeration objects include: * */ event: { POINTER_START: browser.POINTER_START, POINTER_MOVE: browser.POINTER_MOVE, POINTER_END: browser.POINTER_END }, /** * Visual object alinment enumeration objects include: * */ align: { TOP_LEFT: 'TL', //top & left TOP: 'T', //top & center TOP_RIGHT: 'TR', //top & right LEFT: 'L', //left & center CENTER: 'C', //center RIGHT: 'R', //right & center BOTTOM_LEFT: 'BL', //bottom & left BOTTOM: 'B', //bottom & center BOTTOM_RIGHT: 'BR' //bottom & right }, /** * Get DOM element content in the page display area. * @param {HTMLElement} elem DOM elements. * @returns {Object} Viewable area DOM elements. Format is: {left:0, top:0, width:100, height:100}. */ getElementRect: function(elem) { var bounds; try { //this fails if it's a disconnected DOM node bounds = elem.getBoundingClientRect(); } catch (e) { bounds = { top: elem.offsetTop, left: elem.offsetLeft, right: elem.offsetLeft + elem.offsetWidth, bottom: elem.offsetTop + elem.offsetHeight }; } var offsetX = ((win.pageXOffset || docElem.scrollLeft) - (docElem.clientLeft || 0)) || 0; var offsetY = ((win.pageYOffset || docElem.scrollTop) - (docElem.clientTop || 0)) || 0; var styles = win.getComputedStyle ? getComputedStyle(elem) : elem.currentStyle; var parseIntFn = parseInt; var padLeft = (parseIntFn(styles.paddingLeft) + parseIntFn(styles.borderLeftWidth)) || 0; var padTop = (parseIntFn(styles.paddingTop) + parseIntFn(styles.borderTopWidth)) || 0; var padRight = (parseIntFn(styles.paddingRight) + parseIntFn(styles.borderRightWidth)) || 0; var padBottom = (parseIntFn(styles.paddingBottom) + parseIntFn(styles.borderBottomWidth)) || 0; var top = bounds.top || 0; var left = bounds.left || 0; var right = bounds.right || 0; var bottom = bounds.bottom || 0; return { left: left + offsetX + padLeft, top: top + offsetY + padTop, width: right - padRight - left - padLeft, height: bottom - padBottom - top - padTop }; }, /** * Create a DOM element. You can specify properties and styles. * @param {String} type DOM element type to be created. Such as: 'div'. * @param {Object} properties Properties and styles for DOM element. * @returns {HTMLElement} A DOM element. */ createElement: function(type, properties) { var elem = doc.createElement(type), p, val, s; for (p in properties) { val = properties[p]; if (p === 'style') { for (s in val) elem.style[s] = val[s]; } else { elem[p] = val; } } return elem; }, /** * Gets a DOM element according to the parameter id. This method is equivalent to document.getElementById(id). * @param {String} id id of the DOM element you want to get. * @returns {HTMLElement} A DOM element. */ getElement: function(id) { return doc.getElementById(id); }, /** * Set visual object DOM element CSS style. * @param {View} obj Specifies the CSS style to set the visual object. * @private */ setElementStyleByView: function(obj) { var drawable = obj.drawable, style = drawable.domElement.style, stateCache = obj._stateCache || (obj._stateCache = {}), prefix = Hilo.browser.jsVendor, px = 'px', flag = false; if (this.cacheStateIfChanged(obj, ['visible'], stateCache)) { style.display = !obj.visible ? 'none' : ''; } if (this.cacheStateIfChanged(obj, ['alpha'], stateCache)) { style.opacity = obj.alpha; } if (!obj.visible || obj.alpha <= 0) return; if (this.cacheStateIfChanged(obj, ['width'], stateCache)) { style.width = obj.width + px; } if (this.cacheStateIfChanged(obj, ['height'], stateCache)) { style.height = obj.height + px; } if (this.cacheStateIfChanged(obj, ['depth'], stateCache)) { style.zIndex = obj.depth + 1; } if (obj.transform){ var transform = obj.transform; if (flag = this.cacheStateIfChanged(obj, ['pivotX', 'pivotY'], stateCache)) { style[prefix + 'TransformOrigin'] = '0 0'; } style[prefix + 'Transform'] = 'matrix3d(' + transform.a + ', '+ transform.b + ', 0, 0, '+ transform.c + ', '+ transform.d + ', 0, 0, 0, 0, 1, 0, '+ transform.tx + ', '+ transform.ty + ', 0, 1)'; } else{ if (flag = this.cacheStateIfChanged(obj, ['pivotX', 'pivotY'], stateCache)) { style[prefix + 'TransformOrigin'] = obj.pivotX + px + ' ' + obj.pivotY + px; } if (this.cacheStateIfChanged(obj, ['x', 'y', 'rotation', 'scaleX', 'scaleY'], stateCache) || flag) { style[prefix + 'Transform'] = this.getTransformCSS(obj); } } if (this.cacheStateIfChanged(obj, ['background'], stateCache)) { style.backgroundColor = obj.background; } if (!style.pointerEvents) { style.pointerEvents = 'none'; } //render image as background var image = drawable.image; if (image) { var src = image.src; if (src !== stateCache.image) { stateCache.image = src; style.backgroundImage = 'url(' + src + ')'; } var rect = drawable.rect; if (rect) { var sx = rect[0], sy = rect[1]; if (sx !== stateCache.sx) { stateCache.sx = sx; style.backgroundPositionX = -sx + px; } if (sy !== stateCache.sy) { stateCache.sy = sy; style.backgroundPositionY = -sy + px; } } } //render mask var mask = obj.mask; if (mask) { var maskImage = mask.drawable.domElement.style.backgroundImage; if (maskImage !== stateCache.maskImage) { stateCache.maskImage = maskImage; style[prefix + 'MaskImage'] = maskImage; style[prefix + 'MaskRepeat'] = 'no-repeat'; } var maskX = mask.x, maskY = mask.y; if (maskX !== stateCache.maskX || maskY !== stateCache.maskY) { stateCache.maskX = maskX; stateCache.maskY = maskY; style[prefix + 'MaskPosition'] = maskX + px + ' ' + maskY + px; } } }, /** * @private */ cacheStateIfChanged: function(obj, propNames, stateCache) { var i, len, name, value, changed = false; for (i = 0, len = propNames.length; i < len; i++) { name = propNames[i]; value = obj[name]; if (value != stateCache[name]) { stateCache[name] = value; changed = true; } } return changed; }, /** * Generated visual object CSS style transformation. * @param {View} obj Specifies visual object whose CSS style must be got. * @returns {String} String representation of the CSS style. */ getTransformCSS: function(obj) { var use3d = this.browser.supportTransform3D, str3d = use3d ? '3d' : ''; return 'translate' + str3d + '(' + (obj.x - obj.pivotX) + 'px, ' + (obj.y - obj.pivotY) + (use3d ? 'px, 0px)' : 'px)') + 'rotate' + str3d + (use3d ? '(0, 0, 1, ' : '(') + obj.rotation + 'deg)' + 'scale' + str3d + '(' + obj.scaleX + ', ' + obj.scaleY + (use3d ? ', 1)' : ')'); } };