(function() { // ========================================================================== // Project: Ember Metal // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== /*globals Em:true ENV */ if ('undefined' === typeof Ember) { /** @namespace @name Ember @version 0.9.8.1 All Ember methods and functions are defined inside of this namespace. You generally should not add new properties to this namespace as it may be overwritten by future versions of Ember. You can also use the shorthand "Em" instead of "Ember". Ember-Runtime is a framework that provides core functions for Ember including cross-platform functions, support for property observing and objects. Its focus is on small size and performance. You can use this in place of or along-side other cross-platform libraries such as jQuery. The core Runtime framework is based on the jQuery API with a number of performance optimizations. */ // Create core object. Make it act like an instance of Ember.Namespace so that // objects assigned to it are given a sane string representation. Ember = {}; // aliases needed to keep minifiers from removing the global context if ('undefined' !== typeof window) { window.Em = window.Ember = Em = Ember; } } // Make sure these are set whether Ember was already defined or not Ember.isNamespace = true; Ember.toString = function() { return "Ember"; }; /** @static @type String @default '0.9.8.1' @constant */ Ember.VERSION = '0.9.8.1'; /** @static @type Hash @constant Standard environmental variables. You can define these in a global `ENV` variable before loading Ember to control various configuration settings. */ Ember.ENV = 'undefined' === typeof ENV ? {} : ENV; // .......................................................... // BOOTSTRAP // /** @static @type Boolean @default true @constant Determines whether Ember should enhances some built-in object prototypes to provide a more friendly API. If enabled, a few methods will be added to Function, String, and Array. Object.prototype will not be enhanced, which is the one that causes most troubles for people. In general we recommend leaving this option set to true since it rarely conflicts with other code. If you need to turn it off however, you can define an ENV.EXTEND_PROTOTYPES config to disable it. */ Ember.EXTEND_PROTOTYPES = (Ember.ENV.EXTEND_PROTOTYPES !== false); /** @static @type Boolean @default Ember.EXTEND_PROTOTYPES @constant Determines whether Ember should add ECMAScript 5 shims to older browsers. */ Ember.SHIM_ES5 = (Ember.ENV.SHIM_ES5 === false) ? false : Ember.EXTEND_PROTOTYPES; /** @static @type Boolean @default false @constant Determines whether computed properties are cacheable by default. In future releases this will default to `true`. For the 1.0 release, the option to turn off caching by default will be removed entirely. When caching is enabled by default, you can use `volatile()` to disable caching on individual computed properties. */ Ember.CP_DEFAULT_CACHEABLE = !!Ember.ENV.CP_DEFAULT_CACHEABLE; /** @static @type Boolean @default false @constant Determines whether views render their templates using themselves as the context, or whether it is inherited from the parent. In future releases, this will default to `true`. For the 1.0 release, the option to have views change context by default will be removed entirely. If you need to update your application to use the new context rules, simply prefix property access with `view.`: // Before: {{#each App.photosController}} Photo Title: {{title}} {{#view App.InfoView contentBinding="this"}} {{content.date}} {{content.cameraType}} {{otherViewProperty}} {{/view}} {{/each}} // After: {{#each App.photosController}} Photo Title: {{title}} {{#view App.InfoView}} {{date}} {{cameraType}} {{view.otherViewProperty}} {{/view}} {{/each}} */ Ember.VIEW_PRESERVES_CONTEXT = !!Ember.ENV.VIEW_PRESERVES_CONTEXT; /** Empty function. Useful for some operations. @returns {Object} @private */ Ember.K = function() { return this; }; /** @namespace @name window @description The global window object */ // Stub out the methods defined by the ember-debug package in case it's not loaded if ('undefined' === typeof Ember.assert) { Ember.assert = Ember.K; } if ('undefined' === typeof Ember.warn) { Ember.warn = Ember.K; } if ('undefined' === typeof Ember.deprecate) { Ember.deprecate = Ember.K; } if ('undefined' === typeof Ember.deprecateFunc) { Ember.deprecateFunc = function(_, func) { return func; }; } // These are deprecated but still supported if ('undefined' === typeof ember_assert) { window.ember_assert = Ember.K; } if ('undefined' === typeof ember_warn) { window.ember_warn = Ember.K; } if ('undefined' === typeof ember_deprecate) { window.ember_deprecate = Ember.K; } if ('undefined' === typeof ember_deprecateFunc) { /** @private */ window.ember_deprecateFunc = function(_, func) { return func; }; } // .......................................................... // LOGGER // /** @class Inside Ember-Metal, simply uses the window.console object. Override this to provide more robust logging functionality. */ Ember.Logger = window.console || { log: Ember.K, warn: Ember.K, error: Ember.K }; })(); (function() { // ========================================================================== // Project: Ember Metal // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== /*globals Node */ /** @class Platform specific methods and feature detectors needed by the framework. @name Ember.platform */ var platform = Ember.platform = {} ; /** Identical to Object.create(). Implements if not available natively. @memberOf Ember.platform @name create */ platform.create = Object.create; if (!platform.create) { /** @private */ var O_ctor = function() {}, O_proto = O_ctor.prototype; platform.create = function(obj, descs) { O_ctor.prototype = obj; obj = new O_ctor(); O_ctor.prototype = O_proto; if (descs !== undefined) { for(var key in descs) { if (!descs.hasOwnProperty(key)) continue; platform.defineProperty(obj, key, descs[key]); } } return obj; }; platform.create.isSimulated = true; } /** @private */ var defineProperty = Object.defineProperty; var canRedefineProperties, canDefinePropertyOnDOM; // Catch IE8 where Object.defineProperty exists but only works on DOM elements if (defineProperty) { try { defineProperty({}, 'a',{get:function(){}}); } catch (e) { /** @private */ defineProperty = null; } } if (defineProperty) { // Detects a bug in Android <3.2 where you cannot redefine a property using // Object.defineProperty once accessors have already been set. /** @private */ canRedefineProperties = (function() { var obj = {}; defineProperty(obj, 'a', { configurable: true, enumerable: true, get: function() { }, set: function() { } }); defineProperty(obj, 'a', { configurable: true, enumerable: true, writable: true, value: true }); return obj.a === true; })(); // This is for Safari 5.0, which supports Object.defineProperty, but not // on DOM nodes. /** @private */ canDefinePropertyOnDOM = (function(){ try { defineProperty(document.createElement('div'), 'definePropertyOnDOM', {}); return true; } catch(e) { } return false; })(); if (!canRedefineProperties) { /** @private */ defineProperty = null; } else if (!canDefinePropertyOnDOM) { /** @private */ defineProperty = function(obj, keyName, desc){ var isNode; if (typeof Node === "object") { isNode = obj instanceof Node; } else { isNode = typeof obj === "object" && typeof obj.nodeType === "number" && typeof obj.nodeName === "string"; } if (isNode) { // TODO: Should we have a warning here? return (obj[keyName] = desc.value); } else { return Object.defineProperty(obj, keyName, desc); } }; } } /** Identical to Object.defineProperty(). Implements as much functionality as possible if not available natively. @memberOf Ember.platform @name defineProperty @param {Object} obj The object to modify @param {String} keyName property name to modify @param {Object} desc descriptor hash @returns {void} */ platform.defineProperty = defineProperty; /** Set to true if the platform supports native getters and setters. @memberOf Ember.platform @name hasPropertyAccessors */ platform.hasPropertyAccessors = true; if (!platform.defineProperty) { platform.hasPropertyAccessors = false; platform.defineProperty = function(obj, keyName, desc) { obj[keyName] = desc.value; }; platform.defineProperty.isSimulated = true; } })(); (function() { // ========================================================================== // Project: Ember Metal // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== // .......................................................... // GUIDS // // Used for guid generation... var GUID_KEY = '__ember'+ (+ new Date()); var uuid, numberCache, stringCache; uuid = 0; numberCache = []; stringCache = {}; var GUID_DESC = Ember.GUID_DESC = { configurable: true, writable: true, enumerable: false }; var o_defineProperty = Ember.platform.defineProperty; var o_create = Ember.platform.create; /** @private @static @type String @constant A unique key used to assign guids and other private metadata to objects. If you inspect an object in your browser debugger you will often see these. They can be safely ignored. On browsers that support it, these properties are added with enumeration disabled so they won't show up when you iterate over your properties. */ Ember.GUID_KEY = GUID_KEY; /** @private Generates a new guid, optionally saving the guid to the object that you pass in. You will rarely need to use this method. Instead you should call Ember.guidFor(obj), which return an existing guid if available. @param {Object} obj Optional object the guid will be used for. If passed in, the guid will be saved on the object and reused whenever you pass the same object again. If no object is passed, just generate a new guid. @param {String} prefix Optional prefix to place in front of the guid. Useful when you want to separate the guid into separate namespaces. @returns {String} the guid */ Ember.generateGuid = function(obj, prefix) { if (!prefix) prefix = 'ember'; var ret = (prefix + (uuid++)); if (obj) { GUID_DESC.value = ret; o_defineProperty(obj, GUID_KEY, GUID_DESC); GUID_DESC.value = null; } return ret ; }; /** @private Returns a unique id for the object. If the object does not yet have a guid, one will be assigned to it. You can call this on any object, Ember.Object-based or not, but be aware that it will add a _guid property. You can also use this method on DOM Element objects. @method @param obj {Object} any object, string, number, Element, or primitive @returns {String} the unique guid for this instance. */ Ember.guidFor = function(obj) { // special cases where we don't want to add a key to object if (obj === undefined) return "(undefined)"; if (obj === null) return "(null)"; var cache, ret; var type = typeof obj; // Don't allow prototype changes to String etc. to change the guidFor switch(type) { case 'number': ret = numberCache[obj]; if (!ret) ret = numberCache[obj] = 'nu'+obj; return ret; case 'string': ret = stringCache[obj]; if (!ret) ret = stringCache[obj] = 'st'+(uuid++); return ret; case 'boolean': return obj ? '(true)' : '(false)'; default: if (obj[GUID_KEY]) return obj[GUID_KEY]; if (obj === Object) return '(Object)'; if (obj === Array) return '(Array)'; return Ember.generateGuid(obj, 'ember'); } }; // .......................................................... // META // var META_DESC = { writable: true, configurable: false, enumerable: false, value: null }; var META_KEY = Ember.GUID_KEY+'_meta'; /** The key used to store meta information on object for property observing. @static @property */ Ember.META_KEY = META_KEY; // Placeholder for non-writable metas. var EMPTY_META = { descs: {}, watching: {} }; if (Object.freeze) Object.freeze(EMPTY_META); var createMeta = Ember.platform.defineProperty.isSimulated ? o_create : (function(meta) { return meta; }); /** @private @function Retrieves the meta hash for an object. If 'writable' is true ensures the hash is writable for this object as well. The meta object contains information about computed property descriptors as well as any watched properties and other information. You generally will not access this information directly but instead work with higher level methods that manipulate this hash indirectly. @param {Object} obj The object to retrieve meta for @param {Boolean} writable Pass false if you do not intend to modify the meta hash, allowing the method to avoid making an unnecessary copy. @returns {Hash} */ Ember.meta = function meta(obj, writable) { var ret = obj[META_KEY]; if (writable===false) return ret || EMPTY_META; if (!ret) { o_defineProperty(obj, META_KEY, META_DESC); ret = obj[META_KEY] = createMeta({ descs: {}, watching: {}, values: {}, lastSetValues: {}, cache: {}, source: obj }); // make sure we don't accidentally try to create constructor like desc ret.descs.constructor = null; } else if (ret.source !== obj) { ret = o_create(ret); ret.descs = o_create(ret.descs); ret.values = o_create(ret.values); ret.watching = o_create(ret.watching); ret.lastSetValues = {}; ret.cache = {}; ret.source = obj; o_defineProperty(obj, META_KEY, META_DESC); ret = obj[META_KEY] = createMeta(ret); } return ret; }; Ember.getMeta = function getMeta(obj, property) { var meta = Ember.meta(obj, false); return meta[property]; }; Ember.setMeta = function setMeta(obj, property, value) { var meta = Ember.meta(obj, true); meta[property] = value; return value; }; /** @private In order to store defaults for a class, a prototype may need to create a default meta object, which will be inherited by any objects instantiated from the class's constructor. However, the properties of that meta object are only shallow-cloned, so if a property is a hash (like the event system's `listeners` hash), it will by default be shared across all instances of that class. This method allows extensions to deeply clone a series of nested hashes or other complex objects. For instance, the event system might pass ['listeners', 'foo:change', 'ember157'] to `prepareMetaPath`, which will walk down the keys provided. For each key, if the key does not exist, it is created. If it already exists and it was inherited from its constructor, the constructor's key is cloned. You can also pass false for `writable`, which will simply return undefined if `prepareMetaPath` discovers any part of the path that shared or undefined. @param {Object} obj The object whose meta we are examining @param {Array} path An array of keys to walk down @param {Boolean} writable whether or not to create a new meta (or meta property) if one does not already exist or if it's shared with its constructor */ Ember.metaPath = function(obj, path, writable) { var meta = Ember.meta(obj, writable), keyName, value; for (var i=0, l=path.length; i [] Ember.makeArray(null); => [] Ember.makeArray(undefined); => [] Ember.makeArray('lindsay'); => ['lindsay'] Ember.makeArray([1,2,42]); => [1,2,42] var controller = Ember.ArrayProxy.create({ content: [] }); Ember.makeArray(controller) === controller; => true @param {Object} obj the object @returns {Array} */ Ember.makeArray = function(obj) { if (obj === null || obj === undefined) return []; return Ember.isArray(obj) ? obj : [obj]; }; })(); (function() { // ========================================================================== // Project: Ember Metal // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== var USE_ACCESSORS = Ember.platform.hasPropertyAccessors && Ember.ENV.USE_ACCESSORS; Ember.USE_ACCESSORS = !!USE_ACCESSORS; var meta = Ember.meta; // .......................................................... // GET AND SET // // If we are on a platform that supports accessors we can get use those. // Otherwise simulate accessors by looking up the property directly on the // object. var get, set; /** @private */ get = function get(obj, keyName) { if (keyName === undefined && 'string' === typeof obj) { keyName = obj; obj = Ember; } if (!obj) return undefined; var ret = obj[keyName]; if (ret===undefined && 'function'===typeof obj.unknownProperty) { ret = obj.unknownProperty(keyName); } return ret; }; /** @private */ set = function set(obj, keyName, value) { if (('object'===typeof obj) && !(keyName in obj)) { if ('function' === typeof obj.setUnknownProperty) { obj.setUnknownProperty(keyName, value); } else if ('function' === typeof obj.unknownProperty) { obj.unknownProperty(keyName, value); } else obj[keyName] = value; } else { obj[keyName] = value; } return value; }; if (!USE_ACCESSORS) { var o_get = get, o_set = set; /** @private */ get = function(obj, keyName) { if (keyName === undefined && 'string' === typeof obj) { keyName = obj; obj = Ember; } if (!obj) return undefined; var desc = meta(obj, false).descs[keyName]; if (desc) return desc.get(obj, keyName); else return o_get(obj, keyName); }; /** @private */ set = function(obj, keyName, value) { var desc = meta(obj, false).descs[keyName]; if (desc) desc.set(obj, keyName, value); else o_set(obj, keyName, value); return value; }; } /** @function Gets the value of a property on an object. If the property is computed, the function will be invoked. If the property is not defined but the object implements the unknownProperty() method then that will be invoked. If you plan to run on IE8 and older browsers then you should use this method anytime you want to retrieve a property on an object that you don't know for sure is private. (My convention only properties beginning with an underscore '_' are considered private.) On all newer browsers, you only need to use this method to retrieve properties if the property might not be defined on the object and you want to respect the unknownProperty() handler. Otherwise you can ignore this method. Note that if the obj itself is null, this method will simply return undefined. @param {Object} obj The object to retrieve from. @param {String} keyName The property key to retrieve @returns {Object} the property value or null. */ Ember.get = get; /** @function Sets the value of a property on an object, respecting computed properties and notifying observers and other listeners of the change. If the property is not defined but the object implements the unknownProperty() method then that will be invoked as well. If you plan to run on IE8 and older browsers then you should use this method anytime you want to set a property on an object that you don't know for sure is private. (My convention only properties beginning with an underscore '_' are considered private.) On all newer browsers, you only need to use this method to set properties if the property might not be defined on the object and you want to respect the unknownProperty() handler. Otherwise you can ignore this method. @param {Object} obj The object to modify. @param {String} keyName The property key to set @param {Object} value The value to set @returns {Object} the passed value. */ Ember.set = set; // .......................................................... // PATHS // /** @private */ function cleanupStars(path) { if (path.indexOf('*') === -1 || path === '*') return path; return path.replace(/(^|.)\*/, function(match, char){ return (char === '.') ? match : (char + '.'); }); } /** @private */ function normalizePath(path) { path = cleanupStars(path); if (path==='*') return path; //special case... var first = path.charAt(0); if(first==='.') return 'this'+path; return path; } // assumes normalized input; no *, normalized path, always a target... /** @private */ function getPath(target, path) { var len = path.length, idx, next, key; path = cleanupStars(path); idx = 0; while(target && idx Ember if (root === null && path.indexOf('.') < 0) { return get(window, path); } // detect complicated paths and normalize them path = normalizePath(path); hasThis = HAS_THIS.test(path); if (!root || hasThis) { var tuple = normalizeTuple(root, path); root = tuple[0]; path = tuple[1]; tuple.length = 0; } return getPath(root, path); }; Ember.setPath = function(root, path, value, tolerant) { var keyName; if (arguments.length===2 && 'string' === typeof root) { value = path; path = root; root = null; } path = normalizePath(path); if (path.indexOf('.') > 0) { keyName = path.slice(path.lastIndexOf('.')+1); path = path.slice(0, path.length-(keyName.length+1)); if (path !== 'this') { root = Ember.getPath(root, path); } } else { if (IS_GLOBAL.test(path)) throw new Error('Invalid Path'); keyName = path; } if (!keyName || keyName.length===0 || keyName==='*') { throw new Error('Invalid Path'); } if (!root) { if (tolerant) { return; } else { throw new Error('Object in path '+path+' could not be found or was destroyed.'); } } return Ember.set(root, keyName, value); }; /** Error-tolerant form of Ember.setPath. Will not blow up if any part of the chain is undefined, null, or destroyed. This is primarily used when syncing bindings, which may try to update after an object has been destroyed. */ Ember.trySetPath = function(root, path, value) { if (arguments.length===2 && 'string' === typeof root) { value = path; path = root; root = null; } return Ember.setPath(root, path, value, true); }; /** Returns true if the provided path is global (e.g., "MyApp.fooController.bar") instead of local ("foo.bar.baz"). @param {String} path @returns Boolean */ Ember.isGlobalPath = function(path) { return !HAS_THIS.test(path) && IS_GLOBAL.test(path); }; })(); (function() { // ========================================================================== // Project: Ember Metal // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== var USE_ACCESSORS = Ember.USE_ACCESSORS; var GUID_KEY = Ember.GUID_KEY; var META_KEY = Ember.META_KEY; var meta = Ember.meta; var o_create = Ember.platform.create; var o_defineProperty = Ember.platform.defineProperty; var SIMPLE_PROPERTY, WATCHED_PROPERTY; // .......................................................... // DESCRIPTOR // var SIMPLE_DESC = { writable: true, configurable: true, enumerable: true, value: null }; /** @private @constructor Objects of this type can implement an interface to responds requests to get and set. The default implementation handles simple properties. You generally won't need to create or subclass this directly. */ var Dc = Ember.Descriptor = function() {}; var setup = Dc.setup = function(obj, keyName, value) { SIMPLE_DESC.value = value; o_defineProperty(obj, keyName, SIMPLE_DESC); SIMPLE_DESC.value = null; }; var Dp = Ember.Descriptor.prototype; /** Called whenever we want to set the property value. Should set the value and return the actual set value (which is usually the same but may be different in the case of computed properties.) @param {Object} obj The object to set the value on. @param {String} keyName The key to set. @param {Object} value The new value @returns {Object} value actual set value */ Dp.set = function(obj, keyName, value) { obj[keyName] = value; return value; }; /** Called whenever we want to get the property value. Should retrieve the current value. @param {Object} obj The object to get the value on. @param {String} keyName The key to retrieve @returns {Object} the current value */ Dp.get = function(obj, keyName) { return w_get(obj, keyName, obj); }; /** This is called on the descriptor to set it up on the object. The descriptor is responsible for actually defining the property on the object here. The passed `value` is the transferValue returned from any previous descriptor. @param {Object} obj The object to set the value on. @param {String} keyName The key to set. @param {Object} value The transfer value from any previous descriptor. @returns {void} */ Dp.setup = setup; /** This is called on the descriptor just before another descriptor takes its place. This method should at least return the 'transfer value' of the property - which is the value you want to passed as the input to the new descriptor's setup() method. It is not generally necessary to actually 'undefine' the property as a new property descriptor will redefine it immediately after this method returns. @param {Object} obj The object to set the value on. @param {String} keyName The key to set. @returns {Object} transfer value */ Dp.teardown = function(obj, keyName) { return obj[keyName]; }; Dp.val = function(obj, keyName) { return obj[keyName]; }; // .......................................................... // SIMPLE AND WATCHED PROPERTIES // // if accessors are disabled for the app then this will act as a guard when // testing on browsers that do support accessors. It will throw an exception // if you do foo.bar instead of Ember.get(foo, 'bar') // The exception to this is that any objects managed by Ember but not a descendant // of Ember.Object will not throw an exception, instead failing silently. This // prevent errors with other libraries that may attempt to access special // properties on standard objects like Array. Usually this happens when copying // an object by looping over all properties. if (!USE_ACCESSORS) { Ember.Descriptor.MUST_USE_GETTER = function() { if (this instanceof Ember.Object) { } }; Ember.Descriptor.MUST_USE_SETTER = function() { if (this instanceof Ember.Object) { if (this.isDestroyed) { } else { } } }; } var WATCHED_DESC = { configurable: true, enumerable: true, set: Ember.Descriptor.MUST_USE_SETTER }; /** @private */ function w_get(obj, keyName, values) { values = values || meta(obj, false).values; if (values) { var ret = values[keyName]; if (ret !== undefined) { return ret; } if (obj.unknownProperty) { return obj.unknownProperty(keyName); } } } /** @private */ function w_set(obj, keyName, value) { var m = meta(obj), watching; watching = m.watching[keyName]>0 && value!==m.values[keyName]; if (watching) Ember.propertyWillChange(obj, keyName); m.values[keyName] = value; if (watching) Ember.propertyDidChange(obj, keyName); return value; } var WATCHED_GETTERS = {}; /** @private */ function mkWatchedGetter(keyName) { var ret = WATCHED_GETTERS[keyName]; if (!ret) { ret = WATCHED_GETTERS[keyName] = function() { return w_get(this, keyName); }; } return ret; } var WATCHED_SETTERS = {}; /** @private */ function mkWatchedSetter(keyName) { var ret = WATCHED_SETTERS[keyName]; if (!ret) { ret = WATCHED_SETTERS[keyName] = function(value) { return w_set(this, keyName, value); }; } return ret; } /** @private Private version of simple property that invokes property change callbacks. */ WATCHED_PROPERTY = new Ember.Descriptor(); if (Ember.platform.hasPropertyAccessors) { WATCHED_PROPERTY.get = w_get ; WATCHED_PROPERTY.set = w_set ; if (USE_ACCESSORS) { WATCHED_PROPERTY.setup = function(obj, keyName, value) { WATCHED_DESC.get = mkWatchedGetter(keyName); WATCHED_DESC.set = mkWatchedSetter(keyName); o_defineProperty(obj, keyName, WATCHED_DESC); WATCHED_DESC.get = WATCHED_DESC.set = null; if (value !== undefined) meta(obj).values[keyName] = value; }; } else { WATCHED_PROPERTY.setup = function(obj, keyName, value) { WATCHED_DESC.get = mkWatchedGetter(keyName); o_defineProperty(obj, keyName, WATCHED_DESC); WATCHED_DESC.get = null; if (value !== undefined) meta(obj).values[keyName] = value; }; } WATCHED_PROPERTY.teardown = function(obj, keyName) { var ret = meta(obj).values[keyName]; delete meta(obj).values[keyName]; return ret; }; // NOTE: if platform does not have property accessors then we just have to // set values and hope for the best. You just won't get any warnings... } else { WATCHED_PROPERTY.set = function(obj, keyName, value) { var m = meta(obj), watching; watching = m.watching[keyName]>0 && value!==obj[keyName]; if (watching) Ember.propertyWillChange(obj, keyName); obj[keyName] = value; if (watching) Ember.propertyDidChange(obj, keyName); return value; }; } /** The default descriptor for simple properties. Pass as the third argument to Ember.defineProperty() along with a value to set a simple value. @static @default Ember.Descriptor */ Ember.SIMPLE_PROPERTY = new Ember.Descriptor(); SIMPLE_PROPERTY = Ember.SIMPLE_PROPERTY; SIMPLE_PROPERTY.unwatched = WATCHED_PROPERTY.unwatched = SIMPLE_PROPERTY; SIMPLE_PROPERTY.watched = WATCHED_PROPERTY.watched = WATCHED_PROPERTY; // .......................................................... // DEFINING PROPERTIES API // /** @private */ function hasDesc(descs, keyName) { if (keyName === 'toString') return 'function' !== typeof descs.toString; else return !!descs[keyName]; } /** @private NOTE: This is a low-level method used by other parts of the API. You almost never want to call this method directly. Instead you should use Ember.mixin() to define new properties. Defines a property on an object. This method works much like the ES5 Object.defineProperty() method except that it can also accept computed properties and other special descriptors. Normally this method takes only three parameters. However if you pass an instance of Ember.Descriptor as the third param then you can pass an optional value as the fourth parameter. This is often more efficient than creating new descriptor hashes for each property. ## Examples // ES5 compatible mode Ember.defineProperty(contact, 'firstName', { writable: true, configurable: false, enumerable: true, value: 'Charles' }); // define a simple property Ember.defineProperty(contact, 'lastName', Ember.SIMPLE_PROPERTY, 'Jolley'); // define a computed property Ember.defineProperty(contact, 'fullName', Ember.computed(function() { return this.firstName+' '+this.lastName; }).property('firstName', 'lastName').cacheable()); */ Ember.defineProperty = function(obj, keyName, desc, val) { var m = meta(obj, false), descs = m.descs, watching = m.watching[keyName]>0, override = true; if (val === undefined) { override = false; val = hasDesc(descs, keyName) ? descs[keyName].teardown(obj, keyName) : obj[keyName]; } else if (hasDesc(descs, keyName)) { descs[keyName].teardown(obj, keyName); } if (!desc) desc = SIMPLE_PROPERTY; if (desc instanceof Ember.Descriptor) { m = meta(obj, true); descs = m.descs; desc = (watching ? desc.watched : desc.unwatched) || desc; descs[keyName] = desc; desc.setup(obj, keyName, val, watching); // compatibility with ES5 } else { if (descs[keyName]) meta(obj).descs[keyName] = null; o_defineProperty(obj, keyName, desc); } // if key is being watched, override chains that // were initialized with the prototype if (override && watching) Ember.overrideChains(obj, keyName, m); return this; }; /** Creates a new object using the passed object as its prototype. On browsers that support it, this uses the built in Object.create method. Else one is simulated for you. This method is a better choice than Object.create() because it will make sure that any observers, event listeners, and computed properties are inherited from the parent as well. @param {Object} obj The object you want to have as the prototype. @returns {Object} the newly created object */ Ember.create = function(obj, props) { var ret = o_create(obj, props); if (GUID_KEY in ret) Ember.generateGuid(ret, 'ember'); if (META_KEY in ret) Ember.rewatch(ret); // setup watch chains if needed. return ret; }; /** @private Creates a new object using the passed object as its prototype. This method acts like `Ember.create()` in every way except that bindings, observers, and computed properties will be activated on the object. The purpose of this method is to build an object for use in a prototype chain. (i.e. to be set as the `prototype` property on a constructor function). Prototype objects need to inherit bindings, observers and other configuration so they pass it on to their children. However since they are never 'live' objects themselves, they should not fire or make other changes when various properties around them change. You should use this method anytime you want to create a new object for use in a prototype chain. @param {Object} obj The base object. @param {Object} hash Optional hash of properties to define on the object. @returns {Object} new object */ Ember.createPrototype = function(obj, props) { var ret = o_create(obj, props); meta(ret, true).proto = ret; if (GUID_KEY in ret) Ember.generateGuid(ret, 'ember'); if (META_KEY in ret) Ember.rewatch(ret); // setup watch chains if needed. return ret; }; })(); (function() { // ========================================================================== // Project: Ember Metal // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== var meta = Ember.meta; var guidFor = Ember.guidFor; var USE_ACCESSORS = Ember.USE_ACCESSORS; var a_slice = Array.prototype.slice; var o_create = Ember.platform.create; var o_defineProperty = Ember.platform.defineProperty; // .......................................................... // DEPENDENT KEYS // // data structure: // meta.deps = { // 'depKey': { // 'keyName': count, // __emberproto__: SRC_OBJ [to detect clones] // }, // __emberproto__: SRC_OBJ // } /** @private */ function uniqDeps(obj, depKey) { var m = meta(obj), deps, ret; deps = m.deps; if (!deps) { deps = m.deps = { __emberproto__: obj }; } else if (deps.__emberproto__ !== obj) { deps = m.deps = o_create(deps); deps.__emberproto__ = obj; } ret = deps[depKey]; if (!ret) { ret = deps[depKey] = { __emberproto__: obj }; } else if (ret.__emberproto__ !== obj) { ret = deps[depKey] = o_create(ret); ret.__emberproto__ = obj; } return ret; } /** @private */ function addDependentKey(obj, keyName, depKey) { var deps = uniqDeps(obj, depKey); deps[keyName] = (deps[keyName] || 0) + 1; Ember.watch(obj, depKey); } /** @private */ function removeDependentKey(obj, keyName, depKey) { var deps = uniqDeps(obj, depKey); deps[keyName] = (deps[keyName] || 0) - 1; Ember.unwatch(obj, depKey); } /** @private */ function addDependentKeys(desc, obj, keyName) { var keys = desc._dependentKeys, len = keys ? keys.length : 0; for(var idx=0;idx0, ret, oldSuspended, lastSetValues; oldSuspended = desc._suspended; desc._suspended = this; watched = watched && m.lastSetValues[keyName]!==guidFor(value); if (watched) { m.lastSetValues[keyName] = guidFor(value); Ember.propertyWillChange(this, keyName); } if (cacheable) delete m.cache[keyName]; ret = func.call(this, keyName, value); if (cacheable) m.cache[keyName] = ret; if (watched) Ember.propertyDidChange(this, keyName); desc._suspended = oldSuspended; return ret; }; } /** @extends Ember.ComputedProperty @private */ var Cp = ComputedProperty.prototype; /** Call on a computed property to set it into cacheable mode. When in this mode the computed property will automatically cache the return value of your function until one of the dependent keys changes. MyApp.president = Ember.Object.create({ fullName: function() { return this.get('firstName') + ' ' + this.get('lastName'); // After calculating the value of this function, Ember.js will // return that value without re-executing this function until // one of the dependent properties change. }.property('firstName', 'lastName').cacheable() }); Properties are cacheable by default. @name Ember.ComputedProperty.cacheable @param {Boolean} aFlag optional set to false to disable caching @returns {Ember.ComputedProperty} receiver */ Cp.cacheable = function(aFlag) { this._cacheable = aFlag!==false; return this; }; /** Call on a computed property to set it into non-cached mode. When in this mode the computed property will not automatically cache the return value. MyApp.outsideService = Ember.Object.create({ value: function() { return OutsideService.getValue(); }.property().volatile() }); @name Ember.ComputedProperty.volatile @returns {Ember.ComputedProperty} receiver */ Cp.volatile = function() { return this.cacheable(false); }; /** Sets the dependent keys on this computed property. Pass any number of arguments containing key paths that this computed property depends on. MyApp.president = Ember.Object.create({ fullName: Ember.computed(function() { return this.get('firstName') + ' ' + this.get('lastName'); // Tell Ember.js that this computed property depends on firstName // and lastName }).property('firstName', 'lastName') }); @name Ember.ComputedProperty.property @param {String} path... zero or more property paths @returns {Ember.ComputedProperty} receiver */ Cp.property = function() { this._dependentKeys = a_slice.call(arguments); return this; }; /** In some cases, you may want to annotate computed properties with additional metadata about how they function or what values they operate on. For example, computed property functions may close over variables that are then no longer available for introspection. You can pass a hash of these values to a computed property like this: person: function() { var personId = this.get('personId'); return App.Person.create({ id: personId }); }.property().meta({ type: App.Person }) The hash that you pass to the `meta()` function will be saved on the computed property descriptor under the `_meta` key. Ember runtime exposes a public API for retrieving these values from classes, via the `metaForProperty()` function. @name Ember.ComputedProperty.meta @param {Hash} metadata @returns {Ember.ComputedProperty} property descriptor instance */ Cp.meta = function(meta) { this._meta = meta; return this; }; /** @private - impl descriptor API */ Cp.setup = function(obj, keyName, value) { CP_DESC.get = mkCpGetter(keyName, this); CP_DESC.set = mkCpSetter(keyName, this); o_defineProperty(obj, keyName, CP_DESC); CP_DESC.get = CP_DESC.set = null; addDependentKeys(this, obj, keyName); }; /** @private - impl descriptor API */ Cp.teardown = function(obj, keyName) { var keys = this._dependentKeys, len = keys ? keys.length : 0; for(var idx=0;idx0, ret, oldSuspended, lastSetValues; oldSuspended = this._suspended; this._suspended = obj; watched = watched && m.lastSetValues[keyName]!==guidFor(value); if (watched) { m.lastSetValues[keyName] = guidFor(value); Ember.propertyWillChange(obj, keyName); } if (cacheable) delete m.cache[keyName]; ret = this.func.call(obj, keyName, value); if (cacheable) m.cache[keyName] = ret; if (watched) Ember.propertyDidChange(obj, keyName); this._suspended = oldSuspended; return ret; }; Cp.val = function(obj, keyName) { return meta(obj, false).values[keyName]; }; if (!Ember.platform.hasPropertyAccessors) { Cp.setup = function(obj, keyName, value) { obj[keyName] = undefined; // so it shows up in key iteration addDependentKeys(this, obj, keyName); }; } else if (!USE_ACCESSORS) { Cp.setup = function(obj, keyName) { // throw exception if not using Ember.get() and Ember.set() when supported o_defineProperty(obj, keyName, CP_DESC); addDependentKeys(this, obj, keyName); }; } /** This helper returns a new property descriptor that wraps the passed computed property function. You can use this helper to define properties with mixins or via Ember.defineProperty(). The function you pass will be used to both get and set property values. The function should accept two parameters, key and value. If value is not undefined you should set the value first. In either case return the current value of the property. @param {Function} func The computed property function. @returns {Ember.ComputedProperty} property descriptor instance */ Ember.computed = function(func) { var args; if (arguments.length > 1) { args = a_slice.call(arguments, 0, -1); func = a_slice.call(arguments, -1)[0]; } var cp = new ComputedProperty(func); if (args) { cp.property.apply(cp, args); } return cp; }; /** Returns the cached value for a property, if one exists. This can be useful for peeking at the value of a computed property that is generated lazily, without accidentally causing it to be created. @param {Object} obj the object whose property you want to check @param {String} key the name of the property whose cached value you want to return */ Ember.cacheFor = function(obj, key) { var cache = meta(obj, false).cache; if (cache && key in cache) { return cache[key]; } }; })(); (function() { /*jshint newcap:false*/ // NOTE: There is a bug in jshint that doesn't recognize `Object()` without `new` // as being ok unless both `newcap:false` and not `use strict`. // https://github.com/jshint/jshint/issues/392 // Testing this is not ideal, but we want ArrayUtils to use native functions // if available, but not to use versions created by libraries like Prototype /** @private */ var isNativeFunc = function(func) { // This should probably work in all browsers likely to have ES5 array methods return func && Function.prototype.toString.call(func).indexOf('[native code]') > -1; }; // From: https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/array/map /** @private */ var arrayMap = isNativeFunc(Array.prototype.map) ? Array.prototype.map : function(fun /*, thisp */) { //"use strict"; if (this === void 0 || this === null) { throw new TypeError(); } var t = Object(this); var len = t.length >>> 0; if (typeof fun !== "function") { throw new TypeError(); } var res = new Array(len); var thisp = arguments[1]; for (var i = 0; i < len; i++) { if (i in t) { res[i] = fun.call(thisp, t[i], i, t); } } return res; }; // From: https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/array/foreach /** @private */ var arrayForEach = isNativeFunc(Array.prototype.forEach) ? Array.prototype.forEach : function(fun /*, thisp */) { //"use strict"; if (this === void 0 || this === null) { throw new TypeError(); } var t = Object(this); var len = t.length >>> 0; if (typeof fun !== "function") { throw new TypeError(); } var thisp = arguments[1]; for (var i = 0; i < len; i++) { if (i in t) { fun.call(thisp, t[i], i, t); } } }; /** @private */ var arrayIndexOf = isNativeFunc(Array.prototype.indexOf) ? Array.prototype.indexOf : function (obj, fromIndex) { if (fromIndex === null || fromIndex === undefined) { fromIndex = 0; } else if (fromIndex < 0) { fromIndex = Math.max(0, this.length + fromIndex); } for (var i = fromIndex, j = this.length; i < j; i++) { if (this[i] === obj) { return i; } } return -1; }; Ember.ArrayUtils = { map: function(obj) { var args = Array.prototype.slice.call(arguments, 1); return obj.map ? obj.map.apply(obj, args) : arrayMap.apply(obj, args); }, forEach: function(obj) { var args = Array.prototype.slice.call(arguments, 1); return obj.forEach ? obj.forEach.apply(obj, args) : arrayForEach.apply(obj, args); }, indexOf: function(obj) { var args = Array.prototype.slice.call(arguments, 1); return obj.indexOf ? obj.indexOf.apply(obj, args) : arrayIndexOf.apply(obj, args); }, indexesOf: function(obj) { var args = Array.prototype.slice.call(arguments, 1); return args[0] === undefined ? [] : Ember.ArrayUtils.map(args[0], function(item) { return Ember.ArrayUtils.indexOf(obj, item); }); }, removeObject: function(array, item) { var index = this.indexOf(array, item); if (index !== -1) { array.splice(index, 1); } } }; if (Ember.SHIM_ES5) { if (!Array.prototype.map) { /** @private */ Array.prototype.map = arrayMap; } if (!Array.prototype.forEach) { /** @private */ Array.prototype.forEach = arrayForEach; } if (!Array.prototype.indexOf) { /** @private */ Array.prototype.indexOf = arrayIndexOf; } } })(); (function() { // ========================================================================== // Project: Ember Metal // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== var AFTER_OBSERVERS = ':change'; var BEFORE_OBSERVERS = ':before'; var guidFor = Ember.guidFor; var normalizePath = Ember.normalizePath; var deferred = 0; var array_Slice = Array.prototype.slice; var array_ForEach = Ember.ArrayUtils.forEach; /** @private */ var ObserverSet = function () { this.targetSet = {}; }; ObserverSet.prototype.add = function (target, path) { var targetSet = this.targetSet, targetGuid = Ember.guidFor(target), pathSet = targetSet[targetGuid]; if (!pathSet) { targetSet[targetGuid] = pathSet = {}; } if (pathSet[path]) { return false; } else { return pathSet[path] = true; } }; ObserverSet.prototype.clear = function () { this.targetSet = {}; }; /** @private */ var DeferredEventQueue = function() { this.targetSet = {}; this.queue = []; }; DeferredEventQueue.prototype.push = function(target, eventName) { var targetSet = this.targetSet, queue = this.queue, targetGuid = Ember.guidFor(target), eventNameSet = targetSet[targetGuid], index; if (!eventNameSet) { targetSet[targetGuid] = eventNameSet = {}; } index = eventNameSet[eventName]; if (index === undefined) { eventNameSet[eventName] = queue.push(Ember.deferEvent(target, eventName)) - 1; } else { queue[index] = Ember.deferEvent(target, eventName); } }; DeferredEventQueue.prototype.flush = function() { var queue = this.queue; this.queue = []; this.targetSet = {}; for (var i=0, len=queue.length; i < len; ++i) { queue[i](); } }; var queue = new DeferredEventQueue(), beforeObserverSet = new ObserverSet(); /** @private */ function notifyObservers(obj, eventName, forceNotification) { if (deferred && !forceNotification) { queue.push(obj, eventName); } else { Ember.sendEvent(obj, eventName); } } /** @private */ function flushObserverQueue() { beforeObserverSet.clear(); queue.flush(); } Ember.beginPropertyChanges = function() { deferred++; return this; }; Ember.endPropertyChanges = function() { deferred--; if (deferred<=0) flushObserverQueue(); }; /** Make a series of property changes together in an exception-safe way. Ember.changeProperties(function() { obj1.set('foo', mayBlowUpWhenSet); obj2.set('bar', baz); }); */ Ember.changeProperties = function(cb, binding){ Ember.beginPropertyChanges(); try { cb.call(binding); } finally { Ember.endPropertyChanges(); } }; /** Set a list of properties on an object. These properties are set inside a single `beginPropertyChanges` and `endPropertyChanges` batch, so observers will be buffered. */ Ember.setProperties = function(self, hash) { Ember.changeProperties(function(){ for(var prop in hash) { if (hash.hasOwnProperty(prop)) Ember.set(self, prop, hash[prop]); } }); return self; }; /** @private */ function changeEvent(keyName) { return keyName+AFTER_OBSERVERS; } /** @private */ function beforeEvent(keyName) { return keyName+BEFORE_OBSERVERS; } /** @private */ function changeKey(eventName) { return eventName.slice(0, -7); } /** @private */ function beforeKey(eventName) { return eventName.slice(0, -7); } /** @private */ function xformForArgs(args) { return function (target, method, params) { var obj = params[0], keyName = changeKey(params[1]), val; var copy_args = args.slice(); if (method.length>2) { val = Ember.getPath(Ember.isGlobalPath(keyName) ? window : obj, keyName); } copy_args.unshift(obj, keyName, val); method.apply(target, copy_args); }; } var xformChange = xformForArgs([]); /** @private */ function xformBefore(target, method, params) { var obj = params[0], keyName = beforeKey(params[1]), val; if (method.length>2) val = Ember.getPath(obj, keyName); method.call(target, obj, keyName, val); } Ember.addObserver = function(obj, path, target, method) { path = normalizePath(path); var xform; if (arguments.length > 4) { var args = array_Slice.call(arguments, 4); xform = xformForArgs(args); } else { xform = xformChange; } Ember.addListener(obj, changeEvent(path), target, method, xform); Ember.watch(obj, path); return this; }; /** @private */ Ember.observersFor = function(obj, path) { return Ember.listenersFor(obj, changeEvent(path)); }; Ember.removeObserver = function(obj, path, target, method) { path = normalizePath(path); Ember.unwatch(obj, path); Ember.removeListener(obj, changeEvent(path), target, method); return this; }; Ember.addBeforeObserver = function(obj, path, target, method) { path = normalizePath(path); Ember.addListener(obj, beforeEvent(path), target, method, xformBefore); Ember.watch(obj, path); return this; }; // Suspend observer during callback. // // This should only be used by the target of the observer // while it is setting the observed path. /** @private */ Ember._suspendObserver = function(obj, path, target, method, callback) { return Ember._suspendListener(obj, changeEvent(path), target, method, callback); }; /** @private */ Ember.beforeObserversFor = function(obj, path) { return Ember.listenersFor(obj, beforeEvent(path)); }; Ember.removeBeforeObserver = function(obj, path, target, method) { path = normalizePath(path); Ember.unwatch(obj, path); Ember.removeListener(obj, beforeEvent(path), target, method); return this; }; /** @private */ Ember.notifyObservers = function(obj, keyName) { if (obj.isDestroying) { return; } notifyObservers(obj, changeEvent(keyName)); }; /** @private */ Ember.notifyBeforeObservers = function(obj, keyName) { if (obj.isDestroying) { return; } var guid, set, forceNotification = false; if (deferred) { if (beforeObserverSet.add(obj, keyName)) { forceNotification = true; } else { return; } } notifyObservers(obj, beforeEvent(keyName), forceNotification); }; })(); (function() { // ========================================================================== // Project: Ember Metal // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== var guidFor = Ember.guidFor; var meta = Ember.meta; var get = Ember.get, set = Ember.set; var normalizeTuple = Ember.normalizeTuple.primitive; var normalizePath = Ember.normalizePath; var SIMPLE_PROPERTY = Ember.SIMPLE_PROPERTY; var GUID_KEY = Ember.GUID_KEY; var META_KEY = Ember.META_KEY; var notifyObservers = Ember.notifyObservers; var forEach = Ember.ArrayUtils.forEach; var FIRST_KEY = /^([^\.\*]+)/; var IS_PATH = /[\.\*]/; /** @private */ function firstKey(path) { return path.match(FIRST_KEY)[0]; } // returns true if the passed path is just a keyName /** @private */ function isKeyName(path) { return path==='*' || !IS_PATH.test(path); } // .......................................................... // DEPENDENT KEYS // var DEP_SKIP = { __emberproto__: true }; // skip some keys and toString /** @private */ function iterDeps(method, obj, depKey, seen, meta) { var guid = guidFor(obj); if (!seen[guid]) seen[guid] = {}; if (seen[guid][depKey]) return ; seen[guid][depKey] = true; var deps = meta.deps; deps = deps && deps[depKey]; if (deps) { for(var key in deps) { if (DEP_SKIP[key]) continue; method(obj, key); } } } var WILL_SEEN, DID_SEEN; // called whenever a property is about to change to clear the cache of any dependent keys (and notify those properties of changes, etc...) /** @private */ function dependentKeysWillChange(obj, depKey, meta) { if (obj.isDestroying) { return; } var seen = WILL_SEEN, top = !seen; if (top) seen = WILL_SEEN = {}; iterDeps(propertyWillChange, obj, depKey, seen, meta); if (top) WILL_SEEN = null; } // called whenever a property has just changed to update dependent keys /** @private */ function dependentKeysDidChange(obj, depKey, meta) { if (obj.isDestroying) { return; } var seen = DID_SEEN, top = !seen; if (top) seen = DID_SEEN = {}; iterDeps(propertyDidChange, obj, depKey, seen, meta); if (top) DID_SEEN = null; } // .......................................................... // CHAIN // /** @private */ function addChainWatcher(obj, keyName, node) { if (!obj || ('object' !== typeof obj)) return; // nothing to do var m = meta(obj); var nodes = m.chainWatchers; if (!nodes || nodes.__emberproto__ !== obj) { nodes = m.chainWatchers = { __emberproto__: obj }; } if (!nodes[keyName]) nodes[keyName] = {}; nodes[keyName][guidFor(node)] = node; Ember.watch(obj, keyName); } /** @private */ function removeChainWatcher(obj, keyName, node) { if (!obj || ('object' !== typeof obj)) return; // nothing to do var m = meta(obj, false); var nodes = m.chainWatchers; if (!nodes || nodes.__emberproto__ !== obj) return; //nothing to do if (nodes[keyName]) delete nodes[keyName][guidFor(node)]; Ember.unwatch(obj, keyName); } var pendingQueue = []; // attempts to add the pendingQueue chains again. If some of them end up // back in the queue and reschedule is true, schedules a timeout to try // again. /** @private */ function flushPendingChains() { if (pendingQueue.length===0) return ; // nothing to do var queue = pendingQueue; pendingQueue = []; forEach(queue, function(q) { q[0].add(q[1]); }); } /** @private */ function isProto(pvalue) { return meta(pvalue, false).proto === pvalue; } // A ChainNode watches a single key on an object. If you provide a starting // value for the key then the node won't actually watch it. For a root node // pass null for parent and key and object for value. /** @private */ var ChainNode = function(parent, key, value, separator) { var obj; this._parent = parent; this._key = key; // _watching is true when calling get(this._parent, this._key) will // return the value of this node. // // It is false for the root of a chain (because we have no parent) // and for global paths (because the parent node is the object with // the observer on it) this._watching = value===undefined; this._value = value; this._separator = separator || '.'; this._paths = {}; if (this._watching) { this._object = parent.value(); if (this._object) addChainWatcher(this._object, this._key, this); } // Special-case: the EachProxy relies on immediate evaluation to // establish its observers. // // TODO: Replace this with an efficient callback that the EachProxy // can implement. if (this._parent && this._parent._key === '@each') { this.value(); } }; var Wp = ChainNode.prototype; Wp.value = function() { if (this._value === undefined && this._watching){ var obj = this._parent.value(); this._value = (obj && !isProto(obj)) ? get(obj, this._key) : undefined; } return this._value; }; Wp.destroy = function() { if (this._watching) { var obj = this._object; if (obj) removeChainWatcher(obj, this._key, this); this._watching = false; // so future calls do nothing } }; // copies a top level object only Wp.copy = function(obj) { var ret = new ChainNode(null, null, obj, this._separator); var paths = this._paths, path; for(path in paths) { if (paths[path] <= 0) continue; // this check will also catch non-number vals. ret.add(path); } return ret; }; // called on the root node of a chain to setup watchers on the specified // path. Wp.add = function(path) { var obj, tuple, key, src, separator, paths; paths = this._paths; paths[path] = (paths[path] || 0) + 1 ; obj = this.value(); tuple = normalizeTuple(obj, path); // the path was a local path if (tuple[0] && (tuple[0] === obj)) { path = tuple[1]; key = firstKey(path); path = path.slice(key.length+1); // global path, but object does not exist yet. // put into a queue and try to connect later. } else if (!tuple[0]) { pendingQueue.push([this, path]); tuple.length = 0; return; // global path, and object already exists } else { src = tuple[0]; key = path.slice(0, 0-(tuple[1].length+1)); separator = path.slice(key.length, key.length+1); path = tuple[1]; } tuple.length = 0; this.chain(key, path, src, separator); }; // called on the root node of a chain to teardown watcher on the specified // path Wp.remove = function(path) { var obj, tuple, key, src, paths; paths = this._paths; if (paths[path] > 0) paths[path]--; obj = this.value(); tuple = normalizeTuple(obj, path); if (tuple[0] === obj) { path = tuple[1]; key = firstKey(path); path = path.slice(key.length+1); } else { src = tuple[0]; key = path.slice(0, 0-(tuple[1].length+1)); path = tuple[1]; } tuple.length = 0; this.unchain(key, path); }; Wp.count = 0; Wp.chain = function(key, path, src, separator) { var chains = this._chains, node; if (!chains) chains = this._chains = {}; node = chains[key]; if (!node) node = chains[key] = new ChainNode(this, key, src, separator); node.count++; // count chains... // chain rest of path if there is one if (path && path.length>0) { key = firstKey(path); path = path.slice(key.length+1); node.chain(key, path); // NOTE: no src means it will observe changes... } }; Wp.unchain = function(key, path) { var chains = this._chains, node = chains[key]; // unchain rest of path first... if (path && path.length>1) { key = firstKey(path); path = path.slice(key.length+1); node.unchain(key, path); } // delete node if needed. node.count--; if (node.count<=0) { delete chains[node._key]; node.destroy(); } }; Wp.willChange = function() { var chains = this._chains; if (chains) { for(var key in chains) { if (!chains.hasOwnProperty(key)) continue; chains[key].willChange(); } } if (this._parent) this._parent.chainWillChange(this, this._key, 1); }; Wp.chainWillChange = function(chain, path, depth) { if (this._key) path = this._key+this._separator+path; if (this._parent) { this._parent.chainWillChange(this, path, depth+1); } else { if (depth>1) Ember.propertyWillChange(this.value(), path); path = 'this.'+path; if (this._paths[path]>0) Ember.propertyWillChange(this.value(), path); } }; Wp.chainDidChange = function(chain, path, depth) { if (this._key) path = this._key+this._separator+path; if (this._parent) { this._parent.chainDidChange(this, path, depth+1); } else { if (depth>1) Ember.propertyDidChange(this.value(), path); path = 'this.'+path; if (this._paths[path]>0) Ember.propertyDidChange(this.value(), path); } }; Wp.didChange = function(suppressEvent) { // invalidate my own value first. if (this._watching) { var obj = this._parent.value(); if (obj !== this._object) { removeChainWatcher(this._object, this._key, this); this._object = obj; addChainWatcher(obj, this._key, this); } this._value = undefined; // Special-case: the EachProxy relies on immediate evaluation to // establish its observers. if (this._parent && this._parent._key === '@each') this.value(); } // then notify chains... var chains = this._chains; if (chains) { for(var key in chains) { if (!chains.hasOwnProperty(key)) continue; chains[key].didChange(suppressEvent); } } if (suppressEvent) return; // and finally tell parent about my path changing... if (this._parent) this._parent.chainDidChange(this, this._key, 1); }; // get the chains for the current object. If the current object has // chains inherited from the proto they will be cloned and reconfigured for // the current object. /** @private */ function chainsFor(obj) { var m = meta(obj), ret = m.chains; if (!ret) { ret = m.chains = new ChainNode(null, null, obj); } else if (ret.value() !== obj) { ret = m.chains = ret.copy(obj); } return ret ; } /** @private */ function notifyChains(obj, m, keyName, methodName, arg) { var nodes = m.chainWatchers; if (!nodes || nodes.__emberproto__ !== obj) return; // nothing to do nodes = nodes[keyName]; if (!nodes) return; for(var key in nodes) { if (!nodes.hasOwnProperty(key)) continue; nodes[key][methodName](arg); } } Ember.overrideChains = function(obj, keyName, m) { notifyChains(obj, m, keyName, 'didChange', true); }; /** @private */ function chainsWillChange(obj, keyName, m) { notifyChains(obj, m, keyName, 'willChange'); } /** @private */ function chainsDidChange(obj, keyName, m) { notifyChains(obj, m, keyName, 'didChange'); } // .......................................................... // WATCH // var WATCHED_PROPERTY = Ember.SIMPLE_PROPERTY.watched; /** @private Starts watching a property on an object. Whenever the property changes, invokes Ember.propertyWillChange and Ember.propertyDidChange. This is the primitive used by observers and dependent keys; usually you will never call this method directly but instead use higher level methods like Ember.addObserver(). */ Ember.watch = function(obj, keyName) { // can't watch length on Array - it is special... if (keyName === 'length' && Ember.typeOf(obj)==='array') return this; var m = meta(obj), watching = m.watching, desc; keyName = normalizePath(keyName); // activate watching first time if (!watching[keyName]) { watching[keyName] = 1; if (isKeyName(keyName)) { desc = m.descs[keyName]; desc = desc ? desc.watched : WATCHED_PROPERTY; if (desc) Ember.defineProperty(obj, keyName, desc); } else { chainsFor(obj).add(keyName); } } else { watching[keyName] = (watching[keyName]||0)+1; } return this; }; Ember.isWatching = function(obj, keyName) { return !!meta(obj).watching[keyName]; }; Ember.watch.flushPending = flushPendingChains; /** @private */ Ember.unwatch = function(obj, keyName) { // can't watch length on Array - it is special... if (keyName === 'length' && Ember.typeOf(obj)==='array') return this; var watching = meta(obj).watching, desc, descs; keyName = normalizePath(keyName); if (watching[keyName] === 1) { watching[keyName] = 0; if (isKeyName(keyName)) { desc = meta(obj).descs[keyName]; desc = desc ? desc.unwatched : SIMPLE_PROPERTY; if (desc) Ember.defineProperty(obj, keyName, desc); } else { chainsFor(obj).remove(keyName); } } else if (watching[keyName]>1) { watching[keyName]--; } return this; }; /** @private Call on an object when you first beget it from another object. This will setup any chained watchers on the object instance as needed. This method is safe to call multiple times. */ Ember.rewatch = function(obj) { var m = meta(obj, false), chains = m.chains, bindings = m.bindings, key, b; // make sure the object has its own guid. if (GUID_KEY in obj && !obj.hasOwnProperty(GUID_KEY)) { Ember.generateGuid(obj, 'ember'); } // make sure any chained watchers update. if (chains && chains.value() !== obj) chainsFor(obj); return this; }; // .......................................................... // PROPERTY CHANGES // /** This function is called just before an object property is about to change. It will notify any before observers and prepare caches among other things. Normally you will not need to call this method directly but if for some reason you can't directly watch a property you can invoke this method manually along with `Ember.propertyDidChange()` which you should call just after the property value changes. @memberOf Ember @param {Object} obj The object with the property that will change @param {String} keyName The property key (or path) that will change. @returns {void} */ function propertyWillChange(obj, keyName) { var m = meta(obj, false), proto = m.proto, desc = m.descs[keyName]; if (proto === obj) return ; if (desc && desc.willChange) desc.willChange(obj, keyName); dependentKeysWillChange(obj, keyName, m); chainsWillChange(obj, keyName, m); Ember.notifyBeforeObservers(obj, keyName); } Ember.propertyWillChange = propertyWillChange; /** This function is called just after an object property has changed. It will notify any observers and clear caches among other things. Normally you will not need to call this method directly but if for some reason you can't directly watch a property you can invoke this method manually along with `Ember.propertyWilLChange()` which you should call just before the property value changes. @memberOf Ember @param {Object} obj The object with the property that will change @param {String} keyName The property key (or path) that will change. @returns {void} */ function propertyDidChange(obj, keyName) { var m = meta(obj, false), proto = m.proto, desc = m.descs[keyName]; if (proto === obj) return ; if (desc && desc.didChange) desc.didChange(obj, keyName); dependentKeysDidChange(obj, keyName, m); chainsDidChange(obj, keyName, m); Ember.notifyObservers(obj, keyName); } Ember.propertyDidChange = propertyDidChange; var NODE_STACK = []; /** Tears down the meta on an object so that it can be garbage collected. Multiple calls will have no effect. @param {Object} obj the object to destroy @returns {void} */ Ember.destroy = function (obj) { var meta = obj[META_KEY], node, nodes, key, nodeObject; if (meta) { obj[META_KEY] = null; // remove chainWatchers to remove circular references that would prevent GC node = meta.chains; if (node) { NODE_STACK.push(node); // process tree while (NODE_STACK.length > 0) { node = NODE_STACK.pop(); // push children nodes = node._chains; if (nodes) { for (key in nodes) { if (nodes.hasOwnProperty(key)) { NODE_STACK.push(nodes[key]); } } } // remove chainWatcher in node object if (node._watching) { nodeObject = node._object; if (nodeObject) { removeChainWatcher(nodeObject, node._key, node); } } } } } }; })(); (function() { // ========================================================================== // Project: Ember Metal // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== var o_create = Ember.platform.create; var meta = Ember.meta; var guidFor = Ember.guidFor; var a_slice = Array.prototype.slice; /** The event system uses a series of nested hashes to store listeners on an object. When a listener is registered, or when an event arrives, these hashes are consulted to determine which target and action pair to invoke. The hashes are stored in the object's meta hash, and look like this: // Object's meta hash { listeners: { // variable name: `listenerSet` "foo:changed": { // variable name: `targetSet` [targetGuid]: { // variable name: `actionSet` [methodGuid]: { // variable name: `action` target: [Object object], method: [Function function], xform: [Function function] } } } } } */ /** @private */ var metaPath = Ember.metaPath; // Gets the set of all actions, keyed on the guid of each action's // method property. /** @private */ function actionSetFor(obj, eventName, target, writable) { var targetGuid = guidFor(target); return metaPath(obj, ['listeners', eventName, targetGuid], writable); } // Gets the set of all targets, keyed on the guid of each action's // target property. /** @private */ function targetSetFor(obj, eventName) { var listenerSet = meta(obj, false).listeners; if (!listenerSet) { return false; } return listenerSet[eventName] || false; } // TODO: This knowledge should really be a part of the // meta system. var SKIP_PROPERTIES = { __ember_source__: true }; /** @private */ function iterateSet(targetSet, callback, params) { if (!targetSet) { return false; } // Iterate through all elements of the target set for(var targetGuid in targetSet) { if (SKIP_PROPERTIES[targetGuid]) { continue; } var actionSet = targetSet[targetGuid]; if (actionSet) { // Iterate through the elements of the action set for(var methodGuid in actionSet) { if (SKIP_PROPERTIES[methodGuid]) { continue; } var action = actionSet[methodGuid]; if (action) { if (callback(action, params) === true) { return true; } } } } } return false; } /** @private */ function invokeAction(action, params) { var method = action.method, target = action.target, xform = action.xform; // If there is no target, the target is the object // on which the event was fired. if (!target) { target = params[0]; } if ('string' === typeof method) { method = target[method]; } // Listeners can provide an `xform` function, which can perform // arbitrary transformations, such as changing the order of // parameters. // // This is primarily used by ember-runtime's observer system, which // provides a higher level abstraction on top of events, including // dynamically looking up current values and passing them into the // registered listener. if (xform) { xform(target, method, params); } else { method.apply(target, params); } } /** The parameters passed to an event listener are not exactly the parameters passed to an observer. if you pass an xform function, it will be invoked and is able to translate event listener parameters into the form that observers are expecting. @memberOf Ember */ function addListener(obj, eventName, target, method, xform) { if (!method && 'function' === typeof target) { method = target; target = null; } var actionSet = actionSetFor(obj, eventName, target, true), methodGuid = guidFor(method); if (!actionSet[methodGuid]) { actionSet[methodGuid] = { target: target, method: method, xform: xform }; } else { actionSet[methodGuid].xform = xform; // used by observers etc to map params } if ('function' === typeof obj.didAddListener) { obj.didAddListener(eventName, target, method); } } /** @memberOf Ember */ function removeListener(obj, eventName, target, method) { if (!method && 'function'===typeof target) { method = target; target = null; } var actionSet = actionSetFor(obj, eventName, target, true), methodGuid = guidFor(method); // we can't simply delete this parameter, because if we do, we might // re-expose the property from the prototype chain. if (actionSet && actionSet[methodGuid]) { actionSet[methodGuid] = null; } if (obj && 'function'===typeof obj.didRemoveListener) { obj.didRemoveListener(eventName, target, method); } } // Suspend listener during callback. // // This should only be used by the target of the event listener // when it is taking an action that would cause the event, e.g. // an object might suspend its property change listener while it is // setting that property. /** @private */ function suspendListener(obj, eventName, target, method, callback) { if (!method && 'function' === typeof target) { method = target; target = null; } var actionSet = actionSetFor(obj, eventName, target, true), methodGuid = guidFor(method), action = actionSet && actionSet[methodGuid]; actionSet[methodGuid] = null; try { return callback.call(target); } finally { actionSet[methodGuid] = action; } } // returns a list of currently watched events /** @memberOf Ember */ function watchedEvents(obj) { var listeners = meta(obj, false).listeners, ret = []; if (listeners) { for(var eventName in listeners) { if (!SKIP_PROPERTIES[eventName] && listeners[eventName]) { ret.push(eventName); } } } return ret; } /** @memberOf Ember */ function sendEvent(obj, eventName) { // first give object a chance to handle it if (obj !== Ember && 'function' === typeof obj.sendEvent) { obj.sendEvent.apply(obj, a_slice.call(arguments, 1)); } var targetSet = targetSetFor(obj, eventName); iterateSet(targetSet, invokeAction, arguments); return true; } /** @memberOf Ember */ function deferEvent(obj, eventName) { var targetSet = targetSetFor(obj, eventName), actions = [], params = arguments; iterateSet(targetSet, function (action) { actions.push(action); }); return function() { if (obj !== Ember && 'function' === typeof obj.sendEvent) { obj.sendEvent.apply(obj, a_slice.call(params, 1)); } for (var i=0, len=actions.length; i < len; ++i) { invokeAction(actions[i], params); } }; } /** @memberOf Ember */ function hasListeners(obj, eventName) { var targetSet = targetSetFor(obj, eventName); if (iterateSet(targetSet, function () {return true;})) { return true; } // no listeners! might as well clean this up so it is faster later. var set = metaPath(obj, ['listeners'], true); set[eventName] = null; return false; } /** @memberOf Ember */ function listenersFor(obj, eventName) { var targetSet = targetSetFor(obj, eventName), ret = []; iterateSet(targetSet, function (action) { ret.push([action.target, action.method]); }); return ret; } Ember.addListener = addListener; Ember.removeListener = removeListener; Ember._suspendListener = suspendListener; Ember.sendEvent = sendEvent; Ember.hasListeners = hasListeners; Ember.watchedEvents = watchedEvents; Ember.listenersFor = listenersFor; Ember.deferEvent = deferEvent; })(); (function() { // ========================================================================== // Project: Ember Runtime // Copyright: ©2006-2011 Strobe Inc. and contributors. // Portions ©2008-2010 Apple Inc. All rights reserved. // License: Licensed under MIT license (see license.js) // ========================================================================== // Ember.Logger // Ember.watch.flushPending // Ember.beginPropertyChanges, Ember.endPropertyChanges // Ember.guidFor // Ember.ArrayUtils // .......................................................... // HELPERS // var slice = Array.prototype.slice; var forEach = Ember.ArrayUtils.forEach; // invokes passed params - normalizing so you can pass target/func, // target/string or just func /** @private */ function invoke(target, method, args, ignore) { if (method===undefined) { method = target; target = undefined; } if ('string'===typeof method) method = target[method]; if (args && ignore>0) { args = args.length>ignore ? slice.call(args, ignore) : null; } // Unfortunately in some browsers we lose the backtrace if we rethrow the existing error, // so in the event that we don't have an `onerror` handler we don't wrap in a try/catch if ('function' === typeof Ember.onerror) { try { // IE8's Function.prototype.apply doesn't accept undefined/null arguments. return method.apply(target || this, args || []); } catch (error) { Ember.onerror(error); } } else { // IE8's Function.prototype.apply doesn't accept undefined/null arguments. return method.apply(target || this, args || []); } } // .......................................................... // RUNLOOP // var timerMark; // used by timers... /** @private */ var K = function() {}; /** @private */ var RunLoop = function(prev) { var self; if (this instanceof RunLoop) { self = this; } else { self = new K(); } self._prev = prev || null; self.onceTimers = {}; return self; }; K.prototype = RunLoop.prototype; RunLoop.prototype = { end: function() { this.flush(); }, prev: function() { return this._prev; }, // .......................................................... // Delayed Actions // schedule: function(queueName, target, method) { var queues = this._queues, queue; if (!queues) queues = this._queues = {}; queue = queues[queueName]; if (!queue) queue = queues[queueName] = []; var args = arguments.length>3 ? slice.call(arguments, 3) : null; queue.push({ target: target, method: method, args: args }); return this; }, flush: function(queueName) { var queues = this._queues, queueNames, idx, len, queue, log; if (!queues) return this; // nothing to do function iter(item) { invoke(item.target, item.method, item.args); } Ember.watch.flushPending(); // make sure all chained watchers are setup if (queueName) { while (this._queues && (queue = this._queues[queueName])) { this._queues[queueName] = null; // the sync phase is to allow property changes to propagate. don't // invoke observers until that is finished. if (queueName === 'sync') { log = Ember.LOG_BINDINGS; if (log) Ember.Logger.log('Begin: Flush Sync Queue'); Ember.beginPropertyChanges(); try { forEach(queue, iter); } finally { Ember.endPropertyChanges(); } if (log) Ember.Logger.log('End: Flush Sync Queue'); } else { forEach(queue, iter); } } } else { queueNames = Ember.run.queues; len = queueNames.length; do { this._queues = null; for(idx=0;idx= timer.expires) { delete timers[key]; invoke(timer.target, timer.method, timer.args, 2); } else { if (earliest<0 || (timer.expires < earliest)) earliest=timer.expires; } } } // schedule next timeout to fire... if (earliest>0) setTimeout(invokeLaterTimers, earliest-(+ new Date())); } /** Invokes the passed target/method and optional arguments after a specified period if time. The last parameter of this method must always be a number of milliseconds. You should use this method whenever you need to run some action after a period of time instead of using setTimeout(). This method will ensure that items that expire during the same script execution cycle all execute together, which is often more efficient than using a real setTimeout. Ember.run.later(myContext, function(){ // code here will execute within a RunLoop in about 500ms with this == myContext }, 500); @param {Object} target (optional) target of method to invoke @param {Function|String} method The method to invoke. If you pass a string it will be resolved on the target at the time the method is invoked. @param {Object...} args Optional arguments to pass to the timeout. @param {Number} wait Number of milliseconds to wait. @returns {Timer} an object you can use to cancel a timer at a later time. */ Ember.run.later = function(target, method) { var args, expires, timer, guid, wait; // setTimeout compatibility... if (arguments.length===2 && 'function' === typeof target) { wait = method; method = target; target = undefined; args = [target, method]; } else { args = slice.call(arguments); wait = args.pop(); } expires = (+ new Date())+wait; timer = { target: target, method: method, expires: expires, args: args }; guid = Ember.guidFor(timer); timers[guid] = timer; run.once(timers, invokeLaterTimers); return guid; }; /** @private */ function invokeOnceTimer(guid, onceTimers) { if (onceTimers[this.tguid]) delete onceTimers[this.tguid][this.mguid]; if (timers[guid]) invoke(this.target, this.method, this.args, 2); delete timers[guid]; } /** Schedules an item to run one time during the current RunLoop. Calling this method with the same target/method combination will have no effect. Note that although you can pass optional arguments these will not be considered when looking for duplicates. New arguments will replace previous calls. Ember.run(function(){ var doFoo = function() { foo(); } Ember.run.once(myContext, doFoo); Ember.run.once(myContext, doFoo); // doFoo will only be executed once at the end of the RunLoop }); @param {Object} target (optional) target of method to invoke @param {Function|String} method The method to invoke. If you pass a string it will be resolved on the target at the time the method is invoked. @param {Object...} args Optional arguments to pass to the timeout. @returns {Object} timer */ Ember.run.once = function(target, method) { var tguid = Ember.guidFor(target), mguid = Ember.guidFor(method), guid, timer; var onceTimers = run.autorun().onceTimers; guid = onceTimers[tguid] && onceTimers[tguid][mguid]; if (guid && timers[guid]) { timers[guid].args = slice.call(arguments); // replace args } else { timer = { target: target, method: method, args: slice.call(arguments), tguid: tguid, mguid: mguid }; guid = Ember.guidFor(timer); timers[guid] = timer; if (!onceTimers[tguid]) onceTimers[tguid] = {}; onceTimers[tguid][mguid] = guid; // so it isn't scheduled more than once run.schedule('actions', timer, invokeOnceTimer, guid, onceTimers); } return guid; }; var scheduledNext = false; /** @private */ function invokeNextTimers() { scheduledNext = null; for(var key in timers) { if (!timers.hasOwnProperty(key)) continue; var timer = timers[key]; if (timer.next) { delete timers[key]; invoke(timer.target, timer.method, timer.args, 2); } } } /** Schedules an item to run after control has been returned to the system. This is often equivalent to calling setTimeout(function...,1). Ember.run.next(myContext, function(){ // code to be executed in the next RunLoop, which will be scheduled after the current one }); @param {Object} target (optional) target of method to invoke @param {Function|String} method The method to invoke. If you pass a string it will be resolved on the target at the time the method is invoked. @param {Object...} args Optional arguments to pass to the timeout. @returns {Object} timer */ Ember.run.next = function(target, method) { var timer, guid; timer = { target: target, method: method, args: slice.call(arguments), next: true }; guid = Ember.guidFor(timer); timers[guid] = timer; if (!scheduledNext) scheduledNext = setTimeout(invokeNextTimers, 1); return guid; }; /** Cancels a scheduled item. Must be a value returned by `Ember.run.later()`, `Ember.run.once()`, or `Ember.run.next()`. var runNext = Ember.run.next(myContext, function(){ // will not be executed }); Ember.run.cancel(runNext); var runLater = Ember.run.next(myContext, function(){ // will not be executed }, 500); Ember.run.cancel(runLater); var runOnce = Ember.run.once(myContext, function(){ // will not be executed }); Ember.run.cancel(runOnce); @param {Object} timer Timer object to cancel @returns {void} */ Ember.run.cancel = function(timer) { delete timers[timer]; }; })(); (function() { // ========================================================================== // Project: Ember Runtime // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== // Ember.Logger // get, getPath, setPath, trySetPath // guidFor, isArray, meta // addObserver, removeObserver // Ember.run.schedule // .......................................................... // CONSTANTS // /** @static Debug parameter you can turn on. This will log all bindings that fire to the console. This should be disabled in production code. Note that you can also enable this from the console or temporarily. @type Boolean @default false */ Ember.LOG_BINDINGS = false || !!Ember.ENV.LOG_BINDINGS; /** @static Performance paramter. This will benchmark the time spent firing each binding. @type Boolean */ Ember.BENCHMARK_BINDING_NOTIFICATIONS = !!Ember.ENV.BENCHMARK_BINDING_NOTIFICATIONS; /** @static Performance parameter. This will benchmark the time spend configuring each binding. @type Boolean */ Ember.BENCHMARK_BINDING_SETUP = !!Ember.ENV.BENCHMARK_BINDING_SETUP; /** @static Default placeholder for multiple values in bindings. @type String @default '@@MULT@@' */ Ember.MULTIPLE_PLACEHOLDER = '@@MULT@@'; /** @static Default placeholder for empty values in bindings. Used by notEmpty() helper unless you specify an alternative. @type String @default '@@EMPTY@@' */ Ember.EMPTY_PLACEHOLDER = '@@EMPTY@@'; // .......................................................... // TYPE COERCION HELPERS // // Coerces a non-array value into an array. /** @private */ function MULTIPLE(val) { if (val instanceof Array) return val; if (val === undefined || val === null) return []; return [val]; } // Treats a single-element array as the element. Otherwise // returns a placeholder. /** @private */ function SINGLE(val, placeholder) { if (val instanceof Array) { if (val.length>1) return placeholder; else return val[0]; } return val; } // Coerces the binding value into a Boolean. var BOOL = { to: function (val) { return !!val; } }; // Returns the Boolean inverse of the value. var NOT = { to: function NOT(val) { return !val; } }; var get = Ember.get, getPath = Ember.getPath, setPath = Ember.setPath, guidFor = Ember.guidFor, isGlobalPath = Ember.isGlobalPath; // Applies a binding's transformations against a value. /** @private */ function getTransformedValue(binding, val, obj, dir) { // First run a type transform, if it exists, that changes the fundamental // type of the value. For example, some transforms convert an array to a // single object. var typeTransform = binding._typeTransform; if (typeTransform) { val = typeTransform(val, binding._placeholder); } // handle transforms var transforms = binding._transforms, len = transforms ? transforms.length : 0, idx; for(idx=0;idx null - [a] => a - [a,b,c] => Multiple Placeholder You can pass in an optional multiple placeholder or it will use the default. Note that this transform will only happen on forwarded valued. Reverse values are send unchanged. @param {String} fromPath from path or null @param {Object} [placeholder] Placeholder value. @returns {Ember.Binding} this */ single: function(placeholder) { if (placeholder===undefined) placeholder = Ember.MULTIPLE_PLACEHOLDER; this._typeTransform = SINGLE; this._placeholder = placeholder; return this; }, /** Adds a transform that will convert the passed value to an array. If the value is null or undefined, it will be converted to an empty array. @param {String} [fromPath] @returns {Ember.Binding} this */ multiple: function() { this._typeTransform = MULTIPLE; this._placeholder = null; return this; }, /** Adds a transform to convert the value to a bool value. If the value is an array it will return true if array is not empty. If the value is a string it will return true if the string is not empty. @returns {Ember.Binding} this */ bool: function() { this.transform(BOOL); return this; }, /** Adds a transform that will return the placeholder value if the value is null, undefined, an empty array or an empty string. See also notNull(). @param {Object} [placeholder] Placeholder value. @returns {Ember.Binding} this */ notEmpty: function(placeholder) { if (placeholder === null || placeholder === undefined) { placeholder = Ember.EMPTY_PLACEHOLDER; } this.transform({ to: function(val) { return empty(val) ? placeholder : val; } }); return this; }, /** Adds a transform that will return the placeholder value if the value is null or undefined. Otherwise it will passthrough untouched. See also notEmpty(). @param {String} fromPath from path or null @param {Object} [placeholder] Placeholder value. @returns {Ember.Binding} this */ notNull: function(placeholder) { if (placeholder === null || placeholder === undefined) { placeholder = Ember.EMPTY_PLACEHOLDER; } this.transform({ to: function(val) { return (val === null || val === undefined) ? placeholder : val; } }); return this; }, /** Adds a transform to convert the value to the inverse of a bool value. This uses the same transform as bool() but inverts it. @returns {Ember.Binding} this */ not: function() { this.transform(NOT); return this; }, /** Adds a transform that will return true if the value is null or undefined, false otherwise. @returns {Ember.Binding} this */ isNull: function() { this.transform(function(val) { return val === null || val === undefined; }); return this; }, /** @private */ toString: function() { var oneWay = this._oneWay ? '[oneWay]' : ''; return "Ember.Binding<" + guidFor(this) + ">(" + this._from + " -> " + this._to + ")" + oneWay; }, // .......................................................... // CONNECT AND SYNC // /** Attempts to connect this binding instance so that it can receive and relay changes. This method will raise an exception if you have not set the from/to properties yet. @param {Object} obj The root object for this binding. @param {Boolean} preferFromParam private: Normally, `connect` cannot take an object if `from` already set an object. Internally, we would like to be able to provide a default object to be used if no object was provided via `from`, so this parameter turns off the assertion. @returns {Ember.Binding} this */ connect: function(obj) { var oneWay = this._oneWay, operand = this._operand; // add an observer on the object to be notified when the binding should be updated Ember.addObserver(obj, this._from, this, this.fromDidChange); // if there is an operand, add an observer onto it as well if (operand) { Ember.addObserver(obj, operand, this, this.fromDidChange); } // if the binding is a two-way binding, also set up an observer on the target // object. if (!oneWay) { Ember.addObserver(obj, this._to, this, this.toDidChange); } if (Ember.meta(obj,false).proto !== obj) { this._scheduleSync(obj, 'fwd'); } this._readyToSync = true; return this; }, /** Disconnects the binding instance. Changes will no longer be relayed. You will not usually need to call this method. @param {Object} obj The root object you passed when connecting the binding. @returns {Ember.Binding} this */ disconnect: function(obj) { var oneWay = this._oneWay, operand = this._operand; // remove an observer on the object so we're no longer notified of // changes that should update bindings. Ember.removeObserver(obj, this._from, this, this.fromDidChange); // if there is an operand, remove the observer from it as well if (operand) Ember.removeObserver(obj, operand, this, this.fromDidChange); // if the binding is two-way, remove the observer from the target as well if (!oneWay) Ember.removeObserver(obj, this._to, this, this.toDidChange); this._readyToSync = false; // disable scheduled syncs... return this; }, // .......................................................... // PRIVATE // /** @private - called when the from side changes */ fromDidChange: function(target) { this._scheduleSync(target, 'fwd'); }, /** @private - called when the to side changes */ toDidChange: function(target) { this._scheduleSync(target, 'back'); }, /** @private */ _scheduleSync: function(obj, dir) { var guid = guidFor(obj), existingDir = this[guid]; // if we haven't scheduled the binding yet, schedule it if (!existingDir) { Ember.run.schedule('sync', this, this._sync, obj); this[guid] = dir; } // If both a 'back' and 'fwd' sync have been scheduled on the same object, // default to a 'fwd' sync so that it remains deterministic. if (existingDir === 'back' && dir === 'fwd') { this[guid] = 'fwd'; } }, /** @private */ _sync: function(obj) { var log = Ember.LOG_BINDINGS; // don't synchronize destroyed objects or disconnected bindings if (obj.isDestroyed || !this._readyToSync) { return; } // get the direction of the binding for the object we are // synchronizing from var guid = guidFor(obj), direction = this[guid]; var fromPath = this._from, toPath = this._to; delete this[guid]; // if we're synchronizing from the remote object... if (direction === 'fwd') { var fromValue = getTransformedFromValue(obj, this); if (log) { Ember.Logger.log(' ', this.toString(), '->', fromValue, obj); } if (this._oneWay) { Ember.trySetPath(Ember.isGlobalPath(toPath) ? window : obj, toPath, fromValue); } else { Ember._suspendObserver(obj, toPath, this, this.toDidChange, function () { Ember.trySetPath(Ember.isGlobalPath(toPath) ? window : obj, toPath, fromValue); }); } // if we're synchronizing *to* the remote object } else if (direction === 'back') {// && !this._oneWay) { var toValue = getTransformedToValue(obj, this); if (log) { Ember.Logger.log(' ', this.toString(), '<-', toValue, obj); } Ember._suspendObserver(obj, fromPath, this, this.fromDidChange, function () { Ember.trySetPath(Ember.isGlobalPath(fromPath) ? window : obj, fromPath, toValue); }); } } }; /** @private */ function mixinProperties(to, from) { for (var key in from) { if (from.hasOwnProperty(key)) { to[key] = from[key]; } } } mixinProperties(Binding, /** @scope Ember.Binding */ { /** @see Ember.Binding.prototype.from */ from: function() { var C = this, binding = new C(); return binding.from.apply(binding, arguments); }, /** @see Ember.Binding.prototype.to */ to: function() { var C = this, binding = new C(); return binding.to.apply(binding, arguments); }, /** @see Ember.Binding.prototype.oneWay */ oneWay: function(from, flag) { var C = this, binding = new C(null, from); return binding.oneWay(flag); }, /** @see Ember.Binding.prototype.single */ single: function(from, placeholder) { var C = this, binding = new C(null, from); return binding.single(placeholder); }, /** @see Ember.Binding.prototype.multiple */ multiple: function(from) { var C = this, binding = new C(null, from); return binding.multiple(); }, /** @see Ember.Binding.prototype.transform */ transform: function(from, func) { if (!func) { func = from; from = null; } var C = this, binding = new C(null, from); return binding.transform(func); }, /** @see Ember.Binding.prototype.notEmpty */ notEmpty: function(from, placeholder) { var C = this, binding = new C(null, from); return binding.notEmpty(placeholder); }, /** @see Ember.Binding.prototype.notNull */ notNull: function(from, placeholder) { var C = this, binding = new C(null, from); return binding.notNull(placeholder); }, /** @see Ember.Binding.prototype.bool */ bool: function(from) { var C = this, binding = new C(null, from); return binding.bool(); }, /** @see Ember.Binding.prototype.not */ not: function(from) { var C = this, binding = new C(null, from); return binding.not(); }, /** @see Ember.Binding.prototype.isNull */ isNull: function(from) { var C = this, binding = new C(null, from); return binding.isNull(); }, /** Adds a transform that forwards the logical 'AND' of values at 'pathA' and 'pathB' whenever either source changes. Note that the transform acts strictly as a one-way binding, working only in the direction 'pathA' AND 'pathB' --> value (value returned is the result of ('pathA' && 'pathB')) Usage example where a delete button's `isEnabled` value is determined by whether something is selected in a list and whether the current user is allowed to delete: deleteButton: Ember.ButtonView.design({ isEnabledBinding: Ember.Binding.and('MyApp.itemsController.hasSelection', 'MyApp.userController.canDelete') }) @param {String} pathA The first part of the conditional @param {String} pathB The second part of the conditional */ and: function(pathA, pathB) { var C = this, binding = new C(null, pathA).oneWay(); binding._operand = pathB; binding._operation = AND_OPERATION; return binding; }, /** Adds a transform that forwards the 'OR' of values at 'pathA' and 'pathB' whenever either source changes. Note that the transform acts strictly as a one-way binding, working only in the direction 'pathA' AND 'pathB' --> value (value returned is the result of ('pathA' || 'pathB')) @param {String} pathA The first part of the conditional @param {String} pathB The second part of the conditional */ or: function(pathA, pathB) { var C = this, binding = new C(null, pathA).oneWay(); binding._operand = pathB; binding._operation = OR_OPERATION; return binding; }, /** Registers a custom transform for use in bindings. @param {String} name The name of the transform @param {Function} transform The transformation function */ registerTransform: function(name, transform) { this.prototype[name] = transform; this[name] = function(from) { var C = this, binding = new C(null, from), args; args = Array.prototype.slice.call(arguments, 1); return binding[name].apply(binding, args); }; } }); /** @class A binding simply connects the properties of two objects so that whenever the value of one property changes, the other property will be changed also. You do not usually work with Binding objects directly but instead describe bindings in your class definition using something like: valueBinding: "MyApp.someController.title" This will create a binding from `MyApp.someController.title` to the `value` property of your object instance automatically. Now the two values will be kept in sync. ## Customizing Your Bindings In addition to synchronizing values, bindings can also perform some basic transforms on values. These transforms can help to make sure the data fed into one object always meets the expectations of that object regardless of what the other object outputs. To customize a binding, you can use one of the many helper methods defined on Ember.Binding like so: valueBinding: Ember.Binding.single("MyApp.someController.title") This will create a binding just like the example above, except that now the binding will convert the value of `MyApp.someController.title` to a single object (removing any arrays) before applying it to the `value` property of your object. You can also chain helper methods to build custom bindings like so: valueBinding: Ember.Binding.single("MyApp.someController.title").notEmpty("(EMPTY)") This will force the value of MyApp.someController.title to be a single value and then check to see if the value is "empty" (null, undefined, empty array, or an empty string). If it is empty, the value will be set to the string "(EMPTY)". ## One Way Bindings One especially useful binding customization you can use is the `oneWay()` helper. This helper tells Ember that you are only interested in receiving changes on the object you are binding from. For example, if you are binding to a preference and you want to be notified if the preference has changed, but your object will not be changing the preference itself, you could do: bigTitlesBinding: Ember.Binding.oneWay("MyApp.preferencesController.bigTitles") This way if the value of MyApp.preferencesController.bigTitles changes the "bigTitles" property of your object will change also. However, if you change the value of your "bigTitles" property, it will not update the preferencesController. One way bindings are almost twice as fast to setup and twice as fast to execute because the binding only has to worry about changes to one side. You should consider using one way bindings anytime you have an object that may be created frequently and you do not intend to change a property; only to monitor it for changes. (such as in the example above). ## Adding Custom Transforms In addition to using the standard helpers provided by Ember, you can also defined your own custom transform functions which will be used to convert the value. To do this, just define your transform function and add it to the binding with the transform() helper. The following example will not allow Integers less than ten. Note that it checks the value of the bindings and allows all other values to pass: valueBinding: Ember.Binding.transform(function(value, binding) { return ((Ember.typeOf(value) === 'number') && (value < 10)) ? 10 : value; }).from("MyApp.someController.value") If you would like to instead use this transform on a number of bindings, you can also optionally add your own helper method to Ember.Binding. This method should simply return the value of `this.transform()`. The example below adds a new helper called `notLessThan()` which will limit the value to be not less than the passed minimum: Ember.Binding.registerTransform('notLessThan', function(minValue) { return this.transform(function(value, binding) { return ((Ember.typeOf(value) === 'number') && (value < minValue)) ? minValue : value; }); }); You could specify this in your core.js file, for example. Then anywhere in your application you can use it to define bindings like so: valueBinding: Ember.Binding.from("MyApp.someController.value").notLessThan(10) Also, remember that helpers are chained so you can use your helper along with any other helpers. The example below will create a one way binding that does not allow empty values or values less than 10: valueBinding: Ember.Binding.oneWay("MyApp.someController.value").notEmpty().notLessThan(10) Finally, it's also possible to specify bi-directional transforms. To do this, you can pass a hash to `transform` with `to` and `from`. In the following example, we are expecting a lowercase string that we want to transform to uppercase. valueBinding: Ember.Binding.transform({ to: function(value, binding) { return value.toUpperCase(); }, from: function(value, binding) { return value.toLowerCase(); } ## How to Manually Adding Binding All of the examples above show you how to configure a custom binding, but the result of these customizations will be a binding template, not a fully active binding. The binding will actually become active only when you instantiate the object the binding belongs to. It is useful however, to understand what actually happens when the binding is activated. For a binding to function it must have at least a "from" property and a "to" property. The from property path points to the object/key that you want to bind from while the to path points to the object/key you want to bind to. When you define a custom binding, you are usually describing the property you want to bind from (such as "MyApp.someController.value" in the examples above). When your object is created, it will automatically assign the value you want to bind "to" based on the name of your binding key. In the examples above, during init, Ember objects will effectively call something like this on your binding: binding = Ember.Binding.from(this.valueBinding).to("value"); This creates a new binding instance based on the template you provide, and sets the to path to the "value" property of the new object. Now that the binding is fully configured with a "from" and a "to", it simply needs to be connected to become active. This is done through the connect() method: binding.connect(this); Note that when you connect a binding you pass the object you want it to be connected to. This object will be used as the root for both the from and to side of the binding when inspecting relative paths. This allows the binding to be automatically inherited by subclassed objects as well. Now that the binding is connected, it will observe both the from and to side and relay changes. If you ever needed to do so (you almost never will, but it is useful to understand this anyway), you could manually create an active binding by using the Ember.bind() helper method. (This is the same method used by to setup your bindings on objects): Ember.bind(MyApp.anotherObject, "value", "MyApp.someController.value"); Both of these code fragments have the same effect as doing the most friendly form of binding creation like so: MyApp.anotherObject = Ember.Object.create({ valueBinding: "MyApp.someController.value", // OTHER CODE FOR THIS OBJECT... }); Ember's built in binding creation method makes it easy to automatically create bindings for you. You should always use the highest-level APIs available, even if you understand how it works underneath. @since Ember 0.9 */ Ember.Binding = Binding; /** Global helper method to create a new binding. Just pass the root object along with a to and from path to create and connect the binding. The new binding object will be returned which you can further configure with transforms and other conditions. @param {Object} obj The root object of the transform. @param {String} to The path to the 'to' side of the binding. Must be relative to obj. @param {String} from The path to the 'from' side of the binding. Must be relative to obj or a global path. @returns {Ember.Binding} binding instance */ Ember.bind = function(obj, to, from) { return new Ember.Binding(to, from).connect(obj); }; Ember.oneWay = function(obj, to, from) { return new Ember.Binding(to, from).oneWay().connect(obj); }; })(); (function() { // ========================================================================== // Project: Ember Runtime // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== var Mixin, MixinDelegate, REQUIRED, Alias; var classToString, superClassString; var a_map = Ember.ArrayUtils.map; var a_indexOf = Ember.ArrayUtils.indexOf; var a_forEach = Ember.ArrayUtils.forEach; var a_slice = Array.prototype.slice; var EMPTY_META = {}; // dummy for non-writable meta var META_SKIP = { __emberproto__: true, __ember_count__: true }; var o_create = Ember.platform.create; /** @private */ function meta(obj, writable) { var m = Ember.meta(obj, writable!==false), ret = m.mixins; if (writable===false) return ret || EMPTY_META; if (!ret) { ret = m.mixins = { __emberproto__: obj }; } else if (ret.__emberproto__ !== obj) { ret = m.mixins = o_create(ret); ret.__emberproto__ = obj; } return ret; } /** @private */ function initMixin(mixin, args) { if (args && args.length > 0) { mixin.mixins = a_map(args, function(x) { if (x instanceof Mixin) return x; // Note: Manually setup a primitive mixin here. This is the only // way to actually get a primitive mixin. This way normal creation // of mixins will give you combined mixins... var mixin = new Mixin(); mixin.properties = x; return mixin; }); } return mixin; } var NATIVES = [Boolean, Object, Number, Array, Date, String]; /** @private */ function isMethod(obj) { if ('function' !== typeof obj || obj.isMethod===false) return false; return a_indexOf(NATIVES, obj)<0; } /** @private */ function mergeMixins(mixins, m, descs, values, base) { var len = mixins.length, idx, mixin, guid, props, value, key, ovalue, concats; /** @private */ function removeKeys(keyName) { delete descs[keyName]; delete values[keyName]; } for(idx=0;idx=0) || key === 'concatenatedProperties') { var baseValue = values[key] || base[key]; value = baseValue ? baseValue.concat(value) : Ember.makeArray(value); } descs[key] = Ember.SIMPLE_PROPERTY; values[key] = value; } } // manually copy toString() because some JS engines do not enumerate it if (props.hasOwnProperty('toString')) { base.toString = props.toString; } } else if (mixin.mixins) { mergeMixins(mixin.mixins, m, descs, values, base); if (mixin._without) a_forEach(mixin._without, removeKeys); } } } /** @private */ var defineProperty = Ember.defineProperty; /** @private */ function writableReq(obj) { var m = Ember.meta(obj), req = m.required; if (!req || (req.__emberproto__ !== obj)) { req = m.required = req ? o_create(req) : { __ember_count__: 0 }; req.__emberproto__ = obj; } return req; } /** @private */ function getObserverPaths(value) { return ('function' === typeof value) && value.__ember_observes__; } /** @private */ function getBeforeObserverPaths(value) { return ('function' === typeof value) && value.__ember_observesBefore__; } var IS_BINDING = Ember.IS_BINDING = /^.+Binding$/; function detectBinding(obj, key, m) { if (IS_BINDING.test(key)) { var bindings = m.bindings; if (!bindings) { bindings = m.bindings = { __emberproto__: obj }; } else if (bindings.__emberproto__ !== obj) { bindings = m.bindings = o_create(m.bindings); bindings.__emberproto__ = obj; } bindings[key] = true; } } function connectBindings(obj, m) { if (m === undefined) { m = Ember.meta(obj); } var bindings = m.bindings, key, binding; if (bindings) { for (key in bindings) { binding = key !== '__emberproto__' && obj[key]; if (binding) { if (binding instanceof Ember.Binding) { binding = binding.copy(); // copy prototypes' instance binding.to(key.slice(0, -7)); } else { binding = new Ember.Binding(key.slice(0,-7), binding); } binding.connect(obj); obj[key] = binding; } } } } /** @private */ function applyMixin(obj, mixins, partial) { var descs = {}, values = {}, m = Ember.meta(obj), req = m.required; var key, willApply, didApply, value, desc; // Go through all mixins and hashes passed in, and: // // * Handle concatenated properties // * Set up _super wrapping if necessary // * Set up descriptors (simple, watched or computed properties) // * Copying `toString` in broken browsers mergeMixins(mixins, meta(obj), descs, values, obj); if (MixinDelegate.detect(obj)) { willApply = values.willApplyProperty || obj.willApplyProperty; didApply = values.didApplyProperty || obj.didApplyProperty; } for(key in descs) { if (!descs.hasOwnProperty(key)) continue; desc = descs[key]; value = values[key]; if (desc === REQUIRED) { if (!(key in obj)) { if (!partial) throw new Error('Required property not defined: '+key); // for partial applies add to hash of required keys req = writableReq(obj); req.__ember_count__++; req[key] = true; } } else { while (desc instanceof Alias) { var altKey = desc.methodName; if (descs[altKey]) { value = values[altKey]; desc = descs[altKey]; } else if (m.descs[altKey]) { desc = m.descs[altKey]; value = desc.val(obj, altKey); } else { value = obj[altKey]; desc = Ember.SIMPLE_PROPERTY; } } if (willApply) willApply.call(obj, key); var observerPaths = getObserverPaths(value), curObserverPaths = observerPaths && getObserverPaths(obj[key]), beforeObserverPaths = getBeforeObserverPaths(value), curBeforeObserverPaths = beforeObserverPaths && getBeforeObserverPaths(obj[key]), len, idx; if (curObserverPaths) { len = curObserverPaths.length; for(idx=0;idx0) { var keys = []; for(key in req) { if (META_SKIP[key]) continue; keys.push(key); } throw new Error('Required properties not defined: '+keys.join(',')); } return obj; } Ember.mixin = function(obj) { var args = a_slice.call(arguments, 1); return applyMixin(obj, args, false); }; /** @constructor */ Ember.Mixin = function() { return initMixin(this, arguments); }; /** @private */ Mixin = Ember.Mixin; /** @private */ Mixin._apply = applyMixin; Mixin.applyPartial = function(obj) { var args = a_slice.call(arguments, 1); return applyMixin(obj, args, true); }; Mixin.finishPartial = function(obj) { connectBindings(obj); return obj; }; Mixin.create = function() { classToString.processed = false; var M = this; return initMixin(new M(), arguments); }; Mixin.prototype.reopen = function() { var mixin, tmp; if (this.properties) { mixin = Mixin.create(); mixin.properties = this.properties; delete this.properties; this.mixins = [mixin]; } var len = arguments.length, mixins = this.mixins, idx; for(idx=0;idx= 0) { if (_detect(mixins[loc], targetMixin, seen)) return true; } return false; } Mixin.prototype.detect = function(obj) { if (!obj) return false; if (obj instanceof Mixin) return _detect(obj, this, {}); return !!meta(obj, false)[Ember.guidFor(this)]; }; Mixin.prototype.without = function() { var ret = new Mixin(this); ret._without = a_slice.call(arguments); return ret; }; /** @private */ function _keys(ret, mixin, seen) { if (seen[Ember.guidFor(mixin)]) return; seen[Ember.guidFor(mixin)] = true; if (mixin.properties) { var props = mixin.properties; for(var key in props) { if (props.hasOwnProperty(key)) ret[key] = true; } } else if (mixin.mixins) { a_forEach(mixin.mixins, function(x) { _keys(ret, x, seen); }); } } Mixin.prototype.keys = function() { var keys = {}, seen = {}, ret = []; _keys(keys, this, seen); for(var key in keys) { if (keys.hasOwnProperty(key)) ret.push(key); } return ret; }; /** @private - make Mixin's have nice displayNames */ var NAME_KEY = Ember.GUID_KEY+'_name'; var get = Ember.get; /** @private */ function processNames(paths, root, seen) { var idx = paths.length; for(var key in root) { if (!root.hasOwnProperty || !root.hasOwnProperty(key)) continue; var obj = root[key]; paths[idx] = key; if (obj && obj.toString === classToString) { obj[NAME_KEY] = paths.join('.'); } else if (obj && get(obj, 'isNamespace')) { if (seen[Ember.guidFor(obj)]) continue; seen[Ember.guidFor(obj)] = true; processNames(paths, obj, seen); } } paths.length = idx; // cut out last item } /** @private */ function findNamespaces() { var Namespace = Ember.Namespace, obj, isNamespace; if (Namespace.PROCESSED) { return; } for (var prop in window) { // get(window.globalStorage, 'isNamespace') would try to read the storage for domain isNamespace and cause exception in Firefox. // globalStorage is a storage obsoleted by the WhatWG storage specification. See https://developer.mozilla.org/en/DOM/Storage#globalStorage if (prop === "globalStorage" && window.StorageList && window.globalStorage instanceof window.StorageList) { continue; } // Unfortunately, some versions of IE don't support window.hasOwnProperty if (window.hasOwnProperty && !window.hasOwnProperty(prop)) { continue; } // At times we are not allowed to access certain properties for security reasons. // There are also times where even if we can access them, we are not allowed to access their properties. try { obj = window[prop]; isNamespace = obj && get(obj, 'isNamespace'); } catch (e) { continue; } if (isNamespace) { obj[NAME_KEY] = prop; } } } Ember.identifyNamespaces = findNamespaces; /** @private */ superClassString = function(mixin) { var superclass = mixin.superclass; if (superclass) { if (superclass[NAME_KEY]) { return superclass[NAME_KEY]; } else { return superClassString(superclass); } } else { return; } }; /** @private */ classToString = function() { var Namespace = Ember.Namespace, namespace; // TODO: Namespace should really be in Metal if (Namespace) { if (!this[NAME_KEY] && !classToString.processed) { if (!Namespace.PROCESSED) { findNamespaces(); Namespace.PROCESSED = true; } classToString.processed = true; var namespaces = Namespace.NAMESPACES; for (var i=0, l=namespaces.length; i 'undefined' Ember.typeOf(null); => 'null' Ember.typeOf(undefined); => 'undefined' Ember.typeOf('michael'); => 'string' Ember.typeOf(101); => 'number' Ember.typeOf(true); => 'boolean' Ember.typeOf(Ember.makeArray); => 'function' Ember.typeOf([1,2,90]); => 'array' Ember.typeOf(Ember.Object.extend()); => 'class' Ember.typeOf(Ember.Object.create()); => 'instance' Ember.typeOf(new Error('teamocil')); => 'error' // "normal" JavaScript object Ember.typeOf({a: 'b'}); => 'object' @param item {Object} the item to check @returns {String} the type */ Ember.typeOf = function(item) { var ret; ret = (item === null || item === undefined) ? String(item) : TYPE_MAP[toString.call(item)] || 'object'; if (ret === 'function') { if (Ember.Object && Ember.Object.detect(item)) ret = 'class'; } else if (ret === 'object') { if (item instanceof Error) ret = 'error'; else if (Ember.Object && item instanceof Ember.Object) ret = 'instance'; else ret = 'object'; } return ret; }; /** Returns true if the passed value is null or undefined. This avoids errors from JSLint complaining about use of ==, which can be technically confusing. Ember.none(); => true Ember.none(null); => true Ember.none(undefined); => true Ember.none(''); => false Ember.none([]); => false Ember.none(function(){}); => false @param {Object} obj Value to test @returns {Boolean} */ Ember.none = function(obj) { return obj === null || obj === undefined; }; /** Verifies that a value is null or an empty string | array | function. Constrains the rules on `Ember.none` by returning false for empty string and empty arrays. Ember.empty(); => true Ember.empty(null); => true Ember.empty(undefined); => true Ember.empty(''); => true Ember.empty([]); => true Ember.empty('tobias fünke'); => false Ember.empty([0,1,2]); => false @param {Object} obj Value to test @returns {Boolean} */ Ember.empty = function(obj) { return obj === null || obj === undefined || (obj.length === 0 && typeof obj !== 'function'); }; /** This will compare two javascript values of possibly different types. It will tell you which one is greater than the other by returning: - -1 if the first is smaller than the second, - 0 if both are equal, - 1 if the first is greater than the second. The order is calculated based on Ember.ORDER_DEFINITION, if types are different. In case they have the same type an appropriate comparison for this type is made. Ember.compare('hello', 'hello'); => 0 Ember.compare('abc', 'dfg'); => -1 Ember.compare(2, 1); => 1 @param {Object} v First value to compare @param {Object} w Second value to compare @returns {Number} -1 if v < w, 0 if v = w and 1 if v > w. */ Ember.compare = function compare(v, w) { if (v === w) { return 0; } var type1 = Ember.typeOf(v); var type2 = Ember.typeOf(w); var Comparable = Ember.Comparable; if (Comparable) { if (type1==='instance' && Comparable.detect(v.constructor)) { return v.constructor.compare(v, w); } if (type2 === 'instance' && Comparable.detect(w.constructor)) { return 1-w.constructor.compare(w, v); } } // If we haven't yet generated a reverse-mapping of Ember.ORDER_DEFINITION, // do so now. var mapping = Ember.ORDER_DEFINITION_MAPPING; if (!mapping) { var order = Ember.ORDER_DEFINITION; mapping = Ember.ORDER_DEFINITION_MAPPING = {}; var idx, len; for (idx = 0, len = order.length; idx < len; ++idx) { mapping[order[idx]] = idx; } // We no longer need Ember.ORDER_DEFINITION. delete Ember.ORDER_DEFINITION; } var type1Index = mapping[type1]; var type2Index = mapping[type2]; if (type1Index < type2Index) { return -1; } if (type1Index > type2Index) { return 1; } // types are equal - so we have to check values now switch (type1) { case 'boolean': case 'number': if (v < w) { return -1; } if (v > w) { return 1; } return 0; case 'string': var comp = v.localeCompare(w); if (comp < 0) { return -1; } if (comp > 0) { return 1; } return 0; case 'array': var vLen = v.length; var wLen = w.length; var l = Math.min(vLen, wLen); var r = 0; var i = 0; while (r === 0 && i < l) { r = compare(v[i],w[i]); i++; } if (r !== 0) { return r; } // all elements are equal now // shorter array should be ordered first if (vLen < wLen) { return -1; } if (vLen > wLen) { return 1; } // arrays are equal now return 0; case 'instance': if (Ember.Comparable && Ember.Comparable.detect(v)) { return v.compare(v, w); } return 0; default: return 0; } }; /** @private */ function _copy(obj, deep, seen, copies) { var ret, loc, key; // primitive data types are immutable, just return them. if ('object' !== typeof obj || obj===null) return obj; // avoid cyclical loops if (deep && (loc=indexOf(seen, obj))>=0) return copies[loc]; // IMPORTANT: this specific test will detect a native array only. Any other // object will need to implement Copyable. if (Ember.typeOf(obj) === 'array') { ret = obj.slice(); if (deep) { loc = ret.length; while(--loc>=0) ret[loc] = _copy(ret[loc], deep, seen, copies); } } else if (Ember.Copyable && Ember.Copyable.detect(obj)) { ret = obj.copy(deep, seen, copies); } else { ret = {}; for(key in obj) { if (!obj.hasOwnProperty(key)) continue; ret[key] = deep ? _copy(obj[key], deep, seen, copies) : obj[key]; } } if (deep) { seen.push(obj); copies.push(ret); } return ret; } /** Creates a clone of the passed object. This function can take just about any type of object and create a clone of it, including primitive values (which are not actually cloned because they are immutable). If the passed object implements the clone() method, then this function will simply call that method and return the result. @param {Object} object The object to clone @param {Boolean} deep If true, a deep copy of the object is made @returns {Object} The cloned object */ Ember.copy = function(obj, deep) { // fast paths if ('object' !== typeof obj || obj===null) return obj; // can't copy primitives if (Ember.Copyable && Ember.Copyable.detect(obj)) return obj.copy(deep); return _copy(obj, deep, deep ? [] : null, deep ? [] : null); }; /** Convenience method to inspect an object. This method will attempt to convert the object into a useful string description. @param {Object} obj The object you want to inspect. @returns {String} A description of the object */ Ember.inspect = function(obj) { var v, ret = []; for(var key in obj) { if (obj.hasOwnProperty(key)) { v = obj[key]; if (v === 'toString') { continue; } // ignore useless items if (Ember.typeOf(v) === 'function') { v = "function() { ... }"; } ret.push(key + ": " + v); } } return "{" + ret.join(" , ") + "}"; }; /** Compares two objects, returning true if they are logically equal. This is a deeper comparison than a simple triple equal. For sets it will compare the internal objects. For any other object that implements `isEqual()` it will respect that method. Ember.isEqual('hello', 'hello'); => true Ember.isEqual(1, 2); => false Ember.isEqual([4,2], [4,2]); => false @param {Object} a first object to compare @param {Object} b second object to compare @returns {Boolean} */ Ember.isEqual = function(a, b) { if (a && 'function'===typeof a.isEqual) return a.isEqual(b); return a === b; }; /** @private Used by Ember.compare */ Ember.ORDER_DEFINITION = Ember.ENV.ORDER_DEFINITION || [ 'undefined', 'null', 'boolean', 'number', 'string', 'array', 'object', 'instance', 'function', 'class' ]; /** Returns all of the keys defined on an object or hash. This is useful when inspecting objects for debugging. On browsers that support it, this uses the native Object.keys implementation. @function @param {Object} obj @returns {Array} Array containing keys of obj */ Ember.keys = Object.keys; if (!Ember.keys) { Ember.keys = function(obj) { var ret = []; for(var key in obj) { if (obj.hasOwnProperty(key)) { ret.push(key); } } return ret; }; } // .......................................................... // ERROR // /** @class A subclass of the JavaScript Error object for use in Ember. */ Ember.Error = function() { var tmp = Error.prototype.constructor.apply(this, arguments); for (var p in tmp) { if (tmp.hasOwnProperty(p)) { this[p] = tmp[p]; } } this.message = tmp.message; }; Ember.Error.prototype = Ember.create(Error.prototype); })(); (function() { // ========================================================================== // Project: Ember Runtime // Copyright: ©2011 Strobe Inc. // License: Licensed under MIT license (see license.js) // ========================================================================== /** @private **/ var STRING_DASHERIZE_REGEXP = (/[ _]/g); var STRING_DASHERIZE_CACHE = {}; var STRING_DECAMELIZE_REGEXP = (/([a-z])([A-Z])/g); var STRING_CAMELIZE_REGEXP = (/(\-|_|\s)+(.)?/g); var STRING_UNDERSCORE_REGEXP_1 = (/([a-z\d])([A-Z]+)/g); var STRING_UNDERSCORE_REGEXP_2 = (/\-|\s+/g); /** Defines the hash of localized strings for the current language. Used by the `Ember.String.loc()` helper. To localize, add string values to this hash. @property {String} */ Ember.STRINGS = {}; /** Defines string helper methods including string formatting and localization. Unless Ember.EXTEND_PROTOTYPES = false these methods will also be added to the String.prototype as well. @namespace */ Ember.String = { /** Apply formatting options to the string. This will look for occurrences of %@ in your string and substitute them with the arguments you pass into this method. If you want to control the specific order of replacement, you can add a number after the key as well to indicate which argument you want to insert. Ordered insertions are most useful when building loc strings where values you need to insert may appear in different orders. "Hello %@ %@".fmt('John', 'Doe') => "Hello John Doe" "Hello %@2, %@1".fmt('John', 'Doe') => "Hello Doe, John" @param {Object...} [args] @returns {String} formatted string */ fmt: function(str, formats) { // first, replace any ORDERED replacements. var idx = 0; // the current index for non-numerical replacements return str.replace(/%@([0-9]+)?/g, function(s, argIndex) { argIndex = (argIndex) ? parseInt(argIndex,0) - 1 : idx++ ; s = formats[argIndex]; return ((s === null) ? '(null)' : (s === undefined) ? '' : s).toString(); }) ; }, /** Formats the passed string, but first looks up the string in the localized strings hash. This is a convenient way to localize text. See `Ember.String.fmt()` for more information on formatting. Note that it is traditional but not required to prefix localized string keys with an underscore or other character so you can easily identify localized strings. Ember.STRINGS = { '_Hello World': 'Bonjour le monde', '_Hello %@ %@': 'Bonjour %@ %@' }; Ember.String.loc("_Hello World"); => 'Bonjour le monde'; Ember.String.loc("_Hello %@ %@", ["John", "Smith"]); => "Bonjour John Smith"; @param {String} str The string to format @param {Array} formats Optional array of parameters to interpolate into string. @returns {String} formatted string */ loc: function(str, formats) { str = Ember.STRINGS[str] || str; return Ember.String.fmt(str, formats) ; }, /** Splits a string into separate units separated by spaces, eliminating any empty strings in the process. This is a convenience method for split that is mostly useful when applied to the String.prototype. Ember.String.w("alpha beta gamma").forEach(function(key) { console.log(key); }); > alpha > beta > gamma @param {String} str The string to split @returns {String} split string */ w: function(str) { return str.split(/\s+/); }, /** Converts a camelized string into all lower case separated by underscores. 'innerHTML'.decamelize() => 'inner_html' 'action_name'.decamelize() => 'action_name' 'css-class-name'.decamelize() => 'css-class-name' 'my favorite items'.decamelize() => 'my favorite items' @param {String} str The string to decamelize. @returns {String} the decamelized string. */ decamelize: function(str) { return str.replace(STRING_DECAMELIZE_REGEXP, '$1_$2').toLowerCase(); }, /** Replaces underscores or spaces with dashes. 'innerHTML'.dasherize() => 'inner-html' 'action_name'.dasherize() => 'action-name' 'css-class-name'.dasherize() => 'css-class-name' 'my favorite items'.dasherize() => 'my-favorite-items' @param {String} str The string to dasherize. @returns {String} the dasherized string. */ dasherize: function(str) { var cache = STRING_DASHERIZE_CACHE, ret = cache[str]; if (ret) { return ret; } else { ret = Ember.String.decamelize(str).replace(STRING_DASHERIZE_REGEXP,'-'); cache[str] = ret; } return ret; }, /** Returns the lowerCaseCamel form of a string. 'innerHTML'.camelize() => 'innerHTML' 'action_name'.camelize() => 'actionName' 'css-class-name'.camelize() => 'cssClassName' 'my favorite items'.camelize() => 'myFavoriteItems' @param {String} str The string to camelize. @returns {String} the camelized string. */ camelize: function(str) { return str.replace(STRING_CAMELIZE_REGEXP, function(match, separator, chr) { return chr ? chr.toUpperCase() : ''; }); }, /** More general than decamelize. Returns the lower_case_and_underscored form of a string. 'innerHTML'.underscore() => 'inner_html' 'action_name'.underscore() => 'action_name' 'css-class-name'.underscore() => 'css_class_name' 'my favorite items'.underscore() => 'my_favorite_items' @param {String} str The string to underscore. @returns {String} the underscored string. */ underscore: function(str) { return str.replace(STRING_UNDERSCORE_REGEXP_1, '$1_$2'). replace(STRING_UNDERSCORE_REGEXP_2, '_').toLowerCase(); } }; })(); (function() { // ========================================================================== // Project: Ember Runtime // Copyright: ©2006-2011 Strobe Inc. and contributors. // Portions ©2008-2011 Apple Inc. All rights reserved. // License: Licensed under MIT license (see license.js) // ========================================================================== var fmt = Ember.String.fmt, w = Ember.String.w, loc = Ember.String.loc, camelize = Ember.String.camelize, decamelize = Ember.String.decamelize, dasherize = Ember.String.dasherize, underscore = Ember.String.underscore; if (Ember.EXTEND_PROTOTYPES) { /** @see Ember.String.fmt */ String.prototype.fmt = function() { return fmt(this, arguments); }; /** @see Ember.String.w */ String.prototype.w = function() { return w(this); }; /** @see Ember.String.loc */ String.prototype.loc = function() { return loc(this, arguments); }; /** @see Ember.String.camelize */ String.prototype.camelize = function() { return camelize(this); }; /** @see Ember.String.decamelize */ String.prototype.decamelize = function() { return decamelize(this); }; /** @see Ember.String.dasherize */ String.prototype.dasherize = function() { return dasherize(this); }; /** @see Ember.String.underscore */ String.prototype.underscore = function() { return underscore(this); }; } })(); (function() { // ========================================================================== // Project: Ember Runtime // Copyright: ©2006-2011 Strobe Inc. and contributors. // Portions ©2008-2011 Apple Inc. All rights reserved. // License: Licensed under MIT license (see license.js) // ========================================================================== var a_slice = Array.prototype.slice; if (Ember.EXTEND_PROTOTYPES) { /** The `property` extension of Javascript's Function prototype is available when Ember.EXTEND_PROTOTYPES is true, which is the default. Computed properties allow you to treat a function like a property: MyApp.president = Ember.Object.create({ firstName: "Barack", lastName: "Obama", fullName: function() { return this.get('firstName') + ' ' + this.get('lastName'); // Call this flag to mark the function as a property }.property() }); MyApp.president.get('fullName'); => "Barack Obama" Treating a function like a property is useful because they can work with bindings, just like any other property. Many computed properties have dependencies on other properties. For example, in the above example, the `fullName` property depends on `firstName` and `lastName` to determine its value. You can tell Ember.js about these dependencies like this: MyApp.president = Ember.Object.create({ firstName: "Barack", lastName: "Obama", fullName: function() { return this.get('firstName') + ' ' + this.get('lastName'); // Tell Ember.js that this computed property depends on firstName // and lastName }.property('firstName', 'lastName') }); Make sure you list these dependencies so Ember.js knows when to update bindings that connect to a computed property. Changing a dependency will not immediately trigger an update of the computed property, but will instead clear the cache so that it is updated when the next `get` is called on the property. Note: you will usually want to use `property(...)` with `cacheable()`. @see Ember.ComputedProperty @see Ember.computed */ Function.prototype.property = function() { var ret = Ember.computed(this); return ret.property.apply(ret, arguments); }; /** The `observes` extension of Javascript's Function prototype is available when Ember.EXTEND_PROTOTYPES is true, which is the default. You can observe property changes simply by adding the `observes` call to the end of your method declarations in classes that you write. For example: Ember.Object.create({ valueObserver: function() { // Executes whenever the "value" property changes }.observes('value') }); @see Ember.Observable */ Function.prototype.observes = function() { this.__ember_observes__ = a_slice.call(arguments); return this; }; /** The `observesBefore` extension of Javascript's Function prototype is available when Ember.EXTEND_PROTOTYPES is true, which is the default. You can get notified when a property changes is about to happen by by adding the `observesBefore` call to the end of your method declarations in classes that you write. For example: Ember.Object.create({ valueObserver: function() { // Executes whenever the "value" property is about to change }.observesBefore('value') }); @see Ember.Observable */ Function.prototype.observesBefore = function() { this.__ember_observesBefore__ = a_slice.call(arguments); return this; }; } })(); (function() { // ========================================================================== // Project: Ember Runtime // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== })(); (function() { // ========================================================================== // Project: Ember Runtime // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== // .......................................................... // HELPERS // var get = Ember.get, set = Ember.set; var a_slice = Array.prototype.slice; var a_indexOf = Ember.ArrayUtils.indexOf; var contexts = []; /** @private */ function popCtx() { return contexts.length===0 ? {} : contexts.pop(); } /** @private */ function pushCtx(ctx) { contexts.push(ctx); return null; } /** @private */ function iter(key, value) { var valueProvided = arguments.length === 2; function i(item) { var cur = get(item, key); return valueProvided ? value===cur : !!cur; } return i ; } /** @private */ function xform(target, method, params) { method.call(target, params[0], params[2], params[3]); } /** @class This mixin defines the common interface implemented by enumerable objects in Ember. Most of these methods follow the standard Array iteration API defined up to JavaScript 1.8 (excluding language-specific features that cannot be emulated in older versions of JavaScript). This mixin is applied automatically to the Array class on page load, so you can use any of these methods on simple arrays. If Array already implements one of these methods, the mixin will not override them. h3. Writing Your Own Enumerable To make your own custom class enumerable, you need two items: 1. You must have a length property. This property should change whenever the number of items in your enumerable object changes. If you using this with an Ember.Object subclass, you should be sure to change the length property using set(). 2. If you must implement nextObject(). See documentation. Once you have these two methods implement, apply the Ember.Enumerable mixin to your class and you will be able to enumerate the contents of your object like any other collection. h3. Using Ember Enumeration with Other Libraries Many other libraries provide some kind of iterator or enumeration like facility. This is often where the most common API conflicts occur. Ember's API is designed to be as friendly as possible with other libraries by implementing only methods that mostly correspond to the JavaScript 1.8 API. @since Ember 0.9 */ Ember.Enumerable = Ember.Mixin.create( /** @lends Ember.Enumerable */ { /** @private - compatibility */ isEnumerable: true, /** Implement this method to make your class enumerable. This method will be call repeatedly during enumeration. The index value will always begin with 0 and increment monotonically. You don't have to rely on the index value to determine what object to return, but you should always check the value and start from the beginning when you see the requested index is 0. The previousObject is the object that was returned from the last call to nextObject for the current iteration. This is a useful way to manage iteration if you are tracing a linked list, for example. Finally the context parameter will always contain a hash you can use as a "scratchpad" to maintain any other state you need in order to iterate properly. The context object is reused and is not reset between iterations so make sure you setup the context with a fresh state whenever the index parameter is 0. Generally iterators will continue to call nextObject until the index reaches the your current length-1. If you run out of data before this time for some reason, you should simply return undefined. The default implementation of this method simply looks up the index. This works great on any Array-like objects. @param index {Number} the current index of the iteration @param previousObject {Object} the value returned by the last call to nextObject. @param context {Object} a context object you can use to maintain state. @returns {Object} the next object in the iteration or undefined */ nextObject: Ember.required(Function), /** Helper method returns the first object from a collection. This is usually used by bindings and other parts of the framework to extract a single object if the enumerable contains only one item. If you override this method, you should implement it so that it will always return the same value each time it is called. If your enumerable contains only one object, this method should always return that object. If your enumerable is empty, this method should return undefined. var arr = ["a", "b", "c"]; arr.firstObject(); => "a" var arr = []; arr.firstObject(); => undefined @returns {Object} the object or undefined */ firstObject: Ember.computed(function() { if (get(this, 'length')===0) return undefined ; // handle generic enumerables var context = popCtx(), ret; ret = this.nextObject(0, null, context); pushCtx(context); return ret ; }).property('[]').cacheable(), /** Helper method returns the last object from a collection. If your enumerable contains only one object, this method should always return that object. If your enumerable is empty, this method should return undefined. var arr = ["a", "b", "c"]; arr.lastObject(); => "c" var arr = []; arr.lastObject(); => undefined @returns {Object} the last object or undefined */ lastObject: Ember.computed(function() { var len = get(this, 'length'); if (len===0) return undefined ; var context = popCtx(), idx=0, cur, last = null; do { last = cur; cur = this.nextObject(idx++, last, context); } while (cur !== undefined); pushCtx(context); return last; }).property('[]').cacheable(), /** Returns true if the passed object can be found in the receiver. The default version will iterate through the enumerable until the object is found. You may want to override this with a more efficient version. var arr = ["a", "b", "c"]; arr.contains("a"); => true arr.contains("z"); => false @param {Object} obj The object to search for. @returns {Boolean} true if object is found in enumerable. */ contains: function(obj) { return this.find(function(item) { return item===obj; }) !== undefined; }, /** Iterates through the enumerable, calling the passed function on each item. This method corresponds to the forEach() method defined in JavaScript 1.6. The callback method you provide should have the following signature (all parameters are optional): function(item, index, enumerable); - *item* is the current item in the iteration. - *index* is the current index in the iteration - *enumerable* is the enumerable object itself. Note that in addition to a callback, you can also pass an optional target object that will be set as "this" on the context. This is a good way to give your iterator function access to the current object. @param {Function} callback The callback to execute @param {Object} target The target object to use @returns {Object} receiver */ forEach: function(callback, target) { if (typeof callback !== "function") throw new TypeError() ; var len = get(this, 'length'), last = null, context = popCtx(); if (target === undefined) target = null; for(var idx=0;idx1) args = a_slice.call(arguments, 1); this.forEach(function(x, idx) { var method = x && x[methodName]; if ('function' === typeof method) { ret[idx] = args ? method.apply(x, args) : method.call(x); } }, this); return ret; }, /** Simply converts the enumerable into a genuine array. The order is not guaranteed. Corresponds to the method implemented by Prototype. @returns {Array} the enumerable as an array. */ toArray: function() { var ret = []; this.forEach(function(o, idx) { ret[idx] = o; }); return ret ; }, /** Returns a copy of the array with all null elements removed. var arr = ["a", null, "c", null]; arr.compact(); => ["a", "c"] @returns {Array} the array without null elements. */ compact: function() { return this.without(null); }, /** Returns a new enumerable that excludes the passed value. The default implementation returns an array regardless of the receiver type unless the receiver does not contain the value. var arr = ["a", "b", "a", "c"]; arr.without("a"); => ["b", "c"] @param {Object} value @returns {Ember.Enumerable} */ without: function(value) { if (!this.contains(value)) return this; // nothing to do var ret = [] ; this.forEach(function(k) { if (k !== value) ret[ret.length] = k; }) ; return ret ; }, /** Returns a new enumerable that contains only unique values. The default implementation returns an array regardless of the receiver type. var arr = ["a", "a", "b", "b"]; arr.uniq(); => ["a", "b"] @returns {Ember.Enumerable} */ uniq: function() { var ret = []; this.forEach(function(k){ if (a_indexOf(ret, k)<0) ret.push(k); }); return ret; }, /** This property will trigger anytime the enumerable's content changes. You can observe this property to be notified of changes to the enumerables content. For plain enumerables, this property is read only. Ember.Array overrides this method. @property {Ember.Array} */ '[]': Ember.computed(function(key, value) { return this; }).property().cacheable(), // .......................................................... // ENUMERABLE OBSERVERS // /** Registers an enumerable observer. Must implement Ember.EnumerableObserver mixin. */ addEnumerableObserver: function(target, opts) { var willChange = (opts && opts.willChange) || 'enumerableWillChange', didChange = (opts && opts.didChange) || 'enumerableDidChange'; var hasObservers = get(this, 'hasEnumerableObservers'); if (!hasObservers) Ember.propertyWillChange(this, 'hasEnumerableObservers'); Ember.addListener(this, '@enumerable:before', target, willChange, xform); Ember.addListener(this, '@enumerable:change', target, didChange, xform); if (!hasObservers) Ember.propertyDidChange(this, 'hasEnumerableObservers'); return this; }, /** Removes a registered enumerable observer. */ removeEnumerableObserver: function(target, opts) { var willChange = (opts && opts.willChange) || 'enumerableWillChange', didChange = (opts && opts.didChange) || 'enumerableDidChange'; var hasObservers = get(this, 'hasEnumerableObservers'); if (hasObservers) Ember.propertyWillChange(this, 'hasEnumerableObservers'); Ember.removeListener(this, '@enumerable:before', target, willChange); Ember.removeListener(this, '@enumerable:change', target, didChange); if (hasObservers) Ember.propertyDidChange(this, 'hasEnumerableObservers'); return this; }, /** Becomes true whenever the array currently has observers watching changes on the array. @property {Boolean} */ hasEnumerableObservers: Ember.computed(function() { return Ember.hasListeners(this, '@enumerable:change') || Ember.hasListeners(this, '@enumerable:before'); }).property().cacheable(), /** Invoke this method just before the contents of your enumerable will change. You can either omit the parameters completely or pass the objects to be removed or added if available or just a count. @param {Ember.Enumerable|Number} removing An enumerable of the objects to be removed or the number of items to be removed. @param {Ember.Enumerable|Number} adding An enumerable of the objects to be added or the number of items to be added. @returns {Ember.Enumerable} receiver */ enumerableContentWillChange: function(removing, adding) { var removeCnt, addCnt, hasDelta; if ('number' === typeof removing) removeCnt = removing; else if (removing) removeCnt = get(removing, 'length'); else removeCnt = removing = -1; if ('number' === typeof adding) addCnt = adding; else if (adding) addCnt = get(adding,'length'); else addCnt = adding = -1; hasDelta = addCnt<0 || removeCnt<0 || addCnt-removeCnt!==0; if (removing === -1) removing = null; if (adding === -1) adding = null; Ember.propertyWillChange(this, '[]'); if (hasDelta) Ember.propertyWillChange(this, 'length'); Ember.sendEvent(this, '@enumerable:before', removing, adding); return this; }, /** Invoke this method when the contents of your enumerable has changed. This will notify any observers watching for content changes. If your are implementing an ordered enumerable (such as an array), also pass the start and end values where the content changed so that it can be used to notify range observers. @param {Number} start optional start offset for the content change. For unordered enumerables, you should always pass -1. @param {Ember.Enumerable|Number} removing An enumerable of the objects to be removed or the number of items to be removed. @param {Ember.Enumerable|Numbe} adding An enumerable of the objects to be added or the number of items to be added. @returns {Object} receiver */ enumerableContentDidChange: function(removing, adding) { var notify = this.propertyDidChange, removeCnt, addCnt, hasDelta; if ('number' === typeof removing) removeCnt = removing; else if (removing) removeCnt = get(removing, 'length'); else removeCnt = removing = -1; if ('number' === typeof adding) addCnt = adding; else if (adding) addCnt = get(adding, 'length'); else addCnt = adding = -1; hasDelta = addCnt<0 || removeCnt<0 || addCnt-removeCnt!==0; if (removing === -1) removing = null; if (adding === -1) adding = null; Ember.sendEvent(this, '@enumerable:change', removing, adding); if (hasDelta) Ember.propertyDidChange(this, 'length'); Ember.propertyDidChange(this, '[]'); return this ; } }) ; })(); (function() { // ========================================================================== // Project: Ember Runtime // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== // .......................................................... // HELPERS // var get = Ember.get, set = Ember.set, meta = Ember.meta, map = Ember.ArrayUtils.map, cacheFor = Ember.cacheFor; /** @private */ function none(obj) { return obj===null || obj===undefined; } /** @private */ function xform(target, method, params) { method.call(target, params[0], params[2], params[3], params[4]); } // .......................................................... // ARRAY // /** @namespace This module implements Observer-friendly Array-like behavior. This mixin is picked up by the Array class as well as other controllers, etc. that want to appear to be arrays. Unlike Ember.Enumerable, this mixin defines methods specifically for collections that provide index-ordered access to their contents. When you are designing code that needs to accept any kind of Array-like object, you should use these methods instead of Array primitives because these will properly notify observers of changes to the array. Although these methods are efficient, they do add a layer of indirection to your application so it is a good idea to use them only when you need the flexibility of using both true JavaScript arrays and "virtual" arrays such as controllers and collections. You can use the methods defined in this module to access and modify array contents in a KVO-friendly way. You can also be notified whenever the membership if an array changes by changing the syntax of the property to .observes('*myProperty.[]') . To support Ember.Array in your own class, you must override two primitives to use it: replace() and objectAt(). Note that the Ember.Array mixin also incorporates the Ember.Enumerable mixin. All Ember.Array-like objects are also enumerable. @extends Ember.Enumerable @since Ember 0.9.0 */ Ember.Array = Ember.Mixin.create(Ember.Enumerable, /** @scope Ember.Array.prototype */ { /** @private - compatibility */ isSCArray: true, /** @field {Number} length Your array must support the length property. Your replace methods should set this property whenever it changes. */ length: Ember.required(), /** This is one of the primitives you must implement to support Ember.Array. Returns the object at the named index. If your object supports retrieving the value of an array item using get() (i.e. myArray.get(0)), then you do not need to implement this method yourself. @param {Number} idx The index of the item to return. If idx exceeds the current length, return null. */ objectAt: function(idx) { if ((idx < 0) || (idx>=get(this, 'length'))) return undefined ; return get(this, idx); }, /** This returns the objects at the specified indexes, using objectAt. @param {Array} indexes An array of indexes of items to return. */ objectsAt: function(indexes) { var self = this; return map(indexes, function(idx){ return self.objectAt(idx); }); }, /** @private (nodoc) - overrides Ember.Enumerable version */ nextObject: function(idx) { return this.objectAt(idx); }, /** @field [] This is the handler for the special array content property. If you get this property, it will return this. If you set this property it a new array, it will replace the current content. This property overrides the default property defined in Ember.Enumerable. */ '[]': Ember.computed(function(key, value) { if (value !== undefined) this.replace(0, get(this, 'length'), value) ; return this ; }).property().cacheable(), firstObject: Ember.computed(function() { return this.objectAt(0); }).property().cacheable(), lastObject: Ember.computed(function() { return this.objectAt(get(this, 'length')-1); }).property().cacheable(), /** @private (nodoc) - optimized version from Enumerable */ contains: function(obj){ return this.indexOf(obj) >= 0; }, // Add any extra methods to Ember.Array that are native to the built-in Array. /** Returns a new array that is a slice of the receiver. This implementation uses the observable array methods to retrieve the objects for the new slice. var arr = ['red', 'green', 'blue']; arr.slice(0); => ['red', 'green', 'blue'] arr.slice(0, 2); => ['red', 'green'] arr.slice(1, 100); => ['green', 'blue'] @param beginIndex {Integer} (Optional) index to begin slicing from. @param endIndex {Integer} (Optional) index to end the slice at. @returns {Array} New array with specified slice */ slice: function(beginIndex, endIndex) { var ret = []; var length = get(this, 'length') ; if (none(beginIndex)) beginIndex = 0 ; if (none(endIndex) || (endIndex > length)) endIndex = length ; while(beginIndex < endIndex) { ret[ret.length] = this.objectAt(beginIndex++) ; } return ret ; }, /** Returns the index of the given object's first occurrence. If no startAt argument is given, the starting location to search is 0. If it's negative, will count backward from the end of the array. Returns -1 if no match is found. var arr = ["a", "b", "c", "d", "a"]; arr.indexOf("a"); => 0 arr.indexOf("z"); => -1 arr.indexOf("a", 2); => 4 arr.indexOf("a", -1); => 4 arr.indexOf("b", 3); => -1 arr.indexOf("a", 100); => -1 @param {Object} object the item to search for @param {Number} startAt optional starting location to search, default 0 @returns {Number} index or -1 if not found */ indexOf: function(object, startAt) { var idx, len = get(this, 'length'); if (startAt === undefined) startAt = 0; if (startAt < 0) startAt += len; for(idx=startAt;idx 4 arr.lastIndexOf("z"); => -1 arr.lastIndexOf("a", 2); => 0 arr.lastIndexOf("a", -1); => 4 arr.lastIndexOf("b", 3); => 1 arr.lastIndexOf("a", 100); => 4 @param {Object} object the item to search for @param {Number} startAt optional starting location to search, default 0 @returns {Number} index or -1 if not found */ lastIndexOf: function(object, startAt) { var idx, len = get(this, 'length'); if (startAt === undefined || startAt >= len) startAt = len-1; if (startAt < 0) startAt += len; for(idx=startAt;idx>=0;idx--) { if (this.objectAt(idx) === object) return idx ; } return -1; }, // .......................................................... // ARRAY OBSERVERS // /** Adds an array observer to the receiving array. The array observer object normally must implement two methods: * `arrayWillChange(start, removeCount, addCount)` - This method will be called just before the array is modified. * `arrayDidChange(start, removeCount, addCount)` - This method will be called just after the array is modified. Both callbacks will be passed the starting index of the change as well a a count of the items to be removed and added. You can use these callbacks to optionally inspect the array during the change, clear caches, or do any other bookkeeping necessary. In addition to passing a target, you can also include an options hash which you can use to override the method names that will be invoked on the target. @param {Object} target The observer object. @param {Hash} opts Optional hash of configuration options including willChange, didChange, and a context option. @returns {Ember.Array} receiver */ addArrayObserver: function(target, opts) { var willChange = (opts && opts.willChange) || 'arrayWillChange', didChange = (opts && opts.didChange) || 'arrayDidChange'; var hasObservers = get(this, 'hasArrayObservers'); if (!hasObservers) Ember.propertyWillChange(this, 'hasArrayObservers'); Ember.addListener(this, '@array:before', target, willChange, xform); Ember.addListener(this, '@array:change', target, didChange, xform); if (!hasObservers) Ember.propertyDidChange(this, 'hasArrayObservers'); return this; }, /** Removes an array observer from the object if the observer is current registered. Calling this method multiple times with the same object will have no effect. @param {Object} target The object observing the array. @returns {Ember.Array} receiver */ removeArrayObserver: function(target, opts) { var willChange = (opts && opts.willChange) || 'arrayWillChange', didChange = (opts && opts.didChange) || 'arrayDidChange'; var hasObservers = get(this, 'hasArrayObservers'); if (hasObservers) Ember.propertyWillChange(this, 'hasArrayObservers'); Ember.removeListener(this, '@array:before', target, willChange, xform); Ember.removeListener(this, '@array:change', target, didChange, xform); if (hasObservers) Ember.propertyDidChange(this, 'hasArrayObservers'); return this; }, /** Becomes true whenever the array currently has observers watching changes on the array. @property {Boolean} */ hasArrayObservers: Ember.computed(function() { return Ember.hasListeners(this, '@array:change') || Ember.hasListeners(this, '@array:before'); }).property().cacheable(), /** If you are implementing an object that supports Ember.Array, call this method just before the array content changes to notify any observers and invalidate any related properties. Pass the starting index of the change as well as a delta of the amounts to change. @param {Number} startIdx The starting index in the array that will change. @param {Number} removeAmt The number of items that will be removed. If you pass null assumes 0 @param {Number} addAmt The number of items that will be added. If you pass null assumes 0. @returns {Ember.Array} receiver */ arrayContentWillChange: function(startIdx, removeAmt, addAmt) { // if no args are passed assume everything changes if (startIdx===undefined) { startIdx = 0; removeAmt = addAmt = -1; } else { if (removeAmt === undefined) removeAmt=-1; if (addAmt === undefined) addAmt=-1; } Ember.sendEvent(this, '@array:before', startIdx, removeAmt, addAmt); var removing, lim; if (startIdx>=0 && removeAmt>=0 && get(this, 'hasEnumerableObservers')) { removing = []; lim = startIdx+removeAmt; for(var idx=startIdx;idx=0 && addAmt>=0 && get(this, 'hasEnumerableObservers')) { adding = []; lim = startIdx+addAmt; for(var idx=startIdx;idx b` Default implementation raises an exception. @param a {Object} the first object to compare @param b {Object} the second object to compare @returns {Integer} the result of the comparison */ compare: Ember.required(Function) }); })(); (function() { // ========================================================================== // Project: Ember Runtime // Copyright: ©2006-2011 Strobe Inc. and contributors. // Portions ©2008-2010 Apple Inc. All rights reserved. // License: Licensed under MIT license (see license.js) // ========================================================================== var get = Ember.get, set = Ember.set; /** @namespace Implements some standard methods for copying an object. Add this mixin to any object you create that can create a copy of itself. This mixin is added automatically to the built-in array. You should generally implement the copy() method to return a copy of the receiver. Note that frozenCopy() will only work if you also implement Ember.Freezable. @since Ember 0.9 */ Ember.Copyable = Ember.Mixin.create( /** @scope Ember.Copyable.prototype */ { /** Override to return a copy of the receiver. Default implementation raises an exception. @param deep {Boolean} if true, a deep copy of the object should be made @returns {Object} copy of receiver */ copy: Ember.required(Function), /** If the object implements Ember.Freezable, then this will return a new copy if the object is not frozen and the receiver if the object is frozen. Raises an exception if you try to call this method on a object that does not support freezing. You should use this method whenever you want a copy of a freezable object since a freezable object can simply return itself without actually consuming more memory. @returns {Object} copy of receiver or receiver */ frozenCopy: function() { if (Ember.Freezable && Ember.Freezable.detect(this)) { return get(this, 'isFrozen') ? this : this.copy().freeze(); } else { throw new Error(Ember.String.fmt("%@ does not support freezing", [this])); } } }); })(); (function() { // ========================================================================== // Project: Ember Runtime // Copyright: ©2006-2011 Strobe Inc. and contributors. // Portions ©2008-2010 Apple Inc. All rights reserved. // License: Licensed under MIT license (see license.js) // ========================================================================== var get = Ember.get, set = Ember.set; /** @namespace The Ember.Freezable mixin implements some basic methods for marking an object as frozen. Once an object is frozen it should be read only. No changes may be made the internal state of the object. ## Enforcement To fully support freezing in your subclass, you must include this mixin and override any method that might alter any property on the object to instead raise an exception. You can check the state of an object by checking the isFrozen property. Although future versions of JavaScript may support language-level freezing object objects, that is not the case today. Even if an object is freezable, it is still technically possible to modify the object, even though it could break other parts of your application that do not expect a frozen object to change. It is, therefore, very important that you always respect the isFrozen property on all freezable objects. ## Example Usage The example below shows a simple object that implement the Ember.Freezable protocol. Contact = Ember.Object.extend(Ember.Freezable, { firstName: null, lastName: null, // swaps the names swapNames: function() { if (this.get('isFrozen')) throw Ember.FROZEN_ERROR; var tmp = this.get('firstName'); this.set('firstName', this.get('lastName')); this.set('lastName', tmp); return this; } }); c = Context.create({ firstName: "John", lastName: "Doe" }); c.swapNames(); => returns c c.freeze(); c.swapNames(); => EXCEPTION ## Copying Usually the Ember.Freezable protocol is implemented in cooperation with the Ember.Copyable protocol, which defines a frozenCopy() method that will return a frozen object, if the object implements this method as well. @since Ember 0.9 */ Ember.Freezable = Ember.Mixin.create( /** @scope Ember.Freezable.prototype */ { /** Set to true when the object is frozen. Use this property to detect whether your object is frozen or not. @property {Boolean} */ isFrozen: false, /** Freezes the object. Once this method has been called the object should no longer allow any properties to be edited. @returns {Object} receiver */ freeze: function() { if (get(this, 'isFrozen')) return this; set(this, 'isFrozen', true); return this; } }); Ember.FROZEN_ERROR = "Frozen object cannot be modified."; })(); (function() { // ========================================================================== // Project: Ember Runtime // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== var forEach = Ember.ArrayUtils.forEach; /** @class This mixin defines the API for modifying generic enumerables. These methods can be applied to an object regardless of whether it is ordered or unordered. Note that an Enumerable can change even if it does not implement this mixin. For example, a MappedEnumerable cannot be directly modified but if its underlying enumerable changes, it will change also. ## Adding Objects To add an object to an enumerable, use the addObject() method. This method will only add the object to the enumerable if the object is not already present and the object if of a type supported by the enumerable. set.addObject(contact); ## Removing Objects To remove an object form an enumerable, use the removeObject() method. This will only remove the object if it is already in the enumerable, otherwise this method has no effect. set.removeObject(contact); ## Implementing In Your Own Code If you are implementing an object and want to support this API, just include this mixin in your class and implement the required methods. In your unit tests, be sure to apply the Ember.MutableEnumerableTests to your object. @extends Ember.Mixin @extends Ember.Enumerable */ Ember.MutableEnumerable = Ember.Mixin.create(Ember.Enumerable, /** @scope Ember.MutableEnumerable.prototype */ { /** __Required.__ You must implement this method to apply this mixin. Attempts to add the passed object to the receiver if the object is not already present in the collection. If the object is present, this method has no effect. If the passed object is of a type not supported by the receiver then this method should raise an exception. @param {Object} object The object to add to the enumerable. @returns {Object} the passed object */ addObject: Ember.required(Function), /** Adds each object in the passed enumerable to the receiver. @param {Ember.Enumerable} objects the objects to add. @returns {Object} receiver */ addObjects: function(objects) { Ember.beginPropertyChanges(this); forEach(objects, function(obj) { this.addObject(obj); }, this); Ember.endPropertyChanges(this); return this; }, /** __Required.__ You must implement this method to apply this mixin. Attempts to remove the passed object from the receiver collection if the object is in present in the collection. If the object is not present, this method has no effect. If the passed object is of a type not supported by the receiver then this method should raise an exception. @param {Object} object The object to remove from the enumerable. @returns {Object} the passed object */ removeObject: Ember.required(Function), /** Removes each objects in the passed enumerable from the receiver. @param {Ember.Enumerable} objects the objects to remove @returns {Object} receiver */ removeObjects: function(objects) { Ember.beginPropertyChanges(this); forEach(objects, function(obj) { this.removeObject(obj); }, this); Ember.endPropertyChanges(this); return this; } }); })(); (function() { // ========================================================================== // Project: Ember Runtime // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== // .......................................................... // CONSTANTS // var OUT_OF_RANGE_EXCEPTION = "Index out of range" ; var EMPTY = []; // .......................................................... // HELPERS // var get = Ember.get, set = Ember.set, forEach = Ember.ArrayUtils.forEach; /** @class This mixin defines the API for modifying array-like objects. These methods can be applied only to a collection that keeps its items in an ordered set. Note that an Array can change even if it does not implement this mixin. For example, one might implement a SparseArray that cannot be directly modified, but if its underlying enumerable changes, it will change also. @extends Ember.Mixin @extends Ember.Array @extends Ember.MutableEnumerable */ Ember.MutableArray = Ember.Mixin.create(Ember.Array, Ember.MutableEnumerable, /** @scope Ember.MutableArray.prototype */ { /** __Required.__ You must implement this method to apply this mixin. This is one of the primitives you must implement to support Ember.Array. You should replace amt objects started at idx with the objects in the passed array. You should also call this.enumerableContentDidChange() ; @param {Number} idx Starting index in the array to replace. If idx >= length, then append to the end of the array. @param {Number} amt Number of elements that should be removed from the array, starting at *idx*. @param {Array} objects An array of zero or more objects that should be inserted into the array at *idx* */ replace: Ember.required(), /** Remove all elements from self. This is useful if you want to reuse an existing array without having to recreate it. var colors = ["red", "green", "blue"]; color.length(); => 3 colors.clear(); => [] colors.length(); => 0 @returns {Ember.Array} An empty Array. */ clear: function () { var len = get(this, 'length'); if (len === 0) return this; this.replace(0, len, EMPTY); return this; }, /** This will use the primitive replace() method to insert an object at the specified index. var colors = ["red", "green", "blue"]; colors.insertAt(2, "yellow"); => ["red", "green", "yellow", "blue"] colors.insertAt(5, "orange"); => Error: Index out of range @param {Number} idx index of insert the object at. @param {Object} object object to insert */ insertAt: function(idx, object) { if (idx > get(this, 'length')) throw new Error(OUT_OF_RANGE_EXCEPTION) ; this.replace(idx, 0, [object]) ; return this ; }, /** Remove an object at the specified index using the replace() primitive method. You can pass either a single index, or a start and a length. If you pass a start and length that is beyond the length this method will throw an Ember.OUT_OF_RANGE_EXCEPTION var colors = ["red", "green", "blue", "yellow", "orange"]; colors.removeAt(0); => ["green", "blue", "yellow", "orange"] colors.removeAt(2, 2); => ["green", "blue"] colors.removeAt(4, 2); => Error: Index out of range @param {Number} start index, start of range @param {Number} len length of passing range @returns {Object} receiver */ removeAt: function(start, len) { var delta = 0; if ('number' === typeof start) { if ((start < 0) || (start >= get(this, 'length'))) { throw new Error(OUT_OF_RANGE_EXCEPTION); } // fast case if (len === undefined) len = 1; this.replace(start, len, EMPTY); } return this ; }, /** Push the object onto the end of the array. Works just like push() but it is KVO-compliant. var colors = ["red", "green", "blue"]; colors.pushObject("black"); => ["red", "green", "blue", "black"] colors.pushObject(["yellow", "orange"]); => ["red", "green", "blue", "black", ["yellow", "orange"]] */ pushObject: function(obj) { this.insertAt(get(this, 'length'), obj) ; return obj ; }, /** Add the objects in the passed numerable to the end of the array. Defers notifying observers of the change until all objects are added. var colors = ["red", "green", "blue"]; colors.pushObjects("black"); => ["red", "green", "blue", "black"] colors.pushObjects(["yellow", "orange"]); => ["red", "green", "blue", "black", "yellow", "orange"] @param {Ember.Enumerable} objects the objects to add @returns {Ember.Array} receiver */ pushObjects: function(objects) { this.replace(get(this, 'length'), 0, objects); return this; }, /** Pop object from array or nil if none are left. Works just like pop() but it is KVO-compliant. var colors = ["red", "green", "blue"]; colors.popObject(); => "blue" console.log(colors); => ["red", "green"] */ popObject: function() { var len = get(this, 'length') ; if (len === 0) return null ; var ret = this.objectAt(len-1) ; this.removeAt(len-1, 1) ; return ret ; }, /** Shift an object from start of array or nil if none are left. Works just like shift() but it is KVO-compliant. var colors = ["red", "green", "blue"]; colors.shiftObject(); => "red" console.log(colors); => ["green", "blue"] */ shiftObject: function() { if (get(this, 'length') === 0) return null ; var ret = this.objectAt(0) ; this.removeAt(0) ; return ret ; }, /** Unshift an object to start of array. Works just like unshift() but it is KVO-compliant. var colors = ["red", "green", "blue"]; colors.unshiftObject("yellow"); => ["yellow", "red", "green", "blue"] colors.unshiftObject(["black", "white"]); => [["black", "white"], "yellow", "red", "green", "blue"] */ unshiftObject: function(obj) { this.insertAt(0, obj) ; return obj ; }, /** Adds the named objects to the beginning of the array. Defers notifying observers until all objects have been added. var colors = ["red", "green", "blue"]; colors.unshiftObjects(["black", "white"]); => ["black", "white", "red", "green", "blue"] colors.unshiftObjects("yellow"); => Type Error: 'undefined' is not a function @param {Ember.Enumerable} objects the objects to add @returns {Ember.Array} receiver */ unshiftObjects: function(objects) { this.replace(0, 0, objects); return this; }, // .......................................................... // IMPLEMENT Ember.MutableEnumerable // /** @private (nodoc) */ removeObject: function(obj) { var loc = get(this, 'length') || 0; while(--loc >= 0) { var curObject = this.objectAt(loc) ; if (curObject === obj) this.removeAt(loc) ; } return this ; }, /** @private (nodoc) */ addObject: function(obj) { if (!this.contains(obj)) this.pushObject(obj); return this ; } }); })(); (function() { // ========================================================================== // Project: Ember Runtime // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== var get = Ember.get, set = Ember.set; /** @class ## Overview This mixin provides properties and property observing functionality, core features of the Ember object model. Properties and observers allow one object to observe changes to a property on another object. This is one of the fundamental ways that models, controllers and views communicate with each other in an Ember application. Any object that has this mixin applied can be used in observer operations. That includes Ember.Object and most objects you will interact with as you write your Ember application. Note that you will not generally apply this mixin to classes yourself, but you will use the features provided by this module frequently, so it is important to understand how to use it. ## Using get() and set() Because of Ember's support for bindings and observers, you will always access properties using the get method, and set properties using the set method. This allows the observing objects to be notified and computed properties to be handled properly. More documentation about `get` and `set` are below. ## Observing Property Changes You typically observe property changes simply by adding the `observes` call to the end of your method declarations in classes that you write. For example: Ember.Object.create({ valueObserver: function() { // Executes whenever the "value" property changes }.observes('value') }); Although this is the most common way to add an observer, this capability is actually built into the Ember.Object class on top of two methods defined in this mixin: `addObserver` and `removeObserver`. You can use these two methods to add and remove observers yourself if you need to do so at runtime. To add an observer for a property, call: object.addObserver('propertyKey', targetObject, targetAction) This will call the `targetAction` method on the `targetObject` to be called whenever the value of the `propertyKey` changes. Note that if `propertyKey` is a computed property, the observer will be called when any of the property dependencies are changed, even if the resulting value of the computed property is unchanged. This is necessary because computed properties are not computed until `get` is called. @extends Ember.Mixin */ Ember.Observable = Ember.Mixin.create(/** @scope Ember.Observable.prototype */ { /** @private - compatibility */ isObserverable: true, /** Retrieves the value of a property from the object. This method is usually similar to using object[keyName] or object.keyName, however it supports both computed properties and the unknownProperty handler. Because `get` unifies the syntax for accessing all these kinds of properties, it can make many refactorings easier, such as replacing a simple property with a computed property, or vice versa. ### Computed Properties Computed properties are methods defined with the `property` modifier declared at the end, such as: fullName: function() { return this.getEach('firstName', 'lastName').compact().join(' '); }.property('firstName', 'lastName') When you call `get` on a computed property, the function will be called and the return value will be returned instead of the function itself. ### Unknown Properties Likewise, if you try to call `get` on a property whose value is undefined, the unknownProperty() method will be called on the object. If this method returns any value other than undefined, it will be returned instead. This allows you to implement "virtual" properties that are not defined upfront. @param {String} key The property to retrieve @returns {Object} The property value or undefined. */ get: function(keyName) { return get(this, keyName); }, /** To get multiple properties at once, call getProperties with a list of strings or an array: record.getProperties('firstName', 'lastName', 'zipCode'); // => { firstName: 'John', lastName: 'Doe', zipCode: '10011' } is equivalent to: record.getProperties(['firstName', 'lastName', 'zipCode']); // => { firstName: 'John', lastName: 'Doe', zipCode: '10011' } @param {String...|Array} list of keys to get @returns {Hash} */ getProperties: function() { var ret = {}; var propertyNames = arguments; if (arguments.length === 1 && Ember.typeOf(arguments[0]) === 'array') { propertyNames = arguments[0]; } for(var i = 0; i < propertyNames.length; i++) { ret[propertyNames[i]] = get(this, propertyNames[i]); } return ret; }, /** Sets the key equal to value. This method is generally very similar to calling object[key] = value or object.key = value, except that it provides support for computed properties, the unknownProperty() method and property observers. ### Computed Properties If you try to set a value on a key that has a computed property handler defined (see the get() method for an example), then set() will call that method, passing both the value and key instead of simply changing the value itself. This is useful for those times when you need to implement a property that is composed of one or more member properties. ### Unknown Properties If you try to set a value on a key that is undefined in the target object, then the unknownProperty() handler will be called instead. This gives you an opportunity to implement complex "virtual" properties that are not predefined on the object. If unknownProperty() returns undefined, then set() will simply set the value on the object. ### Property Observers In addition to changing the property, set() will also register a property change with the object. Unless you have placed this call inside of a beginPropertyChanges() and endPropertyChanges(), any "local" observers (i.e. observer methods declared on the same object), will be called immediately. Any "remote" observers (i.e. observer methods declared on another object) will be placed in a queue and called at a later time in a coalesced manner. ### Chaining In addition to property changes, set() returns the value of the object itself so you can do chaining like this: record.set('firstName', 'Charles').set('lastName', 'Jolley'); @param {String} key The property to set @param {Object} value The value to set or null. @returns {Ember.Observable} */ set: function(keyName, value) { set(this, keyName, value); return this; }, /** To set multiple properties at once, call setProperties with a Hash: record.setProperties({ firstName: 'Charles', lastName: 'Jolley' }); @param {Hash} hash the hash of keys and values to set @returns {Ember.Observable} */ setProperties: function(hash) { return Ember.setProperties(this, hash); }, /** Begins a grouping of property changes. You can use this method to group property changes so that notifications will not be sent until the changes are finished. If you plan to make a large number of changes to an object at one time, you should call this method at the beginning of the changes to begin deferring change notifications. When you are done making changes, call endPropertyChanges() to deliver the deferred change notifications and end deferring. @returns {Ember.Observable} */ beginPropertyChanges: function() { Ember.beginPropertyChanges(); return this; }, /** Ends a grouping of property changes. You can use this method to group property changes so that notifications will not be sent until the changes are finished. If you plan to make a large number of changes to an object at one time, you should call beginPropertyChanges() at the beginning of the changes to defer change notifications. When you are done making changes, call this method to deliver the deferred change notifications and end deferring. @returns {Ember.Observable} */ endPropertyChanges: function() { Ember.endPropertyChanges(); return this; }, /** Notify the observer system that a property is about to change. Sometimes you need to change a value directly or indirectly without actually calling get() or set() on it. In this case, you can use this method and propertyDidChange() instead. Calling these two methods together will notify all observers that the property has potentially changed value. Note that you must always call propertyWillChange and propertyDidChange as a pair. If you do not, it may get the property change groups out of order and cause notifications to be delivered more often than you would like. @param {String} key The property key that is about to change. @returns {Ember.Observable} */ propertyWillChange: function(keyName){ Ember.propertyWillChange(this, keyName); return this; }, /** Notify the observer system that a property has just changed. Sometimes you need to change a value directly or indirectly without actually calling get() or set() on it. In this case, you can use this method and propertyWillChange() instead. Calling these two methods together will notify all observers that the property has potentially changed value. Note that you must always call propertyWillChange and propertyDidChange as a pair. If you do not, it may get the property change groups out of order and cause notifications to be delivered more often than you would like. @param {String} keyName The property key that has just changed. @returns {Ember.Observable} */ propertyDidChange: function(keyName) { Ember.propertyDidChange(this, keyName); return this; }, /** Convenience method to call `propertyWillChange` and `propertyDidChange` in succession. @param {String} keyName The property key to be notified about. @returns {Ember.Observable} */ notifyPropertyChange: function(keyName) { this.propertyWillChange(keyName); this.propertyDidChange(keyName); return this; }, /** Adds an observer on a property. This is the core method used to register an observer for a property. Once you call this method, anytime the key's value is set, your observer will be notified. Note that the observers are triggered anytime the value is set, regardless of whether it has actually changed. Your observer should be prepared to handle that. You can also pass an optional context parameter to this method. The context will be passed to your observer method whenever it is triggered. Note that if you add the same target/method pair on a key multiple times with different context parameters, your observer will only be called once with the last context you passed. ### Observer Methods Observer methods you pass should generally have the following signature if you do not pass a "context" parameter: fooDidChange: function(sender, key, value, rev); The sender is the object that changed. The key is the property that changes. The value property is currently reserved and unused. The rev is the last property revision of the object when it changed, which you can use to detect if the key value has really changed or not. If you pass a "context" parameter, the context will be passed before the revision like so: fooDidChange: function(sender, key, value, context, rev); Usually you will not need the value, context or revision parameters at the end. In this case, it is common to write observer methods that take only a sender and key value as parameters or, if you aren't interested in any of these values, to write an observer that has no parameters at all. @param {String} key The key to observer @param {Object} target The target object to invoke @param {String|Function} method The method to invoke. @returns {Ember.Object} self */ addObserver: function(key, target, method) { Ember.addObserver(this, key, target, method); }, /** Remove an observer you have previously registered on this object. Pass the same key, target, and method you passed to addObserver() and your target will no longer receive notifications. @param {String} key The key to observer @param {Object} target The target object to invoke @param {String|Function} method The method to invoke. @returns {Ember.Observable} receiver */ removeObserver: function(key, target, method) { Ember.removeObserver(this, key, target, method); }, /** Returns true if the object currently has observers registered for a particular key. You can use this method to potentially defer performing an expensive action until someone begins observing a particular property on the object. @param {String} key Key to check @returns {Boolean} */ hasObserverFor: function(key) { return Ember.hasListeners(this, key+':change'); }, /** This method will be called when a client attempts to get the value of a property that has not been defined in one of the typical ways. Override this method to create "virtual" properties. @param {String} key The name of the unknown property that was requested. @returns {Object} The property value or undefined. Default is undefined. */ unknownProperty: function(key) { return undefined; }, /** This method will be called when a client attempts to set the value of a property that has not been defined in one of the typical ways. Override this method to create "virtual" properties. @param {String} key The name of the unknown property to be set. @param {Object} value The value the unknown property is to be set to. */ setUnknownProperty: function(key, value) { this[key] = value; }, /** This is like `get`, but allows you to pass in a dot-separated property path. person.getPath('address.zip'); // return the zip person.getPath('children.firstObject.age'); // return the first kid's age This reads much better than chained `get` calls. @param {String} path The property path to retrieve @returns {Object} The property value or undefined. */ getPath: function(path) { return Ember.getPath(this, path); }, /** This is like `set`, but allows you to specify the property you want to set as a dot-separated property path. person.setPath('address.zip', 10011); // set the zip to 10011 person.setPath('children.firstObject.age', 6); // set the first kid's age to 6 This is not as commonly used as `getPath`, but it can be useful. @param {String} path The path to the property that will be set @param {Object} value The value to set or null. @returns {Ember.Observable} */ setPath: function(path, value) { Ember.setPath(this, path, value); return this; }, /** Retrieves the value of a property, or a default value in the case that the property returns undefined. person.getWithDefault('lastName', 'Doe'); @param {String} keyName The name of the property to retrieve @param {Object} defaultValue The value to return if the property value is undefined @returns {Object} The property value or the defaultValue. */ getWithDefault: function(keyName, defaultValue) { return Ember.getWithDefault(this, keyName, defaultValue); }, /** Set the value of a property to the current value plus some amount. person.incrementProperty('age'); team.incrementProperty('score', 2); @param {String} keyName The name of the property to increment @param {Object} increment The amount to increment by. Defaults to 1 @returns {Object} The new property value */ incrementProperty: function(keyName, increment) { if (!increment) { increment = 1; } set(this, keyName, (get(this, keyName) || 0)+increment); return get(this, keyName); }, /** Set the value of a property to the current value minus some amount. player.decrementProperty('lives'); orc.decrementProperty('health', 5); @param {String} keyName The name of the property to decrement @param {Object} increment The amount to decrement by. Defaults to 1 @returns {Object} The new property value */ decrementProperty: function(keyName, increment) { if (!increment) { increment = 1; } set(this, keyName, (get(this, keyName) || 0)-increment); return get(this, keyName); }, /** Set the value of a boolean property to the opposite of it's current value. starship.toggleProperty('warpDriveEnaged'); @param {String} keyName The name of the property to toggle @returns {Object} The new property value */ toggleProperty: function(keyName) { set(this, keyName, !get(this, keyName)); return get(this, keyName); }, /** Returns the cached value of a computed property, if it exists. This allows you to inspect the value of a computed property without accidentally invoking it if it is intended to be generated lazily. @param {String} keyName @returns {Object} The cached value of the computed property, if any */ cacheFor: function(keyName) { return Ember.cacheFor(this, keyName); }, /** @private - intended for debugging purposes */ observersForKey: function(keyName) { return Ember.observersFor(this, keyName); } }); })(); (function() { var get = Ember.get, set = Ember.set, getPath = Ember.getPath; Ember.TargetActionSupport = Ember.Mixin.create({ target: null, action: null, targetObject: Ember.computed(function() { var target = get(this, 'target'); if (Ember.typeOf(target) === "string") { var value = getPath(this, target); if (value === undefined) { value = getPath(window, target); } return value; } else { return target; } }).property('target').cacheable(), triggerAction: function() { var action = get(this, 'action'), target = get(this, 'targetObject'); if (target && action) { var ret; if (typeof target.send === 'function') { ret = target.send(action, this); } else { if (typeof action === 'string') { action = target[action]; } ret = action.call(target, this); } if (ret !== false) ret = true; return ret; } else { return false; } } }); })(); (function() { var get = Ember.get, set = Ember.set, a_slice = Array.prototype.slice; /** @private */ function xform(target, method, params) { var args = a_slice.call(params, 2); method.apply(target, args); } Ember.Evented = Ember.Mixin.create({ on: function(name, target, method) { if (!method) { method = target; target = null; } Ember.addListener(this, name, target, method, xform); }, fire: function(name) { Ember.sendEvent.apply(null, [this, name].concat(a_slice.call(arguments, 1))); }, off: function(name, target, method) { Ember.removeListener(this, name, target, method); } }); })(); (function() { // ========================================================================== // Project: Ember Runtime // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== })(); (function() { // ========================================================================== // Project: Ember Runtime // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== // NOTE: this object should never be included directly. Instead use Ember. // Ember.Object. We only define this separately so that Ember.Set can depend on it var rewatch = Ember.rewatch; var classToString = Ember.Mixin.prototype.toString; var set = Ember.set, get = Ember.get; var o_create = Ember.platform.create, o_defineProperty = Ember.platform.defineProperty, a_slice = Array.prototype.slice, meta = Ember.meta; /** @private */ function makeCtor() { // Note: avoid accessing any properties on the object since it makes the // method a lot faster. This is glue code so we want it to be as fast as // possible. var wasApplied = false, initMixins, init = false, hasChains = false; var Class = function() { if (!wasApplied) { Class.proto(); } // prepare prototype... if (initMixins) { this.reopen.apply(this, initMixins); initMixins = null; rewatch(this); // always rewatch just in case Ember.Mixin.finishPartial(this); this.init.apply(this, arguments); } else { if (hasChains) { rewatch(this); } else { Ember.GUID_DESC.value = undefined; o_defineProperty(this, Ember.GUID_KEY, Ember.GUID_DESC); } if (init===false) { init = this.init; } // cache for later instantiations Ember.GUID_DESC.value = undefined; o_defineProperty(this, '_super', Ember.GUID_DESC); Ember.Mixin.finishPartial(this); init.apply(this, arguments); } }; Class.toString = classToString; Class.willReopen = function() { if (wasApplied) { Class.PrototypeMixin = Ember.Mixin.create(Class.PrototypeMixin); } wasApplied = false; }; Class._initMixins = function(args) { initMixins = args; }; Class.proto = function() { var superclass = Class.superclass; if (superclass) { superclass.proto(); } if (!wasApplied) { wasApplied = true; Class.PrototypeMixin.applyPartial(Class.prototype); Ember.rewatch(Class.prototype); // setup watch chains if needed. hasChains = !!meta(Class.prototype, false).chains; // avoid rewatch } return this.prototype; }; return Class; } var CoreObject = makeCtor(); CoreObject.PrototypeMixin = Ember.Mixin.create( /** @scope Ember.CoreObject */ { reopen: function() { Ember.Mixin._apply(this, arguments, true); return this; }, isInstance: true, /** @private */ init: function() {}, /** @field */ isDestroyed: false, /** @field */ isDestroying: false, /** Destroys an object by setting the isDestroyed flag and removing its metadata, which effectively destroys observers and bindings. If you try to set a property on a destroyed object, an exception will be raised. Note that destruction is scheduled for the end of the run loop and does not happen immediately. @returns {Ember.Object} receiver */ destroy: function() { if (this.isDestroying) { return; } this.isDestroying = true; if (this.willDestroy) { this.willDestroy(); } set(this, 'isDestroyed', true); Ember.run.schedule('destroy', this, this._scheduledDestroy); return this; }, /** Invoked by the run loop to actually destroy the object. This is scheduled for execution by the `destroy` method. @private */ _scheduledDestroy: function() { Ember.destroy(this); if (this.didDestroy) { this.didDestroy(); } }, bind: function(to, from) { if (!(from instanceof Ember.Binding)) { from = Ember.Binding.from(from); } from.to(to).connect(this); return from; }, toString: function() { return '<'+this.constructor.toString()+':'+Ember.guidFor(this)+'>'; } }); CoreObject.__super__ = null; var ClassMixin = Ember.Mixin.create({ ClassMixin: Ember.required(), PrototypeMixin: Ember.required(), isClass: true, isMethod: false, extend: function() { var Class = makeCtor(), proto; Class.ClassMixin = Ember.Mixin.create(this.ClassMixin); Class.PrototypeMixin = Ember.Mixin.create(this.PrototypeMixin); Class.ClassMixin.ownerConstructor = Class; Class.PrototypeMixin.ownerConstructor = Class; var PrototypeMixin = Class.PrototypeMixin; PrototypeMixin.reopen.apply(PrototypeMixin, arguments); Class.superclass = this; Class.__super__ = this.prototype; proto = Class.prototype = o_create(this.prototype); proto.constructor = Class; Ember.generateGuid(proto, 'ember'); meta(proto).proto = proto; // this will disable observers on prototype Class.subclasses = Ember.Set ? new Ember.Set() : null; if (this.subclasses) { this.subclasses.add(Class); } Class.ClassMixin.apply(Class); return Class; }, create: function() { var C = this; if (arguments.length>0) { this._initMixins(arguments); } return new C(); }, reopen: function() { this.willReopen(); var PrototypeMixin = this.PrototypeMixin; PrototypeMixin.reopen.apply(PrototypeMixin, arguments); return this; }, reopenClass: function() { var ClassMixin = this.ClassMixin; ClassMixin.reopen.apply(ClassMixin, arguments); Ember.Mixin._apply(this, arguments, false); return this; }, detect: function(obj) { if ('function' !== typeof obj) { return false; } while(obj) { if (obj===this) { return true; } obj = obj.superclass; } return false; }, detectInstance: function(obj) { return obj instanceof this; }, /** In some cases, you may want to annotate computed properties with additional metadata about how they function or what values they operate on. For example, computed property functions may close over variables that are then no longer available for introspection. You can pass a hash of these values to a computed property like this: person: function() { var personId = this.get('personId'); return App.Person.create({ id: personId }); }.property().meta({ type: App.Person }) Once you've done this, you can retrieve the values saved to the computed property from your class like this: MyClass.metaForProperty('person'); This will return the original hash that was passed to `meta()`. */ metaForProperty: function(key) { var desc = meta(this.proto(), false).descs[key]; return desc._meta || {}; }, /** Iterate over each computed property for the class, passing its name and any associated metadata (see `metaForProperty`) to the callback. */ eachComputedProperty: function(callback, binding) { var proto = this.proto(), descs = meta(proto).descs, empty = {}, property; for (var name in descs) { property = descs[name]; if (property instanceof Ember.ComputedProperty) { callback.call(binding || this, name, property._meta || empty); } } } }); CoreObject.ClassMixin = ClassMixin; ClassMixin.apply(CoreObject); /** @class */ Ember.CoreObject = CoreObject; })(); (function() { // ========================================================================== // Project: Ember Runtime // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== var get = Ember.get, set = Ember.set, guidFor = Ember.guidFor, none = Ember.none; /** @class An unordered collection of objects. A Set works a bit like an array except that its items are not ordered. You can create a set to efficiently test for membership for an object. You can also iterate through a set just like an array, even accessing objects by index, however there is no guarantee as to their order. All Sets are observable via the Enumerable Observer API - which works on any enumerable object including both Sets and Arrays. ## Creating a Set You can create a set like you would most objects using `new Ember.Set()`. Most new sets you create will be empty, but you can also initialize the set with some content by passing an array or other enumerable of objects to the constructor. Finally, you can pass in an existing set and the set will be copied. You can also create a copy of a set by calling `Ember.Set#copy()`. #js // creates a new empty set var foundNames = new Ember.Set(); // creates a set with four names in it. var names = new Ember.Set(["Charles", "Tom", "Juan", "Alex"]); // :P // creates a copy of the names set. var namesCopy = new Ember.Set(names); // same as above. var anotherNamesCopy = names.copy(); ## Adding/Removing Objects You generally add or remove objects from a set using `add()` or `remove()`. You can add any type of object including primitives such as numbers, strings, and booleans. Unlike arrays, objects can only exist one time in a set. If you call `add()` on a set with the same object multiple times, the object will only be added once. Likewise, calling `remove()` with the same object multiple times will remove the object the first time and have no effect on future calls until you add the object to the set again. NOTE: You cannot add/remove null or undefined to a set. Any attempt to do so will be ignored. In addition to add/remove you can also call `push()`/`pop()`. Push behaves just like `add()` but `pop()`, unlike `remove()` will pick an arbitrary object, remove it and return it. This is a good way to use a set as a job queue when you don't care which order the jobs are executed in. ## Testing for an Object To test for an object's presence in a set you simply call `Ember.Set#contains()`. ## Observing changes When using `Ember.Set`, you can observe the `"[]"` property to be alerted whenever the content changes. You can also add an enumerable observer to the set to be notified of specific objects that are added and removed from the set. See `Ember.Enumerable` for more information on enumerables. This is often unhelpful. If you are filtering sets of objects, for instance, it is very inefficient to re-filter all of the items each time the set changes. It would be better if you could just adjust the filtered set based on what was changed on the original set. The same issue applies to merging sets, as well. ## Other Methods `Ember.Set` primary implements other mixin APIs. For a complete reference on the methods you will use with `Ember.Set`, please consult these mixins. The most useful ones will be `Ember.Enumerable` and `Ember.MutableEnumerable` which implement most of the common iterator methods you are used to on Array. Note that you can also use the `Ember.Copyable` and `Ember.Freezable` APIs on `Ember.Set` as well. Once a set is frozen it can no longer be modified. The benefit of this is that when you call frozenCopy() on it, Ember will avoid making copies of the set. This allows you to write code that can know with certainty when the underlying set data will or will not be modified. @extends Ember.Enumerable @extends Ember.MutableEnumerable @extends Ember.Copyable @extends Ember.Freezable @since Ember 0.9 */ Ember.Set = Ember.CoreObject.extend(Ember.MutableEnumerable, Ember.Copyable, Ember.Freezable, /** @scope Ember.Set.prototype */ { // .......................................................... // IMPLEMENT ENUMERABLE APIS // /** This property will change as the number of objects in the set changes. @property Number @default 0 */ length: 0, /** Clears the set. This is useful if you want to reuse an existing set without having to recreate it. var colors = new Ember.Set(["red", "green", "blue"]); colors.length; => 3 colors.clear(); colors.length; => 0 @returns {Ember.Set} An empty Set */ clear: function() { if (this.isFrozen) { throw new Error(Ember.FROZEN_ERROR); } var len = get(this, 'length'); if (len === 0) { return this; } var guid; this.enumerableContentWillChange(len, 0); Ember.propertyWillChange(this, 'firstObject'); Ember.propertyWillChange(this, 'lastObject'); for (var i=0; i < len; i++){ guid = guidFor(this[i]); delete this[guid]; delete this[i]; } set(this, 'length', 0); Ember.propertyDidChange(this, 'firstObject'); Ember.propertyDidChange(this, 'lastObject'); this.enumerableContentDidChange(len, 0); return this; }, /** Returns true if the passed object is also an enumerable that contains the same objects as the receiver. var colors = ["red", "green", "blue"], same_colors = new Ember.Set(colors); same_colors.isEqual(colors); => true same_colors.isEqual(["purple", "brown"]); => false @param {Ember.Set} obj the other object. @returns {Boolean} */ isEqual: function(obj) { // fail fast if (!Ember.Enumerable.detect(obj)) return false; var loc = get(this, 'length'); if (get(obj, 'length') !== loc) return false; while(--loc >= 0) { if (!obj.contains(this[loc])) return false; } return true; }, /** Adds an object to the set. Only non-null objects can be added to a set and those can only be added once. If the object is already in the set or the passed value is null this method will have no effect. This is an alias for `Ember.MutableEnumerable.addObject()`. var colors = new Ember.Set(); colors.add("blue"); => ["blue"] colors.add("blue"); => ["blue"] colors.add("red"); => ["blue", "red"] colors.add(null); => ["blue", "red"] colors.add(undefined); => ["blue", "red"] @function @param {Object} obj The object to add. @returns {Ember.Set} The set itself. */ add: Ember.alias('addObject'), /** Removes the object from the set if it is found. If you pass a null value or an object that is already not in the set, this method will have no effect. This is an alias for `Ember.MutableEnumerable.removeObject()`. var colors = new Ember.Set(["red", "green", "blue"]); colors.remove("red"); => ["blue", "green"] colors.remove("purple"); => ["blue", "green"] colors.remove(null); => ["blue", "green"] @function @param {Object} obj The object to remove @returns {Ember.Set} The set itself. */ remove: Ember.alias('removeObject'), /** Removes the last element from the set and returns it, or null if it's empty. var colors = new Ember.Set(["green", "blue"]); colors.pop(); => "blue" colors.pop(); => "green" colors.pop(); => null @returns {Object} The removed object from the set or null. */ pop: function() { if (get(this, 'isFrozen')) throw new Error(Ember.FROZEN_ERROR); var obj = this.length > 0 ? this[this.length-1] : null; this.remove(obj); return obj; }, /** Inserts the given object on to the end of the set. It returns the set itself. This is an alias for `Ember.MutableEnumerable.addObject()`. var colors = new Ember.Set(); colors.push("red"); => ["red"] colors.push("green"); => ["red", "green"] colors.push("blue"); => ["red", "green", "blue"] @function @returns {Ember.Set} The set itself. */ push: Ember.alias('addObject'), /** Removes the last element from the set and returns it, or null if it's empty. This is an alias for `Ember.Set.pop()`. var colors = new Ember.Set(["green", "blue"]); colors.shift(); => "blue" colors.shift(); => "green" colors.shift(); => null @function @returns {Object} The removed object from the set or null. */ shift: Ember.alias('pop'), /** Inserts the given object on to the end of the set. It returns the set itself. This is an alias of `Ember.Set.push()` var colors = new Ember.Set(); colors.unshift("red"); => ["red"] colors.unshift("green"); => ["red", "green"] colors.unshift("blue"); => ["red", "green", "blue"] @function @returns {Ember.Set} The set itself. */ unshift: Ember.alias('push'), /** Adds each object in the passed enumerable to the set. This is an alias of `Ember.MutableEnumerable.addObjects()` var colors = new Ember.Set(); colors.addEach(["red", "green", "blue"]); => ["red", "green", "blue"] @function @param {Ember.Enumerable} objects the objects to add. @returns {Ember.Set} The set itself. */ addEach: Ember.alias('addObjects'), /** Removes each object in the passed enumerable to the set. This is an alias of `Ember.MutableEnumerable.removeObjects()` var colors = new Ember.Set(["red", "green", "blue"]); colors.removeEach(["red", "blue"]); => ["green"] @function @param {Ember.Enumerable} objects the objects to remove. @returns {Ember.Set} The set itself. */ removeEach: Ember.alias('removeObjects'), // .......................................................... // PRIVATE ENUMERABLE SUPPORT // /** @private */ init: function(items) { this._super(); if (items) this.addObjects(items); }, /** @private (nodoc) - implement Ember.Enumerable */ nextObject: function(idx) { return this[idx]; }, /** @private - more optimized version */ firstObject: Ember.computed(function() { return this.length > 0 ? this[0] : undefined; }).property().cacheable(), /** @private - more optimized version */ lastObject: Ember.computed(function() { return this.length > 0 ? this[this.length-1] : undefined; }).property().cacheable(), /** @private (nodoc) - implements Ember.MutableEnumerable */ addObject: function(obj) { if (get(this, 'isFrozen')) throw new Error(Ember.FROZEN_ERROR); if (none(obj)) return this; // nothing to do var guid = guidFor(obj), idx = this[guid], len = get(this, 'length'), added ; if (idx>=0 && idx=0 && idx=0; }, /** @private (nodoc) */ copy: function() { var C = this.constructor, ret = new C(), loc = get(this, 'length'); set(ret, 'length', loc); while(--loc>=0) { ret[loc] = this[loc]; ret[guidFor(this[loc])] = loc; } return ret; }, /** @private */ toString: function() { var len = this.length, idx, array = []; for(idx = 0; idx < len; idx++) { array[idx] = this[idx]; } return "Ember.Set<%@>".fmt(array.join(',')); } }); })(); (function() { // ========================================================================== // Project: Ember Runtime // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== Ember.CoreObject.subclasses = new Ember.Set(); /** @class @extends Ember.CoreObject @extends Ember.Observable */ Ember.Object = Ember.CoreObject.extend(Ember.Observable); })(); (function() { // ========================================================================== // Project: Ember Runtime // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== var indexOf = Ember.ArrayUtils.indexOf; /** @private A Namespace is an object usually used to contain other objects or methods such as an application or framework. Create a namespace anytime you want to define one of these new containers. # Example Usage MyFramework = Ember.Namespace.create({ VERSION: '1.0.0' }); */ Ember.Namespace = Ember.Object.extend({ isNamespace: true, init: function() { Ember.Namespace.NAMESPACES.push(this); Ember.Namespace.PROCESSED = false; }, toString: function() { Ember.identifyNamespaces(); return this[Ember.GUID_KEY+'_name']; }, destroy: function() { var namespaces = Ember.Namespace.NAMESPACES; window[this.toString()] = undefined; namespaces.splice(indexOf(namespaces, this), 1); this._super(); } }); Ember.Namespace.NAMESPACES = [Ember]; Ember.Namespace.PROCESSED = false; })(); (function() { // ========================================================================== // Project: Ember Runtime // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== /** @private Defines a namespace that will contain an executable application. This is very similar to a normal namespace except that it is expected to include at least a 'ready' function which can be run to initialize the application. Currently Ember.Application is very similar to Ember.Namespace. However, this class may be augmented by additional frameworks so it is important to use this instance when building new applications. # Example Usage MyApp = Ember.Application.create({ VERSION: '1.0.0', store: Ember.Store.create().from(Ember.fixtures) }); MyApp.ready = function() { //..init code goes here... } */ Ember.Application = Ember.Namespace.extend(); })(); (function() { // ========================================================================== // Project: Ember Runtime // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== var get = Ember.get, set = Ember.set; /** @class An ArrayProxy wraps any other object that implements Ember.Array and/or Ember.MutableArray, forwarding all requests. This makes it very useful for a number of binding use cases or other cases where being able to swap out the underlying array is useful. A simple example of usage: var pets = ['dog', 'cat', 'fish']; var ap = Ember.ArrayProxy.create({ content: Ember.A(pets) }); ap.get('firstObject'); // => 'dog' ap.set('content', ['amoeba', 'paramecium']); ap.get('firstObject'); // => 'amoeba' This class can also be useful as a layer to transform the contents of an array, as they are accessed. This can be done by overriding `objectAtContent`: var pets = ['dog', 'cat', 'fish']; var ap = Ember.ArrayProxy.create({ content: Ember.A(pets), objectAtContent: function(idx) { return this.get('content').objectAt(idx).toUpperCase(); } }); ap.get('firstObject'); // => 'DOG' @extends Ember.Object @extends Ember.Array @extends Ember.MutableArray */ Ember.ArrayProxy = Ember.Object.extend(Ember.MutableArray, /** @scope Ember.ArrayProxy.prototype */ { /** The content array. Must be an object that implements Ember.Array and/or Ember.MutableArray. @property {Ember.Array} */ content: null, /** Should actually retrieve the object at the specified index from the content. You can override this method in subclasses to transform the content item to something new. This method will only be called if content is non-null. @param {Number} idx The index to retrieve. @returns {Object} the value or undefined if none found */ objectAtContent: function(idx) { return get(this, 'content').objectAt(idx); }, /** Should actually replace the specified objects on the content array. You can override this method in subclasses to transform the content item into something new. This method will only be called if content is non-null. @param {Number} idx The starting index @param {Number} amt The number of items to remove from the content. @param {Array} objects Optional array of objects to insert or null if no objects. @returns {void} */ replaceContent: function(idx, amt, objects) { get(this, 'content').replace(idx, amt, objects); }, /** Invoked when the content property is about to change. Notifies observers that the entire array content will change. */ contentWillChange: Ember.beforeObserver(function() { var content = get(this, 'content'), len = content ? get(content, 'length') : 0; this.arrayWillChange(content, 0, len, undefined); if (content) content.removeArrayObserver(this); }, 'content'), /** Invoked when the content property changes. Notifies observers that the entire array content has changed. */ contentDidChange: Ember.observer(function() { var content = get(this, 'content'), len = content ? get(content, 'length') : 0; if (content) content.addArrayObserver(this); this.arrayDidChange(content, 0, undefined, len); }, 'content'), /** @private (nodoc) */ objectAt: function(idx) { return get(this, 'content') && this.objectAtContent(idx); }, /** @private (nodoc) */ length: Ember.computed(function() { var content = get(this, 'content'); return content ? get(content, 'length') : 0; // No dependencies since Enumerable notifies length of change }).property().cacheable(), /** @private (nodoc) */ replace: function(idx, amt, objects) { if (get(this, 'content')) this.replaceContent(idx, amt, objects); return this; }, /** @private (nodoc) */ arrayWillChange: function(item, idx, removedCnt, addedCnt) { this.arrayContentWillChange(idx, removedCnt, addedCnt); }, /** @private (nodoc) */ arrayDidChange: function(item, idx, removedCnt, addedCnt) { this.arrayContentDidChange(idx, removedCnt, addedCnt); }, /** @private (nodoc) */ init: function() { this._super(); this.contentWillChange(); this.contentDidChange(); } }); })(); (function() { // ========================================================================== // Project: Ember Runtime // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== var set = Ember.set, get = Ember.get, guidFor = Ember.guidFor; var forEach = Ember.ArrayUtils.forEach; var EachArray = Ember.Object.extend(Ember.Array, { init: function(content, keyName, owner) { this._super(); this._keyName = keyName; this._owner = owner; this._content = content; }, objectAt: function(idx) { var item = this._content.objectAt(idx); return item && get(item, this._keyName); }, length: Ember.computed(function() { var content = this._content; return content ? get(content, 'length') : 0; }).property().cacheable() }); var IS_OBSERVER = /^.+:(before|change)$/; /** @private */ function addObserverForContentKey(content, keyName, proxy, idx, loc) { var objects = proxy._objects, guid; if (!objects) objects = proxy._objects = {}; while(--loc>=idx) { var item = content.objectAt(loc); if (item) { Ember.addBeforeObserver(item, keyName, proxy, 'contentKeyWillChange'); Ember.addObserver(item, keyName, proxy, 'contentKeyDidChange'); // keep track of the indicies each item was found at so we can map // it back when the obj changes. guid = guidFor(item); if (!objects[guid]) objects[guid] = []; objects[guid].push(loc); } } } /** @private */ function removeObserverForContentKey(content, keyName, proxy, idx, loc) { var objects = proxy._objects; if (!objects) objects = proxy._objects = {}; var indicies, guid; while(--loc>=idx) { var item = content.objectAt(loc); if (item) { Ember.removeBeforeObserver(item, keyName, proxy, 'contentKeyWillChange'); Ember.removeObserver(item, keyName, proxy, 'contentKeyDidChange'); guid = guidFor(item); indicies = objects[guid]; indicies[indicies.indexOf(loc)] = null; } } } /** @private @class This is the object instance returned when you get the @each property on an array. It uses the unknownProperty handler to automatically create EachArray instances for property names. @extends Ember.Object */ Ember.EachProxy = Ember.Object.extend({ init: function(content) { this._super(); this._content = content; content.addArrayObserver(this); // in case someone is already observing some keys make sure they are // added forEach(Ember.watchedEvents(this), function(eventName) { this.didAddListener(eventName); }, this); }, /** You can directly access mapped properties by simply requesting them. The unknownProperty handler will generate an EachArray of each item. */ unknownProperty: function(keyName, value) { var ret; ret = new EachArray(this._content, keyName, this); new Ember.Descriptor().setup(this, keyName, ret); this.beginObservingContentKey(keyName); return ret; }, // .......................................................... // ARRAY CHANGES // Invokes whenever the content array itself changes. arrayWillChange: function(content, idx, removedCnt, addedCnt) { var keys = this._keys, key, array, lim; lim = removedCnt>0 ? idx+removedCnt : -1; Ember.beginPropertyChanges(this); for(key in keys) { if (!keys.hasOwnProperty(key)) { continue; } if (lim>0) removeObserverForContentKey(content, key, this, idx, lim); Ember.propertyWillChange(this, key); } Ember.propertyWillChange(this._content, '@each'); Ember.endPropertyChanges(this); }, arrayDidChange: function(content, idx, removedCnt, addedCnt) { var keys = this._keys, key, array, lim; lim = addedCnt>0 ? idx+addedCnt : -1; Ember.beginPropertyChanges(this); for(key in keys) { if (!keys.hasOwnProperty(key)) { continue; } if (lim>0) addObserverForContentKey(content, key, this, idx, lim); Ember.propertyDidChange(this, key); } Ember.propertyDidChange(this._content, '@each'); Ember.endPropertyChanges(this); }, // .......................................................... // LISTEN FOR NEW OBSERVERS AND OTHER EVENT LISTENERS // Start monitoring keys based on who is listening... didAddListener: function(eventName) { if (IS_OBSERVER.test(eventName)) { this.beginObservingContentKey(eventName.slice(0, -7)); } }, didRemoveListener: function(eventName) { if (IS_OBSERVER.test(eventName)) { this.stopObservingContentKey(eventName.slice(0, -7)); } }, // .......................................................... // CONTENT KEY OBSERVING // Actual watch keys on the source content. beginObservingContentKey: function(keyName) { var keys = this._keys; if (!keys) keys = this._keys = {}; if (!keys[keyName]) { keys[keyName] = 1; var content = this._content, len = get(content, 'length'); addObserverForContentKey(content, keyName, this, 0, len); } else { keys[keyName]++; } }, stopObservingContentKey: function(keyName) { var keys = this._keys; if (keys && (keys[keyName]>0) && (--keys[keyName]<=0)) { var content = this._content, len = get(content, 'length'); removeObserverForContentKey(content, keyName, this, 0, len); } }, contentKeyWillChange: function(obj, keyName) { Ember.propertyWillChange(this, keyName); }, contentKeyDidChange: function(obj, keyName) { Ember.propertyDidChange(this, keyName); } }); })(); (function() { // ========================================================================== // Project: Ember Runtime // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== var get = Ember.get, set = Ember.set; // Add Ember.Array to Array.prototype. Remove methods with native // implementations and supply some more optimized versions of generic methods // because they are so common. var NativeArray = Ember.Mixin.create(Ember.MutableArray, Ember.Observable, Ember.Copyable, { // because length is a built-in property we need to know to just get the // original property. get: function(key) { if (key==='length') return this.length; else if ('number' === typeof key) return this[key]; else return this._super(key); }, objectAt: function(idx) { return this[idx]; }, // primitive for array support. replace: function(idx, amt, objects) { if (this.isFrozen) throw Ember.FROZEN_ERROR ; // if we replaced exactly the same number of items, then pass only the // replaced range. Otherwise, pass the full remaining array length // since everything has shifted var len = objects ? get(objects, 'length') : 0; this.arrayContentWillChange(idx, amt, len); if (!objects || objects.length === 0) { this.splice(idx, amt) ; } else { var args = [idx, amt].concat(objects) ; this.splice.apply(this,args) ; } this.arrayContentDidChange(idx, amt, len); return this ; }, // If you ask for an unknown property, then try to collect the value // from member items. unknownProperty: function(key, value) { var ret;// = this.reducedProperty(key, value) ; if ((value !== undefined) && ret === undefined) { ret = this[key] = value; } return ret ; }, // If browser did not implement indexOf natively, then override with // specialized version indexOf: function(object, startAt) { var idx, len = this.length; if (startAt === undefined) startAt = 0; else startAt = (startAt < 0) ? Math.ceil(startAt) : Math.floor(startAt); if (startAt < 0) startAt += len; for(idx=startAt;idx=0;idx--) { if (this[idx] === object) return idx ; } return -1; }, copy: function() { return this.slice(); } }); // Remove any methods implemented natively so we don't override them var ignore = ['length']; Ember.ArrayUtils.forEach(NativeArray.keys(), function(methodName) { if (Array.prototype[methodName]) ignore.push(methodName); }); if (ignore.length>0) { NativeArray = NativeArray.without.apply(NativeArray, ignore); } /** The NativeArray mixin contains the properties needed to to make the native Array support Ember.MutableArray and all of its dependent APIs. Unless you have Ember.EXTEND_PROTOTYPES set to false, this will be applied automatically. Otherwise you can apply the mixin at anytime by calling `Ember.NativeArray.activate`. @namespace @extends Ember.MutableArray @extends Ember.Array @extends Ember.Enumerable @extends Ember.MutableEnumerable @extends Ember.Copyable @extends Ember.Freezable */ Ember.NativeArray = NativeArray; /** Creates an Ember.NativeArray from an Array like object. Does not modify the original object. @returns {Ember.NativeArray} */ Ember.A = function(arr){ if (arr === undefined) { arr = []; } return Ember.NativeArray.apply(arr); }; /** Activates the mixin on the Array.prototype if not already applied. Calling this method more than once is safe. @returns {void} */ Ember.NativeArray.activate = function() { NativeArray.apply(Array.prototype); Ember.A = function(arr) { return arr || []; }; }; if (Ember.EXTEND_PROTOTYPES) Ember.NativeArray.activate(); })(); (function() { /** JavaScript (before ES6) does not have a Map implementation. Objects, which are often used as dictionaries, may only have Strings as keys. Because Ember has a way to get a unique identifier for every object via `Ember.guidFor`, we can implement a performant Map with arbitrary keys. Because it is commonly used in low-level bookkeeping, Map is implemented as a pure JavaScript object for performance. This implementation follows the current iteration of the ES6 proposal for maps (http://wiki.ecmascript.org/doku.php?id=harmony:simple_maps_and_sets), with two exceptions. First, because we need our implementation to be pleasant on older browsers, we do not use the `delete` name (using `remove` instead). Second, as we do not have the luxury of in-VM iteration, we implement a forEach method for iteration. Map is mocked out to look like an Ember object, so you can do `Ember.Map.create()` for symmetry with other Ember classes. */ /** @private */ var guidFor = Ember.guidFor; var indexOf = Ember.ArrayUtils.indexOf; // This class is used internally by Ember.js and Ember Data. // Please do not use it at this time. We plan to clean it up // and add many tests soon. var OrderedSet = Ember.OrderedSet = function() { this.clear(); }; OrderedSet.create = function() { return new OrderedSet(); }; OrderedSet.prototype = { clear: function() { this.presenceSet = {}; this.list = []; }, add: function(obj) { var guid = guidFor(obj), presenceSet = this.presenceSet, list = this.list; if (guid in presenceSet) { return; } presenceSet[guid] = true; list.push(obj); }, remove: function(obj) { var guid = guidFor(obj), presenceSet = this.presenceSet, list = this.list; delete presenceSet[guid]; var index = indexOf(list, obj); if (index > -1) { list.splice(index, 1); } }, isEmpty: function() { return this.list.length === 0; }, forEach: function(fn, self) { // allow mutation during iteration var list = this.list.slice(); for (var i = 0, j = list.length; i < j; i++) { fn.call(self, list[i]); } }, toArray: function() { return this.list.slice(); } }; /** A Map stores values indexed by keys. Unlike JavaScript's default Objects, the keys of a Map can be any JavaScript object. Internally, a Map has two data structures: `keys`: an OrderedSet of all of the existing keys `values`: a JavaScript Object indexed by the Ember.guidFor(key) When a key/value pair is added for the first time, we add the key to the `keys` OrderedSet, and create or replace an entry in `values`. When an entry is deleted, we delete its entry in `keys` and `values`. */ /** @private */ var Map = Ember.Map = function() { this.keys = Ember.OrderedSet.create(); this.values = {}; }; Map.create = function() { return new Map(); }; Map.prototype = { /** Retrieve the value associated with a given key. @param {anything} key @return {anything} the value associated with the key, or undefined */ get: function(key) { var values = this.values, guid = guidFor(key); return values[guid]; }, /** Adds a value to the map. If a value for the given key has already been provided, the new value will replace the old value. @param {anything} key @param {anything} value */ set: function(key, value) { var keys = this.keys, values = this.values, guid = guidFor(key); keys.add(key); values[guid] = value; }, /** Removes a value from the map for an associated key. @param {anything} key @returns {Boolean} true if an item was removed, false otherwise */ remove: function(key) { // don't use ES6 "delete" because it will be annoying // to use in browsers that are not ES6 friendly; var keys = this.keys, values = this.values, guid = guidFor(key), value; if (values.hasOwnProperty(guid)) { keys.remove(key); value = values[guid]; delete values[guid]; return true; } else { return false; } }, /** Check whether a key is present. @param {anything} key @returns {Boolean} true if the item was present, false otherwise */ has: function(key) { var values = this.values, guid = guidFor(key); return values.hasOwnProperty(guid); }, /** Iterate over all the keys and values. Calls the function once for each key, passing in the key and value, in that order. The keys are guaranteed to be iterated over in insertion order. @param {Function} callback @param {anything} self if passed, the `this` value inside the callback. By default, `this` is the map. */ forEach: function(callback, self) { var keys = this.keys, values = this.values; keys.forEach(function(key) { var guid = guidFor(key); callback.call(self, key, values[guid]); }); } }; })(); (function() { var loadHooks = {}; var loaded = {}; Ember.onLoad = function(name, callback) { var object; loadHooks[name] = loadHooks[name] || Ember.A(); loadHooks[name].pushObject(callback); if (object = loaded[name]) { callback(object); } }; Ember.runLoadHooks = function(name, object) { var hooks; loaded[name] = object; if (hooks = loadHooks[name]) { loadHooks[name].forEach(function(callback) { callback(object); }); } }; })(); (function() { // ========================================================================== // Project: Ember Runtime // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== })(); (function() { // ========================================================================== // Project: Ember Runtime // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== /** @class Ember.ArrayController provides a way for you to publish a collection of objects so that you can easily bind to the collection from a Handlebars #each helper, an Ember.CollectionView, or other controllers. The advantage of using an ArrayController is that you only have to set up your view bindings once; to change what's displayed, simply swap out the `content` property on the controller. For example, imagine you wanted to display a list of items fetched via an XHR request. Create an Ember.ArrayController and set its `content` property: MyApp.listController = Ember.ArrayController.create(); $.get('people.json', function(data) { MyApp.listController.set('content', data); }); Then, create a view that binds to your new controller: {{#each MyApp.listController}} {{firstName}} {{lastName}} {{/each}} Although you are binding to the controller, the behavior of this controller is to pass through any methods or properties to the underlying array. This capability comes from `Ember.ArrayProxy`, which this class inherits from. Note: As of this writing, `ArrayController` does not add any functionality to its superclass, `ArrayProxy`. The Ember team plans to add additional controller-specific functionality in the future, e.g. single or multiple selection support. If you are creating something that is conceptually a controller, use this class. @extends Ember.ArrayProxy */ Ember.ArrayController = Ember.ArrayProxy.extend(); })(); (function() { })(); (function() { // ========================================================================== // Project: Ember Runtime // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== })();