From a3024011a91d3941f81481dd4d600e9684eb0fd4 Mon Sep 17 00:00:00 2001 From: Valerio Virgillito Date: Thu, 2 Feb 2012 00:11:51 -0800 Subject: upgrading to Montage v0.6 Signed-off-by: Valerio Virgillito --- node_modules/montage/ui/native-control.js | 240 ++++++++++++++++++++++++++++++ 1 file changed, 240 insertions(+) create mode 100644 node_modules/montage/ui/native-control.js (limited to 'node_modules/montage/ui/native-control.js') diff --git a/node_modules/montage/ui/native-control.js b/node_modules/montage/ui/native-control.js new file mode 100644 index 00000000..d3c3a635 --- /dev/null +++ b/node_modules/montage/ui/native-control.js @@ -0,0 +1,240 @@ +/* + This file contains proprietary software owned by Motorola Mobility, Inc.
+ No rights, expressed or implied, whatsoever to this software are provided by Motorola Mobility, Inc. hereunder.
+ (c) Copyright 2011 Motorola Mobility, Inc. All Rights Reserved. + */ + +var Montage = require("montage").Montage, + Component = require("ui/component").Component; + +var isUndefined = function(obj) { + return (typeof obj === 'undefined'); +}; + +var extend = function(destination, source) { + for (var property in source) { + destination[property] = source[property]; + } + return destination; +}; + +var STRING_CLASS = '[object String]'; +var _toString = Object.prototype.toString; +var isString = function(object) { + return _toString.call(object) === STRING_CLASS; +}; + +/** + * Base component for all native controls. + */ +exports.NativeControl = Montage.create(Component, { + + hasTemplate: { + value: false + }, + + //http://www.w3.org/TR/html5/elements.html#global-attributes + _baseElementProperties: { + value: { + accesskey: null, + contenteditable: null, // true, false, inherit + contextmenu: null, + 'class': null, + dir: null, + draggable: {dataType: 'boolean'}, + dropzone: null, // copy/move/link + hidden: {dataType: 'boolean'}, + //id: null, + lang: null, + spellcheck: null, + style: null, + tabindex: null, + title: null + } + }, + + /** Stores values that need to be set on the element. Cleared each draw + * cycle. + */ + _elementAttributeValues: { + value: {}, + distinct: true + }, + + /** Stores the descriptors of the properties that can be set on this + * control + */ + _propertyDescriptors: { + value: {}, + distinct: true + }, + + /** + * Add a property to this Component. A default getter/setter is provided and a + * "_" property is created by default. Eg: if the property is "title", "_title" is + * automatically created and the value set to the value from the descriptor. + */ + defineAttribute: { + value: function(name, descriptor) { + descriptor = descriptor || {}; + + var newDescriptor = { + configurable: isUndefined(descriptor.configurable) ? true: descriptor.configurable, + enumerable: isUndefined(descriptor.enumerable) ? true: descriptor.enumerable, + serializable: isUndefined(descriptor.serializable) ? true: descriptor.serializable, + set: (function(name) { + return function(value) { + var attrName = '_' + name; + + var desc = this._propertyDescriptors[name]; + // if requested dataType is boolean (eg: checked, readonly etc) + // coerce the value to boolean + if(desc && "boolean" === desc.dataType) { + value = ( (value || value === "") ? true : false); + } + + // If the set value is different to the current one, + // update it here, and set it to be updated on the + // element in the next draw cycle. + if(!isUndefined(value) && this[attrName] !== value) { + this[attrName] = value; + this._elementAttributeValues[name] = value; + this.needsDraw = true; + } + }; + }(name)), + get: (function(name) { + return function() { + return this['_' + name]; + }; + }(name)) + }; + + // Define _ property + Montage.defineProperty(this, '_' + name, {value: null}); + // Define property getter and setter + Montage.defineProperty(this, name, newDescriptor); + } + }, + + /** + * Add the specified properties as properties of this Component + */ + addAttributes: { + value: function(props) { + var i, desc, prop, obj; + var standardAttributes = {}; + standardAttributes = extend(standardAttributes, this._baseElementProperties); + standardAttributes = extend(standardAttributes, props); + + this._propertyDescriptors = standardAttributes; + + for(prop in standardAttributes) { + if(standardAttributes.hasOwnProperty(prop)) { + obj = standardAttributes[prop]; + // Make sure that the descriptor is of the correct form. + if(obj === null || isString(obj)) { + desc = {value: obj, dataType: "string"}; + standardAttributes[prop] = desc; + } else { + desc = obj; + } + + // Only add the internal prop, and getter and setter if + // they don't already exist. + if(isUndefined(this[prop])) { + this.defineAttribute(prop, desc); + } + } + } + } + }, + + deserializedFromTemplate: { + value: function() { + // The element is now ready, so we can read the attributes that + // have been set on it. + var attrs = this.element.attributes || []; + var i=0, len = attrs.length, name, value, d, desc; + + for(i=0; i< len; i++) { + name = attrs[i].name; + value = attrs[i].value; + + if(isUndefined(this._elementAttributeValues[name])) { + this._elementAttributeValues[name] = value; + // since deserializedFromTemplate is called *after* the initial binding + // is done, override the values only if a value does not already exist + if(isUndefined(this[name]) || this[name] === null) { + this[name] = value; + } + } + } + + // check if this element has textContent + var textContent = this.element.textContent; + // set textContent only if it is defined as part of element properties + if(('textContent' in this) && textContent && ("" !== textContent)) { + if(isUndefined(this._elementAttributeValues['textContent'])) { + this._elementAttributeValues['textContent'] = textContent; + // since deserializedFromTemplate is called *after* the initial binding + // is done, override the values only if a value does not already exist + if(isUndefined(this['textContent']) || this['textContent'] === null) { + this['textContent'] = textContent; + } + } + } + + // Set defaults for any properties that weren't serialised or set + // as attributes on the element. + for (d in this._propertyDescriptors) { + desc = this._propertyDescriptors[d]; + if (this["_"+d] === null && desc !== null && "value" in desc) { + this["_"+d] = this._propertyDescriptors[d].value; + } + } + + } + }, + + + draw: { + enumerable: false, + value: function() { + var el = this.element, desc; + + for(var i in this._elementAttributeValues) { + if(this._elementAttributeValues.hasOwnProperty(i)) { + if(i === 'value') { + continue; + } + var val = this[i]; + desc = this._propertyDescriptors[i]; + if(desc && desc.dataType === 'boolean') { + if(val === true) { + el[i] = true; + el.setAttribute(i, i.toLowerCase()); + } else { + el[i] = false; + el.removeAttribute(i); + } + } else { + if(!isUndefined(val) && val !== null) { + if(i === 'textContent') { + el.textContent = val; + } else { + //https://developer.mozilla.org/en/DOM/element.setAttribute + el.setAttribute(i, val); + } + + } + } + + } + } + // the values have been flushed to the DOM. + this._elementAttributeValues = {}; + + } + } +}); -- cgit v1.2.3