// Version: v1.0.0-rc.2-2-gd22a11b // Last commit: d22a11b (2013-07-25 20:15:17 -0400) (function() { /*global __fail__*/ /** Ember Debug @module ember @submodule ember-debug */ /** @class Ember */ if ('undefined' === typeof Ember) { Ember = {}; if ('undefined' !== typeof window) { window.Em = window.Ember = Em = Ember; } } Ember.ENV = 'undefined' === typeof ENV ? {} : ENV; if (!('MANDATORY_SETTER' in Ember.ENV)) { Ember.ENV.MANDATORY_SETTER = true; // default to true for debug dist } /** Define an assertion that will throw an exception if the condition is not met. Ember build tools will remove any calls to `Ember.assert()` when doing a production build. Example: ```javascript // Test for truthiness Ember.assert('Must pass a valid object', obj); // Fail unconditionally Ember.assert('This code path should never be run') ``` @method assert @param {String} desc A description of the assertion. This will become the text of the Error thrown if the assertion fails. @param {Boolean} test Must be truthy for the assertion to pass. If falsy, an exception will be thrown. */ Ember.assert = function(desc, test) { if (!test) throw new Error("assertion failed: "+desc); }; /** Display a warning with the provided message. Ember build tools will remove any calls to `Ember.warn()` when doing a production build. @method warn @param {String} message A warning to display. @param {Boolean} test An optional boolean. If falsy, the warning will be displayed. */ Ember.warn = function(message, test) { if (!test) { Ember.Logger.warn("WARNING: "+message); if ('trace' in Ember.Logger) Ember.Logger.trace(); } }; /** Display a debug notice. Ember build tools will remove any calls to `Ember.debug()` when doing a production build. ```javascript Ember.debug("I'm a debug notice!"); ``` @method debug @param {String} message A debug message to display. */ Ember.debug = function(message) { Ember.Logger.debug("DEBUG: "+message); }; /** Display a deprecation warning with the provided message and a stack trace (Chrome and Firefox only). Ember build tools will remove any calls to `Ember.deprecate()` when doing a production build. @method deprecate @param {String} message A description of the deprecation. @param {Boolean} test An optional boolean. If falsy, the deprecation will be displayed. */ Ember.deprecate = function(message, test) { if (Ember && Ember.TESTING_DEPRECATION) { return; } if (arguments.length === 1) { test = false; } if (test) { return; } if (Ember && Ember.ENV.RAISE_ON_DEPRECATION) { throw new Error(message); } var error; // When using new Error, we can't do the arguments check for Chrome. Alternatives are welcome try { __fail__.fail(); } catch (e) { error = e; } if (Ember.LOG_STACKTRACE_ON_DEPRECATION && error.stack) { var stack, stackStr = ''; if (error['arguments']) { // Chrome stack = error.stack.replace(/^\s+at\s+/gm, ''). replace(/^([^\(]+?)([\n$])/gm, '{anonymous}($1)$2'). replace(/^Object.\s*\(([^\)]+)\)/gm, '{anonymous}($1)').split('\n'); stack.shift(); } else { // Firefox stack = error.stack.replace(/(?:\n@:0)?\s+$/m, ''). replace(/^\(/gm, '{anonymous}(').split('\n'); } stackStr = "\n " + stack.slice(2).join("\n "); message = message + stackStr; } Ember.Logger.warn("DEPRECATION: "+message); }; /** Display a deprecation warning with the provided message and a stack trace (Chrome and Firefox only) when the wrapped method is called. Ember build tools will not remove calls to `Ember.deprecateFunc()`, though no warnings will be shown in production. @method deprecateFunc @param {String} message A description of the deprecation. @param {Function} func The function to be deprecated. @return {Function} a new function that wrapped the original function with a deprecation warning */ Ember.deprecateFunc = function(message, func) { return function() { Ember.deprecate(message); return func.apply(this, arguments); }; }; })(); // Version: v1.0.0-rc.2-2-gd22a11b // Last commit: d22a11b (2013-07-25 20:15:17 -0400) (function() { var define, requireModule; (function() { var registry = {}, seen = {}; define = function(name, deps, callback) { registry[name] = { deps: deps, callback: callback }; }; requireModule = function(name) { if (seen[name]) { return seen[name]; } seen[name] = {}; var mod = registry[name], deps = mod.deps, callback = mod.callback, reified = [], exports; for (var i=0, l=deps.length; i= 0) { intersection.push(element); } }); return intersection; } }; })(); (function() { /*jshint newcap:false*/ /** @module ember-metal */ // 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 to use native functions // if available, but not to use versions created by libraries like Prototype 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 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 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); } } }; 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.ArrayPolyfills = { map: arrayMap, forEach: arrayForEach, indexOf: arrayIndexOf }; if (Ember.SHIM_ES5) { if (!Array.prototype.map) { Array.prototype.map = arrayMap; } if (!Array.prototype.forEach) { Array.prototype.forEach = arrayForEach; } if (!Array.prototype.indexOf) { Array.prototype.indexOf = arrayIndexOf; } } })(); (function() { /** @module ember-metal */ /* 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. */ var guidFor = Ember.guidFor, indexOf = Ember.ArrayPolyfills.indexOf; var copy = function(obj) { var output = {}; for (var prop in obj) { if (obj.hasOwnProperty(prop)) { output[prop] = obj[prop]; } } return output; }; var copyMap = function(original, newObject) { var keys = original.keys.copy(), values = copy(original.values); newObject.keys = keys; newObject.values = values; return newObject; }; /** This class is used internally by Ember and Ember Data. Please do not use it at this time. We plan to clean it up and add many tests soon. @class OrderedSet @namespace Ember @constructor @private */ var OrderedSet = Ember.OrderedSet = function() { this.clear(); }; /** @method create @static @return {Ember.OrderedSet} */ OrderedSet.create = function() { return new OrderedSet(); }; OrderedSet.prototype = { /** @method clear */ clear: function() { this.presenceSet = {}; this.list = []; }, /** @method add @param obj */ add: function(obj) { var guid = guidFor(obj), presenceSet = this.presenceSet, list = this.list; if (guid in presenceSet) { return; } presenceSet[guid] = true; list.push(obj); }, /** @method remove @param obj */ remove: function(obj) { var guid = guidFor(obj), presenceSet = this.presenceSet, list = this.list; delete presenceSet[guid]; var index = indexOf.call(list, obj); if (index > -1) { list.splice(index, 1); } }, /** @method isEmpty @return {Boolean} */ isEmpty: function() { return this.list.length === 0; }, /** @method has @param obj @return {Boolean} */ has: function(obj) { var guid = guidFor(obj), presenceSet = this.presenceSet; return guid in presenceSet; }, /** @method forEach @param {Function} fn @param self */ 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]); } }, /** @method toArray @return {Array} */ toArray: function() { return this.list.slice(); }, /** @method copy @return {Ember.OrderedSet} */ copy: function() { var set = new OrderedSet(); set.presenceSet = copy(this.presenceSet); set.list = this.list.slice(); return set; } }; /** 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: 1. `keys`: an OrderedSet of all of the existing keys 2. `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`. @class Map @namespace Ember @private @constructor */ var Map = Ember.Map = function() { this.keys = Ember.OrderedSet.create(); this.values = {}; }; /** @method create @static */ Map.create = function() { return new Map(); }; Map.prototype = { /** Retrieve the value associated with a given key. @method get @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. @method set @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. @method remove @param {anything} key @return {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. @method has @param {anything} key @return {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. @method forEach @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]); }); }, /** @method copy @return {Ember.Map} */ copy: function() { return copyMap(this, new Map()); } }; /** @class MapWithDefault @namespace Ember @extends Ember.Map @private @constructor @param [options] @param {anything} [options.defaultValue] */ var MapWithDefault = Ember.MapWithDefault = function(options) { Map.call(this); this.defaultValue = options.defaultValue; }; /** @method create @static @param [options] @param {anything} [options.defaultValue] @return {Ember.MapWithDefault|Ember.Map} If options are passed, returns `Ember.MapWithDefault` otherwise returns `Ember.Map` */ MapWithDefault.create = function(options) { if (options) { return new MapWithDefault(options); } else { return new Map(); } }; MapWithDefault.prototype = Ember.create(Map.prototype); /** Retrieve the value associated with a given key. @method get @param {anything} key @return {anything} the value associated with the key, or the default value */ MapWithDefault.prototype.get = function(key) { var hasValue = this.has(key); if (hasValue) { return Map.prototype.get.call(this, key); } else { var defaultValue = this.defaultValue(key); this.set(key, defaultValue); return defaultValue; } }; /** @method copy @return {Ember.MapWithDefault} */ MapWithDefault.prototype.copy = function() { return copyMap(this, new MapWithDefault({ defaultValue: this.defaultValue })); }; })(); (function() { /** @module ember-metal */ var META_KEY = Ember.META_KEY, get, set; var MANDATORY_SETTER = Ember.ENV.MANDATORY_SETTER; var IS_GLOBAL = /^([A-Z$]|([0-9][A-Z$]))/; var IS_GLOBAL_PATH = /^([A-Z$]|([0-9][A-Z$])).*[\.\*]/; var HAS_THIS = /^this[\.\*]/; var FIRST_KEY = /^([^\.\*]+)/; // .......................................................... // GET AND SET // // If we are on a platform that supports accessors we can use those. // Otherwise simulate accessors by looking up the property directly on the // object. /** 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. (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 object itself is `undefined`, this method will throw an error. @method get @for Ember @param {Object} obj The object to retrieve from. @param {String} keyName The property key to retrieve @return {Object} the property value or `null`. */ get = function get(obj, keyName) { // Helpers that operate with 'this' within an #each if (keyName === '') { return obj; } if (!keyName && 'string'===typeof obj) { keyName = obj; obj = null; } if (!obj || keyName.indexOf('.') !== -1) { Ember.assert("Cannot call get with '"+ keyName +"' on an undefined object.", obj !== undefined); return getPath(obj, keyName); } Ember.assert("You need to provide an object and key to `get`.", !!obj && keyName); var meta = obj[META_KEY], desc = meta && meta.descs[keyName], ret; if (desc) { return desc.get(obj, keyName); } else { if (MANDATORY_SETTER && meta && meta.watching[keyName] > 0) { ret = meta.values[keyName]; } else { ret = obj[keyName]; } if (ret === undefined && 'object' === typeof obj && !(keyName in obj) && 'function' === typeof obj.unknownProperty) { return obj.unknownProperty(keyName); } return ret; } }; /** 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. (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. @method set @for Ember @param {Object} obj The object to modify. @param {String} keyName The property key to set @param {Object} value The value to set @return {Object} the passed value. */ set = function set(obj, keyName, value, tolerant) { if (typeof obj === 'string') { Ember.assert("Path '" + obj + "' must be global if no obj is given.", IS_GLOBAL.test(obj)); value = keyName; keyName = obj; obj = null; } if (!obj || keyName.indexOf('.') !== -1) { return setPath(obj, keyName, value, tolerant); } Ember.assert("You need to provide an object and key to `set`.", !!obj && keyName !== undefined); Ember.assert('calling set on destroyed object', !obj.isDestroyed); var meta = obj[META_KEY], desc = meta && meta.descs[keyName], isUnknown, currentValue; if (desc) { desc.set(obj, keyName, value); } else { isUnknown = 'object' === typeof obj && !(keyName in obj); // setUnknownProperty is called if `obj` is an object, // the property does not already exist, and the // `setUnknownProperty` method exists on the object if (isUnknown && 'function' === typeof obj.setUnknownProperty) { obj.setUnknownProperty(keyName, value); } else if (meta && meta.watching[keyName] > 0) { if (MANDATORY_SETTER) { currentValue = meta.values[keyName]; } else { currentValue = obj[keyName]; } // only trigger a change if the value has changed if (value !== currentValue) { Ember.propertyWillChange(obj, keyName); if (MANDATORY_SETTER) { if (currentValue === undefined && !(keyName in obj)) { Ember.defineProperty(obj, keyName, null, value); // setup mandatory setter } else { meta.values[keyName] = value; } } else { obj[keyName] = value; } Ember.propertyDidChange(obj, keyName); } } else { obj[keyName] = value; } } return value; }; // Currently used only by Ember Data tests if (Ember.config.overrideAccessors) { Ember.get = get; Ember.set = set; Ember.config.overrideAccessors(); get = Ember.get; set = Ember.set; } function firstKey(path) { return path.match(FIRST_KEY)[0]; } // assumes path is already normalized function normalizeTuple(target, path) { var hasThis = HAS_THIS.test(path), isGlobal = !hasThis && IS_GLOBAL_PATH.test(path), key; if (!target || isGlobal) target = Ember.lookup; if (hasThis) path = path.slice(5); if (target === Ember.lookup) { key = firstKey(path); target = get(target, key); path = path.slice(key.length+1); } // must return some kind of path to be valid else other things will break. if (!path || path.length===0) throw new Error('Invalid Path'); return [ target, path ]; } function getPath(root, path) { var hasThis, parts, tuple, idx, len; // If there is no root and path is a key name, return that // property from the global object. // E.g. get('Ember') -> Ember if (root === null && path.indexOf('.') === -1) { return get(Ember.lookup, path); } // detect complicated paths and normalize them hasThis = HAS_THIS.test(path); if (!root || hasThis) { tuple = normalizeTuple(root, path); root = tuple[0]; path = tuple[1]; tuple.length = 0; } parts = path.split("."); len = parts.length; for (idx=0; root && idx 0; if (existingDesc instanceof Ember.Descriptor) { existingDesc.teardown(obj, keyName); } if (desc instanceof Ember.Descriptor) { value = desc; descs[keyName] = desc; if (MANDATORY_SETTER && watching) { objectDefineProperty(obj, keyName, { configurable: true, enumerable: true, writable: true, value: undefined // make enumerable }); } else { obj[keyName] = undefined; // make enumerable } desc.setup(obj, keyName); } else { descs[keyName] = undefined; // shadow descriptor in proto if (desc == null) { value = data; if (MANDATORY_SETTER && watching) { meta.values[keyName] = data; objectDefineProperty(obj, keyName, { configurable: true, enumerable: true, set: MANDATORY_SETTER_FUNCTION, get: DEFAULT_GETTER_FUNCTION(keyName) }); } else { obj[keyName] = data; } } else { value = desc; // compatibility with ES5 objectDefineProperty(obj, keyName, desc); } } // if key is being watched, override chains that // were initialized with the prototype if (watching) { Ember.overrideChains(obj, keyName, meta); } // The `value` passed to the `didDefineProperty` hook is // either the descriptor or data, whichever was passed. if (obj.didDefineProperty) { obj.didDefineProperty(obj, keyName, value); } return this; }; })(); (function() { // Ember.tryFinally /** @module ember-metal */ var AFTER_OBSERVERS = ':change'; var BEFORE_OBSERVERS = ':before'; var guidFor = Ember.guidFor; var deferred = 0; /* this.observerSet = { [senderGuid]: { // variable name: `keySet` [keyName]: listIndex } }, this.observers = [ { sender: obj, keyName: keyName, eventName: eventName, listeners: [ [target, method, onceFlag, suspendedFlag] ] }, ... ] */ function ObserverSet() { this.clear(); } ObserverSet.prototype.add = function(sender, keyName, eventName) { var observerSet = this.observerSet, observers = this.observers, senderGuid = Ember.guidFor(sender), keySet = observerSet[senderGuid], index; if (!keySet) { observerSet[senderGuid] = keySet = {}; } index = keySet[keyName]; if (index === undefined) { index = observers.push({ sender: sender, keyName: keyName, eventName: eventName, listeners: [] }) - 1; keySet[keyName] = index; } return observers[index].listeners; }; ObserverSet.prototype.flush = function() { var observers = this.observers, i, len, observer, sender; this.clear(); for (i=0, len=observers.length; i < len; ++i) { observer = observers[i]; sender = observer.sender; if (sender.isDestroying || sender.isDestroyed) { continue; } Ember.sendEvent(sender, observer.eventName, [sender, observer.keyName], observer.listeners); } }; ObserverSet.prototype.clear = function() { this.observerSet = {}; this.observers = []; }; var beforeObserverSet = new ObserverSet(), observerSet = new ObserverSet(); /** @method beginPropertyChanges @chainable */ Ember.beginPropertyChanges = function() { deferred++; }; /** @method endPropertyChanges */ Ember.endPropertyChanges = function() { deferred--; if (deferred<=0) { beforeObserverSet.clear(); observerSet.flush(); } }; /** Make a series of property changes together in an exception-safe way. ```javascript Ember.changeProperties(function() { obj1.set('foo', mayBlowUpWhenSet); obj2.set('bar', baz); }); ``` @method changeProperties @param {Function} callback @param [binding] */ Ember.changeProperties = function(cb, binding){ Ember.beginPropertyChanges(); Ember.tryFinally(cb, Ember.endPropertyChanges, binding); }; /** Set a list of properties on an object. These properties are set inside a single `beginPropertyChanges` and `endPropertyChanges` batch, so observers will be buffered. @method setProperties @param target @param {Hash} properties @return target */ 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; }; function changeEvent(keyName) { return keyName+AFTER_OBSERVERS; } function beforeEvent(keyName) { return keyName+BEFORE_OBSERVERS; } /** @method addObserver @param obj @param {String} path @param {Object|Function} targetOrMethod @param {Function|String} [method] */ Ember.addObserver = function(obj, path, target, method) { Ember.addListener(obj, changeEvent(path), target, method); Ember.watch(obj, path); return this; }; Ember.observersFor = function(obj, path) { return Ember.listenersFor(obj, changeEvent(path)); }; /** @method removeObserver @param obj @param {String} path @param {Object|Function} targetOrMethod @param {Function|String} [method] */ Ember.removeObserver = function(obj, path, target, method) { Ember.unwatch(obj, path); Ember.removeListener(obj, changeEvent(path), target, method); return this; }; /** @method addBeforeObserver @param obj @param {String} path @param {Object|Function} targetOrMethod @param {Function|String} [method] */ Ember.addBeforeObserver = function(obj, path, target, method) { Ember.addListener(obj, beforeEvent(path), target, method); 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. Ember._suspendBeforeObserver = function(obj, path, target, method, callback) { return Ember._suspendListener(obj, beforeEvent(path), target, method, callback); }; Ember._suspendObserver = function(obj, path, target, method, callback) { return Ember._suspendListener(obj, changeEvent(path), target, method, callback); }; var map = Ember.ArrayPolyfills.map; Ember._suspendBeforeObservers = function(obj, paths, target, method, callback) { var events = map.call(paths, beforeEvent); return Ember._suspendListeners(obj, events, target, method, callback); }; Ember._suspendObservers = function(obj, paths, target, method, callback) { var events = map.call(paths, changeEvent); return Ember._suspendListeners(obj, events, target, method, callback); }; Ember.beforeObserversFor = function(obj, path) { return Ember.listenersFor(obj, beforeEvent(path)); }; /** @method removeBeforeObserver @param obj @param {String} path @param {Object|Function} targetOrMethod @param {Function|String} [method] */ Ember.removeBeforeObserver = function(obj, path, target, method) { Ember.unwatch(obj, path); Ember.removeListener(obj, beforeEvent(path), target, method); return this; }; Ember.notifyBeforeObservers = function(obj, keyName) { if (obj.isDestroying) { return; } var eventName = beforeEvent(keyName), listeners, listenersDiff; if (deferred) { listeners = beforeObserverSet.add(obj, keyName, eventName); listenersDiff = Ember.listenersDiff(obj, eventName, listeners); Ember.sendEvent(obj, eventName, [obj, keyName], listenersDiff); } else { Ember.sendEvent(obj, eventName, [obj, keyName]); } }; Ember.notifyObservers = function(obj, keyName) { if (obj.isDestroying) { return; } var eventName = changeEvent(keyName), listeners; if (deferred) { listeners = observerSet.add(obj, keyName, eventName); Ember.listenersUnion(obj, eventName, listeners); } else { Ember.sendEvent(obj, eventName, [obj, keyName]); } }; })(); (function() { /** @module ember-metal */ var guidFor = Ember.guidFor, // utils.js metaFor = Ember.meta, // utils.js get = Ember.get, // accessors.js set = Ember.set, // accessors.js normalizeTuple = Ember.normalizeTuple, // accessors.js GUID_KEY = Ember.GUID_KEY, // utils.js META_KEY = Ember.META_KEY, // utils.js // circular reference observer depends on Ember.watch // we should move change events to this file or its own property_events.js forEach = Ember.ArrayPolyfills.forEach, // array.js FIRST_KEY = /^([^\.\*]+)/, IS_PATH = /[\.\*]/; var MANDATORY_SETTER = Ember.ENV.MANDATORY_SETTER, o_defineProperty = Ember.platform.defineProperty; function firstKey(path) { return path.match(FIRST_KEY)[0]; } // returns true if the passed path is just a keyName function isKeyName(path) { return path==='*' || !IS_PATH.test(path); } // .......................................................... // DEPENDENT KEYS // 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) { var desc = meta.descs[key]; if (desc && desc._suspended === obj) 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...) 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 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 // function addChainWatcher(obj, keyName, node) { if (!obj || ('object' !== typeof obj)) { return; } // nothing to do var m = metaFor(obj), nodes = m.chainWatchers; if (!m.hasOwnProperty('chainWatchers')) { nodes = m.chainWatchers = {}; } if (!nodes[keyName]) { nodes[keyName] = []; } nodes[keyName].push(node); Ember.watch(obj, keyName); } function removeChainWatcher(obj, keyName, node) { if (!obj || 'object' !== typeof obj) { return; } // nothing to do var m = metaFor(obj, false); if (!m.hasOwnProperty('chainWatchers')) { return; } // nothing to do var nodes = m.chainWatchers; if (nodes[keyName]) { nodes = nodes[keyName]; for (var i = 0, l = nodes.length; i < l; i++) { if (nodes[i] === node) { nodes.splice(i, 1); } } } 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. function flushPendingChains() { if (pendingQueue.length === 0) { return; } // nothing to do var queue = pendingQueue; pendingQueue = []; forEach.call(queue, function(q) { q[0].add(q[1]); }); Ember.warn('Watching an undefined global, Ember expects watched globals to be setup by the time the run loop is flushed, check for typos', pendingQueue.length === 0); } function isProto(pvalue) { return metaFor(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. var ChainNode = function(parent, key, value) { 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._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 ChainNodePrototype = ChainNode.prototype; ChainNodePrototype.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; }; ChainNodePrototype.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 ChainNodePrototype.copy = function(obj) { var ret = new ChainNode(null, null, obj), 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. ChainNodePrototype.add = function(path) { var obj, tuple, key, src, 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)); path = tuple[1]; } tuple.length = 0; this.chain(key, path, src); }; // called on the root node of a chain to teardown watcher on the specified // path ChainNodePrototype.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); }; ChainNodePrototype.count = 0; ChainNodePrototype.chain = function(key, path, src) { var chains = this._chains, node; if (!chains) { chains = this._chains = {}; } node = chains[key]; if (!node) { node = chains[key] = new ChainNode(this, key, src); } 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... } }; ChainNodePrototype.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(); } }; ChainNodePrototype.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); } }; ChainNodePrototype.chainWillChange = function(chain, path, depth) { if (this._key) { path = this._key + '.' + 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); } } }; ChainNodePrototype.chainDidChange = function(chain, path, depth) { if (this._key) { path = this._key + '.' + 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); } } }; ChainNodePrototype.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. function chainsFor(obj) { var m = metaFor(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; } Ember.overrideChains = function(obj, keyName, m) { chainsDidChange(obj, keyName, m, true); }; function chainsWillChange(obj, keyName, m, arg) { if (!m.hasOwnProperty('chainWatchers')) { return; } // nothing to do var nodes = m.chainWatchers; nodes = nodes[keyName]; if (!nodes) { return; } for(var i = 0, l = nodes.length; i < l; i++) { nodes[i].willChange(arg); } } function chainsDidChange(obj, keyName, m, arg) { if (!m.hasOwnProperty('chainWatchers')) { return; } // nothing to do var nodes = m.chainWatchers; nodes = nodes[keyName]; if (!nodes) { return; } // looping in reverse because the chainWatchers array can be modified inside didChange for (var i = nodes.length - 1; i >= 0; i--) { nodes[i].didChange(arg); } } // .......................................................... // WATCH // /** @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()` @method watch @for Ember @param obj @param {String} keyName */ 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 = metaFor(obj), watching = m.watching, desc; // activate watching first time if (!watching[keyName]) { watching[keyName] = 1; if (isKeyName(keyName)) { desc = m.descs[keyName]; if (desc && desc.willWatch) { desc.willWatch(obj, keyName); } if ('function' === typeof obj.willWatchProperty) { obj.willWatchProperty(keyName); } if (MANDATORY_SETTER && keyName in obj) { m.values[keyName] = obj[keyName]; o_defineProperty(obj, keyName, { configurable: true, enumerable: true, set: Ember.MANDATORY_SETTER_FUNCTION, get: Ember.DEFAULT_GETTER_FUNCTION(keyName) }); } } else { chainsFor(obj).add(keyName); } } else { watching[keyName] = (watching[keyName] || 0) + 1; } return this; }; Ember.isWatching = function isWatching(obj, key) { var meta = obj[META_KEY]; return (meta && meta.watching[key]) > 0; }; Ember.watch.flushPending = flushPendingChains; Ember.unwatch = function(obj, keyName) { // can't watch length on Array - it is special... if (keyName === 'length' && Ember.typeOf(obj) === 'array') { return this; } var m = metaFor(obj), watching = m.watching, desc; if (watching[keyName] === 1) { watching[keyName] = 0; if (isKeyName(keyName)) { desc = m.descs[keyName]; if (desc && desc.didUnwatch) { desc.didUnwatch(obj, keyName); } if ('function' === typeof obj.didUnwatchProperty) { obj.didUnwatchProperty(keyName); } if (MANDATORY_SETTER && keyName in obj) { o_defineProperty(obj, keyName, { configurable: true, enumerable: true, writable: true, value: m.values[keyName] }); delete m.values[keyName]; } } 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. @method rewatch @for Ember @param obj */ Ember.rewatch = function(obj) { var m = metaFor(obj, false), chains = m.chains; // 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) { m.chains = chains.copy(obj); } return this; }; Ember.finishChains = function(obj) { var m = metaFor(obj, false), chains = m.chains; if (chains) { if (chains.value() !== obj) { m.chains = chains = chains.copy(obj); } chains.didChange(true); } }; // .......................................................... // 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. @method propertyWillChange @for Ember @param {Object} obj The object with the property that will change @param {String} keyName The property key (or path) that will change. @return {void} */ function propertyWillChange(obj, keyName) { var m = metaFor(obj, false), watching = m.watching[keyName] > 0 || keyName === 'length', proto = m.proto, desc = m.descs[keyName]; if (!watching) { return; } 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. @method propertyDidChange @for Ember @param {Object} obj The object with the property that will change @param {String} keyName The property key (or path) that will change. @return {void} */ function propertyDidChange(obj, keyName) { var m = metaFor(obj, false), watching = m.watching[keyName] > 0 || keyName === 'length', proto = m.proto, desc = m.descs[keyName]; if (proto === obj) { return; } // shouldn't this mean that we're watching this key? if (desc && desc.didChange) { desc.didChange(obj, keyName); } if (!watching && keyName !== 'length') { return; } 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. @method destroy @for Ember @param {Object} obj the object to destroy @return {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() { /** @module ember-metal */ Ember.warn("The CP_DEFAULT_CACHEABLE flag has been removed and computed properties are always cached by default. Use `volatile` if you don't want caching.", Ember.ENV.CP_DEFAULT_CACHEABLE !== false); var get = Ember.get, set = Ember.set, metaFor = Ember.meta, a_slice = [].slice, o_create = Ember.create, META_KEY = Ember.META_KEY, watch = Ember.watch, unwatch = Ember.unwatch; // .......................................................... // DEPENDENT KEYS // // data structure: // meta.deps = { // 'depKey': { // 'keyName': count, // } // } /* This function returns a map of unique dependencies for a given object and key. */ function keysForDep(obj, depsMeta, depKey) { var keys = depsMeta[depKey]; if (!keys) { // if there are no dependencies yet for a the given key // create a new empty list of dependencies for the key keys = depsMeta[depKey] = {}; } else if (!depsMeta.hasOwnProperty(depKey)) { // otherwise if the dependency list is inherited from // a superclass, clone the hash keys = depsMeta[depKey] = o_create(keys); } return keys; } function metaForDeps(obj, meta) { return keysForDep(obj, meta, 'deps'); } function addDependentKeys(desc, obj, keyName, meta) { // the descriptor has a list of dependent keys, so // add all of its dependent keys. var depKeys = desc._dependentKeys, depsMeta, idx, len, depKey, keys; if (!depKeys) return; depsMeta = metaForDeps(obj, meta); for(idx = 0, len = depKeys.length; idx < len; idx++) { depKey = depKeys[idx]; // Lookup keys meta for depKey keys = keysForDep(obj, depsMeta, depKey); // Increment the number of times depKey depends on keyName. keys[keyName] = (keys[keyName] || 0) + 1; // Watch the depKey watch(obj, depKey); } } function removeDependentKeys(desc, obj, keyName, meta) { // the descriptor has a list of dependent keys, so // add all of its dependent keys. var depKeys = desc._dependentKeys, depsMeta, idx, len, depKey, keys; if (!depKeys) return; depsMeta = metaForDeps(obj, meta); for(idx = 0, len = depKeys.length; idx < len; idx++) { depKey = depKeys[idx]; // Lookup keys meta for depKey keys = keysForDep(obj, depsMeta, depKey); // Increment the number of times depKey depends on keyName. keys[keyName] = (keys[keyName] || 0) - 1; // Watch the depKey unwatch(obj, depKey); } } // .......................................................... // COMPUTED PROPERTY // /** @class ComputedProperty @namespace Ember @extends Ember.Descriptor @constructor */ function ComputedProperty(func, opts) { this.func = func; this._cacheable = (opts && opts.cacheable !== undefined) ? opts.cacheable : true; this._dependentKeys = opts && opts.dependentKeys; this._readOnly = opts && (opts.readOnly !== undefined || !!opts.readOnly); } Ember.ComputedProperty = ComputedProperty; ComputedProperty.prototype = new Ember.Descriptor(); var ComputedPropertyPrototype = 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. ```javascript MyApp.president = Ember.Object.create({ fullName: function() { return this.get('firstName') + ' ' + this.get('lastName'); // After calculating the value of this function, Ember will // return that value without re-executing this function until // one of the dependent properties change. }.property('firstName', 'lastName') }); ``` Properties are cacheable by default. @method cacheable @param {Boolean} aFlag optional set to `false` to disable caching @return {Ember.ComputedProperty} this @chainable */ ComputedPropertyPrototype.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. ```javascript MyApp.outsideService = Ember.Object.create({ value: function() { return OutsideService.getValue(); }.property().volatile() }); ``` @method volatile @return {Ember.ComputedProperty} this @chainable */ ComputedPropertyPrototype.volatile = function() { return this.cacheable(false); }; /** Call on a computed property to set it into read-only mode. When in this mode the computed property will throw an error when set. ```javascript MyApp.person = Ember.Object.create({ guid: function() { return 'guid-guid-guid'; }.property().readOnly() }); MyApp.person.set('guid', 'new-guid'); // will throw an exception ``` @method readOnly @return {Ember.ComputedProperty} this @chainable */ ComputedPropertyPrototype.readOnly = function(readOnly) { this._readOnly = readOnly === undefined || !!readOnly; return this; }; /** Sets the dependent keys on this computed property. Pass any number of arguments containing key paths that this computed property depends on. ```javascript MyApp.president = Ember.Object.create({ fullName: Ember.computed(function() { return this.get('firstName') + ' ' + this.get('lastName'); // Tell Ember that this computed property depends on firstName // and lastName }).property('firstName', 'lastName') }); ``` @method property @param {String} path* zero or more property paths @return {Ember.ComputedProperty} this @chainable */ ComputedPropertyPrototype.property = function() { var args = []; for (var i = 0, l = arguments.length; i < l; i++) { args.push(arguments[i]); } this._dependentKeys = args; 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. @method meta @param {Hash} meta @chainable */ ComputedPropertyPrototype.meta = function(meta) { if (arguments.length === 0) { return this._meta || {}; } else { this._meta = meta; return this; } }; /* impl descriptor API */ ComputedPropertyPrototype.willWatch = function(obj, keyName) { // watch already creates meta for this instance var meta = obj[META_KEY]; Ember.assert('watch should have setup meta to be writable', meta.source === obj); if (!(keyName in meta.cache)) { addDependentKeys(this, obj, keyName, meta); } }; ComputedPropertyPrototype.didUnwatch = function(obj, keyName) { var meta = obj[META_KEY]; Ember.assert('unwatch should have setup meta to be writable', meta.source === obj); if (!(keyName in meta.cache)) { // unwatch already creates meta for this instance removeDependentKeys(this, obj, keyName, meta); } }; /* impl descriptor API */ ComputedPropertyPrototype.didChange = function(obj, keyName) { // _suspended is set via a CP.set to ensure we don't clear // the cached value set by the setter if (this._cacheable && this._suspended !== obj) { var meta = metaFor(obj); if (keyName in meta.cache) { delete meta.cache[keyName]; if (!meta.watching[keyName]) { removeDependentKeys(this, obj, keyName, meta); } } } }; /* impl descriptor API */ ComputedPropertyPrototype.get = function(obj, keyName) { var ret, cache, meta; if (this._cacheable) { meta = metaFor(obj); cache = meta.cache; if (keyName in cache) { return cache[keyName]; } ret = cache[keyName] = this.func.call(obj, keyName); if (!meta.watching[keyName]) { addDependentKeys(this, obj, keyName, meta); } } else { ret = this.func.call(obj, keyName); } return ret; }; /* impl descriptor API */ ComputedPropertyPrototype.set = function(obj, keyName, value) { var cacheable = this._cacheable, func = this.func, meta = metaFor(obj, cacheable), watched = meta.watching[keyName], oldSuspended = this._suspended, hadCachedValue = false, cache = meta.cache, cachedValue, ret; if (this._readOnly) { throw new Error('Cannot Set: ' + keyName + ' on: ' + obj.toString() ); } this._suspended = obj; try { if (cacheable && cache.hasOwnProperty(keyName)) { cachedValue = cache[keyName]; hadCachedValue = true; } // Check if the CP has been wrapped if (func.wrappedFunction) { func = func.wrappedFunction; } // For backwards-compatibility with computed properties // that check for arguments.length === 2 to determine if // they are being get or set, only pass the old cached // value if the computed property opts into a third // argument. if (func.length === 3) { ret = func.call(obj, keyName, value, cachedValue); } else if (func.length === 2) { ret = func.call(obj, keyName, value); } else { Ember.defineProperty(obj, keyName, null, cachedValue); Ember.set(obj, keyName, value); return; } if (hadCachedValue && cachedValue === ret) { return; } if (watched) { Ember.propertyWillChange(obj, keyName); } if (hadCachedValue) { delete cache[keyName]; } if (cacheable) { if (!watched && !hadCachedValue) { addDependentKeys(this, obj, keyName, meta); } cache[keyName] = ret; } if (watched) { Ember.propertyDidChange(obj, keyName); } } finally { this._suspended = oldSuspended; } return ret; }; /* called when property is defined */ ComputedPropertyPrototype.setup = function(obj, keyName) { var meta = obj[META_KEY]; if (meta && meta.watching[keyName]) { addDependentKeys(this, obj, keyName, metaFor(obj)); } }; /* called before property is overridden */ ComputedPropertyPrototype.teardown = function(obj, keyName) { var meta = metaFor(obj); if (meta.watching[keyName] || keyName in meta.cache) { removeDependentKeys(this, obj, keyName, meta); } if (this._cacheable) { delete meta.cache[keyName]; } return null; // no value to restore }; /** 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. @method computed @for Ember @param {Function} func The computed property function. @return {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]; } if ( typeof func !== "function" ) { throw new Error("Computed Property declared without a property function"); } 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. @method cacheFor @for Ember @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 @return {any} the cached value */ Ember.cacheFor = function cacheFor(obj, key) { var cache = metaFor(obj, false).cache; if (cache && key in cache) { return cache[key]; } }; function getProperties(self, propertyNames) { var ret = {}; for(var i = 0; i < propertyNames.length; i++) { ret[propertyNames[i]] = get(self, propertyNames[i]); } return ret; } function registerComputed(name, macro) { Ember.computed[name] = function(dependentKey) { var args = a_slice.call(arguments); return Ember.computed(dependentKey, function() { return macro.apply(this, args); }); }; } function registerComputedWithProperties(name, macro) { Ember.computed[name] = function() { var properties = a_slice.call(arguments); var computed = Ember.computed(function() { return macro.apply(this, [getProperties(this, properties)]); }); return computed.property.apply(computed, properties); }; } /** @method computed.empty @for Ember @param {String} dependentKey @return {Ember.ComputedProperty} computed property which negate the original value for property */ registerComputed('empty', function(dependentKey) { return Ember.isEmpty(get(this, dependentKey)); }); /** @method computed.notEmpty @for Ember @param {String} dependentKey @return {Ember.ComputedProperty} computed property which returns true if original value for property is not empty. */ registerComputed('notEmpty', function(dependentKey) { return !Ember.isEmpty(get(this, dependentKey)); }); /** @method computed.none @for Ember @param {String} dependentKey @return {Ember.ComputedProperty} computed property which rturns true if original value for property is null or undefined. */ registerComputed('none', function(dependentKey) { return Ember.isNone(get(this, dependentKey)); }); /** @method computed.not @for Ember @param {String} dependentKey @return {Ember.ComputedProperty} computed property which returns inverse of the original value for property */ registerComputed('not', function(dependentKey) { return !get(this, dependentKey); }); /** @method computed.bool @for Ember @param {String} dependentKey @return {Ember.ComputedProperty} computed property which convert to boolean the original value for property */ registerComputed('bool', function(dependentKey) { return !!get(this, dependentKey); }); /** @method computed.match @for Ember @param {String} dependentKey @param {RegExp} regexp @return {Ember.ComputedProperty} computed property which match the original value for property against a given RegExp */ registerComputed('match', function(dependentKey, regexp) { var value = get(this, dependentKey); return typeof value === 'string' ? !!value.match(regexp) : false; }); /** @method computed.equal @for Ember @param {String} dependentKey @param {String|Number|Object} value @return {Ember.ComputedProperty} computed property which returns true if the original value for property is equal to the given value. */ registerComputed('equal', function(dependentKey, value) { return get(this, dependentKey) === value; }); /** @method computed.gt @for Ember @param {String} dependentKey @param {Number} value @return {Ember.ComputedProperty} computed property which returns true if the original value for property is greater then given value. */ registerComputed('gt', function(dependentKey, value) { return get(this, dependentKey) > value; }); /** @method computed.gte @for Ember @param {String} dependentKey @param {Number} value @return {Ember.ComputedProperty} computed property which returns true if the original value for property is greater or equal then given value. */ registerComputed('gte', function(dependentKey, value) { return get(this, dependentKey) >= value; }); /** @method computed.lt @for Ember @param {String} dependentKey @param {Number} value @return {Ember.ComputedProperty} computed property which returns true if the original value for property is less then given value. */ registerComputed('lt', function(dependentKey, value) { return get(this, dependentKey) < value; }); /** @method computed.lte @for Ember @param {String} dependentKey @param {Number} value @return {Ember.ComputedProperty} computed property which returns true if the original value for property is less or equal then given value. */ registerComputed('lte', function(dependentKey, value) { return get(this, dependentKey) <= value; }); /** @method computed.and @for Ember @param {String} dependentKey, [dependentKey...] @return {Ember.ComputedProperty} computed property which peforms a logical `and` on the values of all the original values for properties. */ registerComputedWithProperties('and', function(properties) { for (var key in properties) { if (properties.hasOwnProperty(key) && !properties[key]) { return false; } } return true; }); /** @method computed.or @for Ember @param {String} dependentKey, [dependentKey...] @return {Ember.ComputedProperty} computed property which peforms a logical `or` on the values of all the original values for properties. */ registerComputedWithProperties('or', function(properties) { for (var key in properties) { if (properties.hasOwnProperty(key) && properties[key]) { return true; } } return false; }); /** @method computed.any @for Ember @param {String} dependentKey, [dependentKey...] @return {Ember.ComputedProperty} computed property which returns the first trouthy value of given list of properties. */ registerComputedWithProperties('any', function(properties) { for (var key in properties) { if (properties.hasOwnProperty(key) && properties[key]) { return properties[key]; } } return null; }); /** @method computed.map @for Ember @param {String} dependentKey, [dependentKey...] @return {Ember.ComputedProperty} computed property which maps values of all passed properties in to an array. */ registerComputedWithProperties('map', function(properties) { var res = []; for (var key in properties) { if (properties.hasOwnProperty(key)) { if (Ember.isNone(properties[key])) { res.push(null); } else { res.push(properties[key]); } } } return res; }); /** @method computed.alias @for Ember @param {String} dependentKey @return {Ember.ComputedProperty} computed property which creates an alias to the original value for property. */ Ember.computed.alias = function(dependentKey) { return Ember.computed(dependentKey, function(key, value){ if (arguments.length > 1) { set(this, dependentKey, value); return value; } else { return get(this, dependentKey); } }); }; /** @method computed.defaultTo @for Ember @param {String} defaultPath @return {Ember.ComputedProperty} computed property which acts like a standard getter and setter, but defaults to the value from `defaultPath`. */ Ember.computed.defaultTo = function(defaultPath) { return Ember.computed(function(key, newValue, cachedValue) { var result; if (arguments.length === 1) { return cachedValue != null ? cachedValue : get(this, defaultPath); } return newValue != null ? newValue : get(this, defaultPath); }); }; })(); (function() { /** @module ember-metal */ var o_create = Ember.create, metaFor = Ember.meta, META_KEY = Ember.META_KEY; /* 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: `actions` [target, method, onceFlag, suspendedFlag] ] } } */ function indexOf(array, target, method) { var index = -1; for (var i = 0, l = array.length; i < l; i++) { if (target === array[i][0] && method === array[i][1]) { index = i; break; } } return index; } function actionsFor(obj, eventName) { var meta = metaFor(obj, true), actions; if (!meta.listeners) { meta.listeners = {}; } if (!meta.hasOwnProperty('listeners')) { // setup inherited copy of the listeners object meta.listeners = o_create(meta.listeners); } actions = meta.listeners[eventName]; // if there are actions, but the eventName doesn't exist in our listeners, then copy them from the prototype if (actions && !meta.listeners.hasOwnProperty(eventName)) { actions = meta.listeners[eventName] = meta.listeners[eventName].slice(); } else if (!actions) { actions = meta.listeners[eventName] = []; } return actions; } function actionsUnion(obj, eventName, otherActions) { var meta = obj[META_KEY], actions = meta && meta.listeners && meta.listeners[eventName]; if (!actions) { return; } for (var i = actions.length - 1; i >= 0; i--) { var target = actions[i][0], method = actions[i][1], once = actions[i][2], suspended = actions[i][3], actionIndex = indexOf(otherActions, target, method); if (actionIndex === -1) { otherActions.push([target, method, once, suspended]); } } } function actionsDiff(obj, eventName, otherActions) { var meta = obj[META_KEY], actions = meta && meta.listeners && meta.listeners[eventName], diffActions = []; if (!actions) { return; } for (var i = actions.length - 1; i >= 0; i--) { var target = actions[i][0], method = actions[i][1], once = actions[i][2], suspended = actions[i][3], actionIndex = indexOf(otherActions, target, method); if (actionIndex !== -1) { continue; } otherActions.push([target, method, once, suspended]); diffActions.push([target, method, once, suspended]); } return diffActions; } /** Add an event listener @method addListener @for Ember @param obj @param {String} eventName @param {Object|Function} targetOrMethod A target object or a function @param {Function|String} method A function or the name of a function to be called on `target` @param {Boolean} once A flag whether a function should only be called once */ function addListener(obj, eventName, target, method, once) { Ember.assert("You must pass at least an object and event name to Ember.addListener", !!obj && !!eventName); if (!method && 'function' === typeof target) { method = target; target = null; } var actions = actionsFor(obj, eventName), actionIndex = indexOf(actions, target, method); if (actionIndex !== -1) { return; } actions.push([target, method, once, undefined]); if ('function' === typeof obj.didAddListener) { obj.didAddListener(eventName, target, method); } } /** Remove an event listener Arguments should match those passed to {{#crossLink "Ember/addListener"}}{{/crossLink}} @method removeListener @for Ember @param obj @param {String} eventName @param {Object|Function} targetOrMethod A target object or a function @param {Function|String} method A function or the name of a function to be called on `target` */ function removeListener(obj, eventName, target, method) { Ember.assert("You must pass at least an object and event name to Ember.removeListener", !!obj && !!eventName); if (!method && 'function' === typeof target) { method = target; target = null; } function _removeListener(target, method, once) { var actions = actionsFor(obj, eventName), actionIndex = indexOf(actions, target, method); // action doesn't exist, give up silently if (actionIndex === -1) { return; } actions.splice(actionIndex, 1); if ('function' === typeof obj.didRemoveListener) { obj.didRemoveListener(eventName, target, method); } } if (method) { _removeListener(target, method); } else { var meta = obj[META_KEY], actions = meta && meta.listeners && meta.listeners[eventName]; if (!actions) { return; } for (var i = actions.length - 1; i >= 0; i--) { _removeListener(actions[i][0], actions[i][1]); } } } /** @private 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. @method suspendListener @for Ember @param obj @param {String} eventName @param {Object|Function} targetOrMethod A target object or a function @param {Function|String} method A function or the name of a function to be called on `target` @param {Function} callback */ function suspendListener(obj, eventName, target, method, callback) { if (!method && 'function' === typeof target) { method = target; target = null; } var actions = actionsFor(obj, eventName), actionIndex = indexOf(actions, target, method), action; if (actionIndex !== -1) { action = actions[actionIndex].slice(); // copy it, otherwise we're modifying a shared object action[3] = true; // mark the action as suspended actions[actionIndex] = action; // replace the shared object with our copy } function tryable() { return callback.call(target); } function finalizer() { if (action) { action[3] = undefined; } } return Ember.tryFinally(tryable, finalizer); } /** @private 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. @method suspendListener @for Ember @param obj @param {Array} eventName Array of event names @param {Object|Function} targetOrMethod A target object or a function @param {Function|String} method A function or the name of a function to be called on `target` @param {Function} callback */ function suspendListeners(obj, eventNames, target, method, callback) { if (!method && 'function' === typeof target) { method = target; target = null; } var suspendedActions = [], eventName, actions, action, i, l; for (i=0, l=eventNames.length; i= 0; i--) { // looping in reverse for once listeners if (!actions[i] || actions[i][3] === true) { continue; } var target = actions[i][0], method = actions[i][1], once = actions[i][2]; if (once) { removeListener(obj, eventName, target, method); } if (!target) { target = obj; } if ('string' === typeof method) { method = target[method]; } if (params) { method.apply(target, params); } else { method.call(target); } } return true; } /** @private @method hasListeners @for Ember @param obj @param {String} eventName */ function hasListeners(obj, eventName) { var meta = obj[META_KEY], actions = meta && meta.listeners && meta.listeners[eventName]; return !!(actions && actions.length); } /** @private @method listenersFor @for Ember @param obj @param {String} eventName */ function listenersFor(obj, eventName) { var ret = []; var meta = obj[META_KEY], actions = meta && meta.listeners && meta.listeners[eventName]; if (!actions) { return ret; } for (var i = 0, l = actions.length; i < l; i++) { var target = actions[i][0], method = actions[i][1]; ret.push([target, method]); } return ret; } Ember.addListener = addListener; Ember.removeListener = removeListener; Ember._suspendListener = suspendListener; Ember._suspendListeners = suspendListeners; Ember.sendEvent = sendEvent; Ember.hasListeners = hasListeners; Ember.watchedEvents = watchedEvents; Ember.listenersFor = listenersFor; Ember.listenersDiff = actionsDiff; Ember.listenersUnion = actionsUnion; })(); (function() { // Ember.Logger // Ember.watch.flushPending // Ember.beginPropertyChanges, Ember.endPropertyChanges // Ember.guidFor, Ember.tryFinally /** @module ember-metal */ // .......................................................... // HELPERS // var slice = [].slice, forEach = Ember.ArrayPolyfills.forEach; // invokes passed params - normalizing so you can pass target/func, // target/string or just func 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; } return Ember.handleErrors(function() { // IE8's Function.prototype.apply doesn't accept undefined/null arguments. return method.apply(target || this, args || []); }, this); } // .......................................................... // RUNLOOP // var timerMark; // used by timers... /** Ember RunLoop (Private) @class RunLoop @namespace Ember @private @constructor */ var RunLoop = function(prev) { this._prev = prev || null; this.onceTimers = {}; }; RunLoop.prototype = { /** @method end */ end: function() { this.flush(); }, /** @method prev */ prev: function() { return this._prev; }, // .......................................................... // Delayed Actions // /** @method schedule @param {String} queueName @param target @param method */ 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; }, /** @method flush @param {String} queueName */ flush: function(queueName) { var queueNames, idx, len, queue, log; if (!this._queues) { return this; } // nothing to do function iter(item) { invoke(item.target, item.method, item.args); } function tryable() { forEach.call(queue, iter); } 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(); Ember.tryFinally(tryable, Ember.endPropertyChanges); if (log) { Ember.Logger.log('End: Flush Sync Queue'); } } else { forEach.call(queue, iter); } } } else { queueNames = Ember.run.queues; len = queueNames.length; idx = 0; outerloop: while (idx < len) { queueName = queueNames[idx]; queue = this._queues && this._queues[queueName]; delete this._queues[queueName]; if (queue) { // 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(); Ember.tryFinally(tryable, Ember.endPropertyChanges); if (log) { Ember.Logger.log('End: Flush Sync Queue'); } } else { forEach.call(queue, iter); } } // Loop through prior queues for (var i = 0; i <= idx; i++) { if (this._queues && this._queues[queueNames[i]]) { // Start over at the first queue with contents idx = i; continue outerloop; } } idx++; } } timerMark = null; return this; } }; Ember.RunLoop = RunLoop; // .......................................................... // Ember.run - this is ideally the only public API the dev sees // /** Runs the passed target and method inside of a RunLoop, ensuring any deferred actions including bindings and views updates are flushed at the end. Normally you should not need to invoke this method yourself. However if you are implementing raw event handlers when interfacing with other libraries or plugins, you should probably wrap all of your code inside this call. ```javascript Ember.run(function(){ // code to be execute within a RunLoop }); ``` @class run @namespace Ember @static @constructor @param {Object} [target] target of method to call @param {Function|String} method Method to invoke. May be a function or a string. If you pass a string then it will be looked up on the passed target. @param {Object} [args*] Any additional arguments you wish to pass to the method. @return {Object} return value from invoking the passed function. */ Ember.run = function(target, method) { var args = arguments; run.begin(); function tryable() { if (target || method) { return invoke(target, method, args, 2); } } return Ember.tryFinally(tryable, run.end); }; var run = Ember.run; /** Begins a new RunLoop. Any deferred actions invoked after the begin will be buffered until you invoke a matching call to `Ember.run.end()`. This is a lower-level way to use a RunLoop instead of using `Ember.run()`. ```javascript Ember.run.begin(); // code to be execute within a RunLoop Ember.run.end(); ``` @method begin @return {void} */ Ember.run.begin = function() { run.currentRunLoop = new RunLoop(run.currentRunLoop); }; /** Ends a RunLoop. This must be called sometime after you call `Ember.run.begin()` to flush any deferred actions. This is a lower-level way to use a RunLoop instead of using `Ember.run()`. ```javascript Ember.run.begin(); // code to be execute within a RunLoop Ember.run.end(); ``` @method end @return {void} */ Ember.run.end = function() { Ember.assert('must have a current run loop', run.currentRunLoop); function tryable() { run.currentRunLoop.end(); } function finalizer() { run.currentRunLoop = run.currentRunLoop.prev(); } Ember.tryFinally(tryable, finalizer); }; /** Array of named queues. This array determines the order in which queues are flushed at the end of the RunLoop. You can define your own queues by simply adding the queue name to this array. Normally you should not need to inspect or modify this property. @property queues @type Array @default ['sync', 'actions', 'destroy'] */ Ember.run.queues = ['sync', 'actions', 'destroy']; /** Adds the passed target/method and any optional arguments to the named queue to be executed at the end of the RunLoop. If you have not already started a RunLoop when calling this method one will be started for you automatically. At the end of a RunLoop, any methods scheduled in this way will be invoked. Methods will be invoked in an order matching the named queues defined in the `run.queues` property. ```javascript Ember.run.schedule('sync', this, function(){ // this will be executed in the first RunLoop queue, when bindings are synced console.log("scheduled on sync queue"); }); Ember.run.schedule('actions', this, function(){ // this will be executed in the 'actions' queue, after bindings have synced. console.log("scheduled on actions queue"); }); // Note the functions will be run in order based on the run queues order. Output would be: // scheduled on sync queue // scheduled on actions queue ``` @method schedule @param {String} queue The name of the queue to schedule against. Default queues are 'sync' and 'actions' @param {Object} [target] target object to use as the context when invoking a method. @param {String|Function} method The method to invoke. If you pass a string it will be resolved on the target object at the time the scheduled item is invoked allowing you to change the target function. @param {Object} [arguments*] Optional arguments to be passed to the queued method. @return {void} */ Ember.run.schedule = function(queue, target, method) { var loop = run.autorun(); loop.schedule.apply(loop, arguments); }; var scheduledAutorun; function autorun() { scheduledAutorun = null; if (run.currentRunLoop) { run.end(); } } // Used by global test teardown Ember.run.hasScheduledTimers = function() { return !!(scheduledAutorun || scheduledLater); }; // Used by global test teardown Ember.run.cancelTimers = function () { if (scheduledAutorun) { clearTimeout(scheduledAutorun); scheduledAutorun = null; } if (scheduledLater) { clearTimeout(scheduledLater); scheduledLater = null; } timers = {}; }; /** Begins a new RunLoop if necessary and schedules a timer to flush the RunLoop at a later time. This method is used by parts of Ember to ensure the RunLoop always finishes. You normally do not need to call this method directly. Instead use `Ember.run()` @method autorun @example Ember.run.autorun(); @return {Ember.RunLoop} the new current RunLoop */ Ember.run.autorun = function() { if (!run.currentRunLoop) { Ember.assert("You have turned on testing mode, which disabled the run-loop's autorun. You will need to wrap any code with asynchronous side-effects in an Ember.run", !Ember.testing); run.begin(); if (!scheduledAutorun) { scheduledAutorun = setTimeout(autorun, 1); } } return run.currentRunLoop; }; /** Immediately flushes any events scheduled in the 'sync' queue. Bindings use this queue so this method is a useful way to immediately force all bindings in the application to sync. You should call this method anytime you need any changed state to propagate throughout the app immediately without repainting the UI (which happens in the later 'render' queue added by the `ember-views` package). ```javascript Ember.run.sync(); ``` @method sync @return {void} */ Ember.run.sync = function() { run.autorun(); run.currentRunLoop.flush('sync'); }; // .......................................................... // TIMERS // var timers = {}; // active timers... var scheduledLater, scheduledLaterExpires; function invokeLaterTimers() { scheduledLater = null; run(function() { var now = (+ new Date()), earliest = -1; for (var key in timers) { if (!timers.hasOwnProperty(key)) { continue; } var timer = timers[key]; if (timer && timer.expires) { if (now >= 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 when the earliest timer expires if (earliest > 0) { scheduledLater = setTimeout(invokeLaterTimers, earliest - now); scheduledLaterExpires = earliest; } }); } /** 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. ```javascript Ember.run.later(myContext, function(){ // code here will execute within a RunLoop in about 500ms with this == myContext }, 500); ``` @method later @param {Object} [target] 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. @return {String} a string you can use to cancel the timer in {{#crossLink "Ember/run.cancel"}}{{/crossLink}} later. */ 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; if(scheduledLater && expires < scheduledLaterExpires) { // Cancel later timer (then reschedule earlier timer below) clearTimeout(scheduledLater); scheduledLater = null; } if (!scheduledLater) { // Schedule later timers to be run. scheduledLater = setTimeout(invokeLaterTimers, wait); scheduledLaterExpires = expires; } return guid; }; function invokeOnceTimer(guid, onceTimers) { if (onceTimers[this.tguid]) { delete onceTimers[this.tguid][this.mguid]; } if (timers[guid]) { invoke(this.target, this.method, this.args); } delete timers[guid]; } function scheduleOnce(queue, target, method, args) { var tguid = Ember.guidFor(target), mguid = Ember.guidFor(method), onceTimers = run.autorun().onceTimers, guid = onceTimers[tguid] && onceTimers[tguid][mguid], timer; if (guid && timers[guid]) { timers[guid].args = args; // replace args } else { timer = { target: target, method: method, args: args, 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(queue, timer, invokeOnceTimer, guid, onceTimers); } return 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. ```javascript 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 }); ``` Also note that passing an anonymous function to `Ember.run.once` will not prevent additional calls with an identical anonymous function from scheduling the items multiple times, e.g.: ```javascript function scheduleIt() { Ember.run.once(myContext, function() { console.log("Closure"); }); } scheduleIt(); scheduleIt(); // "Closure" will print twice, even though we're using `Ember.run.once`, // because the function we pass to it is anonymous and won't match the // previously scheduled operation. ``` @method once @param {Object} [target] 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. @return {Object} timer */ Ember.run.once = function(target, method) { return scheduleOnce('actions', target, method, slice.call(arguments, 2)); }; Ember.run.scheduleOnce = function(queue, target, method, args) { return scheduleOnce(queue, target, method, slice.call(arguments, 3)); }; /** Schedules an item to run from within a separate run loop, after control has been returned to the system. This is equivalent to calling `Ember.run.later` with a wait time of 1ms. ```javascript Ember.run.next(myContext, function(){ // code to be executed in the next run loop, which will be scheduled after the current one }); ``` Multiple operations scheduled with `Ember.run.next` will coalesce into the same later run loop, along with any other operations scheduled by `Ember.run.later` that expire right around the same time that `Ember.run.next` operations will fire. Note that there are often alternatives to using `Ember.run.next`. For instance, if you'd like to schedule an operation to happen after all DOM element operations have completed within the current run loop, you can make use of the `afterRender` run loop queue (added by the `ember-views` package, along with the preceding `render` queue where all the DOM element operations happen). Example: ```javascript App.MyCollectionView = Ember.CollectionView.extend({ didInsertElement: function() { Ember.run.scheduleOnce('afterRender', this, 'processChildElements'); }, processChildElements: function() { // ... do something with collectionView's child view // elements after they've finished rendering, which // can't be done within the CollectionView's // `didInsertElement` hook because that gets run // before the child elements have been added to the DOM. } }); ``` One benefit of the above approach compared to using `Ember.run.next` is that you will be able to perform DOM/CSS operations before unprocessed elements are rendered to the screen, which may prevent flickering or other artifacts caused by delaying processing until after rendering. The other major benefit to the above approach is that `Ember.run.next` introduces an element of non-determinism, which can make things much harder to test, due to its reliance on `setTimeout`; it's much harder to guarantee the order of scheduled operations when they are scheduled outside of the current run loop, i.e. with `Ember.run.next`. @method next @param {Object} [target] 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. @return {Object} timer */ Ember.run.next = function() { var args = slice.call(arguments); args.push(1); // 1 millisecond wait return run.later.apply(this, args); }; /** Cancels a scheduled item. Must be a value returned by `Ember.run.later()`, `Ember.run.once()`, or `Ember.run.next()`. ```javascript var runNext = Ember.run.next(myContext, function(){ // will not be executed }); Ember.run.cancel(runNext); var runLater = Ember.run.later(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); ``` @method cancel @param {Object} timer Timer object to cancel @return {void} */ Ember.run.cancel = function(timer) { delete timers[timer]; }; })(); (function() { // Ember.Logger // get, set, trySet // guidFor, isArray, meta // addObserver, removeObserver // Ember.run.schedule /** @module ember-metal */ // .......................................................... // CONSTANTS // /** 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. @property LOG_BINDINGS @for Ember @type Boolean @default false */ Ember.LOG_BINDINGS = false || !!Ember.ENV.LOG_BINDINGS; var get = Ember.get, set = Ember.set, guidFor = Ember.guidFor, isGlobalPath = Ember.isGlobalPath; function getWithGlobals(obj, path) { return get(isGlobalPath(path) ? Ember.lookup : obj, path); } // .......................................................... // BINDING // var Binding = function(toPath, fromPath) { this._direction = 'fwd'; this._from = fromPath; this._to = toPath; this._directionMap = Ember.Map.create(); }; /** @class Binding @namespace Ember */ Binding.prototype = { /** This copies the Binding so it can be connected to another object. @method copy @return {Ember.Binding} */ copy: function () { var copy = new Binding(this._to, this._from); if (this._oneWay) { copy._oneWay = true; } return copy; }, // .......................................................... // CONFIG // /** This will set `from` property path to the specified value. It will not attempt to resolve this property path to an actual object until you connect the binding. The binding will search for the property path starting at the root object you pass when you `connect()` the binding. It follows the same rules as `get()` - see that method for more information. @method from @param {String} path the property path to connect to @return {Ember.Binding} `this` */ from: function(path) { this._from = path; return this; }, /** This will set the `to` property path to the specified value. It will not attempt to resolve this property path to an actual object until you connect the binding. The binding will search for the property path starting at the root object you pass when you `connect()` the binding. It follows the same rules as `get()` - see that method for more information. @method to @param {String|Tuple} path A property path or tuple @return {Ember.Binding} `this` */ to: function(path) { this._to = path; return this; }, /** Configures the binding as one way. A one-way binding will relay changes on the `from` side to the `to` side, but not the other way around. This means that if you change the `to` side directly, the `from` side may have a different value. @method oneWay @return {Ember.Binding} `this` */ oneWay: function() { this._oneWay = true; return this; }, /** @method toString @return {String} string representation of binding */ 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. @method connect @param {Object} obj The root object for this binding. @return {Ember.Binding} `this` */ connect: function(obj) { Ember.assert('Must pass a valid object to Ember.Binding.connect()', !!obj); var fromPath = this._from, toPath = this._to; Ember.trySet(obj, toPath, getWithGlobals(obj, fromPath)); // add an observer on the object to be notified when the binding should be updated Ember.addObserver(obj, fromPath, this, this.fromDidChange); // if the binding is a two-way binding, also set up an observer on the target if (!this._oneWay) { Ember.addObserver(obj, toPath, this, this.toDidChange); } this._readyToSync = true; return this; }, /** Disconnects the binding instance. Changes will no longer be relayed. You will not usually need to call this method. @method disconnect @param {Object} obj The root object you passed when connecting the binding. @return {Ember.Binding} `this` */ disconnect: function(obj) { Ember.assert('Must pass a valid object to Ember.Binding.disconnect()', !!obj); var twoWay = !this._oneWay; // 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 the binding is two-way, remove the observer from the target as well if (twoWay) { Ember.removeObserver(obj, this._to, this, this.toDidChange); } this._readyToSync = false; // disable scheduled syncs... return this; }, // .......................................................... // PRIVATE // /* called when the from side changes */ fromDidChange: function(target) { this._scheduleSync(target, 'fwd'); }, /* called when the to side changes */ toDidChange: function(target) { this._scheduleSync(target, 'back'); }, _scheduleSync: function(obj, dir) { var directionMap = this._directionMap; var existingDir = directionMap.get(obj); // if we haven't scheduled the binding yet, schedule it if (!existingDir) { Ember.run.schedule('sync', this, this._sync, obj); directionMap.set(obj, 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') { directionMap.set(obj, 'fwd'); } }, _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 directionMap = this._directionMap; var direction = directionMap.get(obj); var fromPath = this._from, toPath = this._to; directionMap.remove(obj); // if we're synchronizing from the remote object... if (direction === 'fwd') { var fromValue = getWithGlobals(obj, this._from); if (log) { Ember.Logger.log(' ', this.toString(), '->', fromValue, obj); } if (this._oneWay) { Ember.trySet(obj, toPath, fromValue); } else { Ember._suspendObserver(obj, toPath, this, this.toDidChange, function () { Ember.trySet(obj, toPath, fromValue); }); } // if we're synchronizing *to* the remote object } else if (direction === 'back') { var toValue = get(obj, this._to); if (log) { Ember.Logger.log(' ', this.toString(), '<-', toValue, obj); } Ember._suspendObserver(obj, fromPath, this, this.fromDidChange, function () { Ember.trySet(Ember.isGlobalPath(fromPath) ? Ember.lookup : obj, fromPath, toValue); }); } } }; function mixinProperties(to, from) { for (var key in from) { if (from.hasOwnProperty(key)) { to[key] = from[key]; } } } mixinProperties(Binding, { /** See {{#crossLink "Ember.Binding/from"}}{{/crossLink}} @method from @static */ from: function() { var C = this, binding = new C(); return binding.from.apply(binding, arguments); }, /** See {{#crossLink "Ember.Binding/to"}}{{/crossLink}} @method to @static */ to: function() { var C = this, binding = new C(); return binding.to.apply(binding, arguments); }, /** Creates a new Binding instance and makes it apply in a single direction. A one-way binding will relay changes on the `from` side object (supplied as the `from` argument) the `to` side, but not the other way around. This means that if you change the "to" side directly, the "from" side may have a different value. See {{#crossLink "Binding/oneWay"}}{{/crossLink}} @method oneWay @param {String} from from path. @param {Boolean} [flag] (Optional) passing nothing here will make the binding `oneWay`. You can instead pass `false` to disable `oneWay`, making the binding two way again. */ oneWay: function(from, flag) { var C = this, binding = new C(null, from); return binding.oneWay(flag); } }); /** An `Ember.Binding` connects the properties of two objects so that whenever the value of one property changes, the other property will be changed also. ## Automatic Creation of Bindings with `/^*Binding/`-named Properties You do not usually create Binding objects directly but instead describe bindings in your class or object definition using automatic binding detection. Properties ending in a `Binding` suffix will be converted to `Ember.Binding` instances. The value of this property should be a string representing a path to another object or a custom binding instanced created using Binding helpers (see "Customizing Your Bindings"): ``` 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. ## 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 Bindings Manually 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 instance. 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: ```javascript 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: ```javascript 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): ```javascript 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: ```javascript 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. @class Binding @namespace Ember @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. @method bind @for Ember @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. @return {Ember.Binding} binding instance */ Ember.bind = function(obj, to, from) { return new Ember.Binding(to, from).connect(obj); }; /** @method oneWay @for Ember @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. @return {Ember.Binding} binding instance */ Ember.oneWay = function(obj, to, from) { return new Ember.Binding(to, from).oneWay().connect(obj); }; })(); (function() { /** @module ember-metal */ var Mixin, REQUIRED, Alias, a_map = Ember.ArrayPolyfills.map, a_indexOf = Ember.ArrayPolyfills.indexOf, a_forEach = Ember.ArrayPolyfills.forEach, a_slice = [].slice, o_create = Ember.create, defineProperty = Ember.defineProperty, guidFor = Ember.guidFor; function mixinsMeta(obj) { var m = Ember.meta(obj, true), ret = m.mixins; if (!ret) { ret = m.mixins = {}; } else if (!m.hasOwnProperty('mixins')) { ret = m.mixins = o_create(ret); } return ret; } function initMixin(mixin, args) { if (args && args.length > 0) { mixin.mixins = a_map.call(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; } function isMethod(obj) { return 'function' === typeof obj && obj.isMethod !== false && obj !== Boolean && obj !== Object && obj !== Number && obj !== Array && obj !== Date && obj !== String; } var CONTINUE = {}; function mixinProperties(mixinsMeta, mixin) { var guid; if (mixin instanceof Mixin) { guid = guidFor(mixin); if (mixinsMeta[guid]) { return CONTINUE; } mixinsMeta[guid] = mixin; return mixin.properties; } else { return mixin; // apply anonymous mixin properties } } function concatenatedProperties(props, values, base) { var concats; // reset before adding each new mixin to pickup concats from previous concats = values.concatenatedProperties || base.concatenatedProperties; if (props.concatenatedProperties) { concats = concats ? concats.concat(props.concatenatedProperties) : props.concatenatedProperties; } return concats; } function giveDescriptorSuper(meta, key, property, values, descs) { var superProperty; // Computed properties override methods, and do not call super to them if (values[key] === undefined) { // Find the original descriptor in a parent mixin superProperty = descs[key]; } // If we didn't find the original descriptor in a parent mixin, find // it on the original object. superProperty = superProperty || meta.descs[key]; if (!superProperty || !(superProperty instanceof Ember.ComputedProperty)) { return property; } // Since multiple mixins may inherit from the same parent, we need // to clone the computed property so that other mixins do not receive // the wrapped version. property = o_create(property); property.func = Ember.wrap(property.func, superProperty.func); return property; } function giveMethodSuper(obj, key, method, values, descs) { var superMethod; // Methods overwrite computed properties, and do not call super to them. if (descs[key] === undefined) { // Find the original method in a parent mixin superMethod = values[key]; } // If we didn't find the original value in a parent mixin, find it in // the original object superMethod = superMethod || obj[key]; // Only wrap the new method if the original method was a function if ('function' !== typeof superMethod) { return method; } return Ember.wrap(method, superMethod); } function applyConcatenatedProperties(obj, key, value, values) { var baseValue = values[key] || obj[key]; if (baseValue) { if ('function' === typeof baseValue.concat) { return baseValue.concat(value); } else { return Ember.makeArray(baseValue).concat(value); } } else { return Ember.makeArray(value); } } function addNormalizedProperty(base, key, value, meta, descs, values, concats) { if (value instanceof Ember.Descriptor) { if (value === REQUIRED && descs[key]) { return CONTINUE; } // Wrap descriptor function to implement // _super() if needed if (value.func) { value = giveDescriptorSuper(meta, key, value, values, descs); } descs[key] = value; values[key] = undefined; } else { // impl super if needed... if (isMethod(value)) { value = giveMethodSuper(base, key, value, values, descs); } else if ((concats && a_indexOf.call(concats, key) >= 0) || key === 'concatenatedProperties') { value = applyConcatenatedProperties(base, key, value, values); } descs[key] = undefined; values[key] = value; } } function mergeMixins(mixins, m, descs, values, base) { var mixin, props, key, concats, meta; function removeKeys(keyName) { delete descs[keyName]; delete values[keyName]; } for(var i=0, l=mixins.length; i= 0) { if (_detect(mixins[loc], targetMixin, seen)) { return true; } } return false; } /** @method detect @param obj @return {Boolean} */ MixinPrototype.detect = function(obj) { if (!obj) { return false; } if (obj instanceof Mixin) { return _detect(obj, this, {}); } var mixins = Ember.meta(obj, false).mixins; if (mixins) { return !!mixins[guidFor(this)]; } return false; }; MixinPrototype.without = function() { var ret = new Mixin(this); ret._without = a_slice.call(arguments); return ret; }; function _keys(ret, mixin, seen) { if (seen[guidFor(mixin)]) { return; } seen[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.call(mixin.mixins, function(x) { _keys(ret, x, seen); }); } } MixinPrototype.keys = function() { var keys = {}, seen = {}, ret = []; _keys(keys, this, seen); for(var key in keys) { if (keys.hasOwnProperty(key)) { ret.push(key); } } return ret; }; // returns the mixins currently applied to the specified object // TODO: Make Ember.mixin Mixin.mixins = function(obj) { var mixins = Ember.meta(obj, false).mixins, ret = []; if (!mixins) { return ret; } for (var key in mixins) { var mixin = mixins[key]; // skip primitive mixins since these are always anonymous if (!mixin.properties) { ret.push(mixin); } } return ret; }; REQUIRED = new Ember.Descriptor(); REQUIRED.toString = function() { return '(Required Property)'; }; /** Denotes a required property for a mixin @method required @for Ember */ Ember.required = function() { return REQUIRED; }; Alias = function(methodName) { this.methodName = methodName; }; Alias.prototype = new Ember.Descriptor(); /** Makes a property or method available via an additional name. ```javascript App.PaintSample = Ember.Object.extend({ color: 'red', colour: Ember.alias('color'), name: function(){ return "Zed"; }, moniker: Ember.alias("name") }); var paintSample = App.PaintSample.create() paintSample.get('colour'); // 'red' paintSample.moniker(); // 'Zed' ``` @method alias @for Ember @param {String} methodName name of the method or property to alias @return {Ember.Descriptor} @deprecated Use `Ember.aliasMethod` or `Ember.computed.alias` instead */ Ember.alias = function(methodName) { return new Alias(methodName); }; Ember.deprecateFunc("Ember.alias is deprecated. Please use Ember.aliasMethod or Ember.computed.alias instead.", Ember.alias); /** Makes a method available via an additional name. ```javascript App.Person = Ember.Object.extend({ name: function(){ return 'Tomhuda Katzdale'; }, moniker: Ember.aliasMethod('name') }); var goodGuy = App.Person.create() ``` @method aliasMethod @for Ember @param {String} methodName name of the method to alias @return {Ember.Descriptor} */ Ember.aliasMethod = function(methodName) { return new Alias(methodName); }; // .......................................................... // OBSERVER HELPER // /** @method observer @for Ember @param {Function} func @param {String} propertyNames* @return func */ Ember.observer = function(func) { var paths = a_slice.call(arguments, 1); func.__ember_observes__ = paths; return func; }; // If observers ever become asynchronous, Ember.immediateObserver // must remain synchronous. /** @method immediateObserver @for Ember @param {Function} func @param {String} propertyNames* @return func */ Ember.immediateObserver = function() { for (var i=0, l=arguments.length; i 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; case 'date': var vNum = v.getTime(); var wNum = w.getTime(); if (vNum < wNum) { return -1; } if (vNum > wNum) { return 1; } return 0; default: return 0; } }; 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]; Ember.assert('Cannot clone an Ember.Object that does not implement Ember.Copyable', !(obj instanceof Ember.Object) || (Ember.Copyable && Ember.Copyable.detect(obj))); // 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; // Prevents browsers that don't respect non-enumerability from // copying internal Ember properties if (key.substring(0,2) === '__') 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. @method copy @for Ember @param {Object} obj The object to clone @param {Boolean} deep If true, a deep copy of the object is made @return {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. It is a pretty simple implementation. If you want something more robust, use something like JSDump: https://github.com/NV/jsDump @method inspect @for Ember @param {Object} obj The object you want to inspect. @return {String} A description of the object */ Ember.inspect = function(obj) { if (typeof obj !== 'object' || obj === null) { return 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. ```javascript Ember.isEqual('hello', 'hello'); // true Ember.isEqual(1, 2); // false Ember.isEqual([4,2], [4,2]); // false ``` @method isEqual @for Ember @param {Object} a first object to compare @param {Object} b second object to compare @return {Boolean} */ Ember.isEqual = function(a, b) { if (a && 'function'===typeof a.isEqual) return a.isEqual(b); return a === b; }; // Used by Ember.compare Ember.ORDER_DEFINITION = Ember.ENV.ORDER_DEFINITION || [ 'undefined', 'null', 'boolean', 'number', 'string', 'array', 'object', 'instance', 'function', 'class', 'date' ]; /** 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. @method keys @for Ember @param {Object} obj @return {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 // var errorProps = ['description', 'fileName', 'lineNumber', 'message', 'name', 'number', 'stack']; /** A subclass of the JavaScript Error object for use in Ember. @class Error @namespace Ember @extends Error @constructor */ Ember.Error = function() { var tmp = Error.prototype.constructor.apply(this, arguments); // Unfortunately errors are not enumerable in Chrome (at least), so `for prop in tmp` doesn't work. for (var idx = 0; idx < errorProps.length; idx++) { this[errorProps[idx]] = tmp[errorProps[idx]]; } }; Ember.Error.prototype = Ember.create(Error.prototype); })(); (function() { /** Expose RSVP implementation @class RSVP @namespace Ember @constructor */ Ember.RSVP = requireModule('rsvp'); })(); (function() { /** @module ember @submodule ember-runtime */ 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 STRINGS @for Ember @type Hash */ Ember.STRINGS = {}; /** Defines string helper methods including string formatting and localization. Unless `Ember.EXTEND_PROTOTYPES.String` is `false` these methods will also be added to the `String.prototype` as well. @class String @namespace Ember @static */ 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. ```javascript "Hello %@ %@".fmt('John', 'Doe'); // "Hello John Doe" "Hello %@2, %@1".fmt('John', 'Doe'); // "Hello Doe, John" ``` @method fmt @param {Object...} [args] @return {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. ```javascript 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"; ``` @method loc @param {String} str The string to format @param {Array} formats Optional array of parameters to interpolate into string. @return {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`. ```javascript Ember.String.w("alpha beta gamma").forEach(function(key) { console.log(key); }); // > alpha // > beta // > gamma ``` @method w @param {String} str The string to split @return {String} split string */ w: function(str) { return str.split(/\s+/); }, /** Converts a camelized string into all lower case separated by underscores. ```javascript 'innerHTML'.decamelize(); // 'inner_html' 'action_name'.decamelize(); // 'action_name' 'css-class-name'.decamelize(); // 'css-class-name' 'my favorite items'.decamelize(); // 'my favorite items' ``` @method decamelize @param {String} str The string to decamelize. @return {String} the decamelized string. */ decamelize: function(str) { return str.replace(STRING_DECAMELIZE_REGEXP, '$1_$2').toLowerCase(); }, /** Replaces underscores or spaces with dashes. ```javascript 'innerHTML'.dasherize(); // 'inner-html' 'action_name'.dasherize(); // 'action-name' 'css-class-name'.dasherize(); // 'css-class-name' 'my favorite items'.dasherize(); // 'my-favorite-items' ``` @method dasherize @param {String} str The string to dasherize. @return {String} the dasherized string. */ dasherize: function(str) { var cache = STRING_DASHERIZE_CACHE, hit = cache.hasOwnProperty(str), ret; if (hit) { return cache[str]; } else { ret = Ember.String.decamelize(str).replace(STRING_DASHERIZE_REGEXP,'-'); cache[str] = ret; } return ret; }, /** Returns the lowerCamelCase form of a string. ```javascript 'innerHTML'.camelize(); // 'innerHTML' 'action_name'.camelize(); // 'actionName' 'css-class-name'.camelize(); // 'cssClassName' 'my favorite items'.camelize(); // 'myFavoriteItems' 'My Favorite Items'.camelize(); // 'myFavoriteItems' ``` @method camelize @param {String} str The string to camelize. @return {String} the camelized string. */ camelize: function(str) { return str.replace(STRING_CAMELIZE_REGEXP, function(match, separator, chr) { return chr ? chr.toUpperCase() : ''; }).replace(/^([A-Z])/, function(match, separator, chr) { return match.toLowerCase(); }); }, /** Returns the UpperCamelCase form of a string. ```javascript 'innerHTML'.classify(); // 'InnerHTML' 'action_name'.classify(); // 'ActionName' 'css-class-name'.classify(); // 'CssClassName' 'my favorite items'.classify(); // 'MyFavoriteItems' ``` @method classify @param {String} str the string to classify @return {String} the classified string */ classify: function(str) { var parts = str.split("."), out = []; for (var i=0, l=parts.length; i1) 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. @method toArray @return {Array} the enumerable as an array. */ toArray: function() { var ret = Ember.A([]); this.forEach(function(o, idx) { ret[idx] = o; }); return ret ; }, /** Returns a copy of the array with all null and undefined elements removed. ```javascript var arr = ["a", null, "c", undefined]; arr.compact(); // ["a", "c"] ``` @method compact @return {Array} the array without null and undefined elements. */ compact: function() { return this.filter(function(value) { return value != 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. ```javascript var arr = ["a", "b", "a", "c"]; arr.without("a"); // ["b", "c"] ``` @method without @param {Object} value @return {Ember.Enumerable} */ without: function(value) { if (!this.contains(value)) return this; // nothing to do var ret = Ember.A([]); 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. ```javascript var arr = ["a", "a", "b", "b"]; arr.uniq(); // ["a", "b"] ``` @method uniq @return {Ember.Enumerable} */ uniq: function() { var ret = Ember.A([]); 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 [] @type Ember.Array @return this */ '[]': Ember.computed(function(key, value) { return this; }), // .......................................................... // ENUMERABLE OBSERVERS // /** Registers an enumerable observer. Must implement `Ember.EnumerableObserver` mixin. @method addEnumerableObserver @param {Object} target @param {Hash} [opts] @return this */ 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); Ember.addListener(this, '@enumerable:change', target, didChange); if (!hasObservers) Ember.propertyDidChange(this, 'hasEnumerableObservers'); return this; }, /** Removes a registered enumerable observer. @method removeEnumerableObserver @param {Object} target @param {Hash} [opts] @return this */ 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 hasEnumerableObservers @type Boolean */ hasEnumerableObservers: Ember.computed(function() { return Ember.hasListeners(this, '@enumerable:change') || Ember.hasListeners(this, '@enumerable:before'); }), /** 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. @method enumerableContentWillChange @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. @chainable */ 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', [this, 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. @method enumerableContentDidChange @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|Number} adding An enumerable of the objects to be added or the number of items to be added. @chainable */ enumerableContentDidChange: 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.sendEvent(this, '@enumerable:change', [this, removing, adding]); if (hasDelta) Ember.propertyDidChange(this, 'length'); Ember.propertyDidChange(this, '[]'); return this ; } }) ; })(); (function() { /** @module ember @submodule ember-runtime */ // .......................................................... // HELPERS // var get = Ember.get, set = Ember.set, map = Ember.EnumerableUtils.map, cacheFor = Ember.cacheFor; function none(obj) { return obj===null || obj===undefined; } // .......................................................... // ARRAY // /** 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. @class Array @namespace Ember @extends Ember.Mixin @uses Ember.Enumerable @since Ember 0.9.0 */ Ember.Array = Ember.Mixin.create(Ember.Enumerable, /** @scope Ember.Array.prototype */ { // compatibility isSCArray: true, /** Your array must support the `length` property. Your replace methods should set this property whenever it changes. @property {Number} length */ length: Ember.required(), /** Returns the object at the given `index`. If the given `index` is negative or is greater or equal than the array length, returns `undefined`. This is one of the primitives you must implement to support `Ember.Array`. 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. ```javascript var arr = ['a', 'b', 'c', 'd']; arr.objectAt(0); // "a" arr.objectAt(3); // "d" arr.objectAt(-1); // undefined arr.objectAt(4); // undefined arr.objectAt(5); // undefined ``` @method objectAt @param {Number} idx The index of the item to return. @return {any} item at index or undefined */ 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`. ```javascript var arr = ['a', 'b', 'c', 'd']; arr.objectsAt([0, 1, 2]); // ["a", "b", "c"] arr.objectsAt([2, 3, 4]); // ["c", "d", undefined] ``` @method objectsAt @param {Array} indexes An array of indexes of items to return. @return {Array} */ objectsAt: function(indexes) { var self = this; return map(indexes, function(idx){ return self.objectAt(idx); }); }, // overrides Ember.Enumerable version nextObject: function(idx) { return this.objectAt(idx); }, /** 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`. @property [] @return this */ '[]': Ember.computed(function(key, value) { if (value !== undefined) this.replace(0, get(this, 'length'), value) ; return this ; }), firstObject: Ember.computed(function() { return this.objectAt(0); }), lastObject: Ember.computed(function() { return this.objectAt(get(this, 'length')-1); }), // 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. ```javascript var arr = ['red', 'green', 'blue']; arr.slice(0); // ['red', 'green', 'blue'] arr.slice(0, 2); // ['red', 'green'] arr.slice(1, 100); // ['green', 'blue'] ``` @method slice @param {Integer} beginIndex (Optional) index to begin slicing from. @param {Integer} endIndex (Optional) index to end the slice at. @return {Array} New array with specified slice */ slice: function(beginIndex, endIndex) { var ret = Ember.A([]); var length = get(this, 'length') ; if (none(beginIndex)) beginIndex = 0 ; if (none(endIndex) || (endIndex > length)) endIndex = length ; if (beginIndex < 0) beginIndex = length + beginIndex; if (endIndex < 0) endIndex = length + endIndex; 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. ```javascript 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 ``` @method indexOf @param {Object} object the item to search for @param {Number} startAt optional starting location to search, default 0 @return {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= 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. @method addArrayObserver @param {Object} target The observer object. @param {Hash} opts Optional hash of configuration options including `willChange` and `didChange` option. @return {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); Ember.addListener(this, '@array:change', target, didChange); 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. @method removeArrayObserver @param {Object} target The object observing the array. @param {Hash} opts Optional hash of configuration options including `willChange` and `didChange` option. @return {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); Ember.removeListener(this, '@array:change', target, didChange); 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'); }), /** 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. @method arrayContentWillChange @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. @return {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; } // Make sure the @each proxy is set up if anyone is observing @each if (Ember.isWatching(this, '@each')) { get(this, '@each'); } Ember.sendEvent(this, '@array:before', [this, 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. @method compare @param a {Object} the first object to compare @param b {Object} the second object to compare @return {Integer} the result of the comparison */ compare: Ember.required(Function) }); })(); (function() { /** @module ember @submodule ember-runtime */ var get = Ember.get, set = Ember.set; /** 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`. @class Copyable @namespace Ember @extends Ember.Mixin @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. @method copy @param {Boolean} deep if `true`, a deep copy of the object should be made @return {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. @method frozenCopy @return {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() { /** @module ember @submodule ember-runtime */ var get = Ember.get, set = Ember.set; /** 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. ```javascript 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. @class Freezable @namespace Ember @extends Ember.Mixin @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 isFrozen @type Boolean */ isFrozen: false, /** Freezes the object. Once this method has been called the object should no longer allow any properties to be edited. @method freeze @return {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() { /** @module ember @submodule ember-runtime */ var forEach = Ember.EnumerableUtils.forEach; /** 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. ```javascript 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. ```javascript 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. @class MutableEnumerable @namespace Ember @extends Ember.Mixin @uses Ember.Enumerable */ Ember.MutableEnumerable = Ember.Mixin.create(Ember.Enumerable, { /** __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. @method addObject @param {Object} object The object to add to the enumerable. @return {Object} the passed object */ addObject: Ember.required(Function), /** Adds each object in the passed enumerable to the receiver. @method addObjects @param {Ember.Enumerable} objects the objects to add. @return {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. @method removeObject @param {Object} object The object to remove from the enumerable. @return {Object} the passed object */ removeObject: Ember.required(Function), /** Removes each objects in the passed enumerable from the receiver. @method removeObjects @param {Ember.Enumerable} objects the objects to remove @return {Object} receiver */ removeObjects: function(objects) { Ember.beginPropertyChanges(this); forEach(objects, function(obj) { this.removeObject(obj); }, this); Ember.endPropertyChanges(this); return this; } }); })(); (function() { /** @module ember @submodule ember-runtime */ // .......................................................... // CONSTANTS // var OUT_OF_RANGE_EXCEPTION = "Index out of range" ; var EMPTY = []; // .......................................................... // HELPERS // var get = Ember.get, set = Ember.set; /** 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. @class MutableArray @namespace Ember @extends Ember.Mixin @uses Ember.Array @uses 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()` @method replace @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. ```javascript var colors = ["red", "green", "blue"]; color.length(); // 3 colors.clear(); // [] colors.length(); // 0 ``` @method clear @return {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. ```javascript var colors = ["red", "green", "blue"]; colors.insertAt(2, "yellow"); // ["red", "green", "yellow", "blue"] colors.insertAt(5, "orange"); // Error: Index out of range ``` @method insertAt @param {Number} idx index of insert the object at. @param {Object} object object to insert @return this */ 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` ```javascript 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 ``` @method removeAt @param {Number} start index, start of range @param {Number} len length of passing range @return {Object} receiver */ removeAt: function(start, len) { 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. ```javascript var colors = ["red", "green", "blue"]; colors.pushObject("black"); // ["red", "green", "blue", "black"] colors.pushObject(["yellow", "orange"]); // ["red", "green", "blue", "black", ["yellow", "orange"]] ``` @method pushObject @param {anything} obj object to push @return {any} the same obj passed as param */ 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. ```javascript var colors = ["red", "green", "blue"]; colors.pushObjects("black"); // ["red", "green", "blue", "black"] colors.pushObjects(["yellow", "orange"]); // ["red", "green", "blue", "black", "yellow", "orange"] ``` @method pushObjects @param {Ember.Enumerable} objects the objects to add @return {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. ```javascript var colors = ["red", "green", "blue"]; colors.popObject(); // "blue" console.log(colors); // ["red", "green"] ``` @method popObject @return object */ 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. ```javascript var colors = ["red", "green", "blue"]; colors.shiftObject(); // "red" console.log(colors); // ["green", "blue"] ``` @method shiftObject @return object */ 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. ```javascript var colors = ["red", "green", "blue"]; colors.unshiftObject("yellow"); // ["yellow", "red", "green", "blue"] colors.unshiftObject(["black", "white"]); // [["black", "white"], "yellow", "red", "green", "blue"] ``` @method unshiftObject @param {anything} obj object to unshift @return {any} the same obj passed as param */ 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. ```javascript var colors = ["red", "green", "blue"]; colors.unshiftObjects(["black", "white"]); // ["black", "white", "red", "green", "blue"] colors.unshiftObjects("yellow"); // Type Error: 'undefined' is not a function ``` @method unshiftObjects @param {Ember.Enumerable} objects the objects to add @return {Ember.Array} receiver */ unshiftObjects: function(objects) { this.replace(0, 0, objects); return this; }, /** Reverse objects in the array. Works just like `reverse()` but it is KVO-compliant. @method reverseObjects @return {Ember.Array} receiver */ reverseObjects: function() { var len = get(this, 'length'); if (len === 0) return this; var objects = this.toArray().reverse(); this.replace(0, len, objects); return this; }, /** Replace all the the receiver's content with content of the argument. If argument is an empty array receiver will be cleared. ```javascript var colors = ["red", "green", "blue"]; colors.setObjects(["black", "white"]); // ["black", "white"] colors.setObjects([]); // [] ``` @method setObjects @param {Ember.Array} objects array whose content will be used for replacing the content of the receiver @return {Ember.Array} receiver with the new content */ setObjects: function(objects) { if (objects.length === 0) return this.clear(); var len = get(this, 'length'); this.replace(0, len, objects); return this; }, // .......................................................... // IMPLEMENT Ember.MutableEnumerable // 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 ; }, addObject: function(obj) { if (!this.contains(obj)) this.pushObject(obj); return this ; } }); })(); (function() { /** @module ember @submodule ember-runtime */ var get = Ember.get, set = Ember.set; /** ## 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: ```javascript 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: ```javascript 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. @class Observable @namespace Ember @extends Ember.Mixin */ Ember.Observable = Ember.Mixin.create(/** @scope Ember.Observable.prototype */ { /** 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: ```javascript 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. @method get @param {String} keyName The property to retrieve @return {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: ```javascript record.getProperties('firstName', 'lastName', 'zipCode'); // { firstName: 'John', lastName: 'Doe', zipCode: '10011' } ``` is equivalent to: ```javascript record.getProperties(['firstName', 'lastName', 'zipCode']); // { firstName: 'John', lastName: 'Doe', zipCode: '10011' } ``` @method getProperties @param {String...|Array} list of keys to get @return {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 provided key or path to the 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: ```javascript record.set('firstName', 'Charles').set('lastName', 'Jolley'); ``` @method set @param {String} keyName The property to set @param {Object} value The value to set or `null`. @return {Ember.Observable} */ set: function(keyName, value) { set(this, keyName, value); return this; }, /** To set multiple properties at once, call `setProperties` with a Hash: ```javascript record.setProperties({ firstName: 'Charles', lastName: 'Jolley' }); ``` @method setProperties @param {Hash} hash the hash of keys and values to set @return {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. @method beginPropertyChanges @return {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. @method endPropertyChanges @return {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. @method propertyWillChange @param {String} keyName The property key that is about to change. @return {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. @method propertyDidChange @param {String} keyName The property key that has just changed. @return {Ember.Observable} */ propertyDidChange: function(keyName) { Ember.propertyDidChange(this, keyName); return this; }, /** Convenience method to call `propertyWillChange` and `propertyDidChange` in succession. @method notifyPropertyChange @param {String} keyName The property key to be notified about. @return {Ember.Observable} */ notifyPropertyChange: function(keyName) { this.propertyWillChange(keyName); this.propertyDidChange(keyName); return this; }, addBeforeObserver: function(key, target, method) { Ember.addBeforeObserver(this, key, target, method); }, /** 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: ```javascript 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: ```javascript 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. @method addObserver @param {String} key The key to observer @param {Object} target The target object to invoke @param {String|Function} method The method to invoke. @return {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. @method removeObserver @param {String} key The key to observer @param {Object} target The target object to invoke @param {String|Function} method The method to invoke. @return {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. @method hasObserverFor @param {String} key Key to check @return {Boolean} */ hasObserverFor: function(key) { return Ember.hasListeners(this, key+':change'); }, /** @deprecated @method getPath @param {String} path The property path to retrieve @return {Object} The property value or undefined. */ getPath: function(path) { Ember.deprecate("getPath is deprecated since get now supports paths"); return this.get(path); }, /** @deprecated @method setPath @param {String} path The path to the property that will be set @param {Object} value The value to set or `null`. @return {Ember.Observable} */ setPath: function(path, value) { Ember.deprecate("setPath is deprecated since set now supports paths"); return this.set(path, value); }, /** Retrieves the value of a property, or a default value in the case that the property returns `undefined`. ```javascript person.getWithDefault('lastName', 'Doe'); ``` @method getWithDefault @param {String} keyName The name of the property to retrieve @param {Object} defaultValue The value to return if the property value is undefined @return {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. ```javascript person.incrementProperty('age'); team.incrementProperty('score', 2); ``` @method incrementProperty @param {String} keyName The name of the property to increment @param {Object} increment The amount to increment by. Defaults to 1 @return {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. ```javascript player.decrementProperty('lives'); orc.decrementProperty('health', 5); ``` @method decrementProperty @param {String} keyName The name of the property to decrement @param {Object} increment The amount to decrement by. Defaults to 1 @return {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. ```javascript starship.toggleProperty('warpDriveEnaged'); ``` @method toggleProperty @param {String} keyName The name of the property to toggle @return {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. @method cacheFor @param {String} keyName @return {Object} The cached value of the computed property, if any */ cacheFor: function(keyName) { return Ember.cacheFor(this, keyName); }, // intended for debugging purposes observersForKey: function(keyName) { return Ember.observersFor(this, keyName); } }); })(); (function() { /** @module ember @submodule ember-runtime */ var get = Ember.get, set = Ember.set; /** @class TargetActionSupport @namespace Ember @extends Ember.Mixin */ 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 = get(this, target); if (value === undefined) { value = get(Ember.lookup, target); } return value; } else { return target; } }).property('target'), 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() { /** @module ember @submodule ember-runtime */ /** This mixin allows for Ember objects to subscribe to and emit events. ```javascript App.Person = Ember.Object.extend(Ember.Evented, { greet: function() { // ... this.trigger('greet'); } }); var person = App.Person.create(); person.on('greet', function() { console.log('Our person has greeted'); }); person.greet(); // outputs: 'Our person has greeted' ``` You can also chain multiple event subscriptions: ```javascript person.on('greet', function() { console.log('Our person has greeted'); }).one('greet', function() { console.log('Offer one-time special'); }).off('event', this, forgetThis); ``` @class Evented @namespace Ember @extends Ember.Mixin */ Ember.Evented = Ember.Mixin.create({ /** Subscribes to a named event with given function. ```javascript person.on('didLoad', function() { // fired once the person has loaded }); ``` An optional target can be passed in as the 2nd argument that will be set as the "this" for the callback. This is a good way to give your function access to the object triggering the event. When the target parameter is used the callback becomes the third argument. @method on @param {String} name The name of the event @param {Object} [target] The "this" binding for the callback @param {Function} method The callback to execute @return this */ on: function(name, target, method) { Ember.addListener(this, name, target, method); return this; }, /** Subscribes a function to a named event and then cancels the subscription after the first time the event is triggered. It is good to use ``one`` when you only care about the first time an event has taken place. This function takes an optional 2nd argument that will become the "this" value for the callback. If this argument is passed then the 3rd argument becomes the function. @method one @param {String} name The name of the event @param {Object} [target] The "this" binding for the callback @param {Function} method The callback to execute @return this */ one: function(name, target, method) { if (!method) { method = target; target = null; } Ember.addListener(this, name, target, method, true); return this; }, /** Triggers a named event for the object. Any additional arguments will be passed as parameters to the functions that are subscribed to the event. ```javascript person.on('didEat', function(food) { console.log('person ate some ' + food); }); person.trigger('didEat', 'broccoli'); // outputs: person ate some broccoli ``` @method trigger @param {String} name The name of the event @param {Object...} args Optional arguments to pass on */ trigger: function(name) { var args = [], i, l; for (i = 1, l = arguments.length; i < l; i++) { args.push(arguments[i]); } Ember.sendEvent(this, name, args); }, fire: function(name) { Ember.deprecate("Ember.Evented#fire() has been deprecated in favor of trigger() for compatibility with jQuery. It will be removed in 1.0. Please update your code to call trigger() instead."); this.trigger.apply(this, arguments); }, /** Cancels subscription for give name, target, and method. @method off @param {String} name The name of the event @param {Object} target The target of the subscription @param {Function} method The function of the subscription @return this */ off: function(name, target, method) { Ember.removeListener(this, name, target, method); return this; }, /** Checks to see if object has any subscriptions for named event. @method has @param {String} name The name of the event @return {Boolean} does the object have a subscription for event */ has: function(name) { return Ember.hasListeners(this, name); } }); })(); (function() { var RSVP = requireModule("rsvp"); RSVP.async = function(callback, binding) { Ember.run.schedule('actions', binding, callback); }; /** @module ember @submodule ember-runtime */ var get = Ember.get; /** @class Deferred @namespace Ember @extends Ember.Mixin */ Ember.DeferredMixin = Ember.Mixin.create({ /** Add handlers to be called when the Deferred object is resolved or rejected. @method then @param {Function} doneCallback a callback function to be called when done @param {Function} failCallback a callback function to be called when failed */ then: function(doneCallback, failCallback) { var promise = get(this, 'promise'); return promise.then.apply(promise, arguments); }, /** Resolve a Deferred object and call any `doneCallbacks` with the given args. @method resolve */ resolve: function(value) { get(this, 'promise').resolve(value); }, /** Reject a Deferred object and call any `failCallbacks` with the given args. @method reject */ reject: function(value) { get(this, 'promise').reject(value); }, promise: Ember.computed(function() { return new RSVP.Promise(); }) }); })(); (function() { })(); (function() { Ember.Container = requireModule('container'); Ember.Container.set = Ember.set; })(); (function() { /** @module ember @submodule ember-runtime */ // 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 set = Ember.set, get = Ember.get, o_create = Ember.create, o_defineProperty = Ember.platform.defineProperty, GUID_KEY = Ember.GUID_KEY, guidFor = Ember.guidFor, generateGuid = Ember.generateGuid, meta = Ember.meta, rewatch = Ember.rewatch, finishChains = Ember.finishChains, destroy = Ember.destroy, schedule = Ember.run.schedule, Mixin = Ember.Mixin, applyMixin = Mixin._apply, finishPartial = Mixin.finishPartial, reopen = Mixin.prototype.reopen, MANDATORY_SETTER = Ember.ENV.MANDATORY_SETTER, indexOf = Ember.EnumerableUtils.indexOf; var undefinedDescriptor = { configurable: true, writable: true, enumerable: false, value: undefined }; 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, initProperties; var Class = function() { if (!wasApplied) { Class.proto(); // prepare prototype... } o_defineProperty(this, GUID_KEY, undefinedDescriptor); o_defineProperty(this, '_super', undefinedDescriptor); var m = meta(this); m.proto = this; if (initMixins) { // capture locally so we can clear the closed over variable var mixins = initMixins; initMixins = null; this.reopen.apply(this, mixins); } if (initProperties) { // capture locally so we can clear the closed over variable var props = initProperties; initProperties = null; var concatenatedProperties = this.concatenatedProperties; for (var i = 0, l = props.length; i < l; i++) { var properties = props[i]; for (var keyName in properties) { if (!properties.hasOwnProperty(keyName)) { continue; } var value = properties[keyName], IS_BINDING = Ember.IS_BINDING; if (IS_BINDING.test(keyName)) { var bindings = m.bindings; if (!bindings) { bindings = m.bindings = {}; } else if (!m.hasOwnProperty('bindings')) { bindings = m.bindings = o_create(m.bindings); } bindings[keyName] = value; } var desc = m.descs[keyName]; Ember.assert("Ember.Object.create no longer supports defining computed properties.", !(value instanceof Ember.ComputedProperty)); Ember.assert("Ember.Object.create no longer supports defining methods that call _super.", !(typeof value === 'function' && value.toString().indexOf('._super') !== -1)); if (concatenatedProperties && indexOf(concatenatedProperties, keyName) >= 0) { var baseValue = this[keyName]; if (baseValue) { if ('function' === typeof baseValue.concat) { value = baseValue.concat(value); } else { value = Ember.makeArray(baseValue).concat(value); } } else { value = Ember.makeArray(value); } } if (desc) { desc.set(this, keyName, value); } else { if (typeof this.setUnknownProperty === 'function' && !(keyName in this)) { this.setUnknownProperty(keyName, value); } else if (MANDATORY_SETTER) { Ember.defineProperty(this, keyName, null, value); // setup mandatory setter } else { this[keyName] = value; } } } } } finishPartial(this, m); delete m.proto; finishChains(this); this.init.apply(this, arguments); }; Class.toString = Mixin.prototype.toString; Class.willReopen = function() { if (wasApplied) { Class.PrototypeMixin = Mixin.create(Class.PrototypeMixin); } wasApplied = false; }; Class._initMixins = function(args) { initMixins = args; }; Class._initProperties = function(args) { initProperties = args; }; Class.proto = function() { var superclass = Class.superclass; if (superclass) { superclass.proto(); } if (!wasApplied) { wasApplied = true; Class.PrototypeMixin.applyPartial(Class.prototype); rewatch(Class.prototype); } return this.prototype; }; return Class; } var CoreObject = makeCtor(); CoreObject.toString = function() { return "Ember.CoreObject"; }; CoreObject.PrototypeMixin = Mixin.create({ reopen: function() { applyMixin(this, arguments, true); return this; }, isInstance: true, /** An overridable method called when objects are instantiated. By default, does nothing unless it is overridden during class definition. Example: ```javascript App.Person = Ember.Object.extend({ init: function() { this._super(); alert('Name is ' + this.get('name')); } }); var steve = App.Person.create({ name: "Steve" }); // alerts 'Name is Steve'. ``` NOTE: If you do override `init` for a framework class like `Ember.View` or `Ember.ArrayController`, be sure to call `this._super()` in your `init` declaration! If you don't, Ember may not have an opportunity to do important setup work, and you'll see strange behavior in your application. ``` @method init */ init: function() {}, /** Defines the properties that will be concatenated from the superclass (instead of overridden). By default, when you extend an Ember class a property defined in the subclass overrides a property with the same name that is defined in the superclass. However, there are some cases where it is preferable to build up a property's value by combining the superclass' property value with the subclass' value. An example of this in use within Ember is the `classNames` property of `Ember.View`. Here is some sample code showing the difference between a concatenated property and a normal one: ```javascript App.BarView = Ember.View.extend({ someNonConcatenatedProperty: ['bar'], classNames: ['bar'] }); App.FooBarView = App.BarView.extend({ someNonConcatenatedProperty: ['foo'], classNames: ['foo'], }); var fooBarView = App.FooBarView.create(); fooBarView.get('someNonConcatenatedProperty'); // ['foo'] fooBarView.get('classNames'); // ['ember-view', 'bar', 'foo'] ``` This behavior extends to object creation as well. Continuing the above example: ```javascript var view = App.FooBarView.create({ someNonConcatenatedProperty: ['baz'], classNames: ['baz'] }) view.get('someNonConcatenatedProperty'); // ['baz'] view.get('classNames'); // ['ember-view', 'bar', 'foo', 'baz'] ``` Adding a single property that is not an array will just add it in the array: ```javascript var view = App.FooBarView.create({ classNames: 'baz' }) view.get('classNames'); // ['ember-view', 'bar', 'foo', 'baz'] ``` Using the `concatenatedProperties` property, we can tell to Ember that mix the content of the properties. In `Ember.View` the `classNameBindings` and `attributeBindings` properties are also concatenated, in addition to `classNames`. This feature is available for you to use throughout the Ember object model, although typical app developers are likely to use it infrequently. @property concatenatedProperties @type Array @default null */ concatenatedProperties: null, /** Destroyed object property flag. if this property is `true` the observers and bindings were already removed by the effect of calling the `destroy()` method. @property isDestroyed @default false */ isDestroyed: false, /** Destruction scheduled flag. The `destroy()` method has been called. The object stays intact until the end of the run loop at which point the `isDestroyed` flag is set. @property isDestroying @default false */ 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. @method destroy @return {Ember.Object} receiver */ destroy: function() { if (this._didCallDestroy) { return; } this.isDestroying = true; this._didCallDestroy = true; if (this.willDestroy) { this.willDestroy(); } schedule('destroy', this, this._scheduledDestroy); return this; }, /** @private Invoked by the run loop to actually destroy the object. This is scheduled for execution by the `destroy` method. @method _scheduledDestroy */ _scheduledDestroy: function() { destroy(this); set(this, 'isDestroyed', true); 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; }, /** Returns a string representation which attempts to provide more information than Javascript's `toString` typically does, in a generic way for all Ember objects. App.Person = Em.Object.extend() person = App.Person.create() person.toString() //=> "" If the object's class is not defined on an Ember namespace, it will indicate it is a subclass of the registered superclass: Student = App.Person.extend() student = Student.create() student.toString() //=> "<(subclass of App.Person):ember1025>" If the method `toStringExtension` is defined, its return value will be included in the output. App.Teacher = App.Person.extend({ toStringExtension: function(){ return this.get('fullName'); } }); teacher = App.Teacher.create() teacher.toString(); //=> "" @method toString @return {String} string representation */ toString: function toString() { var hasToStringExtension = typeof this.toStringExtension === 'function', extension = hasToStringExtension ? ":" + this.toStringExtension() : ''; var ret = '<'+this.constructor.toString()+':'+guidFor(this)+extension+'>'; this.toString = makeToString(ret); return ret; } }); CoreObject.PrototypeMixin.ownerConstructor = CoreObject; function makeToString(ret) { return function() { return ret; }; } if (Ember.config.overridePrototypeMixin) { Ember.config.overridePrototypeMixin(CoreObject.PrototypeMixin); } CoreObject.__super__ = null; var ClassMixin = Mixin.create({ ClassMixin: Ember.required(), PrototypeMixin: Ember.required(), isClass: true, isMethod: false, extend: function() { var Class = makeCtor(), proto; Class.ClassMixin = Mixin.create(this.ClassMixin); Class.PrototypeMixin = Mixin.create(this.PrototypeMixin); Class.ClassMixin.ownerConstructor = Class; Class.PrototypeMixin.ownerConstructor = Class; reopen.apply(Class.PrototypeMixin, arguments); Class.superclass = this; Class.__super__ = this.prototype; proto = Class.prototype = o_create(this.prototype); proto.constructor = Class; generateGuid(proto, 'ember'); meta(proto).proto = proto; // this will disable observers on prototype Class.ClassMixin.apply(Class); return Class; }, createWithMixins: function() { var C = this; if (arguments.length>0) { this._initMixins(arguments); } return new C(); }, create: function() { var C = this; if (arguments.length>0) { this._initProperties(arguments); } return new C(); }, reopen: function() { this.willReopen(); reopen.apply(this.PrototypeMixin, arguments); return this; }, reopenClass: function() { reopen.apply(this.ClassMixin, arguments); applyMixin(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: ```javascript 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: ```javascript MyClass.metaForProperty('person'); ``` This will return the original hash that was passed to `meta()`. @method metaForProperty @param key {String} property name */ metaForProperty: function(key) { var desc = meta(this.proto(), false).descs[key]; Ember.assert("metaForProperty() could not find a computed property with key '"+key+"'.", !!desc && desc instanceof Ember.ComputedProperty); return desc._meta || {}; }, /** Iterate over each computed property for the class, passing its name and any associated metadata (see `metaForProperty`) to the callback. @method eachComputedProperty @param {Function} callback @param {Object} binding */ 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); } } } }); ClassMixin.ownerConstructor = CoreObject; if (Ember.config.overrideClassMixin) { Ember.config.overrideClassMixin(ClassMixin); } CoreObject.ClassMixin = ClassMixin; ClassMixin.apply(CoreObject); /** @class CoreObject @namespace Ember */ Ember.CoreObject = CoreObject; })(); (function() { /** @module ember @submodule ember-runtime */ /** `Ember.Object` is the main base class for all Ember objects. It is a subclass of `Ember.CoreObject` with the `Ember.Observable` mixin applied. For details, see the documentation for each of these. @class Object @namespace Ember @extends Ember.CoreObject @uses Ember.Observable */ Ember.Object = Ember.CoreObject.extend(Ember.Observable); Ember.Object.toString = function() { return "Ember.Object"; }; })(); (function() { /** @module ember @submodule ember-runtime */ var get = Ember.get, indexOf = Ember.ArrayPolyfills.indexOf; /** 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 ```javascript MyFramework = Ember.Namespace.create({ VERSION: '1.0.0' }); ``` @class Namespace @namespace Ember @extends Ember.Object */ var Namespace = Ember.Namespace = Ember.Object.extend({ isNamespace: true, init: function() { Ember.Namespace.NAMESPACES.push(this); Ember.Namespace.PROCESSED = false; }, toString: function() { var name = get(this, 'name'); if (name) { return name; } findNamespaces(); return this[Ember.GUID_KEY+'_name']; }, nameClasses: function() { processNamespace([this.toString()], this, {}); }, destroy: function() { var namespaces = Ember.Namespace.NAMESPACES; Ember.lookup[this.toString()] = undefined; namespaces.splice(indexOf.call(namespaces, this), 1); this._super(); } }); Namespace.reopenClass({ NAMESPACES: [Ember], NAMESPACES_BY_ID: {}, PROCESSED: false, processAll: processAllNamespaces, byName: function(name) { if (!Ember.BOOTED) { processAllNamespaces(); } return NAMESPACES_BY_ID[name]; } }); var NAMESPACES_BY_ID = Namespace.NAMESPACES_BY_ID; var hasOwnProp = ({}).hasOwnProperty, guidFor = Ember.guidFor; function processNamespace(paths, root, seen) { var idx = paths.length; NAMESPACES_BY_ID[paths.join('.')] = root; // Loop over all of the keys in the namespace, looking for classes for(var key in root) { if (!hasOwnProp.call(root, key)) { continue; } var obj = root[key]; // If we are processing the `Ember` namespace, for example, the // `paths` will start with `["Ember"]`. Every iteration through // the loop will update the **second** element of this list with // the key, so processing `Ember.View` will make the Array // `['Ember', 'View']`. paths[idx] = key; // If we have found an unprocessed class if (obj && obj.toString === classToString) { // Replace the class' `toString` with the dot-separated path // and set its `NAME_KEY` obj.toString = makeToString(paths.join('.')); obj[NAME_KEY] = paths.join('.'); // Support nested namespaces } else if (obj && obj.isNamespace) { // Skip aliased namespaces if (seen[guidFor(obj)]) { continue; } seen[guidFor(obj)] = true; // Process the child namespace processNamespace(paths, obj, seen); } } paths.length = idx; // cut out last item } function findNamespaces() { var Namespace = Ember.Namespace, lookup = Ember.lookup, obj, isNamespace; if (Namespace.PROCESSED) { return; } for (var prop in lookup) { // These don't raise exceptions but can cause warnings if (prop === "parent" || prop === "top" || prop === "frameElement") { continue; } // 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" && lookup.StorageList && lookup.globalStorage instanceof lookup.StorageList) { continue; } // Unfortunately, some versions of IE don't support window.hasOwnProperty if (lookup.hasOwnProperty && !lookup.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 = Ember.lookup[prop]; isNamespace = obj && obj.isNamespace; } catch (e) { continue; } if (isNamespace) { Ember.deprecate("Namespaces should not begin with lowercase.", /^[A-Z]/.test(prop)); obj[NAME_KEY] = prop; } } } var NAME_KEY = Ember.NAME_KEY = Ember.GUID_KEY + '_name'; function superClassString(mixin) { var superclass = mixin.superclass; if (superclass) { if (superclass[NAME_KEY]) { return superclass[NAME_KEY]; } else { return superClassString(superclass); } } else { return; } } function classToString() { if (!Ember.BOOTED && !this[NAME_KEY]) { processAllNamespaces(); } var ret; if (this[NAME_KEY]) { ret = this[NAME_KEY]; } else { var str = superClassString(this); if (str) { ret = "(subclass of " + str + ")"; } else { ret = "(unknown mixin)"; } this.toString = makeToString(ret); } return ret; } function processAllNamespaces() { var unprocessedNamespaces = !Namespace.PROCESSED, unprocessedMixins = Ember.anyUnprocessedMixins; if (unprocessedNamespaces) { findNamespaces(); Namespace.PROCESSED = true; } if (unprocessedNamespaces || unprocessedMixins) { var namespaces = Namespace.NAMESPACES, namespace; for (var i=0, l=namespaces.length; i get(this, 'content.length')) throw new Error(OUT_OF_RANGE_EXCEPTION); this._replace(idx, 0, [object]); return this; }, insertAt: function(idx, object) { if (get(this, 'arrangedContent') === get(this, 'content')) { return this._insertAt(idx, object); } else { throw new Ember.Error("Using insertAt on an arranged ArrayProxy is not allowed."); } }, removeAt: function(start, len) { if ('number' === typeof start) { var content = get(this, 'content'), arrangedContent = get(this, 'arrangedContent'), indices = [], i; if ((start < 0) || (start >= get(this, 'length'))) { throw new Error(OUT_OF_RANGE_EXCEPTION); } if (len === undefined) len = 1; // Get a list of indices in original content to remove for (i=start; i=idx) { var item = content.objectAt(loc); if (item) { Ember.addBeforeObserver(item, keyName, proxy, 'contentKeyWillChange'); Ember.addObserver(item, keyName, proxy, 'contentKeyDidChange'); // keep track of the index 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); } } } 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; } } } /** 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. @private @class EachProxy @namespace Ember @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. @method unknownProperty @param keyName {String} @param value {anything} */ unknownProperty: function(keyName, value) { var ret; ret = new EachArray(this._content, keyName, this); Ember.defineProperty(this, keyName, null, 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, 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, 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() { /** @module ember @submodule ember-runtime */ 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(deep) { if (deep) { return this.map(function(item){ return Ember.copy(item, true); }); } return this.slice(); } }); // Remove any methods implemented natively so we don't override them var ignore = ['length']; Ember.EnumerableUtils.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` or `Ember.EXTEND_PROTOTYPES.Array` set to false, this will be applied automatically. Otherwise you can apply the mixin at anytime by calling `Ember.NativeArray.activate`. @class NativeArray @namespace Ember @extends Ember.Mixin @uses Ember.MutableArray @uses Ember.MutableEnumerable @uses Ember.Copyable @uses Ember.Freezable */ Ember.NativeArray = NativeArray; /** Creates an `Ember.NativeArray` from an Array like object. Does not modify the original object. @method A @for Ember @return {Ember.NativeArray} */ Ember.A = function(arr){ if (arr === undefined) { arr = []; } return Ember.Array.detect(arr) ? arr : Ember.NativeArray.apply(arr); }; /** Activates the mixin on the Array.prototype if not already applied. Calling this method more than once is safe. @method activate @for Ember.NativeArray @static @return {void} */ Ember.NativeArray.activate = function() { NativeArray.apply(Array.prototype); Ember.A = function(arr) { return arr || []; }; }; if (Ember.EXTEND_PROTOTYPES === true || Ember.EXTEND_PROTOTYPES.Array) { Ember.NativeArray.activate(); } })(); (function() { /** @module ember @submodule ember-runtime */ var get = Ember.get, set = Ember.set, guidFor = Ember.guidFor, none = Ember.isNone, fmt = Ember.String.fmt; /** 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()`. ```javascript // 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. @class Set @namespace Ember @extends Ember.CoreObject @uses Ember.MutableEnumerable @uses Ember.Copyable @uses 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 length @type number @default 0 */ length: 0, /** Clears the set. This is useful if you want to reuse an existing set without having to recreate it. ```javascript var colors = new Ember.Set(["red", "green", "blue"]); colors.length; // 3 colors.clear(); colors.length; // 0 ``` @method clear @return {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. ```javascript var colors = ["red", "green", "blue"], same_colors = new Ember.Set(colors); same_colors.isEqual(colors); // true same_colors.isEqual(["purple", "brown"]); // false ``` @method isEqual @param {Ember.Set} obj the other object. @return {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()`. ```javascript 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"] ``` @method add @param {Object} obj The object to add. @return {Ember.Set} The set itself. */ add: Ember.aliasMethod('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()`. ```javascript var colors = new Ember.Set(["red", "green", "blue"]); colors.remove("red"); // ["blue", "green"] colors.remove("purple"); // ["blue", "green"] colors.remove(null); // ["blue", "green"] ``` @method remove @param {Object} obj The object to remove @return {Ember.Set} The set itself. */ remove: Ember.aliasMethod('removeObject'), /** Removes the last element from the set and returns it, or `null` if it's empty. ```javascript var colors = new Ember.Set(["green", "blue"]); colors.pop(); // "blue" colors.pop(); // "green" colors.pop(); // null ``` @method pop @return {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()`. ```javascript var colors = new Ember.Set(); colors.push("red"); // ["red"] colors.push("green"); // ["red", "green"] colors.push("blue"); // ["red", "green", "blue"] ``` @method push @return {Ember.Set} The set itself. */ push: Ember.aliasMethod('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()`. ```javascript var colors = new Ember.Set(["green", "blue"]); colors.shift(); // "blue" colors.shift(); // "green" colors.shift(); // null ``` @method shift @return {Object} The removed object from the set or null. */ shift: Ember.aliasMethod('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()` ```javascript var colors = new Ember.Set(); colors.unshift("red"); // ["red"] colors.unshift("green"); // ["red", "green"] colors.unshift("blue"); // ["red", "green", "blue"] ``` @method unshift @return {Ember.Set} The set itself. */ unshift: Ember.aliasMethod('push'), /** Adds each object in the passed enumerable to the set. This is an alias of `Ember.MutableEnumerable.addObjects()` ```javascript var colors = new Ember.Set(); colors.addEach(["red", "green", "blue"]); // ["red", "green", "blue"] ``` @method addEach @param {Ember.Enumerable} objects the objects to add. @return {Ember.Set} The set itself. */ addEach: Ember.aliasMethod('addObjects'), /** Removes each object in the passed enumerable to the set. This is an alias of `Ember.MutableEnumerable.removeObjects()` ```javascript var colors = new Ember.Set(["red", "green", "blue"]); colors.removeEach(["red", "blue"]); // ["green"] ``` @method removeEach @param {Ember.Enumerable} objects the objects to remove. @return {Ember.Set} The set itself. */ removeEach: Ember.aliasMethod('removeObjects'), // .......................................................... // PRIVATE ENUMERABLE SUPPORT // init: function(items) { this._super(); if (items) this.addObjects(items); }, // implement Ember.Enumerable nextObject: function(idx) { return this[idx]; }, // more optimized version firstObject: Ember.computed(function() { return this.length > 0 ? this[0] : undefined; }), // more optimized version lastObject: Ember.computed(function() { return this.length > 0 ? this[this.length-1] : undefined; }), // 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; }, 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; }, toString: function() { var len = this.length, idx, array = []; for(idx = 0; idx < len; idx++) { array[idx] = this[idx]; } return fmt("Ember.Set<%@>", [array.join(',')]); } }); })(); (function() { var DeferredMixin = Ember.DeferredMixin, // mixins/deferred get = Ember.get; var Deferred = Ember.Object.extend(DeferredMixin); Deferred.reopenClass({ promise: function(callback, binding) { var deferred = Deferred.create(); callback.call(binding, deferred); return get(deferred, 'promise'); } }); Ember.Deferred = Deferred; })(); (function() { /** @module ember @submodule ember-runtime */ var loadHooks = Ember.ENV.EMBER_LOAD_HOOKS || {}; var loaded = {}; /** @method onLoad @for Ember @param name {String} name of hook @param callback {Function} callback to be called */ Ember.onLoad = function(name, callback) { var object; loadHooks[name] = loadHooks[name] || Ember.A(); loadHooks[name].pushObject(callback); if (object = loaded[name]) { callback(object); } }; /** @method runLoadHooks @for Ember @param name {String} name of hook @param object {Object} object to pass to callbacks */ Ember.runLoadHooks = function(name, object) { var hooks; loaded[name] = object; if (hooks = loadHooks[name]) { loadHooks[name].forEach(function(callback) { callback(object); }); } }; })(); (function() { })(); (function() { var get = Ember.get; /** @module ember @submodule ember-runtime */ /** `Ember.ControllerMixin` provides a standard interface for all classes that compose Ember's controller layer: `Ember.Controller`, `Ember.ArrayController`, and `Ember.ObjectController`. Within an `Ember.Router`-managed application single shared instaces of every Controller object in your application's namespace will be added to the application's `Ember.Router` instance. See `Ember.Application#initialize` for additional information. ## Views By default a controller instance will be the rendering context for its associated `Ember.View.` This connection is made during calls to `Ember.ControllerMixin#connectOutlet`. Within the view's template, the `Ember.View` instance can be accessed through the controller with `{{view}}`. ## Target Forwarding By default a controller will target your application's `Ember.Router` instance. Calls to `{{action}}` within the template of a controller's view are forwarded to the router. See `Ember.Handlebars.helpers.action` for additional information. @class ControllerMixin @namespace Ember @extends Ember.Mixin */ Ember.ControllerMixin = Ember.Mixin.create({ /* ducktype as a controller */ isController: true, /** The object to which events from the view should be sent. For example, when a Handlebars template uses the `{{action}}` helper, it will attempt to send the event to the view's controller's `target`. By default, a controller's `target` is set to the router after it is instantiated by `Ember.Application#initialize`. @property target @default null */ target: null, container: null, store: null, model: Ember.computed.alias('content'), send: function(actionName) { var args = [].slice.call(arguments, 1), target; if (this[actionName]) { Ember.assert("The controller " + this + " does not have the action " + actionName, typeof this[actionName] === 'function'); this[actionName].apply(this, args); } else if(target = get(this, 'target')) { Ember.assert("The target for controller " + this + " (" + target + ") did not define a `send` method", typeof target.send === 'function'); target.send.apply(target, arguments); } } }); /** @class Controller @namespace Ember @extends Ember.Object @uses Ember.ControllerMixin */ Ember.Controller = Ember.Object.extend(Ember.ControllerMixin); })(); (function() { /** @module ember @submodule ember-runtime */ var get = Ember.get, set = Ember.set, forEach = Ember.EnumerableUtils.forEach; /** `Ember.SortableMixin` provides a standard interface for array proxies to specify a sort order and maintain this sorting when objects are added, removed, or updated without changing the implicit order of their underlying content array: ```javascript songs = [ {trackNumber: 4, title: 'Ob-La-Di, Ob-La-Da'}, {trackNumber: 2, title: 'Back in the U.S.S.R.'}, {trackNumber: 3, title: 'Glass Onion'}, ]; songsController = Ember.ArrayController.create({ content: songs, sortProperties: ['trackNumber'], sortAscending: true }); songsController.get('firstObject'); // {trackNumber: 2, title: 'Back in the U.S.S.R.'} songsController.addObject({trackNumber: 1, title: 'Dear Prudence'}); songsController.get('firstObject'); // {trackNumber: 1, title: 'Dear Prudence'} ``` @class SortableMixin @namespace Ember @extends Ember.Mixin @uses Ember.MutableEnumerable */ Ember.SortableMixin = Ember.Mixin.create(Ember.MutableEnumerable, { /** Specifies which properties dictate the arrangedContent's sort order. @property {Array} sortProperties */ sortProperties: null, /** Specifies the arrangedContent's sort direction @property {Boolean} sortAscending */ sortAscending: true, orderBy: function(item1, item2) { var result = 0, sortProperties = get(this, 'sortProperties'), sortAscending = get(this, 'sortAscending'); Ember.assert("you need to define `sortProperties`", !!sortProperties); forEach(sortProperties, function(propertyName) { if (result === 0) { result = Ember.compare(get(item1, propertyName), get(item2, propertyName)); if ((result !== 0) && !sortAscending) { result = (-1) * result; } } }); return result; }, destroy: function() { var content = get(this, 'content'), sortProperties = get(this, 'sortProperties'); if (content && sortProperties) { forEach(content, function(item) { forEach(sortProperties, function(sortProperty) { Ember.removeObserver(item, sortProperty, this, 'contentItemSortPropertyDidChange'); }, this); }, this); } return this._super(); }, isSorted: Ember.computed.bool('sortProperties'), arrangedContent: Ember.computed('content', 'sortProperties.@each', function(key, value) { var content = get(this, 'content'), isSorted = get(this, 'isSorted'), sortProperties = get(this, 'sortProperties'), self = this; if (content && isSorted) { content = content.slice(); content.sort(function(item1, item2) { return self.orderBy(item1, item2); }); forEach(content, function(item) { forEach(sortProperties, function(sortProperty) { Ember.addObserver(item, sortProperty, this, 'contentItemSortPropertyDidChange'); }, this); }, this); return Ember.A(content); } return content; }), _contentWillChange: Ember.beforeObserver(function() { var content = get(this, 'content'), sortProperties = get(this, 'sortProperties'); if (content && sortProperties) { forEach(content, function(item) { forEach(sortProperties, function(sortProperty) { Ember.removeObserver(item, sortProperty, this, 'contentItemSortPropertyDidChange'); }, this); }, this); } this._super(); }, 'content'), sortAscendingWillChange: Ember.beforeObserver(function() { this._lastSortAscending = get(this, 'sortAscending'); }, 'sortAscending'), sortAscendingDidChange: Ember.observer(function() { if (get(this, 'sortAscending') !== this._lastSortAscending) { var arrangedContent = get(this, 'arrangedContent'); arrangedContent.reverseObjects(); } }, 'sortAscending'), contentArrayWillChange: function(array, idx, removedCount, addedCount) { var isSorted = get(this, 'isSorted'); if (isSorted) { var arrangedContent = get(this, 'arrangedContent'); var removedObjects = array.slice(idx, idx+removedCount); var sortProperties = get(this, 'sortProperties'); forEach(removedObjects, function(item) { arrangedContent.removeObject(item); forEach(sortProperties, function(sortProperty) { Ember.removeObserver(item, sortProperty, this, 'contentItemSortPropertyDidChange'); }, this); }, this); } return this._super(array, idx, removedCount, addedCount); }, contentArrayDidChange: function(array, idx, removedCount, addedCount) { var isSorted = get(this, 'isSorted'), sortProperties = get(this, 'sortProperties'); if (isSorted) { var addedObjects = array.slice(idx, idx+addedCount); forEach(addedObjects, function(item) { this.insertItemSorted(item); forEach(sortProperties, function(sortProperty) { Ember.addObserver(item, sortProperty, this, 'contentItemSortPropertyDidChange'); }, this); }, this); } return this._super(array, idx, removedCount, addedCount); }, insertItemSorted: function(item) { var arrangedContent = get(this, 'arrangedContent'); var length = get(arrangedContent, 'length'); var idx = this._binarySearch(item, 0, length); arrangedContent.insertAt(idx, item); }, contentItemSortPropertyDidChange: function(item) { var arrangedContent = get(this, 'arrangedContent'), oldIndex = arrangedContent.indexOf(item), leftItem = arrangedContent.objectAt(oldIndex - 1), rightItem = arrangedContent.objectAt(oldIndex + 1), leftResult = leftItem && this.orderBy(item, leftItem), rightResult = rightItem && this.orderBy(item, rightItem); if (leftResult < 0 || rightResult > 0) { arrangedContent.removeObject(item); this.insertItemSorted(item); } }, _binarySearch: function(item, low, high) { var mid, midItem, res, arrangedContent; if (low === high) { return low; } arrangedContent = get(this, 'arrangedContent'); mid = low + Math.floor((high - low) / 2); midItem = arrangedContent.objectAt(mid); res = this.orderBy(midItem, item); if (res < 0) { return this._binarySearch(item, mid+1, high); } else if (res > 0) { return this._binarySearch(item, low, mid); } return mid; } }); })(); (function() { /** @module ember @submodule ember-runtime */ var get = Ember.get, set = Ember.set, forEach = Ember.EnumerableUtils.forEach, replace = Ember.EnumerableUtils.replace; /** `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: ```javascript 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: ```handlebars {{#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. Sometimes you want to display computed properties within the body of an `#each` helper that depend on the underlying items in `content`, but are not present on those items. To do this, set `itemController` to the name of a controller (probably an `ObjectController`) that will wrap each individual item. For example: ```handlebars {{#each post in controller}}
  • {{title}} ({{titleLength}} characters)
  • {{/each}} ``` ```javascript App.PostsController = Ember.ArrayController.extend({ itemController: 'post' }); App.PostController = Ember.ObjectController.extend({ // the `title` property will be proxied to the underlying post. titleLength: function() { return this.get('title').length; }.property('title') }); ``` In some cases it is helpful to return a different `itemController` depending on the particular item. Subclasses can do this by overriding `lookupItemController`. For example: ```javascript App.MyArrayController = Ember.ArrayController.extend({ lookupItemController: function( object ) { if (object.get('isSpecial')) { return "special"; // use App.SpecialController } else { return "regular"; // use App.RegularController } } }); ``` @class ArrayController @namespace Ember @extends Ember.ArrayProxy @uses Ember.SortableMixin @uses Ember.ControllerMixin */ Ember.ArrayController = Ember.ArrayProxy.extend(Ember.ControllerMixin, Ember.SortableMixin, { /** The controller used to wrap items, if any. @property itemController @type String @default null */ itemController: null, /** Return the name of the controller to wrap items, or `null` if items should be returned directly. The default implementation simply returns the `itemController` property, but subclasses can override this method to return different controllers for different objects. For example: ```javascript App.MyArrayController = Ember.ArrayController.extend({ lookupItemController: function( object ) { if (object.get('isSpecial')) { return "special"; // use App.SpecialController } else { return "regular"; // use App.RegularController } } }); ``` @method @type String @default null */ lookupItemController: function(object) { return get(this, 'itemController'); }, objectAtContent: function(idx) { var length = get(this, 'length'), arrangedContent = get(this,'arrangedContent'), object = arrangedContent && arrangedContent.objectAt(idx); if (idx >= 0 && idx < length) { var controllerClass = this.lookupItemController(object); if (controllerClass) { return this.controllerAt(idx, object, controllerClass); } } // When `controllerClass` is falsy, we have not opted in to using item // controllers, so return the object directly. // When the index is out of range, we want to return the "out of range" // value, whatever that might be. Rather than make assumptions // (e.g. guessing `null` or `undefined`) we defer this to `arrangedContent`. return object; }, arrangedContentDidChange: function() { this._super(); this._resetSubControllers(); }, arrayContentDidChange: function(idx, removedCnt, addedCnt) { var subControllers = get(this, '_subControllers'), subControllersToRemove = subControllers.slice(idx, idx+removedCnt); forEach(subControllersToRemove, function(subController) { if (subController) { subController.destroy(); } }); replace(subControllers, idx, removedCnt, new Array(addedCnt)); // The shadow array of subcontrollers must be updated before we trigger // observers, otherwise observers will get the wrong subcontainer when // calling `objectAt` this._super(idx, removedCnt, addedCnt); }, init: function() { this._super(); if (!this.get('content')) { Ember.defineProperty(this, 'content', undefined, Ember.A()); } this.set('_subControllers', Ember.A()); }, controllerAt: function(idx, object, controllerClass) { var container = get(this, 'container'), subControllers = get(this, '_subControllers'), subController = subControllers[idx]; if (!subController) { subController = container.lookup("controller:" + controllerClass, { singleton: false }); subControllers[idx] = subController; } if (!subController) { throw new Error('Could not resolve itemController: "' + controllerClass + '"'); } subController.set('target', this); subController.set('content', object); return subController; }, _subControllers: null, _resetSubControllers: function() { var subControllers = get(this, '_subControllers'); forEach(subControllers, function(subController) { if (subController) { subController.destroy(); } }); this.set('_subControllers', Ember.A()); } }); })(); (function() { /** @module ember @submodule ember-runtime */ /** `Ember.ObjectController` is part of Ember's Controller layer. A single shared instance of each `Ember.ObjectController` subclass in your application's namespace will be created at application initialization and be stored on your application's `Ember.Router` instance. `Ember.ObjectController` derives its functionality from its superclass `Ember.ObjectProxy` and the `Ember.ControllerMixin` mixin. @class ObjectController @namespace Ember @extends Ember.ObjectProxy @uses Ember.ControllerMixin **/ Ember.ObjectController = Ember.ObjectProxy.extend(Ember.ControllerMixin); })(); (function() { })(); (function() { /** Ember Runtime @module ember @submodule ember-runtime @requires ember-metal */ })(); })();