Google Git
Sign in
apache / ambari / refs/heads/branch-1.2.3 / . / ambari-web / vendor / scripts / ember-latest.js
blob: fc0e4ab000cb34ef117f8dcaee8de0d6b5034709 [file] [log] [blame]
// Version: v1.0.pre
// Last commit: 7955b85 (2012-08-03 14:50:17 -0700)
(function() {
/*global __fail__*/
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:
// Test for truthiness
Ember.assert('Must pass a valid object', obj);
// Fail unconditionally
Ember.assert('This code path should never be run')
@static
@function
@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.
@static
@function
@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 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.
@static
@function
@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.<anonymous>\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.
@static
@function
@param {String} message
A description of the deprecation.
@param {Function} func
The function to be deprecated.
*/
Ember.deprecateFunc = function(message, func) {
return function() {
Ember.deprecate(message);
return func.apply(this, arguments);
};
};
window.ember_assert = Ember.deprecateFunc("ember_assert is deprecated. Please use Ember.assert instead.", Ember.assert);
window.ember_warn = Ember.deprecateFunc("ember_warn is deprecated. Please use Ember.warn instead.", Ember.warn);
window.ember_deprecate = Ember.deprecateFunc("ember_deprecate is deprecated. Please use Ember.deprecate instead.", Ember.deprecate);
window.ember_deprecateFunc = Ember.deprecateFunc("ember_deprecateFunc is deprecated. Please use Ember.deprecateFunc instead.", Ember.deprecateFunc);
})();
// Version: v1.0.pre
// Last commit: 7955b85 (2012-08-03 14:50:17 -0700)
(function() {
// ==========================================================================
// Project: Ember Metal
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
/*globals Em:true ENV */
if ('undefined' === typeof Ember) {
// Create core object. Make it act like an instance of Ember.Namespace so that
// objects assigned to it are given a sane string representation.
Ember = {};
}
/**
@namespace
@name Ember
@version 1.0.pre
All Ember methods and functions are defined inside of this namespace.
You generally should not add new properties to this namespace as it may be
overwritten by future versions of Ember.
You can also use the shorthand "Em" instead of "Ember".
Ember-Runtime is a framework that provides core functions for
Ember including cross-platform functions, support for property
observing and objects. Its focus is on small size and performance. You can
use this in place of or along-side other cross-platform libraries such as
jQuery.
The core Runtime framework is based on the jQuery API with a number of
performance optimizations.
*/
// aliases needed to keep minifiers from removing the global context
if ('undefined' !== typeof window) {
window.Em = window.Ember = Em = Ember;
}
// Make sure these are set whether Ember was already defined or not
Ember.isNamespace = true;
Ember.toString = function() { return "Ember"; };
/**
@static
@type String
@default '1.0.pre'
@constant
*/
Ember.VERSION = '1.0.pre';
/**
@static
@type Hash
@constant
Standard environmental variables. You can define these in a global `ENV`
variable before loading Ember to control various configuration
settings.
*/
Ember.ENV = Ember.ENV || ('undefined' === typeof ENV ? {} : ENV);
Ember.config = Ember.config || {};
// ..........................................................
// BOOTSTRAP
//
/**
@static
@type Boolean
@default true
@constant
Determines whether Ember should enhances some built-in object
prototypes to provide a more friendly API. If enabled, a few methods
will be added to Function, String, and Array. Object.prototype will not be
enhanced, which is the one that causes most troubles for people.
In general we recommend leaving this option set to true since it rarely
conflicts with other code. If you need to turn it off however, you can
define an ENV.EXTEND_PROTOTYPES config to disable it.
*/
Ember.EXTEND_PROTOTYPES = (Ember.ENV.EXTEND_PROTOTYPES !== false);
/**
@static
@type Boolean
@default true
@constant
Determines whether Ember logs a full stack trace during deprecation warnings
*/
Ember.LOG_STACKTRACE_ON_DEPRECATION = (Ember.ENV.LOG_STACKTRACE_ON_DEPRECATION !== false);
/**
@static
@type Boolean
@default Ember.EXTEND_PROTOTYPES
@constant
Determines whether Ember should add ECMAScript 5 shims to older browsers.
*/
Ember.SHIM_ES5 = (Ember.ENV.SHIM_ES5 === false) ? false : Ember.EXTEND_PROTOTYPES;
/**
@static
@type Boolean
@default true
@constant
Determines whether computed properties are cacheable by default.
This option will be removed for the 1.1 release.
When caching is enabled by default, you can use `volatile()` to disable
caching on individual computed properties.
*/
Ember.CP_DEFAULT_CACHEABLE = (Ember.ENV.CP_DEFAULT_CACHEABLE !== false);
/**
@static
@type Boolean
@default true
@constant
Determines whether views render their templates using themselves
as the context, or whether it is inherited from the parent. This option
will be removed in the 1.1 release.
If you need to update your application to use the new context rules, simply
prefix property access with `view.`:
// Before:
{{#each App.photosController}}
Photo Title: {{title}}
{{#view App.InfoView contentBinding="this"}}
{{content.date}}
{{content.cameraType}}
{{otherViewProperty}}
{{/view}}
{{/each}}
// After:
{{#each App.photosController}}
Photo Title: {{title}}
{{#view App.InfoView}}
{{date}}
{{cameraType}}
{{view.otherViewProperty}}
{{/view}}
{{/each}}
*/
Ember.VIEW_PRESERVES_CONTEXT = (Ember.ENV.VIEW_PRESERVES_CONTEXT !== false);
/**
Empty function. Useful for some operations.
@returns {Object}
@private
*/
Ember.K = function() { return this; };
/**
@namespace
@name window
@description The global window object
*/
// Stub out the methods defined by the ember-debug package in case it's not loaded
if ('undefined' === typeof Ember.assert) { Ember.assert = Ember.K; }
if ('undefined' === typeof Ember.warn) { Ember.warn = Ember.K; }
if ('undefined' === typeof Ember.deprecate) { Ember.deprecate = Ember.K; }
if ('undefined' === typeof Ember.deprecateFunc) {
Ember.deprecateFunc = function(_, func) { return func; };
}
// These are deprecated but still supported
if ('undefined' === typeof ember_assert) { window.ember_assert = Ember.K; }
if ('undefined' === typeof ember_warn) { window.ember_warn = Ember.K; }
if ('undefined' === typeof ember_deprecate) { window.ember_deprecate = Ember.K; }
if ('undefined' === typeof ember_deprecateFunc) {
/** @private */
window.ember_deprecateFunc = function(_, func) { return func; };
}
// ..........................................................
// LOGGER
//
/**
@class
Inside Ember-Metal, simply uses the window.console object.
Override this to provide more robust logging functionality.
*/
Ember.Logger = window.console || { log: Ember.K, warn: Ember.K, error: Ember.K, info: Ember.K, debug: Ember.K };
})();
(function() {
/*jshint newcap:false*/
// NOTE: There is a bug in jshint that doesn't recognize `Object()` without `new`
// as being ok unless both `newcap:false` and not `use strict`.
// https://github.com/jshint/jshint/issues/392
// Testing this is not ideal, but we want to use native functions
// if available, but not to use versions created by libraries like Prototype
/** @private */
var isNativeFunc = function(func) {
// This should probably work in all browsers likely to have ES5 array methods
return func && Function.prototype.toString.call(func).indexOf('[native code]') > -1;
};
// From: https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/array/map
/** @private */
var arrayMap = isNativeFunc(Array.prototype.map) ? Array.prototype.map : function(fun /*, thisp */) {
//"use strict";
if (this === void 0 || this === null) {
throw new TypeError();
}
var t = Object(this);
var len = t.length >>> 0;
if (typeof fun !== "function") {
throw new TypeError();
}
var res = new Array(len);
var thisp = arguments[1];
for (var i = 0; i < len; i++) {
if (i in t) {
res[i] = fun.call(thisp, t[i], i, t);
}
}
return res;
};
// From: https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/array/foreach
/** @private */
var arrayForEach = isNativeFunc(Array.prototype.forEach) ? Array.prototype.forEach : function(fun /*, thisp */) {
//"use strict";
if (this === void 0 || this === null) {
throw new TypeError();
}
var t = Object(this);
var len = t.length >>> 0;
if (typeof fun !== "function") {
throw new TypeError();
}
var thisp = arguments[1];
for (var i = 0; i < len; i++) {
if (i in t) {
fun.call(thisp, t[i], i, t);
}
}
};
/** @private */
var arrayIndexOf = isNativeFunc(Array.prototype.indexOf) ? Array.prototype.indexOf : function (obj, fromIndex) {
if (fromIndex === null || fromIndex === undefined) { fromIndex = 0; }
else if (fromIndex < 0) { fromIndex = Math.max(0, this.length + fromIndex); }
for (var i = fromIndex, j = this.length; i < j; i++) {
if (this[i] === obj) { return i; }
}
return -1;
};
Ember.ArrayPolyfills = {
map: arrayMap,
forEach: arrayForEach,
indexOf: arrayIndexOf
};
var utils = Ember.EnumerableUtils = {
map: function(obj, callback, thisArg) {
return obj.map ? obj.map.call(obj, callback, thisArg) : arrayMap.call(obj, callback, thisArg);
},
forEach: function(obj, callback, thisArg) {
return obj.forEach ? obj.forEach.call(obj, callback, thisArg) : arrayForEach.call(obj, callback, thisArg);
},
indexOf: function(obj, element, index) {
return obj.indexOf ? obj.indexOf.call(obj, element, index) : arrayIndexOf.call(obj, element, index);
},
indexesOf: function(obj, elements) {
return elements === undefined ? [] : utils.map(elements, function(item) {
return utils.indexOf(obj, item);
});
},
removeObject: function(array, item) {
var index = utils.indexOf(array, item);
if (index !== -1) { array.splice(index, 1); }
}
};
if (Ember.SHIM_ES5) {
if (!Array.prototype.map) {
/** @private */
Array.prototype.map = arrayMap;
}
if (!Array.prototype.forEach) {
/** @private */
Array.prototype.forEach = arrayForEach;
}
if (!Array.prototype.indexOf) {
/** @private */
Array.prototype.indexOf = arrayIndexOf;
}
}
})();
(function() {
// ==========================================================================
// Project: Ember Metal
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
/*globals Node */
/**
@class
Platform specific methods and feature detectors needed by the framework.
@name Ember.platform
*/
var platform = Ember.platform = {};
/**
Identical to Object.create(). Implements if not available natively.
@memberOf Ember.platform
@name create
*/
Ember.create = Object.create;
if (!Ember.create) {
/** @private */
var K = function() {};
Ember.create = function(obj, props) {
K.prototype = obj;
obj = new K();
if (props) {
K.prototype = obj;
for (var prop in props) {
K.prototype[prop] = props[prop].value;
}
obj = new K();
}
K.prototype = null;
return obj;
};
Ember.create.isSimulated = true;
}
/** @private */
var defineProperty = Object.defineProperty;
var canRedefineProperties, canDefinePropertyOnDOM;
// Catch IE8 where Object.defineProperty exists but only works on DOM elements
if (defineProperty) {
try {
defineProperty({}, 'a',{get:function(){}});
} catch (e) {
/** @private */
defineProperty = null;
}
}
if (defineProperty) {
// Detects a bug in Android <3.2 where you cannot redefine a property using
// Object.defineProperty once accessors have already been set.
/** @private */
canRedefineProperties = (function() {
var obj = {};
defineProperty(obj, 'a', {
configurable: true,
enumerable: true,
get: function() { },
set: function() { }
});
defineProperty(obj, 'a', {
configurable: true,
enumerable: true,
writable: true,
value: true
});
return obj.a === true;
})();
// This is for Safari 5.0, which supports Object.defineProperty, but not
// on DOM nodes.
/** @private */
canDefinePropertyOnDOM = (function(){
try {
defineProperty(document.createElement('div'), 'definePropertyOnDOM', {});
return true;
} catch(e) { }
return false;
})();
if (!canRedefineProperties) {
/** @private */
defineProperty = null;
} else if (!canDefinePropertyOnDOM) {
/** @private */
defineProperty = function(obj, keyName, desc){
var isNode;
if (typeof Node === "object") {
isNode = obj instanceof Node;
} else {
isNode = typeof obj === "object" && typeof obj.nodeType === "number" && typeof obj.nodeName === "string";
}
if (isNode) {
// TODO: Should we have a warning here?
return (obj[keyName] = desc.value);
} else {
return Object.defineProperty(obj, keyName, desc);
}
};
}
}
/**
Identical to Object.defineProperty(). Implements as much functionality
as possible if not available natively.
@memberOf Ember.platform
@name defineProperty
@param {Object} obj The object to modify
@param {String} keyName property name to modify
@param {Object} desc descriptor hash
@returns {void}
*/
platform.defineProperty = defineProperty;
/**
Set to true if the platform supports native getters and setters.
@memberOf Ember.platform
@name hasPropertyAccessors
*/
platform.hasPropertyAccessors = true;
if (!platform.defineProperty) {
platform.hasPropertyAccessors = false;
platform.defineProperty = function(obj, keyName, desc) {
if (!desc.get) { obj[keyName] = desc.value; }
};
platform.defineProperty.isSimulated = true;
}
if (Ember.ENV.MANDATORY_SETTER && !platform.hasPropertyAccessors) {
Ember.ENV.MANDATORY_SETTER = false;
}
})();
(function() {
// ==========================================================================
// Project: Ember Metal
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
var o_defineProperty = Ember.platform.defineProperty,
o_create = Ember.create,
// Used for guid generation...
GUID_KEY = '__ember'+ (+ new Date()),
uuid = 0,
numberCache = [],
stringCache = {};
var MANDATORY_SETTER = Ember.ENV.MANDATORY_SETTER;
/**
@private
@static
@type String
@constant
A unique key used to assign guids and other private metadata to objects.
If you inspect an object in your browser debugger you will often see these.
They can be safely ignored.
On browsers that support it, these properties are added with enumeration
disabled so they won't show up when you iterate over your properties.
*/
Ember.GUID_KEY = GUID_KEY;
var GUID_DESC = {
writable: false,
configurable: false,
enumerable: false,
value: null
};
/**
@private
Generates a new guid, optionally saving the guid to the object that you
pass in. You will rarely need to use this method. Instead you should
call Ember.guidFor(obj), which return an existing guid if available.
@param {Object} obj
Optional object the guid will be used for. If passed in, the guid will
be saved on the object and reused whenever you pass the same object
again.
If no object is passed, just generate a new guid.
@param {String} prefix
Optional prefix to place in front of the guid. Useful when you want to
separate the guid into separate namespaces.
@returns {String} the guid
*/
Ember.generateGuid = function generateGuid(obj, prefix) {
if (!prefix) prefix = 'ember';
var ret = (prefix + (uuid++));
if (obj) {
GUID_DESC.value = ret;
o_defineProperty(obj, GUID_KEY, GUID_DESC);
}
return ret ;
};
/**
@private
Returns a unique id for the object. If the object does not yet have
a guid, one will be assigned to it. You can call this on any object,
Ember.Object-based or not, but be aware that it will add a _guid property.
You can also use this method on DOM Element objects.
@method
@param obj {Object} any object, string, number, Element, or primitive
@returns {String} the unique guid for this instance.
*/
Ember.guidFor = function guidFor(obj) {
// special cases where we don't want to add a key to object
if (obj === undefined) return "(undefined)";
if (obj === null) return "(null)";
var cache, ret;
var type = typeof obj;
// Don't allow prototype changes to String etc. to change the guidFor
switch(type) {
case 'number':
ret = numberCache[obj];
if (!ret) ret = numberCache[obj] = 'nu'+obj;
return ret;
case 'string':
ret = stringCache[obj];
if (!ret) ret = stringCache[obj] = 'st'+(uuid++);
return ret;
case 'boolean':
return obj ? '(true)' : '(false)';
default:
if (obj[GUID_KEY]) return obj[GUID_KEY];
if (obj === Object) return '(Object)';
if (obj === Array) return '(Array)';
ret = 'ember'+(uuid++);
GUID_DESC.value = ret;
o_defineProperty(obj, GUID_KEY, GUID_DESC);
return ret;
}
};
// ..........................................................
// META
//
var META_DESC = {
writable: true,
configurable: false,
enumerable: false,
value: null
};
var META_KEY = Ember.GUID_KEY+'_meta';
/**
The key used to store meta information on object for property observing.
@static
@type String
*/
Ember.META_KEY = META_KEY;
// Placeholder for non-writable metas.
var EMPTY_META = {
descs: {},
watching: {}
};
if (MANDATORY_SETTER) { EMPTY_META.values = {}; }
Ember.EMPTY_META = EMPTY_META;
if (Object.freeze) Object.freeze(EMPTY_META);
var isDefinePropertySimulated = Ember.platform.defineProperty.isSimulated;
function Meta(obj) {
this.descs = {};
this.watching = {};
this.cache = {};
this.source = obj;
}
if (isDefinePropertySimulated) {
// on platforms that don't support enumerable false
// make meta fail jQuery.isPlainObject() to hide from
// jQuery.extend() by having a property that fails
// hasOwnProperty check.
Meta.prototype.__preventPlainObject__ = true;
}
/**
@private
@function
Retrieves the meta hash for an object. If 'writable' is true ensures the
hash is writable for this object as well.
The meta object contains information about computed property descriptors as
well as any watched properties and other information. You generally will
not access this information directly but instead work with higher level
methods that manipulate this hash indirectly.
@param {Object} obj
The object to retrieve meta for
@param {Boolean} writable
Pass false if you do not intend to modify the meta hash, allowing the
method to avoid making an unnecessary copy.
@returns {Hash}
*/
Ember.meta = function meta(obj, writable) {
var ret = obj[META_KEY];
if (writable===false) return ret || EMPTY_META;
if (!ret) {
if (!isDefinePropertySimulated) o_defineProperty(obj, META_KEY, META_DESC);
ret = new Meta(obj);
if (MANDATORY_SETTER) { ret.values = {}; }
obj[META_KEY] = ret;
// make sure we don't accidentally try to create constructor like desc
ret.descs.constructor = null;
} else if (ret.source !== obj) {
if (!isDefinePropertySimulated) o_defineProperty(obj, META_KEY, META_DESC);
ret = o_create(ret);
ret.descs = o_create(ret.descs);
ret.watching = o_create(ret.watching);
ret.cache = {};
ret.source = obj;
if (MANDATORY_SETTER) { ret.values = o_create(ret.values); }
obj[META_KEY] = ret;
}
return ret;
};
Ember.getMeta = function getMeta(obj, property) {
var meta = Ember.meta(obj, false);
return meta[property];
};
Ember.setMeta = function setMeta(obj, property, value) {
var meta = Ember.meta(obj, true);
meta[property] = value;
return value;
};
/**
@private
In order to store defaults for a class, a prototype may need to create
a default meta object, which will be inherited by any objects instantiated
from the class's constructor.
However, the properties of that meta object are only shallow-cloned,
so if a property is a hash (like the event system's `listeners` hash),
it will by default be shared across all instances of that class.
This method allows extensions to deeply clone a series of nested hashes or
other complex objects. For instance, the event system might pass
['listeners', 'foo:change', 'ember157'] to `prepareMetaPath`, which will
walk down the keys provided.
For each key, if the key does not exist, it is created. If it already
exists and it was inherited from its constructor, the constructor's
key is cloned.
You can also pass false for `writable`, which will simply return
undefined if `prepareMetaPath` discovers any part of the path that
shared or undefined.
@param {Object} obj The object whose meta we are examining
@param {Array} path An array of keys to walk down
@param {Boolean} writable whether or not to create a new meta
(or meta property) if one does not already exist or if it's
shared with its constructor
*/
Ember.metaPath = function metaPath(obj, path, writable) {
var meta = Ember.meta(obj, writable), keyName, value;
for (var i=0, l=path.length; i<l; i++) {
keyName = path[i];
value = meta[keyName];
if (!value) {
if (!writable) { return undefined; }
value = meta[keyName] = { __ember_source__: obj };
} else if (value.__ember_source__ !== obj) {
if (!writable) { return undefined; }
value = meta[keyName] = o_create(value);
value.__ember_source__ = obj;
}
meta = value;
}
return value;
};
/**
@private
Wraps the passed function so that `this._super` will point to the superFunc
when the function is invoked. This is the primitive we use to implement
calls to super.
@param {Function} func
The function to call
@param {Function} superFunc
The super function.
@returns {Function} wrapped function.
*/
Ember.wrap = function(func, superFunc) {
function K() {}
var newFunc = function() {
var ret, sup = this._super;
this._super = superFunc || K;
ret = func.apply(this, arguments);
this._super = sup;
return ret;
};
newFunc.base = func;
return newFunc;
};
/**
Returns true if the passed object is an array or Array-like.
Ember Array Protocol:
- the object has an objectAt property
- the object is a native Array
- the object is an Object, and has a length property
Unlike Ember.typeOf this method returns true even if the passed object is
not formally array but appears to be array-like (i.e. implements Ember.Array)
Ember.isArray(); // false
Ember.isArray([]); // true
Ember.isArray( Ember.ArrayProxy.create({ content: [] }) ); // true
@param {Object} obj The object to test
@returns {Boolean}
*/
Ember.isArray = function(obj) {
if (!obj || obj.setInterval) { return false; }
if (Array.isArray && Array.isArray(obj)) { return true; }
if (Ember.Array && Ember.Array.detect(obj)) { return true; }
if ((obj.length !== undefined) && 'object'===typeof obj) { return true; }
return false;
};
/**
Forces the passed object to be part of an array. If the object is already
an array or array-like, returns the object. Otherwise adds the object to
an array. If obj is null or undefined, returns an empty array.
Ember.makeArray(); => []
Ember.makeArray(null); => []
Ember.makeArray(undefined); => []
Ember.makeArray('lindsay'); => ['lindsay']
Ember.makeArray([1,2,42]); => [1,2,42]
var controller = Ember.ArrayProxy.create({ content: [] });
Ember.makeArray(controller) === controller; => true
@param {Object} obj the object
@returns {Array}
*/
Ember.makeArray = function(obj) {
if (obj === null || obj === undefined) { return []; }
return Ember.isArray(obj) ? obj : [obj];
};
function canInvoke(obj, methodName) {
return !!(obj && typeof obj[methodName] === 'function');
}
/**
Checks to see if the `methodName` exists on the `obj`.
@function
@param {Object} obj The object to check for the method
@param {String} methodName The method name to check for
*/
Ember.canInvoke = canInvoke;
/**
Checks to see if the `methodName` exists on the `obj`,
and if it does, invokes it with the arguments passed.
@function
@param {Object} obj The object to check for the method
@param {String} methodName The method name to check for
@param {Array} args The arguments to pass to the method
@returns {Boolean} true if the method does not return false
@returns {Boolean} false otherwise
*/
Ember.tryInvoke = function(obj, methodName, args) {
if (canInvoke(obj, methodName)) {
return obj[methodName].apply(obj, args);
}
};
})();
(function() {
/**
JavaScript (before ES6) does not have a Map implementation. Objects,
which are often used as dictionaries, may only have Strings as keys.
Because Ember has a way to get a unique identifier for every object
via `Ember.guidFor`, we can implement a performant Map with arbitrary
keys. Because it is commonly used in low-level bookkeeping, Map is
implemented as a pure JavaScript object for performance.
This implementation follows the current iteration of the ES6 proposal
for maps (http://wiki.ecmascript.org/doku.php?id=harmony:simple_maps_and_sets),
with two exceptions. First, because we need our implementation to be
pleasant on older browsers, we do not use the `delete` name (using
`remove` instead). Second, as we do not have the luxury of in-VM
iteration, we implement a forEach method for iteration.
Map is mocked out to look like an Ember object, so you can do
`Ember.Map.create()` for symmetry with other Ember classes.
*/
/** @private */
var guidFor = Ember.guidFor,
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.js and Ember Data.
// Please do not use it at this time. We plan to clean it up
// and add many tests soon.
var OrderedSet = Ember.OrderedSet = function() {
this.clear();
};
OrderedSet.create = function() {
return new OrderedSet();
};
OrderedSet.prototype = {
clear: function() {
this.presenceSet = {};
this.list = [];
},
add: function(obj) {
var guid = guidFor(obj),
presenceSet = this.presenceSet,
list = this.list;
if (guid in presenceSet) { return; }
presenceSet[guid] = true;
list.push(obj);
},
remove: function(obj) {
var guid = guidFor(obj),
presenceSet = this.presenceSet,
list = this.list;
delete presenceSet[guid];
var index = indexOf.call(list, obj);
if (index > -1) {
list.splice(index, 1);
}
},
isEmpty: function() {
return this.list.length === 0;
},
forEach: function(fn, self) {
// allow mutation during iteration
var list = this.list.slice();
for (var i = 0, j = list.length; i < j; i++) {
fn.call(self, list[i]);
}
},
toArray: function() {
return this.list.slice();
},
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:
`keys`: an OrderedSet of all of the existing keys
`values`: a JavaScript Object indexed by the
Ember.guidFor(key)
When a key/value pair is added for the first time, we
add the key to the `keys` OrderedSet, and create or
replace an entry in `values`. When an entry is deleted,
we delete its entry in `keys` and `values`.
*/
/** @private */
var Map = Ember.Map = function() {
this.keys = Ember.OrderedSet.create();
this.values = {};
};
Map.create = function() {
return new Map();
};
Map.prototype = {
/**
Retrieve the value associated with a given key.
@param {anything} key
@return {anything} the value associated with the key, or undefined
*/
get: function(key) {
var values = this.values,
guid = guidFor(key);
return values[guid];
},
/**
Adds a value to the map. If a value for the given key has already been
provided, the new value will replace the old value.
@param {anything} key
@param {anything} value
*/
set: function(key, value) {
var keys = this.keys,
values = this.values,
guid = guidFor(key);
keys.add(key);
values[guid] = value;
},
/**
Removes a value from the map for an associated key.
@param {anything} key
@returns {Boolean} true if an item was removed, false otherwise
*/
remove: function(key) {
// don't use ES6 "delete" because it will be annoying
// to use in browsers that are not ES6 friendly;
var keys = this.keys,
values = this.values,
guid = guidFor(key),
value;
if (values.hasOwnProperty(guid)) {
keys.remove(key);
value = values[guid];
delete values[guid];
return true;
} else {
return false;
}
},
/**
Check whether a key is present.
@param {anything} key
@returns {Boolean} true if the item was present, false otherwise
*/
has: function(key) {
var values = this.values,
guid = guidFor(key);
return values.hasOwnProperty(guid);
},
/**
Iterate over all the keys and values. Calls the function once
for each key, passing in the key and value, in that order.
The keys are guaranteed to be iterated over in insertion order.
@param {Function} callback
@param {anything} self if passed, the `this` value inside the
callback. By default, `this` is the map.
*/
forEach: function(callback, self) {
var keys = this.keys,
values = this.values;
keys.forEach(function(key) {
var guid = guidFor(key);
callback.call(self, key, values[guid]);
});
},
copy: function() {
return copyMap(this, new Map());
}
};
var MapWithDefault = Ember.MapWithDefault = function(options) {
Map.call(this);
this.defaultValue = options.defaultValue;
};
MapWithDefault.create = function(options) {
if (options) {
return new MapWithDefault(options);
} else {
return new Map();
}
};
MapWithDefault.prototype = Ember.create(Map.prototype);
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;
}
};
MapWithDefault.prototype.copy = function() {
return copyMap(this, new MapWithDefault({
defaultValue: this.defaultValue
}));
};
})();
(function() {
// ==========================================================================
// Project: Ember Metal
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
var META_KEY = Ember.META_KEY, get, set;
var MANDATORY_SETTER = Ember.ENV.MANDATORY_SETTER;
/** @private */
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 get use those.
// Otherwise simulate accessors by looking up the property directly on the
// object.
/** @private */
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) {
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;
}
};
/** @private */
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;
};
/** @private */
function firstKey(path) {
return path.match(FIRST_KEY)[0];
}
// assumes path is already normalized
/** @private */
function normalizeTuple(target, path) {
var hasThis = HAS_THIS.test(path),
isGlobal = !hasThis && IS_GLOBAL_PATH.test(path),
key;
if (!target || isGlobal) target = window;
if (hasThis) path = path.slice(5);
if (target === window) {
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 ];
}
/** @private */
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(window, 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<len; idx++) {
root = get(root, parts[idx], true);
if (root && root.isDestroyed) { return undefined; }
}
return root;
}
/** @private */
function setPath(root, path, value, tolerant) {
var keyName;
// get the last part of the path
keyName = path.slice(path.lastIndexOf('.') + 1);
// get the first part of the part
path = path.slice(0, path.length-(keyName.length+1));
// unless the path is this, look up the first part to
// get the root
if (path !== 'this') {
root = getPath(root, path);
}
if (!keyName || keyName.length === 0) {
throw new Error('You passed an empty path');
}
if (!root) {
if (tolerant) { return; }
else { throw new Error('Object in path '+path+' could not be found or was destroyed.'); }
}
return set(root, keyName, value);
}
/**
@private
Normalizes a target/path pair to reflect that actual target/path that should
be observed, etc. This takes into account passing in global property
paths (i.e. a path beginning with a captial letter not defined on the
target) and * separators.
@param {Object} target
The current target. May be null.
@param {String} path
A path on the target or a global property path.
@returns {Array} a temporary array with the normalized target/path pair.
*/
Ember.normalizeTuple = function(target, path) {
return normalizeTuple(target, path);
};
Ember.getWithDefault = function(root, key, defaultValue) {
var value = get(root, key);
if (value === undefined) { return defaultValue; }
return value;
};
/**
@function
Gets the value of a property on an object. If the property is computed,
the function will be invoked. If the property is not defined but the
object implements the unknownProperty() method then that will be invoked.
If you plan to run on IE8 and older browsers then you should use this
method anytime you want to retrieve a property on an object that you don't
know for sure is private. (My convention only properties beginning with
an underscore '_' are considered private.)
On all newer browsers, you only need to use this method to retrieve
properties if the property might not be defined on the object and you want
to respect the unknownProperty() handler. Otherwise you can ignore this
method.
Note that if the obj itself is null, this method will simply return
undefined.
@param {Object} obj
The object to retrieve from.
@param {String} keyName
The property key to retrieve
@returns {Object} the property value or null.
*/
Ember.get = get;
Ember.getPath = Ember.deprecateFunc('getPath is deprecated since get now supports paths', Ember.get);
/**
@function
Sets the value of a property on an object, respecting computed properties
and notifying observers and other listeners of the change. If the
property is not defined but the object implements the unknownProperty()
method then that will be invoked as well.
If you plan to run on IE8 and older browsers then you should use this
method anytime you want to set a property on an object that you don't
know for sure is private. (My convention only properties beginning with
an underscore '_' are considered private.)
On all newer browsers, you only need to use this method to set
properties if the property might not be defined on the object and you want
to respect the unknownProperty() handler. Otherwise you can ignore this
method.
@param {Object} obj
The object to modify.
@param {String} keyName
The property key to set
@param {Object} value
The value to set
@returns {Object} the passed value.
*/
Ember.set = set;
Ember.setPath = Ember.deprecateFunc('setPath is deprecated since set now supports paths', Ember.set);
/**
Error-tolerant form of Ember.set. Will not blow up if any part of the
chain is undefined, null, or destroyed.
This is primarily used when syncing bindings, which may try to update after
an object has been destroyed.
*/
Ember.trySet = function(root, path, value) {
return set(root, path, value, true);
};
Ember.trySetPath = Ember.deprecateFunc('trySetPath has been renamed to trySet', Ember.trySet);
/**
Returns true if the provided path is global (e.g., "MyApp.fooController.bar")
instead of local ("foo.bar.baz").
@param {String} path
@returns Boolean
*/
Ember.isGlobalPath = function(path) {
return IS_GLOBAL.test(path);
};
if (Ember.config.overrideAccessors) {
Ember.config.overrideAccessors();
get = Ember.get;
set = Ember.set;
}
})();
(function() {
// ==========================================================================
// Project: Ember Metal
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
var GUID_KEY = Ember.GUID_KEY,
META_KEY = Ember.META_KEY,
EMPTY_META = Ember.EMPTY_META,
metaFor = Ember.meta,
o_create = Ember.create,
objectDefineProperty = Ember.platform.defineProperty;
var MANDATORY_SETTER = Ember.ENV.MANDATORY_SETTER;
// ..........................................................
// DESCRIPTOR
//
/**
@private
@constructor
Objects of this type can implement an interface to responds requests to
get and set. The default implementation handles simple properties.
You generally won't need to create or subclass this directly.
*/
var Descriptor = Ember.Descriptor = function() {};
// ..........................................................
// DEFINING PROPERTIES API
//
/**
@private
NOTE: This is a low-level method used by other parts of the API. You almost
never want to call this method directly. Instead you should use Ember.mixin()
to define new properties.
Defines a property on an object. This method works much like the ES5
Object.defineProperty() method except that it can also accept computed
properties and other special descriptors.
Normally this method takes only three parameters. However if you pass an
instance of Ember.Descriptor as the third param then you can pass an optional
value as the fourth parameter. This is often more efficient than creating
new descriptor hashes for each property.
## Examples
// ES5 compatible mode
Ember.defineProperty(contact, 'firstName', {
writable: true,
configurable: false,
enumerable: true,
value: 'Charles'
});
// define a simple property
Ember.defineProperty(contact, 'lastName', undefined, 'Jolley');
// define a computed property
Ember.defineProperty(contact, 'fullName', Ember.computed(function() {
return this.firstName+' '+this.lastName;
}).property('firstName', 'lastName').cacheable());
*/
Ember.defineProperty = function(obj, keyName, desc, data, meta) {
// The first two parameters to defineProperty are mandatory:
//
// * obj: the object to define this property on. This may be
// a prototype.
// * keyName: the name of the property
//
// One and only one of the following two parameters must be
// provided:
//
// * desc: an instance of Ember.Descriptor (typically a
// computed property) or an ES5 descriptor.
// * data: something other than a descriptor, that will
// become the explicit value of this property.
var descs, existingDesc, watching, value;
if (!meta) meta = metaFor(obj);
descs = meta.descs;
existingDesc = meta.descs[keyName];
watching = meta.watching[keyName] > 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: function() {
Ember.assert('Must use Ember.set() to access this property', false);
},
get: function() {
var meta = this[META_KEY];
return meta && meta.values[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() {
// ==========================================================================
// Project: Ember Metal
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
var AFTER_OBSERVERS = ':change';
var BEFORE_OBSERVERS = ':before';
var guidFor = Ember.guidFor;
var deferred = 0;
var array_Slice = [].slice;
/** @private */
var ObserverSet = function () {
this.targetSet = {};
};
ObserverSet.prototype.add = function (target, path) {
var targetSet = this.targetSet,
targetGuid = Ember.guidFor(target),
pathSet = targetSet[targetGuid];
if (!pathSet) {
targetSet[targetGuid] = pathSet = {};
}
if (pathSet[path]) {
return false;
} else {
return pathSet[path] = true;
}
};
ObserverSet.prototype.clear = function () {
this.targetSet = {};
};
/** @private */
var DeferredEventQueue = function() {
this.targetSet = {};
this.queue = [];
};
DeferredEventQueue.prototype.push = function(target, eventName, keyName) {
var targetSet = this.targetSet,
queue = this.queue,
targetGuid = Ember.guidFor(target),
eventNameSet = targetSet[targetGuid],
index;
if (!eventNameSet) {
targetSet[targetGuid] = eventNameSet = {};
}
index = eventNameSet[eventName];
if (index === undefined) {
eventNameSet[eventName] = queue.push(Ember.deferEvent(target, eventName, [target, keyName])) - 1;
} else {
queue[index] = Ember.deferEvent(target, eventName, [target, keyName]);
}
};
DeferredEventQueue.prototype.flush = function() {
var queue = this.queue;
this.queue = [];
this.targetSet = {};
for (var i=0, len=queue.length; i < len; ++i) {
queue[i]();
}
};
var queue = new DeferredEventQueue(), beforeObserverSet = new ObserverSet();
/** @private */
function notifyObservers(obj, eventName, keyName, forceNotification) {
if (deferred && !forceNotification) {
queue.push(obj, eventName, keyName);
} else {
Ember.sendEvent(obj, eventName, [obj, keyName]);
}
}
/** @private */
function flushObserverQueue() {
beforeObserverSet.clear();
queue.flush();
}
Ember.beginPropertyChanges = function() {
deferred++;
return this;
};
Ember.endPropertyChanges = function() {
deferred--;
if (deferred<=0) flushObserverQueue();
};
/**
Make a series of property changes together in an
exception-safe way.
Ember.changeProperties(function() {
obj1.set('foo', mayBlowUpWhenSet);
obj2.set('bar', baz);
});
*/
Ember.changeProperties = function(cb, binding){
Ember.beginPropertyChanges();
try {
cb.call(binding);
} finally {
Ember.endPropertyChanges();
}
};
/**
Set a list of properties on an object. These properties are set inside
a single `beginPropertyChanges` and `endPropertyChanges` batch, so
observers will be buffered.
*/
Ember.setProperties = function(self, hash) {
Ember.changeProperties(function(){
for(var prop in hash) {
if (hash.hasOwnProperty(prop)) Ember.set(self, prop, hash[prop]);
}
});
return self;
};
/** @private */
function changeEvent(keyName) {
return keyName+AFTER_OBSERVERS;
}
/** @private */
function beforeEvent(keyName) {
return keyName+BEFORE_OBSERVERS;
}
Ember.addObserver = function(obj, path, target, method) {
Ember.addListener(obj, changeEvent(path), target, method);
Ember.watch(obj, path);
return this;
};
/** @private */
Ember.observersFor = function(obj, path) {
return Ember.listenersFor(obj, changeEvent(path));
};
Ember.removeObserver = function(obj, path, target, method) {
Ember.unwatch(obj, path);
Ember.removeListener(obj, changeEvent(path), target, method);
return this;
};
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.
/** @private */
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);
};
/** @private */
Ember.beforeObserversFor = function(obj, path) {
return Ember.listenersFor(obj, beforeEvent(path));
};
Ember.removeBeforeObserver = function(obj, path, target, method) {
Ember.unwatch(obj, path);
Ember.removeListener(obj, beforeEvent(path), target, method);
return this;
};
/** @private */
Ember.notifyObservers = function(obj, keyName) {
if (obj.isDestroying) { return; }
notifyObservers(obj, changeEvent(keyName), keyName);
};
/** @private */
Ember.notifyBeforeObservers = function(obj, keyName) {
if (obj.isDestroying) { return; }
var guid, set, forceNotification = false;
if (deferred) {
if (beforeObserverSet.add(obj, keyName)) {
forceNotification = true;
} else {
return;
}
}
notifyObservers(obj, beforeEvent(keyName), keyName, forceNotification);
};
})();
(function() {
// ==========================================================================
// Project: Ember Metal
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
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
notifyObservers = Ember.notifyObservers, // observer.js
forEach = Ember.ArrayPolyfills.forEach, // array.js
FIRST_KEY = /^([^\.\*]+)/,
IS_PATH = /[\.\*]/;
var MANDATORY_SETTER = Ember.ENV.MANDATORY_SETTER,
o_defineProperty = Ember.platform.defineProperty;
/** @private */
function firstKey(path) {
return path.match(FIRST_KEY)[0];
}
// returns true if the passed path is just a keyName
/** @private */
function isKeyName(path) {
return path==='*' || !IS_PATH.test(path);
}
// ..........................................................
// DEPENDENT KEYS
//
var DEP_SKIP = { __emberproto__: true }; // skip some keys and toString
/** @private */
function iterDeps(method, obj, depKey, seen, meta) {
var guid = guidFor(obj);
if (!seen[guid]) seen[guid] = {};
if (seen[guid][depKey]) return;
seen[guid][depKey] = true;
var deps = meta.deps;
deps = deps && deps[depKey];
if (deps) {
for(var key in deps) {
if (DEP_SKIP[key]) continue;
method(obj, key);
}
}
}
var WILL_SEEN, DID_SEEN;
// called whenever a property is about to change to clear the cache of any dependent keys (and notify those properties of changes, etc...)
/** @private */
function dependentKeysWillChange(obj, depKey, meta) {
if (obj.isDestroying) { return; }
var seen = WILL_SEEN, top = !seen;
if (top) { seen = WILL_SEEN = {}; }
iterDeps(propertyWillChange, obj, depKey, seen, meta);
if (top) { WILL_SEEN = null; }
}
// called whenever a property has just changed to update dependent keys
/** @private */
function dependentKeysDidChange(obj, depKey, meta) {
if (obj.isDestroying) { return; }
var seen = DID_SEEN, top = !seen;
if (top) { seen = DID_SEEN = {}; }
iterDeps(propertyDidChange, obj, depKey, seen, meta);
if (top) { DID_SEEN = null; }
}
// ..........................................................
// CHAIN
//
/** @private */
function addChainWatcher(obj, keyName, node) {
if (!obj || ('object' !== typeof obj)) return; // nothing to do
var m = metaFor(obj);
var nodes = m.chainWatchers;
if (!nodes || nodes.__emberproto__ !== obj) {
nodes = m.chainWatchers = { __emberproto__: obj };
}
if (!nodes[keyName]) { nodes[keyName] = {}; }
nodes[keyName][guidFor(node)] = node;
Ember.watch(obj, keyName);
}
/** @private */
function removeChainWatcher(obj, keyName, node) {
if (!obj || 'object' !== typeof obj) { return; } // nothing to do
var m = metaFor(obj, false),
nodes = m.chainWatchers;
if (!nodes || nodes.__emberproto__ !== obj) { return; } //nothing to do
if (nodes[keyName]) { delete nodes[keyName][guidFor(node)]; }
Ember.unwatch(obj, keyName);
}
var pendingQueue = [];
// attempts to add the pendingQueue chains again. If some of them end up
// back in the queue and reschedule is true, schedules a timeout to try
// again.
/** @private */
function flushPendingChains() {
if (pendingQueue.length === 0) { return; } // nothing to do
var queue = pendingQueue;
pendingQueue = [];
forEach.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);
}
/** @private */
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.
/** @private */
var ChainNode = function(parent, key, value, separator) {
var obj;
this._parent = parent;
this._key = key;
// _watching is true when calling get(this._parent, this._key) will
// return the value of this node.
//
// It is false for the root of a chain (because we have no parent)
// and for global paths (because the parent node is the object with
// the observer on it)
this._watching = value===undefined;
this._value = value;
this._separator = separator || '.';
this._paths = {};
if (this._watching) {
this._object = parent.value();
if (this._object) { addChainWatcher(this._object, this._key, this); }
}
// Special-case: the EachProxy relies on immediate evaluation to
// establish its observers.
//
// TODO: Replace this with an efficient callback that the EachProxy
// can implement.
if (this._parent && this._parent._key === '@each') {
this.value();
}
};
var 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, this._separator),
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, separator, paths;
paths = this._paths;
paths[path] = (paths[path] || 0) + 1;
obj = this.value();
tuple = normalizeTuple(obj, path);
// the path was a local path
if (tuple[0] && tuple[0] === obj) {
path = tuple[1];
key = firstKey(path);
path = path.slice(key.length+1);
// global path, but object does not exist yet.
// put into a queue and try to connect later.
} else if (!tuple[0]) {
pendingQueue.push([this, path]);
tuple.length = 0;
return;
// global path, and object already exists
} else {
src = tuple[0];
key = path.slice(0, 0-(tuple[1].length+1));
separator = path.slice(key.length, key.length+1);
path = tuple[1];
}
tuple.length = 0;
this.chain(key, path, src, separator);
};
// called on the root node of a chain to teardown watcher on the specified
// path
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, separator) {
var chains = this._chains, node;
if (!chains) { chains = this._chains = {}; }
node = chains[key];
if (!node) { node = chains[key] = new ChainNode(this, key, src, separator); }
node.count++; // count chains...
// chain rest of path if there is one
if (path && path.length>0) {
key = firstKey(path);
path = path.slice(key.length+1);
node.chain(key, path); // NOTE: no src means it will observe changes...
}
};
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 + this._separator + path; }
if (this._parent) {
this._parent.chainWillChange(this, path, depth+1);
} else {
if (depth > 1) { Ember.propertyWillChange(this.value(), path); }
path = 'this.' + path;
if (this._paths[path] > 0) { Ember.propertyWillChange(this.value(), path); }
}
};
ChainNodePrototype.chainDidChange = function(chain, path, depth) {
if (this._key) { path = this._key + this._separator + path; }
if (this._parent) {
this._parent.chainDidChange(this, path, depth+1);
} else {
if (depth > 1) { Ember.propertyDidChange(this.value(), path); }
path = 'this.' + path;
if (this._paths[path] > 0) { Ember.propertyDidChange(this.value(), path); }
}
};
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.
/** @private */
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;
}
/** @private */
function notifyChains(obj, m, keyName, methodName, arg) {
var nodes = m.chainWatchers;
if (!nodes || nodes.__emberproto__ !== obj) { return; } // nothing to do
nodes = nodes[keyName];
if (!nodes) { return; }
for(var key in nodes) {
if (!nodes.hasOwnProperty(key)) { continue; }
nodes[key][methodName](arg);
}
}
Ember.overrideChains = function(obj, keyName, m) {
notifyChains(obj, m, keyName, 'didChange', true);
};
/** @private */
function chainsWillChange(obj, keyName, m) {
notifyChains(obj, m, keyName, 'willChange');
}
/** @private */
function chainsDidChange(obj, keyName, m) {
notifyChains(obj, m, keyName, 'didChange');
}
// ..........................................................
// WATCH
//
/**
@private
Starts watching a property on an object. Whenever the property changes,
invokes Ember.propertyWillChange and Ember.propertyDidChange. This is the
primitive used by observers and dependent keys; usually you will never call
this method directly but instead use higher level methods like
Ember.addObserver().
*/
Ember.watch = function(obj, keyName) {
// can't watch length on Array - it is special...
if (keyName === 'length' && Ember.typeOf(obj) === 'array') { return this; }
var m = 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: function() {
Ember.assert('Must use Ember.set() to access this property', false);
},
get: function() {
var meta = this[META_KEY];
return meta && meta.values[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;
/** @private */
Ember.unwatch = function(obj, keyName) {
// can't watch length on Array - it is special...
if (keyName === 'length' && Ember.typeOf(obj) === 'array') { return this; }
var 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.
*/
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.
@memberOf Ember
@param {Object} obj
The object with the property that will change
@param {String} keyName
The property key (or path) that will change.
@returns {void}
*/
function propertyWillChange(obj, keyName, value) {
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.
@memberOf Ember
@param {Object} obj
The object with the property that will change
@param {String} keyName
The property key (or path) that will change.
@returns {void}
*/
function propertyDidChange(obj, keyName) {
var m = 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.
@param {Object} obj the object to destroy
@returns {void}
*/
Ember.destroy = function (obj) {
var meta = obj[META_KEY], node, nodes, key, nodeObject;
if (meta) {
obj[META_KEY] = null;
// remove chainWatchers to remove circular references that would prevent GC
node = meta.chains;
if (node) {
NODE_STACK.push(node);
// process tree
while (NODE_STACK.length > 0) {
node = NODE_STACK.pop();
// push children
nodes = node._chains;
if (nodes) {
for (key in nodes) {
if (nodes.hasOwnProperty(key)) {
NODE_STACK.push(nodes[key]);
}
}
}
// remove chainWatcher in node object
if (node._watching) {
nodeObject = node._object;
if (nodeObject) {
removeChainWatcher(nodeObject, node._key, node);
}
}
}
}
}
};
})();
(function() {
// ==========================================================================
// Project: Ember Metal
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
Ember.warn("Computed properties will soon be cacheable by default. To enable this in your app, set `ENV.CP_DEFAULT_CACHEABLE = true`.", Ember.CP_DEFAULT_CACHEABLE);
var get = Ember.get,
metaFor = Ember.meta,
guidFor = Ember.guidFor,
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,
// __emberproto__: SRC_OBJ [to detect clones]
// },
// __emberproto__: SRC_OBJ
// }
/**
@private
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] = { __emberproto__: obj };
} else if (keys.__emberproto__ !== obj) {
// otherwise if the dependency list is inherited from
// a superclass, clone the hash
keys = depsMeta[depKey] = o_create(keys);
keys.__emberproto__ = obj;
}
return keys;
}
/**
@private
return obj[META_KEY].deps
*/
function metaForDeps(obj, meta) {
var deps = meta.deps;
// If the current object has no dependencies...
if (!deps) {
// initialize the dependencies with a pointer back to
// the current object
deps = meta.deps = { __emberproto__: obj };
} else if (deps.__emberproto__ !== obj) {
// otherwise if the dependencies are inherited from the
// object's superclass, clone the deps
deps = meta.deps = o_create(deps);
deps.__emberproto__ = obj;
}
return deps;
}
/** @private */
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);
}
}
/** @private */
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
//
/** @private */
function ComputedProperty(func, opts) {
this.func = func;
this._cacheable = (opts && opts.cacheable !== undefined) ? opts.cacheable : Ember.CP_DEFAULT_CACHEABLE;
this._dependentKeys = opts && opts.dependentKeys;
}
/**
@constructor
*/
Ember.ComputedProperty = ComputedProperty;
ComputedProperty.prototype = new Ember.Descriptor();
/**
@extends Ember.ComputedProperty
@private
*/
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.
MyApp.president = Ember.Object.create({
fullName: function() {
return this.get('firstName') + ' ' + this.get('lastName');
// After calculating the value of this function, Ember.js will
// return that value without re-executing this function until
// one of the dependent properties change.
}.property('firstName', 'lastName').cacheable()
});
Properties are cacheable by default.
@memberOf Ember.ComputedProperty.prototype
@name cacheable
@function
@param {Boolean} aFlag optional set to false to disable caching
@returns {Ember.ComputedProperty} receiver
*/
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.
MyApp.outsideService = Ember.Object.create({
value: function() {
return OutsideService.getValue();
}.property().volatile()
});
@memberOf Ember.ComputedProperty.prototype
@name volatile
@function
@returns {Ember.ComputedProperty} receiver
*/
ComputedPropertyPrototype.volatile = function() {
return this.cacheable(false);
};
/**
Sets the dependent keys on this computed property. Pass any number of
arguments containing key paths that this computed property depends on.
MyApp.president = Ember.Object.create({
fullName: Ember.computed(function() {
return this.get('firstName') + ' ' + this.get('lastName');
// Tell Ember.js that this computed property depends on firstName
// and lastName
}).property('firstName', 'lastName')
});
@memberOf Ember.ComputedProperty.prototype
@name property
@function
@param {String} path... zero or more property paths
@returns {Ember.ComputedProperty} receiver
*/
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.
@memberOf Ember.ComputedProperty.prototype
@name meta
@function
@param {Hash} meta
@returns {Ember.ComputedProperty} property descriptor instance
*/
ComputedPropertyPrototype.meta = function(meta) {
if (arguments.length === 0) {
return this._meta || {};
} else {
this._meta = meta;
return this;
}
};
/** @private - 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);
}
};
/** @private - 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);
}
}
}
};
/** @private - 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;
};
/** @private - impl descriptor API */
ComputedPropertyPrototype.set = function(obj, keyName, value) {
var cacheable = this._cacheable,
meta = metaFor(obj, cacheable),
watched = meta.watching[keyName],
oldSuspended = this._suspended,
hadCachedValue,
ret;
this._suspended = obj;
if (watched) { Ember.propertyWillChange(obj, keyName); }
if (cacheable) {
if (keyName in meta.cache) {
delete meta.cache[keyName];
hadCachedValue = true;
}
}
ret = this.func.call(obj, keyName, value);
if (cacheable) {
if (!watched && !hadCachedValue) {
addDependentKeys(this, obj, keyName, meta);
}
meta.cache[keyName] = ret;
}
if (watched) { Ember.propertyDidChange(obj, keyName); }
this._suspended = oldSuspended;
return ret;
};
/** @private - 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));
}
};
/** @private - 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.
@param {Function} func
The computed property function.
@returns {Ember.ComputedProperty} property descriptor instance
*/
Ember.computed = function(func) {
var args;
if (arguments.length > 1) {
args = a_slice.call(arguments, 0, -1);
func = a_slice.call(arguments, -1)[0];
}
var cp = new ComputedProperty(func);
if (args) {
cp.property.apply(cp, args);
}
return cp;
};
/**
Returns the cached value for a property, if one exists.
This can be useful for peeking at the value of a computed
property that is generated lazily, without accidentally causing
it to be created.
@param {Object} obj the object whose property you want to check
@param {String} key the name of the property whose cached value you want
to return
*/
Ember.cacheFor = function cacheFor(obj, key) {
var cache = metaFor(obj, false).cache;
if (cache && key in cache) {
return cache[key];
}
};
Ember.computed.not = function(dependentKey) {
return Ember.computed(dependentKey, function(key) {
return !get(this, dependentKey);
}).cacheable();
};
Ember.computed.empty = function(dependentKey) {
return Ember.computed(dependentKey, function(key) {
var val = get(this, dependentKey);
return val === undefined || val === null || val === '' || (Ember.isArray(val) && get(val, 'length') === 0);
}).cacheable();
};
Ember.computed.bool = function(dependentKey) {
return Ember.computed(dependentKey, function(key) {
return !!get(this, dependentKey);
}).cacheable();
};
})();
(function() {
// ==========================================================================
// Project: Ember Metal
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
var o_create = Ember.create,
meta = Ember.meta,
metaPath = Ember.metaPath,
guidFor = Ember.guidFor,
a_slice = [].slice;
/**
The event system uses a series of nested hashes to store listeners on an
object. When a listener is registered, or when an event arrives, these
hashes are consulted to determine which target and action pair to invoke.
The hashes are stored in the object's meta hash, and look like this:
// Object's meta hash
{
listeners: { // variable name: `listenerSet`
"foo:changed": { // variable name: `targetSet`
[targetGuid]: { // variable name: `actionSet`
[methodGuid]: { // variable name: `action`
target: [Object object],
method: [Function function]
}
}
}
}
}
*/
// Gets the set of all actions, keyed on the guid of each action's
// method property.
/** @private */
function actionSetFor(obj, eventName, target, writable) {
return metaPath(obj, ['listeners', eventName, guidFor(target)], writable);
}
// Gets the set of all targets, keyed on the guid of each action's
// target property.
/** @private */
function targetSetFor(obj, eventName) {
var listenerSet = meta(obj, false).listeners;
if (!listenerSet) { return false; }
return listenerSet[eventName] || false;
}
// TODO: This knowledge should really be a part of the
// meta system.
var SKIP_PROPERTIES = { __ember_source__: true };
/** @private */
function iterateSet(obj, eventName, callback, params) {
var targetSet = targetSetFor(obj, eventName);
if (!targetSet) { return false; }
// Iterate through all elements of the target set
for(var targetGuid in targetSet) {
if (SKIP_PROPERTIES[targetGuid]) { continue; }
var actionSet = targetSet[targetGuid];
if (actionSet) {
// Iterate through the elements of the action set
for(var methodGuid in actionSet) {
if (SKIP_PROPERTIES[methodGuid]) { continue; }
var action = actionSet[methodGuid];
if (action) {
if (callback(action, params, obj) === true) {
return true;
}
}
}
}
}
return false;
}
/** @private */
function invokeAction(action, params, sender) {
var method = action.method, target = action.target;
// If there is no target, the target is the object
// on which the event was fired.
if (!target) { target = sender; }
if ('string' === typeof method) { method = target[method]; }
if (params) {
method.apply(target, params);
} else {
method.apply(target);
}
}
/**
The sendEvent arguments > 2 are passed to an event listener.
@memberOf Ember
*/
function addListener(obj, eventName, target, method) {
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 actionSet = actionSetFor(obj, eventName, target, true),
methodGuid = guidFor(method);
if (!actionSet[methodGuid]) {
actionSet[methodGuid] = { target: target, method: method };
}
if ('function' === typeof obj.didAddListener) {
obj.didAddListener(eventName, target, method);
}
}
/** @memberOf Ember */
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;
}
var actionSet = actionSetFor(obj, eventName, target, true),
methodGuid = guidFor(method);
// we can't simply delete this parameter, because if we do, we might
// re-expose the property from the prototype chain.
if (actionSet && actionSet[methodGuid]) { actionSet[methodGuid] = null; }
if ('function' === typeof obj.didRemoveListener) {
obj.didRemoveListener(eventName, target, method);
}
}
// Suspend listener during callback.
//
// This should only be used by the target of the event listener
// when it is taking an action that would cause the event, e.g.
// an object might suspend its property change listener while it is
// setting that property.
/** @private */
function suspendListener(obj, eventName, target, method, callback) {
if (!method && 'function' === typeof target) {
method = target;
target = null;
}
var actionSet = actionSetFor(obj, eventName, target, true),
methodGuid = guidFor(method),
action = actionSet && actionSet[methodGuid];
actionSet[methodGuid] = null;
try {
return callback.call(target);
} finally {
actionSet[methodGuid] = action;
}
}
// returns a list of currently watched events
/** @memberOf Ember */
function watchedEvents(obj) {
var listeners = meta(obj, false).listeners, ret = [];
if (listeners) {
for(var eventName in listeners) {
if (!SKIP_PROPERTIES[eventName] && listeners[eventName]) {
ret.push(eventName);
}
}
}
return ret;
}
/** @memberOf Ember */
function sendEvent(obj, eventName, params) {
// first give object a chance to handle it
if (obj !== Ember && 'function' === typeof obj.sendEvent) {
obj.sendEvent(eventName, params);
}
iterateSet(obj, eventName, invokeAction, params);
return true;
}
/** @memberOf Ember */
function deferEvent(obj, eventName, params) {
var actions = [];
iterateSet(obj, eventName, function (action) {
actions.push(action);
});
return function() {
if (obj.isDestroyed) { return; }
if (obj !== Ember && 'function' === typeof obj.sendEvent) {
obj.sendEvent(eventName, params);
}
for (var i=0, len=actions.length; i < len; ++i) {
invokeAction(actions[i], params, obj);
}
};
}
/** @memberOf Ember */
function hasListeners(obj, eventName) {
if (iterateSet(obj, eventName, function() { return true; })) {
return true;
}
// no listeners! might as well clean this up so it is faster later.
var set = metaPath(obj, ['listeners'], true);
set[eventName] = null;
return false;
}
/** @memberOf Ember */
function listenersFor(obj, eventName) {
var ret = [];
iterateSet(obj, eventName, function (action) {
ret.push([action.target, action.method]);
});
return ret;
}
Ember.addListener = addListener;
Ember.removeListener = removeListener;
Ember._suspendListener = suspendListener;
Ember.sendEvent = sendEvent;
Ember.hasListeners = hasListeners;
Ember.watchedEvents = watchedEvents;
Ember.listenersFor = listenersFor;
Ember.deferEvent = deferEvent;
})();
(function() {
// ==========================================================================
// Project: Ember Runtime
// Copyright: ©2006-2011 Strobe Inc. and contributors.
// Portions ©2008-2010 Apple Inc. All rights reserved.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
// Ember.Logger
// Ember.watch.flushPending
// Ember.beginPropertyChanges, Ember.endPropertyChanges
// Ember.guidFor
// ..........................................................
// HELPERS
//
var slice = [].slice,
forEach = Ember.ArrayPolyfills.forEach;
// invokes passed params - normalizing so you can pass target/func,
// target/string or just func
/** @private */
function invoke(target, method, args, ignore) {
if (method === undefined) {
method = target;
target = undefined;
}
if ('string' === typeof method) { method = target[method]; }
if (args && ignore > 0) {
args = args.length > ignore ? slice.call(args, ignore) : null;
}
// Unfortunately in some browsers we lose the backtrace if we rethrow the existing error,
// so in the event that we don't have an `onerror` handler we don't wrap in a try/catch
if ('function' === typeof Ember.onerror) {
try {
// IE8's Function.prototype.apply doesn't accept undefined/null arguments.
return method.apply(target || this, args || []);
} catch (error) {
Ember.onerror(error);
}
} else {
// IE8's Function.prototype.apply doesn't accept undefined/null arguments.
return method.apply(target || this, args || []);
}
}
// ..........................................................
// RUNLOOP
//
var timerMark; // used by timers...
/** @private */
var RunLoop = function(prev) {
this._prev = prev || null;
this.onceTimers = {};
};
RunLoop.prototype = {
end: function() {
this.flush();
},
prev: function() {
return this._prev;
},
// ..........................................................
// Delayed Actions
//
schedule: function(queueName, target, method) {
var queues = this._queues, queue;
if (!queues) { queues = this._queues = {}; }
queue = queues[queueName];
if (!queue) { queue = queues[queueName] = []; }
var args = arguments.length > 3 ? slice.call(arguments, 3) : null;
queue.push({ target: target, method: method, args: args });
return this;
},
flush: function(queueName) {
var queueNames, idx, len, queue, log;
if (!this._queues) { return this; } // nothing to do
function iter(item) {
invoke(item.target, item.method, item.args);
}
Ember.watch.flushPending(); // make sure all chained watchers are setup
if (queueName) {
while (this._queues && (queue = this._queues[queueName])) {
this._queues[queueName] = null;
// the sync phase is to allow property changes to propagate. don't
// invoke observers until that is finished.
if (queueName === 'sync') {
log = Ember.LOG_BINDINGS;
if (log) { Ember.Logger.log('Begin: Flush Sync Queue'); }
Ember.beginPropertyChanges();
try {
forEach.call(queue, iter);
} finally {
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();
try {
forEach.call(queue, iter);
} finally {
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
//
/**
* @namespace Ember.run is both a function and a namespace for
* RunLoop-related functions.
* @name Ember.run
*/
/**
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.
Ember.run(function(){
// code to be execute within a RunLoop
});
@name run
@methodOf Ember.run
@param {Object} target
(Optional) 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.
@returns {Object} return value from invoking the passed function.
*/
Ember.run = function(target, method) {
var ret, loop;
run.begin();
try {
if (target || method) { ret = invoke(target, method, arguments, 2); }
} finally {
run.end();
}
return ret;
};
/** @private */
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
an lower-level way to use a RunLoop instead of using Ember.run().
Ember.run.begin();
// code to be execute within a RunLoop
Ember.run.end();
@returns {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().
Ember.run.begin();
// code to be execute within a RunLoop
Ember.run.end();
@returns {void}
*/
Ember.run.end = function() {
Ember.assert('must have a current run loop', run.currentRunLoop);
try {
run.currentRunLoop.end();
}
finally {
run.currentRunLoop = run.currentRunLoop.prev();
}
};
/**
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.
@type Array
@default ['sync', 'actions', 'destroy', 'timers']
*/
Ember.run.queues = ['sync', 'actions', 'destroy', 'timers'];
/**
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.
Ember.run.schedule('timers', this, function(){
// this will be executed at the end of the RunLoop, when timers are run
console.log("scheduled on timers queue");
});
Ember.run.schedule('sync', this, function(){
// this will be executed at the end of the RunLoop, when bindings are synced
console.log("scheduled on sync queue");
});
// Note the functions will be run in order based on the run queues order. Output would be:
// scheduled on sync queue
// scheduled on timers queue
@param {String} queue
The name of the queue to schedule against. Default queues are 'sync' and
'actions'
@param {Object} target
(Optional) 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.
@returns {void}
*/
Ember.run.schedule = function(queue, target, method) {
var loop = run.autorun();
loop.schedule.apply(loop, arguments);
};
var scheduledAutorun;
/** @private */
function autorun() {
scheduledAutorun = null;
if (run.currentRunLoop) { run.end(); }
}
// Used by global test teardown
/** @private */
Ember.run.hasScheduledTimers = function() {
return !!(scheduledAutorun || scheduledLater || scheduledNext);
};
// Used by global test teardown
/** @private */
Ember.run.cancelTimers = function () {
if (scheduledAutorun) {
clearTimeout(scheduledAutorun);
scheduledAutorun = null;
}
if (scheduledLater) {
clearTimeout(scheduledLater);
scheduledLater = null;
}
if (scheduledNext) {
clearTimeout(scheduledNext);
scheduledNext = 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().
Ember.run.autorun();
@returns {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.
Ember.run.sync();
@returns {void}
*/
Ember.run.sync = function() {
run.autorun();
run.currentRunLoop.flush('sync');
};
// ..........................................................
// TIMERS
//
var timers = {}; // active timers...
var scheduledLater;
/** @private */
function invokeLaterTimers() {
scheduledLater = null;
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...
if (earliest > 0) { scheduledLater = setTimeout(invokeLaterTimers, earliest-(+ new Date())); }
}
/**
Invokes the passed target/method and optional arguments after a specified
period if time. The last parameter of this method must always be a number
of milliseconds.
You should use this method whenever you need to run some action after a
period of time instead of using setTimeout(). This method will ensure that
items that expire during the same script execution cycle all execute
together, which is often more efficient than using a real setTimeout.
Ember.run.later(myContext, function(){
// code here will execute within a RunLoop in about 500ms with this == myContext
}, 500);
@param {Object} target
(optional) target of method to invoke
@param {Function|String} method
The method to invoke. If you pass a string it will be resolved on the
target at the time the method is invoked.
@param {Object...} args
Optional arguments to pass to the timeout.
@param {Number} wait
Number of milliseconds to wait.
@returns {String} a string you can use to cancel the timer in Ember.run.cancel() 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;
run.once(timers, invokeLaterTimers);
return guid;
};
/** @private */
function invokeOnceTimer(guid, onceTimers) {
if (onceTimers[this.tguid]) { delete onceTimers[this.tguid][this.mguid]; }
if (timers[guid]) { invoke(this.target, this.method, this.args, 2); }
delete timers[guid];
}
/**
Schedules an item to run one time during the current RunLoop. Calling
this method with the same target/method combination will have no effect.
Note that although you can pass optional arguments these will not be
considered when looking for duplicates. New arguments will replace previous
calls.
Ember.run(function(){
var doFoo = function() { foo(); }
Ember.run.once(myContext, doFoo);
Ember.run.once(myContext, doFoo);
// doFoo will only be executed once at the end of the RunLoop
});
@param {Object} target
(optional) target of method to invoke
@param {Function|String} method
The method to invoke. If you pass a string it will be resolved on the
target at the time the method is invoked.
@param {Object...} args
Optional arguments to pass to the timeout.
@returns {Object} timer
*/
Ember.run.once = function(target, method) {
var tguid = Ember.guidFor(target),
mguid = Ember.guidFor(method),
onceTimers = run.autorun().onceTimers,
guid = onceTimers[tguid] && onceTimers[tguid][mguid],
timer;
if (guid && timers[guid]) {
timers[guid].args = slice.call(arguments); // replace args
} else {
timer = {
target: target,
method: method,
args: slice.call(arguments),
tguid: tguid,
mguid: mguid
};
guid = Ember.guidFor(timer);
timers[guid] = timer;
if (!onceTimers[tguid]) { onceTimers[tguid] = {}; }
onceTimers[tguid][mguid] = guid; // so it isn't scheduled more than once
run.schedule('actions', timer, invokeOnceTimer, guid, onceTimers);
}
return guid;
};
var scheduledNext;
/** @private */
function invokeNextTimers() {
scheduledNext = null;
for(var key in timers) {
if (!timers.hasOwnProperty(key)) { continue; }
var timer = timers[key];
if (timer.next) {
delete timers[key];
invoke(timer.target, timer.method, timer.args, 2);
}
}
}
/**
Schedules an item to run after control has been returned to the system.
This is often equivalent to calling setTimeout(function...,1).
Ember.run.next(myContext, function(){
// code to be executed in the next RunLoop, which will be scheduled after the current one
});
@param {Object} target
(optional) target of method to invoke
@param {Function|String} method
The method to invoke. If you pass a string it will be resolved on the
target at the time the method is invoked.
@param {Object...} args
Optional arguments to pass to the timeout.
@returns {Object} timer
*/
Ember.run.next = function(target, method) {
var guid,
timer = {
target: target,
method: method,
args: slice.call(arguments),
next: true
};
guid = Ember.guidFor(timer);
timers[guid] = timer;
if (!scheduledNext) { scheduledNext = setTimeout(invokeNextTimers, 1); }
return guid;
};
/**
Cancels a scheduled item. Must be a value returned by `Ember.run.later()`,
`Ember.run.once()`, or `Ember.run.next()`.
var runNext = Ember.run.next(myContext, function(){
// will not be executed
});
Ember.run.cancel(runNext);
var runLater = Ember.run.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);
@param {Object} timer
Timer object to cancel
@returns {void}
*/
Ember.run.cancel = function(timer) {
delete timers[timer];
};
})();
(function() {
// ==========================================================================
// Project: Ember Runtime
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
// Ember.Logger
// get, set, trySet
// guidFor, isArray, meta
// addObserver, removeObserver
// Ember.run.schedule
// ..........................................................
// CONSTANTS
//
/**
@static
Debug parameter you can turn on. This will log all bindings that fire to
the console. This should be disabled in production code. Note that you
can also enable this from the console or temporarily.
@type Boolean
@default false
*/
Ember.LOG_BINDINGS = false || !!Ember.ENV.LOG_BINDINGS;
var get = Ember.get,
set = Ember.set,
guidFor = Ember.guidFor,
isGlobalPath = Ember.isGlobalPath;
/** @private */
function getWithGlobals(obj, path) {
return get(isGlobalPath(path) ? window : obj, path);
}
// ..........................................................
// BINDING
//
/** @private */
var Binding = function(toPath, fromPath) {
this._direction = 'fwd';
this._from = fromPath;
this._to = toPath;
this._directionMap = Ember.Map.create();
};
Binding.prototype = /** @scope Ember.Binding.prototype */ {
/**
This copies the Binding so it can be connected to another object.
@returns {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.
@param {String} propertyPath the property path to connect to
@returns {Ember.Binding} receiver
*/
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.
@param {String|Tuple} propertyPath A property path or tuple
@returns {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.
@returns {Ember.Binding} receiver
*/
oneWay: function() {
this._oneWay = true;
return this;
},
/** @private */
toString: function() {
var oneWay = this._oneWay ? '[oneWay]' : '';
return "Ember.Binding<" + guidFor(this) + ">(" + this._from + " -> " + this._to + ")" + oneWay;
},
// ..........................................................
// CONNECT AND SYNC
//
/**
Attempts to connect this binding instance so that it can receive and relay
changes. This method will raise an exception if you have not set the
from/to properties yet.
@param {Object} obj The root object for this binding.
@returns {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.
@param {Object} obj
The root object you passed when connecting the binding.
@returns {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
//
/** @private - called when the from side changes */
fromDidChange: function(target) {
this._scheduleSync(target, 'fwd');
},
/** @private - called when the to side changes */
toDidChange: function(target) {
this._scheduleSync(target, 'back');
},
/** @private */
_scheduleSync: function(obj, dir) {
var 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');
}
},
/** @private */
_sync: function(obj) {
var log = Ember.LOG_BINDINGS;
// don't synchronize destroyed objects or disconnected bindings
if (obj.isDestroyed || !this._readyToSync) { return; }
// get the direction of the binding for the object we are
// synchronizing from
var 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) ? window : obj, fromPath, toValue);
});
}
}
};
/** @private */
function mixinProperties(to, from) {
for (var key in from) {
if (from.hasOwnProperty(key)) {
to[key] = from[key];
}
}
}
mixinProperties(Binding,
/** @scope Ember.Binding */ {
/**
@see Ember.Binding.prototype.from
*/
from: function() {
var C = this, binding = new C();
return binding.from.apply(binding, arguments);
},
/**
@see Ember.Binding.prototype.to
*/
to: function() {
var C = this, binding = new C();
return binding.to.apply(binding, arguments);
},
/**
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 (supplies
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.
@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.
@see Ember.Binding.prototype.oneWay
*/
oneWay: function(from, flag) {
var C = this, binding = new C(null, from);
return binding.oneWay(flag);
}
});
/**
@class
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:
binding = Ember.Binding.from(this.valueBinding).to("value");
This creates a new binding instance based on the template you provide, and
sets the to path to the "value" property of the new object. Now that the
binding is fully configured with a "from" and a "to", it simply needs to be
connected to become active. This is done through the connect() method:
binding.connect(this);
Note that when you connect a binding you pass the object you want it to be
connected to. This object will be used as the root for both the from and
to side of the binding when inspecting relative paths. This allows the
binding to be automatically inherited by subclassed objects as well.
Now that the binding is connected, it will observe both the from and to side
and relay changes.
If you ever needed to do so (you almost never will, but it is useful to
understand this anyway), you could manually create an active binding by
using the Ember.bind() helper method. (This is the same method used by
to setup your bindings on objects):
Ember.bind(MyApp.anotherObject, "value", "MyApp.someController.value");
Both of these code fragments have the same effect as doing the most friendly
form of binding creation like so:
MyApp.anotherObject = Ember.Object.create({
valueBinding: "MyApp.someController.value",
// OTHER CODE FOR THIS OBJECT...
});
Ember's built in binding creation method makes it easy to automatically
create bindings for you. You should always use the highest-level APIs
available, even if you understand how it works underneath.
@since Ember 0.9
*/
Ember.Binding = Binding;
/**
Global helper method to create a new binding. Just pass the root object
along with a to and from path to create and connect the binding.
@param {Object} obj
The root object of the transform.
@param {String} to
The path to the 'to' side of the binding. Must be relative to obj.
@param {String} from
The path to the 'from' side of the binding. Must be relative to obj or
a global path.
@returns {Ember.Binding} binding instance
*/
Ember.bind = function(obj, to, from) {
return new Ember.Binding(to, from).connect(obj);
};
Ember.oneWay = function(obj, to, from) {
return new Ember.Binding(to, from).oneWay().connect(obj);
};
})();
(function() {
// ==========================================================================
// Project: Ember Runtime
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
var Mixin, REQUIRED, Alias,
classToString, superClassString,
a_map = Ember.ArrayPolyfills.map,
a_indexOf = Ember.ArrayPolyfills.indexOf,
a_forEach = Ember.ArrayPolyfills.forEach,
a_slice = [].slice,
EMPTY_META = {}, // dummy for non-writable meta
META_SKIP = { __emberproto__: true, __ember_count__: true },
o_create = Ember.create,
defineProperty = Ember.defineProperty,
guidFor = Ember.guidFor;
/** @private */
function mixinsMeta(obj) {
var m = Ember.meta(obj, true), ret = m.mixins;
if (!ret) {
ret = m.mixins = { __emberproto__: obj };
} else if (ret.__emberproto__ !== obj) {
ret = m.mixins = o_create(ret);
ret.__emberproto__ = obj;
}
return ret;
}
/** @private */
function initMixin(mixin, args) {
if (args && args.length > 0) {
mixin.mixins = a_map.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;
}
/** @private */
function isMethod(obj) {
return 'function' === typeof obj &&
obj.isMethod !== false &&
obj !== Boolean && obj !== Object && obj !== Number && obj !== Array && obj !== Date && obj !== String;
}
/** @private */
function mergeMixins(mixins, m, descs, values, base) {
var len = mixins.length, idx, mixin, guid, props, value, key, ovalue, concats;
/** @private */
function removeKeys(keyName) {
delete descs[keyName];
delete values[keyName];
}
for(idx=0; idx < len; idx++) {
mixin = mixins[idx];
Ember.assert('Expected hash or Mixin instance, got ' + Object.prototype.toString.call(mixin), typeof mixin === 'object' && mixin !== null && Object.prototype.toString.call(mixin) !== '[object Array]');
if (mixin instanceof Mixin) {
guid = guidFor(mixin);
if (m[guid]) { continue; }
m[guid] = mixin;
props = mixin.properties;
} else {
props = mixin; // apply anonymous mixin properties
}
if (props) {
// 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;
}
for (key in props) {
if (!props.hasOwnProperty(key)) { continue; }
value = props[key];
if (value instanceof Ember.Descriptor) {
if (value === REQUIRED && descs[key]) { continue; }
descs[key] = value;
values[key] = undefined;
} else {
// impl super if needed...
if (isMethod(value)) {
ovalue = descs[key] === undefined && values[key];
if (!ovalue) { ovalue = base[key]; }
if ('function' !== typeof ovalue) { ovalue = null; }
if (ovalue) {
var o = value.__ember_observes__, ob = value.__ember_observesBefore__;
value = Ember.wrap(value, ovalue);
value.__ember_observes__ = o;
value.__ember_observesBefore__ = ob;
}
} else if ((concats && a_indexOf.call(concats, key) >= 0) || key === 'concatenatedProperties') {
var baseValue = values[key] || base[key];
value = baseValue ? baseValue.concat(value) : Ember.makeArray(value);
}
descs[key] = undefined;
values[key] = value;
}
}
// manually copy toString() because some JS engines do not enumerate it
if (props.hasOwnProperty('toString')) {
base.toString = props.toString;
}
} else if (mixin.mixins) {
mergeMixins(mixin.mixins, m, descs, values, base);
if (mixin._without) { a_forEach.call(mixin._without, removeKeys); }
}
}
}
/** @private */
function writableReq(obj) {
var m = Ember.meta(obj), req = m.required;
if (!req || req.__emberproto__ !== obj) {
req = m.required = req ? o_create(req) : { __ember_count__: 0 };
req.__emberproto__ = obj;
}
return req;
}
var IS_BINDING = Ember.IS_BINDING = /^.+Binding$/;
/** @private */
function detectBinding(obj, key, value, m) {
if (IS_BINDING.test(key)) {
var bindings = m.bindings;
if (!bindings) {
bindings = m.bindings = { __emberproto__: obj };
} else if (bindings.__emberproto__ !== obj) {
bindings = m.bindings = o_create(m.bindings);
bindings.__emberproto__ = obj;
}
bindings[key] = value;
}
}
/** @private */
function connectBindings(obj, m) {
// TODO Mixin.apply(instance) should disconnect binding if exists
var bindings = m.bindings, key, binding, to;
if (bindings) {
for (key in bindings) {
binding = key !== '__emberproto__' && bindings[key];
if (binding) {
to = key.slice(0, -7); // strip Binding off end
if (binding instanceof Ember.Binding) {
binding = binding.copy(); // copy prototypes' instance
binding.to(to);
} else { // binding is string path
binding = new Ember.Binding(to, binding);
}
binding.connect(obj);
obj[key] = binding;
}
}
// mark as applied
m.bindings = { __emberproto__: obj };
}
}
function finishPartial(obj, m) {
connectBindings(obj, m || Ember.meta(obj));
return obj;
}
/** @private */
function applyMixin(obj, mixins, partial) {
var descs = {}, values = {}, m = Ember.meta(obj), req = m.required,
key, value, desc, prevValue, paths, len, idx;
// Go through all mixins and hashes passed in, and:
//
// * Handle concatenated properties
// * Set up _super wrapping if necessary
// * Set up computed property descriptors
// * Copying `toString` in broken browsers
mergeMixins(mixins, mixinsMeta(obj), descs, values, obj);
for(key in values) {
if (key === 'contructor') { continue; }
if (!values.hasOwnProperty(key)) { continue; }
desc = descs[key];
value = values[key];
if (desc === REQUIRED) {
if (!(key in obj)) {
Ember.assert('Required property not defined: '+key, !!partial);
// for partial applies add to hash of required keys
req = writableReq(obj);
req.__ember_count__++;
req[key] = true;
}
} else {
while (desc && desc instanceof Alias) {
var altKey = desc.methodName;
if (descs[altKey] || values[altKey]) {
value = values[altKey];
desc = descs[altKey];
} else if (m.descs[altKey]) {
desc = m.descs[altKey];
value = undefined;
} else {
desc = undefined;
value = obj[altKey];
}
}
if (desc === undefined && value === undefined) { continue; }
prevValue = obj[key];
if ('function' === typeof prevValue) {
if ((paths = prevValue.__ember_observesBefore__)) {
len = paths.length;
for (idx=0; idx < len; idx++) {
Ember.removeBeforeObserver(obj, paths[idx], null, key);
}
} else if ((paths = prevValue.__ember_observes__)) {
len = paths.length;
for (idx=0; idx < len; idx++) {
Ember.removeObserver(obj, paths[idx], null, key);
}
}
}
detectBinding(obj, key, value, m);
defineProperty(obj, key, desc, value, m);
if ('function' === typeof value) {
if (paths = value.__ember_observesBefore__) {
len = paths.length;
for (idx=0; idx < len; idx++) {
Ember.addBeforeObserver(obj, paths[idx], null, key);
}
} else if (paths = value.__ember_observes__) {
len = paths.length;
for (idx=0; idx < len; idx++) {
Ember.addObserver(obj, paths[idx], null, key);
}
}
}
if (req && req[key]) {
req = writableReq(obj);
req.__ember_count__--;
req[key] = false;
}
}
}
if (!partial) { // don't apply to prototype
finishPartial(obj, m);
}
// Make sure no required attrs remain
if (!partial && req && req.__ember_count__>0) {
var keys = [];
for (key in req) {
if (META_SKIP[key]) { continue; }
keys.push(key);
}
// TODO: Remove surrounding if clause from production build
Ember.assert('Required properties not defined: '+keys.join(','));
}
return obj;
}
Ember.mixin = function(obj) {
var args = a_slice.call(arguments, 1);
applyMixin(obj, args, false);
return obj;
};
/**
@class
The `Ember.Mixin` class allows you to create mixins, whose properties can be
added to other classes. For instance,
App.Editable = Ember.Mixin.create({
edit: function() {
console.log('starting to edit');
this.set('isEditing', true);
},
isEditing: false
});
// Mix mixins into classes by passing them as the first arguments to
// .extend or .create.
App.CommentView = Ember.View.extend(App.Editable, {
template: Ember.Handlebars.compile('{{#if isEditing}}...{{else}}...{{/if}}')
});
commentView = App.CommentView.create();
commentView.edit(); // => outputs 'starting to edit'
Note that Mixins are created with `Ember.Mixin.create`, not
`Ember.Mixin.extend`.
*/
Ember.Mixin = function() { return initMixin(this, arguments); };
/** @private */
Mixin = Ember.Mixin;
/** @private */
Mixin._apply = applyMixin;
Mixin.applyPartial = function(obj) {
var args = a_slice.call(arguments, 1);
return applyMixin(obj, args, true);
};
Mixin.finishPartial = finishPartial;
Mixin.create = function() {
classToString.processed = false;
var M = this;
return initMixin(new M(), arguments);
};
var MixinPrototype = Mixin.prototype;
MixinPrototype.reopen = function() {
var mixin, tmp;
if (this.properties) {
mixin = Mixin.create();
mixin.properties = this.properties;
delete this.properties;
this.mixins = [mixin];
} else if (!this.mixins) {
this.mixins = [];
}
var len = arguments.length, mixins = this.mixins, idx;
for(idx=0; idx < len; idx++) {
mixin = arguments[idx];
Ember.assert('Expected hash or Mixin instance, got ' + Object.prototype.toString.call(mixin), typeof mixin === 'object' && mixin !== null && Object.prototype.toString.call(mixin) !== '[object Array]');
if (mixin instanceof Mixin) {
mixins.push(mixin);
} else {
tmp = Mixin.create();
tmp.properties = mixin;
mixins.push(tmp);
}
}
return this;
};
MixinPrototype.apply = function(obj) {
return applyMixin(obj, [this], false);
};
MixinPrototype.applyPartial = function(obj) {
return applyMixin(obj, [this], true);
};
/** @private */
function _detect(curMixin, targetMixin, seen) {
var guid = guidFor(curMixin);
if (seen[guid]) { return false; }
seen[guid] = true;
if (curMixin === targetMixin) { return true; }
var mixins = curMixin.mixins, loc = mixins ? mixins.length : 0;
while (--loc >= 0) {
if (_detect(mixins[loc], targetMixin, seen)) { return true; }
}
return false;
}
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;
};
/** @private */
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;
};
/** @private - make Mixin's have nice displayNames */
var NAME_KEY = Ember.GUID_KEY+'_name';
var get = Ember.get;
/** @private */
function processNames(paths, root, seen) {
var idx = paths.length;
for(var key in root) {
if (!root.hasOwnProperty || !root.hasOwnProperty(key)) { continue; }
var obj = root[key];
paths[idx] = key;
if (obj && obj.toString === classToString) {
obj[NAME_KEY] = paths.join('.');
} else if (obj && get(obj, 'isNamespace')) {
if (seen[guidFor(obj)]) { continue; }
seen[guidFor(obj)] = true;
processNames(paths, obj, seen);
}
}
paths.length = idx; // cut out last item
}
/** @private */
function findNamespaces() {
var Namespace = Ember.Namespace, obj, isNamespace;
if (Namespace.PROCESSED) { return; }
for (var prop in window) {
// get(window.globalStorage, 'isNamespace') would try to read the storage for domain isNamespace and cause exception in Firefox.
// globalStorage is a storage obsoleted by the WhatWG storage specification. See https://developer.mozilla.org/en/DOM/Storage#globalStorage
if (prop === "globalStorage" && window.StorageList && window.globalStorage instanceof window.StorageList) { continue; }
// Unfortunately, some versions of IE don't support window.hasOwnProperty
if (window.hasOwnProperty && !window.hasOwnProperty(prop)) { continue; }
// At times we are not allowed to access certain properties for security reasons.
// There are also times where even if we can access them, we are not allowed to access their properties.
try {
obj = window[prop];
isNamespace = obj && get(obj, 'isNamespace');
} catch (e) {
continue;
}
if (isNamespace) {
Ember.deprecate("Namespaces should not begin with lowercase.", /^[A-Z]/.test(prop));
obj[NAME_KEY] = prop;
}
}
}
Ember.identifyNamespaces = findNamespaces;
/** @private */
superClassString = function(mixin) {
var superclass = mixin.superclass;
if (superclass) {
if (superclass[NAME_KEY]) { return superclass[NAME_KEY]; }
else { return superClassString(superclass); }
} else {
return;
}
};
/** @private */
classToString = function() {
var Namespace = Ember.Namespace, namespace;
// TODO: Namespace should really be in Metal
if (Namespace) {
if (!this[NAME_KEY] && !classToString.processed) {
if (!Namespace.PROCESSED) {
findNamespaces();
Namespace.PROCESSED = true;
}
classToString.processed = true;
var namespaces = Namespace.NAMESPACES;
for (var i=0, l=namespaces.length; i<l; i++) {
namespace = namespaces[i];
processNames([namespace.toString()], namespace, {});
}
}
}
if (this[NAME_KEY]) {
return this[NAME_KEY];
} else {
var str = superClassString(this);
if (str) {
return "(subclass of " + str + ")";
} else {
return "(unknown mixin)";
}
}
};
MixinPrototype.toString = classToString;
// returns the mixins currently applied to the specified object
// TODO: Make Ember.mixin
Mixin.mixins = function(obj) {
var ret = [], mixins = Ember.meta(obj, false).mixins, key, mixin;
if (mixins) {
for(key in mixins) {
if (META_SKIP[key]) { continue; }
mixin = mixins[key];
// skip primitive mixins since these are always anonymous
if (!mixin.properties) { ret.push(mixins[key]); }
}
}
return ret;
};
REQUIRED = new Ember.Descriptor();
REQUIRED.toString = function() { return '(Required Property)'; };
Ember.required = function() {
return REQUIRED;
};
/** @private */
Alias = function(methodName) {
this.methodName = methodName;
};
Alias.prototype = new Ember.Descriptor();
Ember.alias = function(methodName) {
return new Alias(methodName);
};
// ..........................................................
// OBSERVER HELPER
//
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.
Ember.immediateObserver = function() {
for (var i=0, l=arguments.length; i<l; i++) {
var arg = arguments[i];
Ember.assert("Immediate observers must observe internal properties only, not properties on other objects.", typeof arg !== "string" || arg.indexOf('.') === -1);
}
return Ember.observer.apply(this, arguments);
};
Ember.beforeObserver = function(func) {
var paths = a_slice.call(arguments, 1);
func.__ember_observesBefore__ = paths;
return func;
};
})();
(function() {
// ==========================================================================
// Project: Ember Metal
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
})();
(function() {
/**
* @license
* ==========================================================================
* Ember
* Copyright ©2006-2011, Strobe Inc. and contributors.
* Portions copyright ©2008-2011 Apple Inc. All rights reserved.
*
* Permission is hereby granted, free of charge, to any person obtaining a
* copy of this software and associated documentation files (the "Software"),
* to deal in the Software without restriction, including without limitation
* the rights to use, copy, modify, merge, publish, distribute, sublicense,
* and/or sell copies of the Software, and to permit persons to whom the
* Software is furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
* DEALINGS IN THE SOFTWARE.
*
* For more information about Ember, visit http://www.emberjs.com
*
* ==========================================================================
*/
})();
(function() {
// ==========================================================================
// Project: Ember Runtime
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
/*globals ENV */
var indexOf = Ember.EnumerableUtils.indexOf;
// ........................................
// TYPING & ARRAY MESSAGING
//
var TYPE_MAP = {};
var t = "Boolean Number String Function Array Date RegExp Object".split(" ");
Ember.ArrayPolyfills.forEach.call(t, function(name) {
TYPE_MAP[ "[object " + name + "]" ] = name.toLowerCase();
});
var toString = Object.prototype.toString;
/**
Returns a consistent type for the passed item.
Use this instead of the built-in Ember.typeOf() to get the type of an item.
It will return the same result across all browsers and includes a bit
more detail. Here is what will be returned:
| Return Value | Meaning |
|---------------|------------------------------------------------------|
| 'string' | String primitive |
| 'number' | Number primitive |
| 'boolean' | Boolean primitive |
| 'null' | Null value |
| 'undefined' | Undefined value |
| 'function' | A function |
| 'array' | An instance of Array |
| 'class' | A Ember class (created using Ember.Object.extend()) |
| 'instance' | A Ember object instance |
| 'error' | An instance of the Error object |
| 'object' | A JavaScript object not inheriting from Ember.Object |
Examples:
Ember.typeOf(); => 'undefined'
Ember.typeOf(null); => 'null'
Ember.typeOf(undefined); => 'undefined'
Ember.typeOf('michael'); => 'string'
Ember.typeOf(101); => 'number'
Ember.typeOf(true); => 'boolean'
Ember.typeOf(Ember.makeArray); => 'function'
Ember.typeOf([1,2,90]); => 'array'
Ember.typeOf(Ember.Object.extend()); => 'class'
Ember.typeOf(Ember.Object.create()); => 'instance'
Ember.typeOf(new Error('teamocil')); => 'error'
// "normal" JavaScript object
Ember.typeOf({a: 'b'}); => 'object'
@param item {Object} the item to check
@returns {String} the type
*/
Ember.typeOf = function(item) {
var ret;
ret = (item === null || item === undefined) ? String(item) : TYPE_MAP[toString.call(item)] || 'object';
if (ret === 'function') {
if (Ember.Object && Ember.Object.detect(item)) ret = 'class';
} else if (ret === 'object') {
if (item instanceof Error) ret = 'error';
else if (Ember.Object && item instanceof Ember.Object) ret = 'instance';
else ret = 'object';
}
return ret;
};
/**
Returns true if the passed value is null or undefined. This avoids errors
from JSLint complaining about use of ==, which can be technically
confusing.
Ember.none(); => true
Ember.none(null); => true
Ember.none(undefined); => true
Ember.none(''); => false
Ember.none([]); => false
Ember.none(function(){}); => false
@param {Object} obj Value to test
@returns {Boolean}
*/
Ember.none = function(obj) {
return obj === null || obj === undefined;
};
/**
Verifies that a value is null or an empty string | array | function.
Constrains the rules on `Ember.none` by returning false for empty
string and empty arrays.
Ember.empty(); => true
Ember.empty(null); => true
Ember.empty(undefined); => true
Ember.empty(''); => true
Ember.empty([]); => true
Ember.empty('tobias fünke'); => false
Ember.empty([0,1,2]); => false
@param {Object} obj Value to test
@returns {Boolean}
*/
Ember.empty = function(obj) {
return obj === null || obj === undefined || (obj.length === 0 && typeof obj !== 'function');
};
/**
This will compare two javascript values of possibly different types.
It will tell you which one is greater than the other by returning:
- -1 if the first is smaller than the second,
- 0 if both are equal,
- 1 if the first is greater than the second.
The order is calculated based on Ember.ORDER_DEFINITION, if types are different.
In case they have the same type an appropriate comparison for this type is made.
Ember.compare('hello', 'hello'); => 0
Ember.compare('abc', 'dfg'); => -1
Ember.compare(2, 1); => 1
@param {Object} v First value to compare
@param {Object} w Second value to compare
@returns {Number} -1 if v < w, 0 if v = w and 1 if v > w.
*/
Ember.compare = function compare(v, w) {
if (v === w) { return 0; }
var type1 = Ember.typeOf(v);
var type2 = Ember.typeOf(w);
var Comparable = Ember.Comparable;
if (Comparable) {
if (type1==='instance' && Comparable.detect(v.constructor)) {
return v.constructor.compare(v, w);
}
if (type2 === 'instance' && Comparable.detect(w.constructor)) {
return 1-w.constructor.compare(w, v);
}
}
// If we haven't yet generated a reverse-mapping of Ember.ORDER_DEFINITION,
// do so now.
var mapping = Ember.ORDER_DEFINITION_MAPPING;
if (!mapping) {
var order = Ember.ORDER_DEFINITION;
mapping = Ember.ORDER_DEFINITION_MAPPING = {};
var idx, len;
for (idx = 0, len = order.length; idx < len; ++idx) {
mapping[order[idx]] = idx;
}
// We no longer need Ember.ORDER_DEFINITION.
delete Ember.ORDER_DEFINITION;
}
var type1Index = mapping[type1];
var type2Index = mapping[type2];
if (type1Index < type2Index) { return -1; }
if (type1Index > type2Index) { return 1; }
// types are equal - so we have to check values now
switch (type1) {
case 'boolean':
case 'number':
if (v < w) { return -1; }
if (v > w) { return 1; }
return 0;
case 'string':
var comp = v.localeCompare(w);
if (comp < 0) { return -1; }
if (comp > 0) { return 1; }
return 0;
case 'array':
var vLen = v.length;
var wLen = w.length;
var l = Math.min(vLen, wLen);
var r = 0;
var i = 0;
while (r === 0 && i < l) {
r = compare(v[i],w[i]);
i++;
}
if (r !== 0) { return r; }
// all elements are equal now
// shorter array should be ordered first
if (vLen < wLen) { return -1; }
if (vLen > wLen) { return 1; }
// arrays are equal now
return 0;
case 'instance':
if (Ember.Comparable && Ember.Comparable.detect(v)) {
return v.compare(v, w);
}
return 0;
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;
}
};
/** @private */
function _copy(obj, deep, seen, copies) {
var ret, loc, key;
// primitive data types are immutable, just return them.
if ('object' !== typeof obj || obj===null) return obj;
// avoid cyclical loops
if (deep && (loc=indexOf(seen, obj))>=0) return copies[loc];
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;
ret[key] = deep ? _copy(obj[key], deep, seen, copies) : obj[key];
}
}
if (deep) {
seen.push(obj);
copies.push(ret);
}
return ret;
}
/**
Creates a clone of the passed object. This function can take just about
any type of object and create a clone of it, including primitive values
(which are not actually cloned because they are immutable).
If the passed object implements the clone() method, then this function
will simply call that method and return the result.
@param {Object} object The object to clone
@param {Boolean} deep If true, a deep copy of the object is made
@returns {Object} The cloned object
*/
Ember.copy = function(obj, deep) {
// fast paths
if ('object' !== typeof obj || obj===null) return obj; // can't copy primitives
if (Ember.Copyable && Ember.Copyable.detect(obj)) return obj.copy(deep);
return _copy(obj, deep, deep ? [] : null, deep ? [] : null);
};
/**
Convenience method to inspect an object. This method will attempt to
convert the object into a useful string description.
@param {Object} obj The object you want to inspect.
@returns {String} A description of the object
*/
Ember.inspect = function(obj) {
var v, ret = [];
for(var key in obj) {
if (obj.hasOwnProperty(key)) {
v = obj[key];
if (v === 'toString') { continue; } // ignore useless items
if (Ember.typeOf(v) === 'function') { v = "function() { ... }"; }
ret.push(key + ": " + v);
}
}
return "{" + ret.join(" , ") + "}";
};
/**
Compares two objects, returning true if they are logically equal. This is
a deeper comparison than a simple triple equal. For sets it will compare the
internal objects. For any other object that implements `isEqual()` it will
respect that method.
Ember.isEqual('hello', 'hello'); => true
Ember.isEqual(1, 2); => false
Ember.isEqual([4,2], [4,2]); => false
@param {Object} a first object to compare
@param {Object} b second object to compare
@returns {Boolean}
*/
Ember.isEqual = function(a, b) {
if (a && 'function'===typeof a.isEqual) return a.isEqual(b);
return a === b;
};
/**
@private
Used by Ember.compare
*/
Ember.ORDER_DEFINITION = Ember.ENV.ORDER_DEFINITION || [
'undefined',
'null',
'boolean',
'number',
'string',
'array',
'object',
'instance',
'function',
'class',
'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.
@function
@param {Object} obj
@returns {Array} Array containing keys of obj
*/
Ember.keys = Object.keys;
if (!Ember.keys) {
Ember.keys = function(obj) {
var ret = [];
for(var key in obj) {
if (obj.hasOwnProperty(key)) { ret.push(key); }
}
return ret;
};
}
// ..........................................................
// ERROR
//
/**
@class
A subclass of the JavaScript Error object for use in Ember.
*/
Ember.Error = function() {
var tmp = Error.prototype.constructor.apply(this, arguments);
for (var p in tmp) {
if (tmp.hasOwnProperty(p)) { this[p] = tmp[p]; }
}
this.message = tmp.message;
};
Ember.Error.prototype = Ember.create(Error.prototype);
})();
(function() {
// ==========================================================================
// Project: Ember Runtime
// Copyright: ©2011 Strobe Inc.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
/** @private **/
var STRING_DASHERIZE_REGEXP = (/[ _]/g);
var STRING_DASHERIZE_CACHE = {};
var STRING_DECAMELIZE_REGEXP = (/([a-z])([A-Z])/g);
var STRING_CAMELIZE_REGEXP = (/(\-|_|\s)+(.)?/g);
var STRING_UNDERSCORE_REGEXP_1 = (/([a-z\d])([A-Z]+)/g);
var STRING_UNDERSCORE_REGEXP_2 = (/\-|\s+/g);
/**
Defines the hash of localized strings for the current language. Used by
the `Ember.String.loc()` helper. To localize, add string values to this
hash.
@type Hash
*/
Ember.STRINGS = {};
/**
Defines string helper methods including string formatting and localization.
Unless Ember.EXTEND_PROTOTYPES = false these methods will also be added to the
String.prototype as well.
@namespace
*/
Ember.String = {
/**
Apply formatting options to the string. This will look for occurrences
of %@ in your string and substitute them with the arguments you pass into
this method. If you want to control the specific order of replacement,
you can add a number after the key as well to indicate which argument
you want to insert.
Ordered insertions are most useful when building loc strings where values
you need to insert may appear in different orders.
"Hello %@ %@".fmt('John', 'Doe') => "Hello John Doe"
"Hello %@2, %@1".fmt('John', 'Doe') => "Hello Doe, John"
@param {Object...} [args]
@returns {String} formatted string
*/
fmt: function(str, formats) {
// first, replace any ORDERED replacements.
var idx = 0; // the current index for non-numerical replacements
return str.replace(/%@([0-9]+)?/g, function(s, argIndex) {
argIndex = (argIndex) ? parseInt(argIndex,0) - 1 : idx++ ;
s = formats[argIndex];
return ((s === null) ? '(null)' : (s === undefined) ? '' : s).toString();
}) ;
},
/**
Formats the passed string, but first looks up the string in the localized
strings hash. This is a convenient way to localize text. See
`Ember.String.fmt()` for more information on formatting.
Note that it is traditional but not required to prefix localized string
keys with an underscore or other character so you can easily identify
localized strings.
Ember.STRINGS = {
'_Hello World': 'Bonjour le monde',
'_Hello %@ %@': 'Bonjour %@ %@'
};
Ember.String.loc("_Hello World");
=> 'Bonjour le monde';
Ember.String.loc("_Hello %@ %@", ["John", "Smith"]);
=> "Bonjour John Smith";
@param {String} str
The string to format
@param {Array} formats
Optional array of parameters to interpolate into string.
@returns {String} formatted string
*/
loc: function(str, formats) {
str = Ember.STRINGS[str] || str;
return Ember.String.fmt(str, formats) ;
},
/**
Splits a string into separate units separated by spaces, eliminating any
empty strings in the process. This is a convenience method for split that
is mostly useful when applied to the String.prototype.
Ember.String.w("alpha beta gamma").forEach(function(key) {
console.log(key);
});
> alpha
> beta
> gamma
@param {String} str
The string to split
@returns {String} split string
*/
w: function(str) { return str.split(/\s+/); },
/**
Converts a camelized string into all lower case separated by underscores.
'innerHTML'.decamelize() => 'inner_html'
'action_name'.decamelize() => 'action_name'
'css-class-name'.decamelize() => 'css-class-name'
'my favorite items'.decamelize() => 'my favorite items'
@param {String} str
The string to decamelize.
@returns {String} the decamelized string.
*/
decamelize: function(str) {
return str.replace(STRING_DECAMELIZE_REGEXP, '$1_$2').toLowerCase();
},
/**
Replaces underscores or spaces with dashes.
'innerHTML'.dasherize() => 'inner-html'
'action_name'.dasherize() => 'action-name'
'css-class-name'.dasherize() => 'css-class-name'
'my favorite items'.dasherize() => 'my-favorite-items'
@param {String} str
The string to dasherize.
@returns {String} the dasherized string.
*/
dasherize: function(str) {
var cache = STRING_DASHERIZE_CACHE,
ret = cache[str];
if (ret) {
return ret;
} else {
ret = Ember.String.decamelize(str).replace(STRING_DASHERIZE_REGEXP,'-');
cache[str] = ret;
}
return ret;
},
/**
Returns the lowerCaseCamel form of a string.
'innerHTML'.camelize() => 'innerHTML'
'action_name'.camelize() => 'actionName'
'css-class-name'.camelize() => 'cssClassName'
'my favorite items'.camelize() => 'myFavoriteItems'
@param {String} str
The string to camelize.
@returns {String} the camelized string.
*/
camelize: function(str) {
return str.replace(STRING_CAMELIZE_REGEXP, function(match, separator, chr) {
return chr ? chr.toUpperCase() : '';
});
},
/**
Returns the UpperCamelCase form of a string.
'innerHTML'.classify() => 'InnerHTML'
'action_name'.classify() => 'ActionName'
'css-class-name'.classify() => 'CssClassName'
'my favorite items'.classift() => 'MyFavoriteItems'
*/
classify: function(str) {
var camelized = Ember.String.camelize(str);
return camelized.charAt(0).toUpperCase() + camelized.substr(1);
},
/**
More general than decamelize. Returns the lower_case_and_underscored
form of a string.
'innerHTML'.underscore() => 'inner_html'
'action_name'.underscore() => 'action_name'
'css-class-name'.underscore() => 'css_class_name'
'my favorite items'.underscore() => 'my_favorite_items'
@param {String} str
The string to underscore.
@returns {String} the underscored string.
*/
underscore: function(str) {
return str.replace(STRING_UNDERSCORE_REGEXP_1, '$1_$2').
replace(STRING_UNDERSCORE_REGEXP_2, '_').toLowerCase();
}
};
})();
(function() {
// ==========================================================================
// Project: Ember Runtime
// Copyright: ©2006-2011 Strobe Inc. and contributors.
// Portions ©2008-2011 Apple Inc. All rights reserved.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
var fmt = Ember.String.fmt,
w = Ember.String.w,
loc = Ember.String.loc,
camelize = Ember.String.camelize,
decamelize = Ember.String.decamelize,
dasherize = Ember.String.dasherize,
underscore = Ember.String.underscore;
if (Ember.EXTEND_PROTOTYPES) {
/**
@see Ember.String.fmt
*/
String.prototype.fmt = function() {
return fmt(this, arguments);
};
/**
@see Ember.String.w
*/
String.prototype.w = function() {
return w(this);
};
/**
@see Ember.String.loc
*/
String.prototype.loc = function() {
return loc(this, arguments);
};
/**
@see Ember.String.camelize
*/
String.prototype.camelize = function() {
return camelize(this);
};
/**
@see Ember.String.decamelize
*/
String.prototype.decamelize = function() {
return decamelize(this);
};
/**
@see Ember.String.dasherize
*/
String.prototype.dasherize = function() {
return dasherize(this);
};
/**
@see Ember.String.underscore
*/
String.prototype.underscore = function() {
return underscore(this);
};
}
})();
(function() {
// ==========================================================================
// Project: Ember Runtime
// Copyright: ©2006-2011 Strobe Inc. and contributors.
// Portions ©2008-2011 Apple Inc. All rights reserved.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
var a_slice = Array.prototype.slice;
if (Ember.EXTEND_PROTOTYPES) {
/**
The `property` extension of Javascript's Function prototype is available
when Ember.EXTEND_PROTOTYPES is true, which is the default.
Computed properties allow you to treat a function like a property:
MyApp.president = Ember.Object.create({
firstName: "Barack",
lastName: "Obama",
fullName: function() {
return this.get('firstName') + ' ' + this.get('lastName');
// Call this flag to mark the function as a property
}.property()
});
MyApp.president.get('fullName'); => "Barack Obama"
Treating a function like a property is useful because they can work with
bindings, just like any other property.
Many computed properties have dependencies on other properties. For
example, in the above example, the `fullName` property depends on
`firstName` and `lastName` to determine its value. You can tell Ember.js
about these dependencies like this:
MyApp.president = Ember.Object.create({
firstName: "Barack",
lastName: "Obama",
fullName: function() {
return this.get('firstName') + ' ' + this.get('lastName');
// Tell Ember.js that this computed property depends on firstName
// and lastName
}.property('firstName', 'lastName')
});
Make sure you list these dependencies so Ember.js knows when to update
bindings that connect to a computed property. Changing a dependency
will not immediately trigger an update of the computed property, but
will instead clear the cache so that it is updated when the next `get`
is called on the property.
Note: you will usually want to use `property(...)` with `cacheable()`.
@see Ember.ComputedProperty
@see Ember.computed
*/
Function.prototype.property = function() {
var ret = Ember.computed(this);
return ret.property.apply(ret, arguments);
};
/**
The `observes` extension of Javascript's Function prototype is available
when Ember.EXTEND_PROTOTYPES is true, which is the default.
You can observe property changes simply by adding the `observes`
call to the end of your method declarations in classes that you write.
For example:
Ember.Object.create({
valueObserver: function() {
// Executes whenever the "value" property changes
}.observes('value')
});
@see Ember.Observable
*/
Function.prototype.observes = function() {
this.__ember_observes__ = a_slice.call(arguments);
return this;
};
/**
The `observesBefore` extension of Javascript's Function prototype is
available when Ember.EXTEND_PROTOTYPES is true, which is the default.
You can get notified when a property changes is about to happen by
by adding the `observesBefore` call to the end of your method
declarations in classes that you write. For example:
Ember.Object.create({
valueObserver: function() {
// Executes whenever the "value" property is about to change
}.observesBefore('value')
});
@see Ember.Observable
*/
Function.prototype.observesBefore = function() {
this.__ember_observesBefore__ = a_slice.call(arguments);
return this;
};
}
})();
(function() {
// ==========================================================================
// Project: Ember Runtime
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
})();
(function() {
// ==========================================================================
// Project: Ember Runtime
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
// ..........................................................
// HELPERS
//
var get = Ember.get, set = Ember.set;
var a_slice = Array.prototype.slice;
var a_indexOf = Ember.EnumerableUtils.indexOf;
var contexts = [];
/** @private */
function popCtx() {
return contexts.length===0 ? {} : contexts.pop();
}
/** @private */
function pushCtx(ctx) {
contexts.push(ctx);
return null;
}
/** @private */
function iter(key, value) {
var valueProvided = arguments.length === 2;
function i(item) {
var cur = get(item, key);
return valueProvided ? value===cur : !!cur;
}
return i ;
}
/**
@class
This mixin defines the common interface implemented by enumerable objects
in Ember. Most of these methods follow the standard Array iteration
API defined up to JavaScript 1.8 (excluding language-specific features that
cannot be emulated in older versions of JavaScript).
This mixin is applied automatically to the Array class on page load, so you
can use any of these methods on simple arrays. If Array already implements
one of these methods, the mixin will not override them.
h3. Writing Your Own Enumerable
To make your own custom class enumerable, you need two items:
1. You must have a length property. This property should change whenever
the number of items in your enumerable object changes. If you using this
with an Ember.Object subclass, you should be sure to change the length
property using set().
2. If you must implement nextObject(). See documentation.
Once you have these two methods implement, apply the Ember.Enumerable mixin
to your class and you will be able to enumerate the contents of your object
like any other collection.
h3. Using Ember Enumeration with Other Libraries
Many other libraries provide some kind of iterator or enumeration like
facility. This is often where the most common API conflicts occur.
Ember's API is designed to be as friendly as possible with other
libraries by implementing only methods that mostly correspond to the
JavaScript 1.8 API.
@extends Ember.Mixin
@since Ember 0.9
*/
Ember.Enumerable = Ember.Mixin.create(
/** @scope Ember.Enumerable.prototype */ {
/** @private - compatibility */
isEnumerable: true,
/**
Implement this method to make your class enumerable.
This method will be call repeatedly during enumeration. The index value
will always begin with 0 and increment monotonically. You don't have to
rely on the index value to determine what object to return, but you should
always check the value and start from the beginning when you see the
requested index is 0.
The previousObject is the object that was returned from the last call
to nextObject for the current iteration. This is a useful way to
manage iteration if you are tracing a linked list, for example.
Finally the context parameter will always contain a hash you can use as
a "scratchpad" to maintain any other state you need in order to iterate
properly. The context object is reused and is not reset between
iterations so make sure you setup the context with a fresh state whenever
the index parameter is 0.
Generally iterators will continue to call nextObject until the index
reaches the your current length-1. If you run out of data before this
time for some reason, you should simply return undefined.
The default implementation of this method simply looks up the index.
This works great on any Array-like objects.
@param {Number} index the current index of the iteration
@param {Object} previousObject the value returned by the last call to nextObject.
@param {Object} context a context object you can use to maintain state.
@returns {Object} the next object in the iteration or undefined
*/
nextObject: Ember.required(Function),
/**
Helper method returns the first object from a collection. This is usually
used by bindings and other parts of the framework to extract a single
object if the enumerable contains only one item.
If you override this method, you should implement it so that it will
always return the same value each time it is called. If your enumerable
contains only one object, this method should always return that object.
If your enumerable is empty, this method should return undefined.
var arr = ["a", "b", "c"];
arr.firstObject(); => "a"
var arr = [];
arr.firstObject(); => undefined
@returns {Object} the object or undefined
*/
firstObject: Ember.computed(function() {
if (get(this, 'length')===0) return undefined ;
// handle generic enumerables
var context = popCtx(), ret;
ret = this.nextObject(0, null, context);
pushCtx(context);
return ret ;
}).property('[]').cacheable(),
/**
Helper method returns the last object from a collection. If your enumerable
contains only one object, this method should always return that object.
If your enumerable is empty, this method should return undefined.
var arr = ["a", "b", "c"];
arr.lastObject(); => "c"
var arr = [];
arr.lastObject(); => undefined
@returns {Object} the last object or undefined
*/
lastObject: Ember.computed(function() {
var len = get(this, 'length');
if (len===0) return undefined ;
var context = popCtx(), idx=0, cur, last = null;
do {
last = cur;
cur = this.nextObject(idx++, last, context);
} while (cur !== undefined);
pushCtx(context);
return last;
}).property('[]').cacheable(),
/**
Returns true if the passed object can be found in the receiver. The
default version will iterate through the enumerable until the object
is found. You may want to override this with a more efficient version.
var arr = ["a", "b", "c"];
arr.contains("a"); => true
arr.contains("z"); => false
@param {Object} obj
The object to search for.
@returns {Boolean} true if object is found in enumerable.
*/
contains: function(obj) {
return this.find(function(item) { return item===obj; }) !== undefined;
},
/**
Iterates through the enumerable, calling the passed function on each
item. This method corresponds to the forEach() method defined in
JavaScript 1.6.
The callback method you provide should have the following signature (all
parameters are optional):
function(item, index, enumerable);
- *item* is the current item in the iteration.
- *index* is the current index in the iteration
- *enumerable* is the enumerable object itself.
Note that in addition to a callback, you can also pass an optional target
object that will be set as "this" on the context. This is a good way
to give your iterator function access to the current object.
@param {Function} callback The callback to execute
@param {Object} [target] The target object to use
@returns {Object} receiver
*/
forEach: function(callback, target) {
if (typeof callback !== "function") throw new TypeError() ;
var len = get(this, 'length'), last = null, context = popCtx();
if (target === undefined) target = null;
for(var idx=0;idx<len;idx++) {
var next = this.nextObject(idx, last, context) ;
callback.call(target, next, idx, this);
last = next ;
}
last = null ;
context = pushCtx(context);
return this ;
},
/**
Alias for mapProperty
@param {String} key name of the property
@returns {Array} The mapped array.
*/
getEach: function(key) {
return this.mapProperty(key);
},
/**
Sets the value on the named property for each member. This is more
efficient than using other methods defined on this helper. If the object
implements Ember.Observable, the value will be changed to set(), otherwise
it will be set directly. null objects are skipped.
@param {String} key The key to set
@param {Object} value The object to set
@returns {Object} receiver
*/
setEach: function(key, value) {
return this.forEach(function(item) {
set(item, key, value);
});
},
/**
Maps all of the items in the enumeration to another value, returning
a new array. This method corresponds to map() defined in JavaScript 1.6.
The callback method you provide should have the following signature (all
parameters are optional):
function(item, index, enumerable);
- *item* is the current item in the iteration.
- *index* is the current index in the iteration
- *enumerable* is the enumerable object itself.
It should return the mapped value.
Note that in addition to a callback, you can also pass an optional target
object that will be set as "this" on the context. This is a good way
to give your iterator function access to the current object.
@param {Function} callback The callback to execute
@param {Object} [target] The target object to use
@returns {Array} The mapped array.
*/
map: function(callback, target) {
var ret = [];
this.forEach(function(x, idx, i) {
ret[idx] = callback.call(target, x, idx,i);
});
return ret ;
},
/**
Similar to map, this specialized function returns the value of the named
property on all items in the enumeration.
@param {String} key name of the property
@returns {Array} The mapped array.
*/
mapProperty: function(key) {
return this.map(function(next) {
return get(next, key);
});
},
/**
Returns an array with all of the items in the enumeration that the passed
function returns true for. This method corresponds to filter() defined in
JavaScript 1.6.
The callback method you provide should have the following signature (all
parameters are optional):
function(item, index, enumerable);
- *item* is the current item in the iteration.
- *index* is the current index in the iteration
- *enumerable* is the enumerable object itself.
It should return the true to include the item in the results, false otherwise.
Note that in addition to a callback, you can also pass an optional target
object that will be set as "this" on the context. This is a good way
to give your iterator function access to the current object.
@param {Function} callback The callback to execute
@param {Object} [target] The target object to use
@returns {Array} A filtered array.
*/
filter: function(callback, target) {
var ret = [];
this.forEach(function(x, idx, i) {
if (callback.call(target, x, idx, i)) ret.push(x);
});
return ret ;
},
/**
Returns an array with just the items with the matched property. You
can pass an optional second argument with the target value. Otherwise
this will match any property that evaluates to true.
@param {String} key the property to test
@param {String} [value] optional value to test against.
@returns {Array} filtered array
*/
filterProperty: function(key, value) {
return this.filter(iter.apply(this, arguments));
},
/**
Returns the first item in the array for which the callback returns true.
This method works similar to the filter() method defined in JavaScript 1.6
except that it will stop working on the array once a match is found.
The callback method you provide should have the following signature (all
parameters are optional):
function(item, index, enumerable);
- *item* is the current item in the iteration.
- *index* is the current index in the iteration
- *enumerable* is the enumerable object itself.
It should return the true to include the item in the results, false otherwise.
Note that in addition to a callback, you can also pass an optional target
object that will be set as "this" on the context. This is a good way
to give your iterator function access to the current object.
@param {Function} callback The callback to execute
@param {Object} [target] The target object to use
@returns {Object} Found item or null.
*/
find: function(callback, target) {
var len = get(this, 'length') ;
if (target === undefined) target = null;
var last = null, next, found = false, ret ;
var context = popCtx();
for(var idx=0;idx<len && !found;idx++) {
next = this.nextObject(idx, last, context) ;
if (found = callback.call(target, next, idx, this)) ret = next ;
last = next ;
}
next = last = null ;
context = pushCtx(context);
return ret ;
},
/**
Returns the first item with a property matching the passed value. You
can pass an optional second argument with the target value. Otherwise
this will match any property that evaluates to true.
This method works much like the more generic find() method.
@param {String} key the property to test
@param {String} [value] optional value to test against.
@returns {Object} found item or null
*/
findProperty: function(key, value) {
return this.find(iter.apply(this, arguments));
},
/**
Returns true if the passed function returns true for every item in the
enumeration. This corresponds with the every() method in JavaScript 1.6.
The callback method you provide should have the following signature (all
parameters are optional):
function(item, index, enumerable);
- *item* is the current item in the iteration.
- *index* is the current index in the iteration
- *enumerable* is the enumerable object itself.
It should return the true or false.
Note that in addition to a callback, you can also pass an optional target
object that will be set as "this" on the context. This is a good way
to give your iterator function access to the current object.
Example Usage:
if (people.every(isEngineer)) { Paychecks.addBigBonus(); }
@param {Function} callback The callback to execute
@param {Object} [target] The target object to use
@returns {Boolean}
*/
every: function(callback, target) {
return !this.find(function(x, idx, i) {
return !callback.call(target, x, idx, i);
});
},
/**
Returns true if the passed property resolves to true for all items in the
enumerable. This method is often simpler/faster than using a callback.
@param {String} key the property to test
@param {String} [value] optional value to test against.
@returns {Array} filtered array
*/
everyProperty: function(key, value) {
return this.every(iter.apply(this, arguments));
},
/**
Returns true if the passed function returns true for any item in the
enumeration. This corresponds with the every() method in JavaScript 1.6.
The callback method you provide should have the following signature (all
parameters are optional):
function(item, index, enumerable);
- *item* is the current item in the iteration.
- *index* is the current index in the iteration
- *enumerable* is the enumerable object itself.
It should return the true to include the item in the results, false otherwise.
Note that in addition to a callback, you can also pass an optional target
object that will be set as "this" on the context. This is a good way
to give your iterator function access to the current object.
Usage Example:
if (people.some(isManager)) { Paychecks.addBiggerBonus(); }
@param {Function} callback The callback to execute
@param {Object} [target] The target object to use
@returns {Array} A filtered array.
*/
some: function(callback, target) {
return !!this.find(function(x, idx, i) {
return !!callback.call(target, x, idx, i);
});
},
/**
Returns true if the passed property resolves to true for any item in the
enumerable. This method is often simpler/faster than using a callback.
@param {String} key the property to test
@param {String} [value] optional value to test against.
@returns {Boolean} true
*/
someProperty: function(key, value) {
return this.some(iter.apply(this, arguments));
},
/**
This will combine the values of the enumerator into a single value. It
is a useful way to collect a summary value from an enumeration. This
corresponds to the reduce() method defined in JavaScript 1.8.
The callback method you provide should have the following signature (all
parameters are optional):
function(previousValue, item, index, enumerable);
- *previousValue* is the value returned by the last call to the iterator.
- *item* is the current item in the iteration.
- *index* is the current index in the iteration
- *enumerable* is the enumerable object itself.
Return the new cumulative value.
In addition to the callback you can also pass an initialValue. An error
will be raised if you do not pass an initial value and the enumerator is
empty.
Note that unlike the other methods, this method does not allow you to
pass a target object to set as this for the callback. It's part of the
spec. Sorry.
@param {Function} callback The callback to execute
@param {Object} initialValue Initial value for the reduce
@param {String} reducerProperty internal use only.
@returns {Object} The reduced value.
*/
reduce: function(callback, initialValue, reducerProperty) {
if (typeof callback !== "function") { throw new TypeError(); }
var ret = initialValue;
this.forEach(function(item, i) {
ret = callback.call(null, ret, item, i, this, reducerProperty);
}, this);
return ret;
},
/**
Invokes the named method on every object in the receiver that
implements it. This method corresponds to the implementation in
Prototype 1.6.
@param {String} methodName the name of the method
@param {Object...} args optional arguments to pass as well.
@returns {Array} return values from calling invoke.
*/
invoke: function(methodName) {
var args, ret = [];
if (arguments.length>1) args = a_slice.call(arguments, 1);
this.forEach(function(x, idx) {
var method = x && x[methodName];
if ('function' === typeof method) {
ret[idx] = args ? method.apply(x, args) : method.call(x);
}
}, this);
return ret;
},
/**
Simply converts the enumerable into a genuine array. The order is not
guaranteed. Corresponds to the method implemented by Prototype.
@returns {Array} the enumerable as an array.
*/
toArray: function() {
var ret = [];
this.forEach(function(o, idx) { ret[idx] = o; });
return ret ;
},
/**
Returns a copy of the array with all null elements removed.
var arr = ["a", null, "c", null];
arr.compact(); => ["a", "c"]
@returns {Array} the array without null elements.
*/
compact: function() { return this.without(null); },
/**
Returns a new enumerable that excludes the passed value. The default
implementation returns an array regardless of the receiver type unless
the receiver does not contain the value.
var arr = ["a", "b", "a", "c"];
arr.without("a"); => ["b", "c"]
@param {Object} value
@returns {Ember.Enumerable}
*/
without: function(value) {
if (!this.contains(value)) return this; // nothing to do
var ret = [] ;
this.forEach(function(k) {
if (k !== value) ret[ret.length] = k;
}) ;
return ret ;
},
/**
Returns a new enumerable that contains only unique values. The default
implementation returns an array regardless of the receiver type.
var arr = ["a", "a", "b", "b"];
arr.uniq(); => ["a", "b"]
@returns {Ember.Enumerable}
*/
uniq: function() {
var ret = [];
this.forEach(function(k){
if (a_indexOf(ret, k)<0) ret.push(k);
});
return ret;
},
/**
This property will trigger anytime the enumerable's content changes.
You can observe this property to be notified of changes to the enumerables
content.
For plain enumerables, this property is read only. Ember.Array overrides
this method.
@type Ember.Array
*/
'[]': Ember.computed(function(key, value) {
return this;
}).property().cacheable(),
// ..........................................................
// ENUMERABLE OBSERVERS
//
/**
Registers an enumerable observer. Must implement Ember.EnumerableObserver
mixin.
*/
addEnumerableObserver: function(target, opts) {
var willChange = (opts && opts.willChange) || 'enumerableWillChange',
didChange = (opts && opts.didChange) || 'enumerableDidChange';
var hasObservers = get(this, 'hasEnumerableObservers');
if (!hasObservers) Ember.propertyWillChange(this, 'hasEnumerableObservers');
Ember.addListener(this, '@enumerable:before', target, willChange);
Ember.addListener(this, '@enumerable:change', target, didChange);
if (!hasObservers) Ember.propertyDidChange(this, 'hasEnumerableObservers');
return this;
},
/**
Removes a registered enumerable observer.
*/
removeEnumerableObserver: function(target, opts) {
var willChange = (opts && opts.willChange) || 'enumerableWillChange',
didChange = (opts && opts.didChange) || 'enumerableDidChange';
var hasObservers = get(this, 'hasEnumerableObservers');
if (hasObservers) Ember.propertyWillChange(this, 'hasEnumerableObservers');
Ember.removeListener(this, '@enumerable:before', target, willChange);
Ember.removeListener(this, '@enumerable:change', target, didChange);
if (hasObservers) Ember.propertyDidChange(this, 'hasEnumerableObservers');
return this;
},
/**
Becomes true whenever the array currently has observers watching changes
on the array.
@type Boolean
*/
hasEnumerableObservers: Ember.computed(function() {
return Ember.hasListeners(this, '@enumerable:change') || Ember.hasListeners(this, '@enumerable:before');
}).property().cacheable(),
/**
Invoke this method just before the contents of your enumerable will
change. You can either omit the parameters completely or pass the objects
to be removed or added if available or just a count.
@param {Ember.Enumerable|Number} removing
An enumerable of the objects to be removed or the number of items to
be removed.
@param {Ember.Enumerable|Number} adding
An enumerable of the objects to be added or the number of items to be
added.
@returns {Ember.Enumerable} receiver
*/
enumerableContentWillChange: function(removing, adding) {
var removeCnt, addCnt, hasDelta;
if ('number' === typeof removing) removeCnt = removing;
else if (removing) removeCnt = get(removing, 'length');
else removeCnt = removing = -1;
if ('number' === typeof adding) addCnt = adding;
else if (adding) addCnt = get(adding,'length');
else addCnt = adding = -1;
hasDelta = addCnt<0 || removeCnt<0 || addCnt-removeCnt!==0;
if (removing === -1) removing = null;
if (adding === -1) adding = null;
Ember.propertyWillChange(this, '[]');
if (hasDelta) Ember.propertyWillChange(this, 'length');
Ember.sendEvent(this, '@enumerable:before', [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.
@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.
@returns {Object} receiver
*/
enumerableContentDidChange: function(removing, adding) {
var notify = this.propertyDidChange, removeCnt, addCnt, hasDelta;
if ('number' === typeof removing) removeCnt = removing;
else if (removing) removeCnt = get(removing, 'length');
else removeCnt = removing = -1;
if ('number' === typeof adding) addCnt = adding;
else if (adding) addCnt = get(adding, 'length');
else addCnt = adding = -1;
hasDelta = addCnt<0 || removeCnt<0 || addCnt-removeCnt!==0;
if (removing === -1) removing = null;
if (adding === -1) adding = null;
Ember.sendEvent(this, '@enumerable:change', [this, removing, adding]);
if (hasDelta) Ember.propertyDidChange(this, 'length');
Ember.propertyDidChange(this, '[]');
return this ;
}
}) ;
})();
(function() {
// ==========================================================================
// Project: Ember Runtime
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
// ..........................................................
// HELPERS
//
var get = Ember.get, set = Ember.set, meta = Ember.meta, map = Ember.EnumerableUtils.map, cacheFor = Ember.cacheFor;
/** @private */
function none(obj) { return obj===null || obj===undefined; }
// ..........................................................
// ARRAY
//
/**
@namespace
This module implements Observer-friendly Array-like behavior. This mixin is
picked up by the Array class as well as other controllers, etc. that want to
appear to be arrays.
Unlike Ember.Enumerable, this mixin defines methods specifically for
collections that provide index-ordered access to their contents. When you
are designing code that needs to accept any kind of Array-like object, you
should use these methods instead of Array primitives because these will
properly notify observers of changes to the array.
Although these methods are efficient, they do add a layer of indirection to
your application so it is a good idea to use them only when you need the
flexibility of using both true JavaScript arrays and "virtual" arrays such
as controllers and collections.
You can use the methods defined in this module to access and modify array
contents in a KVO-friendly way. You can also be notified whenever the
membership if an array changes by changing the syntax of the property to
.observes('*myProperty.[]') .
To support Ember.Array in your own class, you must override two
primitives to use it: replace() and objectAt().
Note that the Ember.Array mixin also incorporates the Ember.Enumerable mixin. All
Ember.Array-like objects are also enumerable.
@extends Ember.Enumerable
@since Ember 0.9.0
*/
Ember.Array = Ember.Mixin.create(Ember.Enumerable, /** @scope Ember.Array.prototype */ {
/** @private - compatibility */
isSCArray: true,
/**
@field {Number} length
Your array must support the length property. Your replace methods should
set this property whenever it changes.
*/
length: Ember.required(),
/**
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.
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
@param {Number} idx
The index of the item to return.
*/
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`.
var arr = ['a', 'b', 'c', 'd'];
arr.objectsAt([0, 1, 2]) => ["a", "b", "c"]
arr.objectsAt([2, 3, 4]) => ["c", "d", undefined]
@param {Array} indexes
An array of indexes of items to return.
*/
objectsAt: function(indexes) {
var self = this;
return map(indexes, function(idx){ return self.objectAt(idx); });
},
/** @private (nodoc) - overrides Ember.Enumerable version */
nextObject: function(idx) {
return this.objectAt(idx);
},
/**
@field []
This is the handler for the special array content property. If you get
this property, it will return this. If you set this property it a new
array, it will replace the current content.
This property overrides the default property defined in Ember.Enumerable.
*/
'[]': Ember.computed(function(key, value) {
if (value !== undefined) this.replace(0, get(this, 'length'), value) ;
return this ;
}).property().cacheable(),
firstObject: Ember.computed(function() {
return this.objectAt(0);
}).property().cacheable(),
lastObject: Ember.computed(function() {
return this.objectAt(get(this, 'length')-1);
}).property().cacheable(),
/** @private (nodoc) - optimized version from Enumerable */
contains: function(obj){
return this.indexOf(obj) >= 0;
},
// Add any extra methods to Ember.Array that are native to the built-in Array.
/**
Returns a new array that is a slice of the receiver. This implementation
uses the observable array methods to retrieve the objects for the new
slice.
var arr = ['red', 'green', 'blue'];
arr.slice(0); => ['red', 'green', 'blue']
arr.slice(0, 2); => ['red', 'green']
arr.slice(1, 100); => ['green', 'blue']
@param beginIndex {Integer} (Optional) index to begin slicing from.
@param endIndex {Integer} (Optional) index to end the slice at.
@returns {Array} New array with specified slice
*/
slice: function(beginIndex, endIndex) {
var ret = [];
var length = get(this, 'length') ;
if (none(beginIndex)) beginIndex = 0 ;
if (none(endIndex) || (endIndex > length)) endIndex = length ;
while(beginIndex < endIndex) {
ret[ret.length] = this.objectAt(beginIndex++) ;
}
return ret ;
},
/**
Returns the index of the given object's first occurrence.
If no startAt argument is given, the starting location to
search is 0. If it's negative, will count backward from
the end of the array. Returns -1 if no match is found.
var arr = ["a", "b", "c", "d", "a"];
arr.indexOf("a"); => 0
arr.indexOf("z"); => -1
arr.indexOf("a", 2); => 4
arr.indexOf("a", -1); => 4
arr.indexOf("b", 3); => -1
arr.indexOf("a", 100); => -1
@param {Object} object the item to search for
@param {Number} startAt optional starting location to search, default 0
@returns {Number} index or -1 if not found
*/
indexOf: function(object, startAt) {
var idx, len = get(this, 'length');
if (startAt === undefined) startAt = 0;
if (startAt < 0) startAt += len;
for(idx=startAt;idx<len;idx++) {
if (this.objectAt(idx, true) === object) return idx ;
}
return -1;
},
/**
Returns the index of the given object's last occurrence.
If no startAt argument is given, the search starts from
the last position. If it's negative, will count backward
from the end of the array. Returns -1 if no match is found.
var arr = ["a", "b", "c", "d", "a"];
arr.lastIndexOf("a"); => 4
arr.lastIndexOf("z"); => -1
arr.lastIndexOf("a", 2); => 0
arr.lastIndexOf("a", -1); => 4
arr.lastIndexOf("b", 3); => 1
arr.lastIndexOf("a", 100); => 4
@param {Object} object the item to search for
@param {Number} startAt optional starting location to search, default 0
@returns {Number} index or -1 if not found
*/
lastIndexOf: function(object, startAt) {
var idx, len = get(this, 'length');
if (startAt === undefined || startAt >= len) startAt = len-1;
if (startAt < 0) startAt += len;
for(idx=startAt;idx>=0;idx--) {
if (this.objectAt(idx) === object) return idx ;
}
return -1;
},
// ..........................................................
// ARRAY OBSERVERS
//
/**
Adds an array observer to the receiving array. The array observer object
normally must implement two methods:
* `arrayWillChange(start, removeCount, addCount)` - This method will be
called just before the array is modified.
* `arrayDidChange(start, removeCount, addCount)` - This method will be
called just after the array is modified.
Both callbacks will be passed the starting index of the change as well a
a count of the items to be removed and added. You can use these callbacks
to optionally inspect the array during the change, clear caches, or do
any other bookkeeping necessary.
In addition to passing a target, you can also include an options hash
which you can use to override the method names that will be invoked on the
target.
@param {Object} target
The observer object.
@param {Hash} opts
Optional hash of configuration options including willChange, didChange,
and a context option.
@returns {Ember.Array} receiver
*/
addArrayObserver: function(target, opts) {
var willChange = (opts && opts.willChange) || 'arrayWillChange',
didChange = (opts && opts.didChange) || 'arrayDidChange';
var hasObservers = get(this, 'hasArrayObservers');
if (!hasObservers) Ember.propertyWillChange(this, 'hasArrayObservers');
Ember.addListener(this, '@array:before', target, willChange);
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.
@param {Object} target
The object observing the array.
@returns {Ember.Array} receiver
*/
removeArrayObserver: function(target, opts) {
var willChange = (opts && opts.willChange) || 'arrayWillChange',
didChange = (opts && opts.didChange) || 'arrayDidChange';
var hasObservers = get(this, 'hasArrayObservers');
if (hasObservers) Ember.propertyWillChange(this, 'hasArrayObservers');
Ember.removeListener(this, '@array:before', target, willChange);
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.
@type Boolean
*/
hasArrayObservers: Ember.computed(function() {
return Ember.hasListeners(this, '@array:change') || Ember.hasListeners(this, '@array:before');
}).property().cacheable(),
/**
If you are implementing an object that supports Ember.Array, call this
method just before the array content changes to notify any observers and
invalidate any related properties. Pass the starting index of the change
as well as a delta of the amounts to change.
@param {Number} startIdx
The starting index in the array that will change.
@param {Number} removeAmt
The number of items that will be removed. If you pass null assumes 0
@param {Number} addAmt
The number of items that will be added. If you pass null assumes 0.
@returns {Ember.Array} receiver
*/
arrayContentWillChange: function(startIdx, removeAmt, addAmt) {
// if no args are passed assume everything changes
if (startIdx===undefined) {
startIdx = 0;
removeAmt = addAmt = -1;
} else {
if (removeAmt === undefined) removeAmt=-1;
if (addAmt === undefined) addAmt=-1;
}
// 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<lim;idx++) removing.push(this.objectAt(idx));
} else {
removing = removeAmt;
}
this.enumerableContentWillChange(removing, addAmt);
return this;
},
arrayContentDidChange: 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;
}
var adding, lim;
if (startIdx>=0 && addAmt>=0 && get(this, 'hasEnumerableObservers')) {
adding = [];
lim = startIdx+addAmt;
for(var idx=startIdx;idx<lim;idx++) adding.push(this.objectAt(idx));
} else {
adding = addAmt;
}
this.enumerableContentDidChange(removeAmt, adding);
Ember.sendEvent(this, '@array:change', [this, startIdx, removeAmt, addAmt]);
var length = get(this, 'length'),
cachedFirst = cacheFor(this, 'firstObject'),
cachedLast = cacheFor(this, 'lastObject');
if (this.objectAt(0) !== cachedFirst) {
Ember.propertyWillChange(this, 'firstObject');
Ember.propertyDidChange(this, 'firstObject');
}
if (this.objectAt(length-1) !== cachedLast) {
Ember.propertyWillChange(this, 'lastObject');
Ember.propertyDidChange(this, 'lastObject');
}
return this;
},
// ..........................................................
// ENUMERATED PROPERTIES
//
/**
Returns a special object that can be used to observe individual properties
on the array. Just get an equivalent property on this object and it will
return an enumerable that maps automatically to the named key on the
member objects.
*/
'@each': Ember.computed(function() {
if (!this.__each) this.__each = new Ember.EachProxy(this);
return this.__each;
}).property().cacheable()
}) ;
})();
(function() {
// ==========================================================================
// Project: Ember Runtime
// Copyright: ©2006-2011 Strobe Inc. and contributors.
// Portions ©2008-2011 Apple Inc. All rights reserved.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
/**
@namespace
Implements some standard methods for comparing objects. Add this mixin to
any class you create that can compare its instances.
You should implement the compare() method.
@extends Ember.Mixin
@since Ember 0.9
*/
Ember.Comparable = Ember.Mixin.create( /** @scope Ember.Comparable.prototype */{
/**
walk like a duck. Indicates that the object can be compared.
@type Boolean
@default true
@constant
*/
isComparable: true,
/**
Override to return the result of the comparison of the two parameters. The
compare method should return:
- `-1` if `a < b`
- `0` if `a == b`
- `1` if `a > b`
Default implementation raises an exception.
@param a {Object} the first object to compare
@param b {Object} the second object to compare
@returns {Integer} the result of the comparison
*/
compare: Ember.required(Function)
});
})();
(function() {
// ==========================================================================
// Project: Ember Runtime
// Copyright: ©2006-2011 Strobe Inc. and contributors.
// Portions ©2008-2010 Apple Inc. All rights reserved.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
var get = Ember.get, set = Ember.set;
/**
@namespace
Implements some standard methods for copying an object. Add this mixin to
any object you create that can create a copy of itself. This mixin is
added automatically to the built-in array.
You should generally implement the copy() method to return a copy of the
receiver.
Note that frozenCopy() will only work if you also implement Ember.Freezable.
@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.
@function
@param deep {Boolean} if true, a deep copy of the object should be made
@returns {Object} copy of receiver
*/
copy: Ember.required(Function),
/**
If the object implements Ember.Freezable, then this will return a new copy
if the object is not frozen and the receiver if the object is frozen.
Raises an exception if you try to call this method on a object that does
not support freezing.
You should use this method whenever you want a copy of a freezable object
since a freezable object can simply return itself without actually
consuming more memory.
@returns {Object} copy of receiver or receiver
*/
frozenCopy: function() {
if (Ember.Freezable && Ember.Freezable.detect(this)) {
return get(this, 'isFrozen') ? this : this.copy().freeze();
} else {
throw new Error(Ember.String.fmt("%@ does not support freezing", [this]));
}
}
});
})();
(function() {
// ==========================================================================
// Project: Ember Runtime
// Copyright: ©2006-2011 Strobe Inc. and contributors.
// Portions ©2008-2010 Apple Inc. All rights reserved.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
var get = Ember.get, set = Ember.set;
/**
@namespace
The Ember.Freezable mixin implements some basic methods for marking an object
as frozen. Once an object is frozen it should be read only. No changes
may be made the internal state of the object.
## Enforcement
To fully support freezing in your subclass, you must include this mixin and
override any method that might alter any property on the object to instead
raise an exception. You can check the state of an object by checking the
isFrozen property.
Although future versions of JavaScript may support language-level freezing
object objects, that is not the case today. Even if an object is freezable,
it is still technically possible to modify the object, even though it could
break other parts of your application that do not expect a frozen object to
change. It is, therefore, very important that you always respect the
isFrozen property on all freezable objects.
## Example Usage
The example below shows a simple object that implement the Ember.Freezable
protocol.
Contact = Ember.Object.extend(Ember.Freezable, {
firstName: null,
lastName: null,
// swaps the names
swapNames: function() {
if (this.get('isFrozen')) throw Ember.FROZEN_ERROR;
var tmp = this.get('firstName');
this.set('firstName', this.get('lastName'));
this.set('lastName', tmp);
return this;
}
});
c = Context.create({ firstName: "John", lastName: "Doe" });
c.swapNames(); => returns c
c.freeze();
c.swapNames(); => EXCEPTION
## Copying
Usually the Ember.Freezable protocol is implemented in cooperation with the
Ember.Copyable protocol, which defines a frozenCopy() method that will return
a frozen object, if the object implements this method as well.
@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.
@type Boolean
*/
isFrozen: false,
/**
Freezes the object. Once this method has been called the object should
no longer allow any properties to be edited.
@returns {Object} receiver
*/
freeze: function() {
if (get(this, 'isFrozen')) return this;
set(this, 'isFrozen', true);
return this;
}
});
Ember.FROZEN_ERROR = "Frozen object cannot be modified.";
})();
(function() {
// ==========================================================================
// Project: Ember Runtime
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
var forEach = Ember.EnumerableUtils.forEach;
/**
@class
This mixin defines the API for modifying generic enumerables. These methods
can be applied to an object regardless of whether it is ordered or
unordered.
Note that an Enumerable can change even if it does not implement this mixin.
For example, a MappedEnumerable cannot be directly modified but if its
underlying enumerable changes, it will change also.
## Adding Objects
To add an object to an enumerable, use the addObject() method. This
method will only add the object to the enumerable if the object is not
already present and the object if of a type supported by the enumerable.
set.addObject(contact);
## Removing Objects
To remove an object form an enumerable, use the removeObject() method. This
will only remove the object if it is already in the enumerable, otherwise
this method has no effect.
set.removeObject(contact);
## Implementing In Your Own Code
If you are implementing an object and want to support this API, just include
this mixin in your class and implement the required methods. In your unit
tests, be sure to apply the Ember.MutableEnumerableTests to your object.
@extends Ember.Mixin
@extends Ember.Enumerable
*/
Ember.MutableEnumerable = Ember.Mixin.create(Ember.Enumerable,
/** @scope Ember.MutableEnumerable.prototype */ {
/**
__Required.__ You must implement this method to apply this mixin.
Attempts to add the passed object to the receiver if the object is not
already present in the collection. If the object is present, this method
has no effect.
If the passed object is of a type not supported by the receiver
then this method should raise an exception.
@function
@param {Object} object
The object to add to the enumerable.
@returns {Object} the passed object
*/
addObject: Ember.required(Function),
/**
Adds each object in the passed enumerable to the receiver.
@param {Ember.Enumerable} objects the objects to add.
@returns {Object} receiver
*/
addObjects: function(objects) {
Ember.beginPropertyChanges(this);
forEach(objects, function(obj) { this.addObject(obj); }, this);
Ember.endPropertyChanges(this);
return this;
},
/**
__Required.__ You must implement this method to apply this mixin.
Attempts to remove the passed object from the receiver collection if the
object is in present in the collection. If the object is not present,
this method has no effect.
If the passed object is of a type not supported by the receiver
then this method should raise an exception.
@function
@param {Object} object
The object to remove from the enumerable.
@returns {Object} the passed object
*/
removeObject: Ember.required(Function),
/**
Removes each objects in the passed enumerable from the receiver.
@param {Ember.Enumerable} objects the objects to remove
@returns {Object} receiver
*/
removeObjects: function(objects) {
Ember.beginPropertyChanges(this);
forEach(objects, function(obj) { this.removeObject(obj); }, this);
Ember.endPropertyChanges(this);
return this;
}
});
})();
(function() {
// ==========================================================================
// Project: Ember Runtime
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
// ..........................................................
// CONSTANTS
//
var OUT_OF_RANGE_EXCEPTION = "Index out of range" ;
var EMPTY = [];
// ..........................................................
// HELPERS
//
var get = Ember.get, set = Ember.set, forEach = Ember.EnumerableUtils.forEach;
/**
@class
This mixin defines the API for modifying array-like objects. These methods
can be applied only to a collection that keeps its items in an ordered set.
Note that an Array can change even if it does not implement this mixin.
For example, one might implement a SparseArray that cannot be directly
modified, but if its underlying enumerable changes, it will change also.
@extends Ember.Mixin
@extends Ember.Array
@extends Ember.MutableEnumerable
*/
Ember.MutableArray = Ember.Mixin.create(Ember.Array, Ember.MutableEnumerable,
/** @scope Ember.MutableArray.prototype */ {
/**
__Required.__ You must implement this method to apply this mixin.
This is one of the primitives you must implement to support Ember.Array. You
should replace amt objects started at idx with the objects in the passed
array. You should also call this.enumerableContentDidChange() ;
@function
@param {Number} idx
Starting index in the array to replace. If idx >= length, then append
to the end of the array.
@param {Number} amt
Number of elements that should be removed from the array, starting at
*idx*.
@param {Array} objects
An array of zero or more objects that should be inserted into the array
at *idx*
*/
replace: Ember.required(),
/**
Remove all elements from self. This is useful if you
want to reuse an existing array without having to recreate it.
var colors = ["red", "green", "blue"];
color.length(); => 3
colors.clear(); => []
colors.length(); => 0
@returns {Ember.Array} An empty Array.
*/
clear: function () {
var len = get(this, 'length');
if (len === 0) return this;
this.replace(0, len, EMPTY);
return this;
},
/**
This will use the primitive replace() method to insert an object at the
specified index.
var colors = ["red", "green", "blue"];
colors.insertAt(2, "yellow"); => ["red", "green", "yellow", "blue"]
colors.insertAt(5, "orange"); => Error: Index out of range
@param {Number} idx index of insert the object at.
@param {Object} object object to insert
*/
insertAt: function(idx, object) {
if (idx > get(this, 'length')) throw new Error(OUT_OF_RANGE_EXCEPTION) ;
this.replace(idx, 0, [object]) ;
return this ;
},
/**
Remove an object at the specified index using the replace() primitive
method. You can pass either a single index, or a start and a length.
If you pass a start and length that is beyond the
length this method will throw an Ember.OUT_OF_RANGE_EXCEPTION
var colors = ["red", "green", "blue", "yellow", "orange"];
colors.removeAt(0); => ["green", "blue", "yellow", "orange"]
colors.removeAt(2, 2); => ["green", "blue"]
colors.removeAt(4, 2); => Error: Index out of range
@param {Number} start index, start of range
@param {Number} len length of passing range
@returns {Object} receiver
*/
removeAt: function(start, len) {
var delta = 0;
if ('number' === typeof start) {
if ((start < 0) || (start >= get(this, 'length'))) {
throw new Error(OUT_OF_RANGE_EXCEPTION);
}
// fast case
if (len === undefined) len = 1;
this.replace(start, len, EMPTY);
}
return this ;
},
/**
Push the object onto the end of the array. Works just like push() but it
is KVO-compliant.
var colors = ["red", "green", "blue"];
colors.pushObject("black"); => ["red", "green", "blue", "black"]
colors.pushObject(["yellow", "orange"]); => ["red", "green", "blue", "black", ["yellow", "orange"]]
*/
pushObject: function(obj) {
this.insertAt(get(this, 'length'), obj) ;
return obj ;
},
/**
Add the objects in the passed numerable to the end of the array. Defers
notifying observers of the change until all objects are added.
var colors = ["red", "green", "blue"];
colors.pushObjects("black"); => ["red", "green", "blue", "black"]
colors.pushObjects(["yellow", "orange"]); => ["red", "green", "blue", "black", "yellow", "orange"]
@param {Ember.Enumerable} objects the objects to add
@returns {Ember.Array} receiver
*/
pushObjects: function(objects) {
this.replace(get(this, 'length'), 0, objects);
return this;
},
/**
Pop object from array or nil if none are left. Works just like pop() but
it is KVO-compliant.
var colors = ["red", "green", "blue"];
colors.popObject(); => "blue"
console.log(colors); => ["red", "green"]
*/
popObject: function() {
var len = get(this, 'length') ;
if (len === 0) return null ;
var ret = this.objectAt(len-1) ;
this.removeAt(len-1, 1) ;
return ret ;
},
/**
Shift an object from start of array or nil if none are left. Works just
like shift() but it is KVO-compliant.
var colors = ["red", "green", "blue"];
colors.shiftObject(); => "red"
console.log(colors); => ["green", "blue"]
*/
shiftObject: function() {
if (get(this, 'length') === 0) return null ;
var ret = this.objectAt(0) ;
this.removeAt(0) ;
return ret ;
},
/**
Unshift an object to start of array. Works just like unshift() but it is
KVO-compliant.
var colors = ["red", "green", "blue"];
colors.unshiftObject("yellow"); => ["yellow", "red", "green", "blue"]
colors.unshiftObject(["black", "white"]); => [["black", "white"], "yellow", "red", "green", "blue"]
*/
unshiftObject: function(obj) {
this.insertAt(0, obj) ;
return obj ;
},
/**
Adds the named objects to the beginning of the array. Defers notifying
observers until all objects have been added.
var colors = ["red", "green", "blue"];
colors.unshiftObjects(["black", "white"]); => ["black", "white", "red", "green", "blue"]
colors.unshiftObjects("yellow"); => Type Error: 'undefined' is not a function
@param {Ember.Enumerable} objects the objects to add
@returns {Ember.Array} receiver
*/
unshiftObjects: function(objects) {
this.replace(0, 0, objects);
return this;
},
/**
Reverse objects in the array. Works just like reverse() but it is
KVO-compliant.
@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;
},
// ..........................................................
// IMPLEMENT Ember.MutableEnumerable
//
/** @private (nodoc) */
removeObject: function(obj) {
var loc = get(this, 'length') || 0;
while(--loc >= 0) {
var curObject = this.objectAt(loc) ;
if (curObject === obj) this.removeAt(loc) ;
}
return this ;
},
/** @private (nodoc) */
addObject: function(obj) {
if (!this.contains(obj)) this.pushObject(obj);
return this ;
}
});
})();
(function() {
// ==========================================================================
// Project: Ember Runtime
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
var get = Ember.get, set = Ember.set, defineProperty = Ember.defineProperty;
/**
@class
## Overview
This mixin provides properties and property observing functionality, core
features of the Ember object model.
Properties and observers allow one object to observe changes to a
property on another object. This is one of the fundamental ways that
models, controllers and views communicate with each other in an Ember
application.
Any object that has this mixin applied can be used in observer
operations. That includes Ember.Object and most objects you will
interact with as you write your Ember application.
Note that you will not generally apply this mixin to classes yourself,
but you will use the features provided by this module frequently, so it
is important to understand how to use it.
## Using get() and set()
Because of Ember's support for bindings and observers, you will always
access properties using the get method, and set properties using the
set method. This allows the observing objects to be notified and
computed properties to be handled properly.
More documentation about `get` and `set` are below.
## Observing Property Changes
You typically observe property changes simply by adding the `observes`
call to the end of your method declarations in classes that you write.
For example:
Ember.Object.create({
valueObserver: function() {
// Executes whenever the "value" property changes
}.observes('value')
});
Although this is the most common way to add an observer, this capability
is actually built into the Ember.Object class on top of two methods
defined in this mixin: `addObserver` and `removeObserver`. You can use
these two methods to add and remove observers yourself if you need to
do so at runtime.
To add an observer for a property, call:
object.addObserver('propertyKey', targetObject, targetAction)
This will call the `targetAction` method on the `targetObject` to be called
whenever the value of the `propertyKey` changes.
Note that if `propertyKey` is a computed property, the observer will be
called when any of the property dependencies are changed, even if the
resulting value of the computed property is unchanged. This is necessary
because computed properties are not computed until `get` is called.
@extends Ember.Mixin
*/
Ember.Observable = Ember.Mixin.create(/** @scope Ember.Observable.prototype */ {
/** @private - compatibility */
isObserverable: true,
/**
Retrieves the value of a property from the object.
This method is usually similar to using object[keyName] or object.keyName,
however it supports both computed properties and the unknownProperty
handler.
Because `get` unifies the syntax for accessing all these kinds
of properties, it can make many refactorings easier, such as replacing a
simple property with a computed property, or vice versa.
### Computed Properties
Computed properties are methods defined with the `property` modifier
declared at the end, such as:
fullName: function() {
return this.getEach('firstName', 'lastName').compact().join(' ');
}.property('firstName', 'lastName')
When you call `get` on a computed property, the function will be
called and the return value will be returned instead of the function
itself.
### Unknown Properties
Likewise, if you try to call `get` on a property whose value is
undefined, the unknownProperty() method will be called on the object.
If this method returns any value other than undefined, it will be returned
instead. This allows you to implement "virtual" properties that are
not defined upfront.
@param {String} key The property to retrieve
@returns {Object} The property value or undefined.
*/
get: function(keyName) {
return get(this, keyName);
},
/**
To get multiple properties at once, call getProperties
with a list of strings or an array:
record.getProperties('firstName', 'lastName', 'zipCode'); // => { firstName: 'John', lastName: 'Doe', zipCode: '10011' }
is equivalent to:
record.getProperties(['firstName', 'lastName', 'zipCode']); // => { firstName: 'John', lastName: 'Doe', zipCode: '10011' }
@param {String...|Array} list of keys to get
@returns {Hash}
*/
getProperties: function() {
var ret = {};
var propertyNames = arguments;
if (arguments.length === 1 && Ember.typeOf(arguments[0]) === 'array') {
propertyNames = arguments[0];
}
for(var i = 0; i < propertyNames.length; i++) {
ret[propertyNames[i]] = get(this, propertyNames[i]);
}
return ret;
},
/**
Sets the 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:
record.set('firstName', 'Charles').set('lastName', 'Jolley');
@param {String} key The property to set
@param {Object} value The value to set or null.
@returns {Ember.Observable}
*/
set: function(keyName, value) {
set(this, keyName, value);
return this;
},
/**
To set multiple properties at once, call setProperties
with a Hash:
record.setProperties({ firstName: 'Charles', lastName: 'Jolley' });
@param {Hash} hash the hash of keys and values to set
@returns {Ember.Observable}
*/
setProperties: function(hash) {
return Ember.setProperties(this, hash);
},
/**
Begins a grouping of property changes.
You can use this method to group property changes so that notifications
will not be sent until the changes are finished. If you plan to make a
large number of changes to an object at one time, you should call this
method at the beginning of the changes to begin deferring change
notifications. When you are done making changes, call endPropertyChanges()
to deliver the deferred change notifications and end deferring.
@returns {Ember.Observable}
*/
beginPropertyChanges: function() {
Ember.beginPropertyChanges();
return this;
},
/**
Ends a grouping of property changes.
You can use this method to group property changes so that notifications
will not be sent until the changes are finished. If you plan to make a
large number of changes to an object at one time, you should call
beginPropertyChanges() at the beginning of the changes to defer change
notifications. When you are done making changes, call this method to
deliver the deferred change notifications and end deferring.
@returns {Ember.Observable}
*/
endPropertyChanges: function() {
Ember.endPropertyChanges();
return this;
},
/**
Notify the observer system that a property is about to change.
Sometimes you need to change a value directly or indirectly without
actually calling get() or set() on it. In this case, you can use this
method and propertyDidChange() instead. Calling these two methods
together will notify all observers that the property has potentially
changed value.
Note that you must always call propertyWillChange and propertyDidChange as
a pair. If you do not, it may get the property change groups out of order
and cause notifications to be delivered more often than you would like.
@param {String} key The property key that is about to change.
@returns {Ember.Observable}
*/
propertyWillChange: function(keyName){
Ember.propertyWillChange(this, keyName);
return this;
},
/**
Notify the observer system that a property has just changed.
Sometimes you need to change a value directly or indirectly without
actually calling get() or set() on it. In this case, you can use this
method and propertyWillChange() instead. Calling these two methods
together will notify all observers that the property has potentially
changed value.
Note that you must always call propertyWillChange and propertyDidChange as
a pair. If you do not, it may get the property change groups out of order
and cause notifications to be delivered more often than you would like.
@param {String} keyName The property key that has just changed.
@returns {Ember.Observable}
*/
propertyDidChange: function(keyName) {
Ember.propertyDidChange(this, keyName);
return this;
},
/**
Convenience method to call `propertyWillChange` and `propertyDidChange` in
succession.
@param {String} keyName The property key to be notified about.
@returns {Ember.Observable}
*/
notifyPropertyChange: function(keyName) {
this.propertyWillChange(keyName);
this.propertyDidChange(keyName);
return this;
},
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:
fooDidChange: function(sender, key, value, rev);
The sender is the object that changed. The key is the property that
changes. The value property is currently reserved and unused. The rev
is the last property revision of the object when it changed, which you can
use to detect if the key value has really changed or not.
If you pass a "context" parameter, the context will be passed before the
revision like so:
fooDidChange: function(sender, key, value, context, rev);
Usually you will not need the value, context or revision parameters at
the end. In this case, it is common to write observer methods that take
only a sender and key value as parameters or, if you aren't interested in
any of these values, to write an observer that has no parameters at all.
@param {String} key The key to observer
@param {Object} target The target object to invoke
@param {String|Function} method The method to invoke.
@returns {Ember.Object} self
*/
addObserver: function(key, target, method) {
Ember.addObserver(this, key, target, method);
},
/**
Remove an observer you have previously registered on this object. Pass
the same key, target, and method you passed to addObserver() and your
target will no longer receive notifications.
@param {String} key The key to observer
@param {Object} target The target object to invoke
@param {String|Function} method The method to invoke.
@returns {Ember.Observable} receiver
*/
removeObserver: function(key, target, method) {
Ember.removeObserver(this, key, target, method);
},
/**
Returns true if the object currently has observers registered for a
particular key. You can use this method to potentially defer performing
an expensive action until someone begins observing a particular property
on the object.
@param {String} key Key to check
@returns {Boolean}
*/
hasObserverFor: function(key) {
return Ember.hasListeners(this, key+':change');
},
/**
This method will be called when a client attempts to get the value of a
property that has not been defined in one of the typical ways. Override
this method to create "virtual" properties.
@param {String} key The name of the unknown property that was requested.
@returns {Object} The property value or undefined. Default is undefined.
*/
unknownProperty: function(key) {
return undefined;
},
/**
This method will be called when a client attempts to set the value of a
property that has not been defined in one of the typical ways. Override
this method to create "virtual" properties.
@param {String} key The name of the unknown property to be set.
@param {Object} value The value the unknown property is to be set to.
*/
setUnknownProperty: function(key, value) {
defineProperty(this, key);
set(this, key, value);
},
/**
@deprecated
@param {String} path The property path to retrieve
@returns {Object} The property value or undefined.
*/
getPath: function(path) {
Ember.deprecate("getPath is deprecated since get now supports paths");
return this.get(path);
},
/**
@deprecated
@param {String} path The path to the property that will be set
@param {Object} value The value to set or null.
@returns {Ember.Observable}
*/
setPath: function(path, value) {
Ember.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.
person.getWithDefault('lastName', 'Doe');
@param {String} keyName The name of the property to retrieve
@param {Object} defaultValue The value to return if the property value is undefined
@returns {Object} The property value or the defaultValue.
*/
getWithDefault: function(keyName, defaultValue) {
return Ember.getWithDefault(this, keyName, defaultValue);
},
/**
Set the value of a property to the current value plus some amount.
person.incrementProperty('age');
team.incrementProperty('score', 2);
@param {String} keyName The name of the property to increment
@param {Object} increment The amount to increment by. Defaults to 1
@returns {Object} The new property value
*/
incrementProperty: function(keyName, increment) {
if (!increment) { increment = 1; }
set(this, keyName, (get(this, keyName) || 0)+increment);
return get(this, keyName);
},
/**
Set the value of a property to the current value minus some amount.
player.decrementProperty('lives');
orc.decrementProperty('health', 5);
@param {String} keyName The name of the property to decrement
@param {Object} increment The amount to decrement by. Defaults to 1
@returns {Object} The new property value
*/
decrementProperty: function(keyName, increment) {
if (!increment) { increment = 1; }
set(this, keyName, (get(this, keyName) || 0)-increment);
return get(this, keyName);
},
/**
Set the value of a boolean property to the opposite of it's
current value.
starship.toggleProperty('warpDriveEnaged');
@param {String} keyName The name of the property to toggle
@returns {Object} The new property value
*/
toggleProperty: function(keyName) {
set(this, keyName, !get(this, keyName));
return get(this, keyName);
},
/**
Returns the cached value of a computed property, if it exists.
This allows you to inspect the value of a computed property
without accidentally invoking it if it is intended to be
generated lazily.
@param {String} keyName
@returns {Object} The cached value of the computed property, if any
*/
cacheFor: function(keyName) {
return Ember.cacheFor(this, keyName);
},
/** @private - intended for debugging purposes */
observersForKey: function(keyName) {
return Ember.observersFor(this, keyName);
}
});
})();
(function() {
var get = Ember.get, set = Ember.set;
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(window, target); }
return value;
} else {
return target;
}
}).property('target').cacheable(),
triggerAction: function() {
var action = get(this, 'action'),
target = get(this, 'targetObject');
if (target && action) {
var ret;
if (typeof target.send === 'function') {
ret = target.send(action, this);
} else {
if (typeof action === 'string') {
action = target[action];
}
ret = action.call(target, this);
}
if (ret !== false) ret = true;
return ret;
} else {
return false;
}
}
});
})();
(function() {
/**
@class
@extends Ember.Mixin
*/
Ember.Evented = Ember.Mixin.create(
/** @scope Ember.Evented.prototype */ {
on: function(name, target, method) {
Ember.addListener(this, name, target, method);
},
one: function(name, target, method) {
if (!method) {
method = target;
target = null;
}
var self = this;
var wrapped = function() {
Ember.removeListener(self, name, target, wrapped);
if ('string' === typeof method) { method = this[method]; }
// Internally, a `null` target means that the target is
// the first parameter to addListener. That means that
// the `this` passed into this function is the target
// determined by the event system.
method.apply(this, arguments);
};
this.on(name, target, wrapped);
},
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);
},
off: function(name, target, method) {
Ember.removeListener(this, name, target, method);
},
has: function(name) {
return Ember.hasListeners(this, name);
}
});
})();
(function() {
// ==========================================================================
// Project: Ember Runtime
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
})();
(function() {
// ==========================================================================
// Project: Ember Runtime
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
// NOTE: this object should never be included directly. Instead use Ember.
// Ember.Object. We only define this separately so that Ember.Set can depend on it
var classToString = Ember.Mixin.prototype.toString;
var set = Ember.set, get = Ember.get;
var o_create = Ember.create,
o_defineProperty = Ember.platform.defineProperty,
a_slice = Array.prototype.slice,
meta = Ember.meta,
rewatch = Ember.rewatch,
finishChains = Ember.finishChains,
finishPartial = Ember.Mixin.finishPartial,
reopen = Ember.Mixin.prototype.reopen;
var undefinedDescriptor = {
configurable: true,
writable: true,
enumerable: false,
value: undefined
};
/** @private */
function makeCtor() {
// Note: avoid accessing any properties on the object since it makes the
// method a lot faster. This is glue code so we want it to be as fast as
// possible.
var wasApplied = false, initMixins;
var Class = function() {
if (!wasApplied) {
Class.proto(); // prepare prototype...
}
var m = Ember.meta(this);
m.proto = this;
if (initMixins) {
this.reopen.apply(this, initMixins);
initMixins = null;
}
o_defineProperty(this, Ember.GUID_KEY, undefinedDescriptor);
o_defineProperty(this, '_super', undefinedDescriptor);
finishPartial(this, m);
delete m.proto;
finishChains(this);
this.init.apply(this, arguments);
};
Class.toString = classToString;
Class.willReopen = function() {
if (wasApplied) {
Class.PrototypeMixin = Ember.Mixin.create(Class.PrototypeMixin);
}
wasApplied = false;
};
Class._initMixins = function(args) { initMixins = args; };
Class.proto = function() {
var superclass = Class.superclass;
if (superclass) { superclass.proto(); }
if (!wasApplied) {
wasApplied = true;
Class.PrototypeMixin.applyPartial(Class.prototype);
rewatch(Class.prototype);
}
return this.prototype;
};
return Class;
}
var CoreObject = makeCtor();
CoreObject.PrototypeMixin = Ember.Mixin.create(
/** @scope Ember.CoreObject.prototype */ {
reopen: function() {
Ember.Mixin._apply(this, arguments, true);
return this;
},
isInstance: true,
/** @private */
init: function() {},
/** @field */
isDestroyed: false,
/** @field */
isDestroying: false,
/**
Destroys an object by setting the isDestroyed flag and removing its
metadata, which effectively destroys observers and bindings.
If you try to set a property on a destroyed object, an exception will be
raised.
Note that destruction is scheduled for the end of the run loop and does not
happen immediately.
@returns {Ember.Object} receiver
*/
destroy: function() {
if (this.isDestroying) { return; }
this.isDestroying = true;
if (this.willDestroy) { this.willDestroy(); }
set(this, 'isDestroyed', true);
Ember.run.schedule('destroy', this, this._scheduledDestroy);
return this;
},
/**
Invoked by the run loop to actually destroy the object. This is
scheduled for execution by the `destroy` method.
@private
*/
_scheduledDestroy: function() {
Ember.destroy(this);
if (this.didDestroy) { this.didDestroy(); }
},
bind: function(to, from) {
if (!(from instanceof Ember.Binding)) { from = Ember.Binding.from(from); }
from.to(to).connect(this);
return from;
},
toString: function() {
return '<'+this.constructor.toString()+':'+Ember.guidFor(this)+'>';
}
});
if (Ember.config.overridePrototypeMixin) {
Ember.config.overridePrototypeMixin(CoreObject.PrototypeMixin);
}
CoreObject.__super__ = null;
var ClassMixin = Ember.Mixin.create(
/** @scope Ember.ClassMixin.prototype */ {
ClassMixin: Ember.required(),
PrototypeMixin: Ember.required(),
isClass: true,
isMethod: false,
extend: function() {
var Class = makeCtor(), proto;
Class.ClassMixin = Ember.Mixin.create(this.ClassMixin);
Class.PrototypeMixin = Ember.Mixin.create(this.PrototypeMixin);
Class.ClassMixin.ownerConstructor = Class;
Class.PrototypeMixin.ownerConstructor = Class;
reopen.apply(Class.PrototypeMixin, arguments);
Class.superclass = this;
Class.__super__ = this.prototype;
proto = Class.prototype = o_create(this.prototype);
proto.constructor = Class;
Ember.generateGuid(proto, 'ember');
meta(proto).proto = proto; // this will disable observers on prototype
Class.ClassMixin.apply(Class);
return Class;
},
create: function() {
var C = this;
if (arguments.length>0) { this._initMixins(arguments); }
return new C();
},
reopen: function() {
this.willReopen();
reopen.apply(this.PrototypeMixin, arguments);
return this;
},
reopenClass: function() {
reopen.apply(this.ClassMixin, arguments);
Ember.Mixin._apply(this, arguments, false);
return this;
},
detect: function(obj) {
if ('function' !== typeof obj) { return false; }
while(obj) {
if (obj===this) { return true; }
obj = obj.superclass;
}
return false;
},
detectInstance: function(obj) {
return obj instanceof this;
},
/**
In some cases, you may want to annotate computed properties with additional
metadata about how they function or what values they operate on. For example,
computed property functions may close over variables that are then no longer
available for introspection.
You can pass a hash of these values to a computed property like this:
person: function() {
var personId = this.get('personId');
return App.Person.create({ id: personId });
}.property().meta({ type: App.Person })
Once you've done this, you can retrieve the values saved to the computed
property from your class like this:
MyClass.metaForProperty('person');
This will return the original hash that was passed to `meta()`.
*/
metaForProperty: function(key) {
var desc = meta(this.proto(), false).descs[key];
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.
*/
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);
}
}
}
});
if (Ember.config.overrideClassMixin) {
Ember.config.overrideClassMixin(ClassMixin);
}
CoreObject.ClassMixin = ClassMixin;
ClassMixin.apply(CoreObject);
/**
@class
*/
Ember.CoreObject = CoreObject;
})();
(function() {
// ==========================================================================
// Project: Ember Runtime
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
var get = Ember.get, set = Ember.set, guidFor = Ember.guidFor, none = Ember.none;
/**
@class
An unordered collection of objects.
A Set works a bit like an array except that its items are not ordered.
You can create a set to efficiently test for membership for an object. You
can also iterate through a set just like an array, even accessing objects
by index, however there is no guarantee as to their order.
All Sets are observable via the Enumerable Observer API - which works
on any enumerable object including both Sets and Arrays.
## Creating a Set
You can create a set like you would most objects using
`new Ember.Set()`. Most new sets you create will be empty, but you can
also initialize the set with some content by passing an array or other
enumerable of objects to the constructor.
Finally, you can pass in an existing set and the set will be copied. You
can also create a copy of a set by calling `Ember.Set#copy()`.
#js
// creates a new empty set
var foundNames = new Ember.Set();
// creates a set with four names in it.
var names = new Ember.Set(["Charles", "Tom", "Juan", "Alex"]); // :P
// creates a copy of the names set.
var namesCopy = new Ember.Set(names);
// same as above.
var anotherNamesCopy = names.copy();
## Adding/Removing Objects
You generally add or remove objects from a set using `add()` or
`remove()`. You can add any type of object including primitives such as
numbers, strings, and booleans.
Unlike arrays, objects can only exist one time in a set. If you call `add()`
on a set with the same object multiple times, the object will only be added
once. Likewise, calling `remove()` with the same object multiple times will
remove the object the first time and have no effect on future calls until
you add the object to the set again.
NOTE: You cannot add/remove null or undefined to a set. Any attempt to do so
will be ignored.
In addition to add/remove you can also call `push()`/`pop()`. Push behaves
just like `add()` but `pop()`, unlike `remove()` will pick an arbitrary
object, remove it and return it. This is a good way to use a set as a job
queue when you don't care which order the jobs are executed in.
## Testing for an Object
To test for an object's presence in a set you simply call
`Ember.Set#contains()`.
## Observing changes
When using `Ember.Set`, you can observe the `"[]"` property to be
alerted whenever the content changes. You can also add an enumerable
observer to the set to be notified of specific objects that are added and
removed from the set. See `Ember.Enumerable` for more information on
enumerables.
This is often unhelpful. If you are filtering sets of objects, for instance,
it is very inefficient to re-filter all of the items each time the set
changes. It would be better if you could just adjust the filtered set based
on what was changed on the original set. The same issue applies to merging
sets, as well.
## Other Methods
`Ember.Set` primary implements other mixin APIs. For a complete reference
on the methods you will use with `Ember.Set`, please consult these mixins.
The most useful ones will be `Ember.Enumerable` and
`Ember.MutableEnumerable` which implement most of the common iterator
methods you are used to on Array.
Note that you can also use the `Ember.Copyable` and `Ember.Freezable`
APIs on `Ember.Set` as well. Once a set is frozen it can no longer be
modified. The benefit of this is that when you call frozenCopy() on it,
Ember will avoid making copies of the set. This allows you to write
code that can know with certainty when the underlying set data will or
will not be modified.
@extends Ember.Enumerable
@extends Ember.MutableEnumerable
@extends Ember.Copyable
@extends Ember.Freezable
@since Ember 0.9
*/
Ember.Set = Ember.CoreObject.extend(Ember.MutableEnumerable, Ember.Copyable, Ember.Freezable,
/** @scope Ember.Set.prototype */ {
// ..........................................................
// IMPLEMENT ENUMERABLE APIS
//
/**
This property will change as the number of objects in the set changes.
@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.
var colors = new Ember.Set(["red", "green", "blue"]);
colors.length; => 3
colors.clear();
colors.length; => 0
@returns {Ember.Set} An empty Set
*/
clear: function() {
if (this.isFrozen) { throw new Error(Ember.FROZEN_ERROR); }
var len = get(this, 'length');
if (len === 0) { return this; }
var guid;
this.enumerableContentWillChange(len, 0);
Ember.propertyWillChange(this, 'firstObject');
Ember.propertyWillChange(this, 'lastObject');
for (var i=0; i < len; i++){
guid = guidFor(this[i]);
delete this[guid];
delete this[i];
}
set(this, 'length', 0);
Ember.propertyDidChange(this, 'firstObject');
Ember.propertyDidChange(this, 'lastObject');
this.enumerableContentDidChange(len, 0);
return this;
},
/**
Returns true if the passed object is also an enumerable that contains the
same objects as the receiver.
var colors = ["red", "green", "blue"],
same_colors = new Ember.Set(colors);
same_colors.isEqual(colors); => true
same_colors.isEqual(["purple", "brown"]); => false
@param {Ember.Set} obj the other object.
@returns {Boolean}
*/
isEqual: function(obj) {
// fail fast
if (!Ember.Enumerable.detect(obj)) return false;
var loc = get(this, 'length');
if (get(obj, 'length') !== loc) return false;
while(--loc >= 0) {
if (!obj.contains(this[loc])) return false;
}
return true;
},
/**
Adds an object to the set. Only non-null objects can be added to a set
and those can only be added once. If the object is already in the set or
the passed value is null this method will have no effect.
This is an alias for `Ember.MutableEnumerable.addObject()`.
var colors = new Ember.Set();
colors.add("blue"); => ["blue"]
colors.add("blue"); => ["blue"]
colors.add("red"); => ["blue", "red"]
colors.add(null); => ["blue", "red"]
colors.add(undefined); => ["blue", "red"]
@function
@param {Object} obj The object to add.
@returns {Ember.Set} The set itself.
*/
add: Ember.alias('addObject'),
/**
Removes the object from the set if it is found. If you pass a null value
or an object that is already not in the set, this method will have no
effect. This is an alias for `Ember.MutableEnumerable.removeObject()`.
var colors = new Ember.Set(["red", "green", "blue"]);
colors.remove("red"); => ["blue", "green"]
colors.remove("purple"); => ["blue", "green"]
colors.remove(null); => ["blue", "green"]
@function
@param {Object} obj The object to remove
@returns {Ember.Set} The set itself.
*/
remove: Ember.alias('removeObject'),
/**
Removes the last element from the set and returns it, or null if it's empty.
var colors = new Ember.Set(["green", "blue"]);
colors.pop(); => "blue"
colors.pop(); => "green"
colors.pop(); => null
@returns {Object} The removed object from the set or null.
*/
pop: function() {
if (get(this, 'isFrozen')) throw new Error(Ember.FROZEN_ERROR);
var obj = this.length > 0 ? this[this.length-1] : null;
this.remove(obj);
return obj;
},
/**
Inserts the given object on to the end of the set. It returns
the set itself.
This is an alias for `Ember.MutableEnumerable.addObject()`.
var colors = new Ember.Set();
colors.push("red"); => ["red"]
colors.push("green"); => ["red", "green"]
colors.push("blue"); => ["red", "green", "blue"]
@function
@returns {Ember.Set} The set itself.
*/
push: Ember.alias('addObject'),
/**
Removes the last element from the set and returns it, or null if it's empty.
This is an alias for `Ember.Set.pop()`.
var colors = new Ember.Set(["green", "blue"]);
colors.shift(); => "blue"
colors.shift(); => "green"
colors.shift(); => null
@function
@returns {Object} The removed object from the set or null.
*/
shift: Ember.alias('pop'),
/**
Inserts the given object on to the end of the set. It returns
the set itself.
This is an alias of `Ember.Set.push()`
var colors = new Ember.Set();
colors.unshift("red"); => ["red"]
colors.unshift("green"); => ["red", "green"]
colors.unshift("blue"); => ["red", "green", "blue"]
@function
@returns {Ember.Set} The set itself.
*/
unshift: Ember.alias('push'),
/**
Adds each object in the passed enumerable to the set.
This is an alias of `Ember.MutableEnumerable.addObjects()`
var colors = new Ember.Set();
colors.addEach(["red", "green", "blue"]); => ["red", "green", "blue"]
@function
@param {Ember.Enumerable} objects the objects to add.
@returns {Ember.Set} The set itself.
*/
addEach: Ember.alias('addObjects'),
/**
Removes each object in the passed enumerable to the set.
This is an alias of `Ember.MutableEnumerable.removeObjects()`
var colors = new Ember.Set(["red", "green", "blue"]);
colors.removeEach(["red", "blue"]); => ["green"]
@function
@param {Ember.Enumerable} objects the objects to remove.
@returns {Ember.Set} The set itself.
*/
removeEach: Ember.alias('removeObjects'),
// ..........................................................
// PRIVATE ENUMERABLE SUPPORT
//
/** @private */
init: function(items) {
this._super();
if (items) this.addObjects(items);
},
/** @private (nodoc) - implement Ember.Enumerable */
nextObject: function(idx) {
return this[idx];
},
/** @private - more optimized version */
firstObject: Ember.computed(function() {
return this.length > 0 ? this[0] : undefined;
}).property().cacheable(),
/** @private - more optimized version */
lastObject: Ember.computed(function() {
return this.length > 0 ? this[this.length-1] : undefined;
}).property().cacheable(),
/** @private (nodoc) - implements Ember.MutableEnumerable */
addObject: function(obj) {
if (get(this, 'isFrozen')) throw new Error(Ember.FROZEN_ERROR);
if (none(obj)) return this; // nothing to do
var guid = guidFor(obj),
idx = this[guid],
len = get(this, 'length'),
added ;
if (idx>=0 && idx<len && (this[idx] === obj)) return this; // added
added = [obj];
this.enumerableContentWillChange(null, added);
Ember.propertyWillChange(this, 'lastObject');
len = get(this, 'length');
this[guid] = len;
this[len] = obj;
set(this, 'length', len+1);
Ember.propertyDidChange(this, 'lastObject');
this.enumerableContentDidChange(null, added);
return this;
},
/** @private (nodoc) - implements Ember.MutableEnumerable */
removeObject: 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'),
isFirst = idx === 0,
isLast = idx === len-1,
last, removed;
if (idx>=0 && idx<len && (this[idx] === obj)) {
removed = [obj];
this.enumerableContentWillChange(removed, null);
if (isFirst) { Ember.propertyWillChange(this, 'firstObject'); }
if (isLast) { Ember.propertyWillChange(this, 'lastObject'); }
// swap items - basically move the item to the end so it can be removed
if (idx < len-1) {
last = this[len-1];
this[idx] = last;
this[guidFor(last)] = idx;
}
delete this[guid];
delete this[len-1];
set(this, 'length', len-1);
if (isFirst) { Ember.propertyDidChange(this, 'firstObject'); }
if (isLast) { Ember.propertyDidChange(this, 'lastObject'); }
this.enumerableContentDidChange(removed, null);
}
return this;
},
/** @private (nodoc) - optimized version */
contains: function(obj) {
return this[guidFor(obj)]>=0;
},
/** @private (nodoc) */
copy: function() {
var C = this.constructor, ret = new C(), loc = get(this, 'length');
set(ret, 'length', loc);
while(--loc>=0) {
ret[loc] = this[loc];
ret[guidFor(this[loc])] = loc;
}
return ret;
},
/** @private */
toString: function() {
var len = this.length, idx, array = [];
for(idx = 0; idx < len; idx++) {
array[idx] = this[idx];
}
return "Ember.Set<%@>".fmt(array.join(','));
}
});
})();
(function() {
// ==========================================================================
// Project: Ember Runtime
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
/**
@class
`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.
@extends Ember.CoreObject
@extends Ember.Observable
*/
Ember.Object = Ember.CoreObject.extend(Ember.Observable);
})();
(function() {
// ==========================================================================
// Project: Ember Runtime
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
var indexOf = Ember.ArrayPolyfills.indexOf;
/**
@private
A Namespace is an object usually used to contain other objects or methods
such as an application or framework. Create a namespace anytime you want
to define one of these new containers.
# Example Usage
MyFramework = Ember.Namespace.create({
VERSION: '1.0.0'
});
*/
Ember.Namespace = Ember.Object.extend({
isNamespace: true,
init: function() {
Ember.Namespace.NAMESPACES.push(this);
Ember.Namespace.PROCESSED = false;
},
toString: function() {
Ember.identifyNamespaces();
return this[Ember.GUID_KEY+'_name'];
},
destroy: function() {
var namespaces = Ember.Namespace.NAMESPACES;
window[this.toString()] = undefined;
namespaces.splice(indexOf.call(namespaces, this), 1);
this._super();
}
});
Ember.Namespace.NAMESPACES = [Ember];
Ember.Namespace.PROCESSED = false;
})();
(function() {
// ==========================================================================
// Project: Ember Runtime
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
/**
@private
Defines a namespace that will contain an executable application. This is
very similar to a normal namespace except that it is expected to include at
least a 'ready' function which can be run to initialize the application.
Currently Ember.Application is very similar to Ember.Namespace. However, this
class may be augmented by additional frameworks so it is important to use
this instance when building new applications.
# Example Usage
MyApp = Ember.Application.create({
VERSION: '1.0.0',
store: Ember.Store.create().from(Ember.fixtures)
});
MyApp.ready = function() {
//..init code goes here...
}
*/
Ember.Application = Ember.Namespace.extend();
})();
(function() {
// ==========================================================================
// Project: Ember Runtime
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
var get = Ember.get, set = Ember.set;
/**
@class
An ArrayProxy wraps any other object that implements Ember.Array and/or
Ember.MutableArray, forwarding all requests. This makes it very useful for
a number of binding use cases or other cases where being able to swap
out the underlying array is useful.
A simple example of usage:
var pets = ['dog', 'cat', 'fish'];
var ap = Ember.ArrayProxy.create({ content: Ember.A(pets) });
ap.get('firstObject'); // => 'dog'
ap.set('content', ['amoeba', 'paramecium']);
ap.get('firstObject'); // => 'amoeba'
This class can also be useful as a layer to transform the contents of
an array, as they are accessed. This can be done by overriding
`objectAtContent`:
var pets = ['dog', 'cat', 'fish'];
var ap = Ember.ArrayProxy.create({
content: Ember.A(pets),
objectAtContent: function(idx) {
return this.get('content').objectAt(idx).toUpperCase();
}
});
ap.get('firstObject'); // => 'DOG'
@extends Ember.Object
@extends Ember.Array
@extends Ember.MutableArray
*/
Ember.ArrayProxy = Ember.Object.extend(Ember.MutableArray,
/** @scope Ember.ArrayProxy.prototype */ {
/**
The content array. Must be an object that implements Ember.Array and/or
Ember.MutableArray.
@type Ember.Array
*/
content: null,
/**
The array that the proxy pretends to be. In the default `ArrayProxy`
implementation, this and `content` are the same. Subclasses of `ArrayProxy`
can override this property to provide things like sorting and filtering.
*/
arrangedContent: Ember.computed('content', function() {
return get(this, 'content');
}).cacheable(),
/**
Should actually retrieve the object at the specified index from the
content. You can override this method in subclasses to transform the
content item to something new.
This method will only be called if content is non-null.
@param {Number} idx
The index to retrieve.
@returns {Object} the value or undefined if none found
*/
objectAtContent: function(idx) {
return get(this, 'arrangedContent').objectAt(idx);
},
/**
Should actually replace the specified objects on the content array.
You can override this method in subclasses to transform the content item
into something new.
This method will only be called if content is non-null.
@param {Number} idx
The starting index
@param {Number} amt
The number of items to remove from the content.
@param {Array} objects
Optional array of objects to insert or null if no objects.
@returns {void}
*/
replaceContent: function(idx, amt, objects) {
get(this, 'arrangedContent').replace(idx, amt, objects);
},
/**
Invoked when the content property is about to change. Notifies observers that the
entire array content will change.
*/
_contentWillChange: Ember.beforeObserver(function() {
var content = get(this, 'content');
if (content) {
content.removeArrayObserver(this, {
willChange: 'contentArrayWillChange',
didChange: 'contentArrayDidChange'
});
}
}, 'content'),
contentArrayWillChange: Ember.K,
contentArrayDidChange: Ember.K,
/**
Invoked when the content property changes. Notifies observers that the
entire array content has changed.
*/
_contentDidChange: Ember.observer(function() {
var content = get(this, 'content'),
len = content ? get(content, 'length') : 0;
Ember.assert("Can't set ArrayProxy's content to itself", content !== this);
if (content) {
content.addArrayObserver(this, {
willChange: 'contentArrayWillChange',
didChange: 'contentArrayDidChange'
});
}
}, 'content'),
_arrangedContentWillChange: Ember.beforeObserver(function() {
var arrangedContent = get(this, 'arrangedContent'),
len = arrangedContent ? get(arrangedContent, 'length') : 0;
this.arrangedContentArrayWillChange(this, 0, len, undefined);
if (arrangedContent) {
arrangedContent.removeArrayObserver(this, {
willChange: 'arrangedContentArrayWillChange',
didChange: 'arrangedContentArrayDidChange'
});
}
}, 'arrangedContent'),
_arrangedContentDidChange: Ember.observer(function() {
var arrangedContent = get(this, 'arrangedContent'),
len = arrangedContent ? get(arrangedContent, 'length') : 0;
Ember.assert("Can't set ArrayProxy's content to itself", arrangedContent !== this);
if (arrangedContent) {
arrangedContent.addArrayObserver(this, {
willChange: 'arrangedContentArrayWillChange',
didChange: 'arrangedContentArrayDidChange'
});
}
this.arrangedContentArrayDidChange(this, 0, undefined, len);
}, 'arrangedContent'),
/** @private (nodoc) */
objectAt: function(idx) {
return get(this, 'content') && this.objectAtContent(idx);
},
/** @private (nodoc) */
length: Ember.computed(function() {
var arrangedContent = get(this, 'arrangedContent');
return arrangedContent ? get(arrangedContent, 'length') : 0;
// No dependencies since Enumerable notifies length of change
}).property().cacheable(),
/** @private (nodoc) */
replace: function(idx, amt, objects) {
if (get(this, 'content')) this.replaceContent(idx, amt, objects);
return this;
},
/** @private (nodoc) */
arrangedContentArrayWillChange: function(item, idx, removedCnt, addedCnt) {
this.arrayContentWillChange(idx, removedCnt, addedCnt);
},
/** @private (nodoc) */
arrangedContentArrayDidChange: function(item, idx, removedCnt, addedCnt) {
this.arrayContentDidChange(idx, removedCnt, addedCnt);
},
/** @private (nodoc) */
init: function() {
this._super();
this._contentWillChange();
this._contentDidChange();
this._arrangedContentWillChange();
this._arrangedContentDidChange();
}
});
})();
(function() {
var get = Ember.get,
set = Ember.set,
fmt = Ember.String.fmt,
addBeforeObserver = Ember.addBeforeObserver,
addObserver = Ember.addObserver,
removeBeforeObserver = Ember.removeBeforeObserver,
removeObserver = Ember.removeObserver,
propertyWillChange = Ember.propertyWillChange,
propertyDidChange = Ember.propertyDidChange;
function contentPropertyWillChange(content, contentKey) {
var key = contentKey.slice(8); // remove "content."
if (key in this) { return; } // if shadowed in proxy
propertyWillChange(this, key);
}
function contentPropertyDidChange(content, contentKey) {
var key = contentKey.slice(8); // remove "content."
if (key in this) { return; } // if shadowed in proxy
propertyDidChange(this, key);
}
/**
@class
`Ember.ObjectProxy` forwards all properties not defined by the proxy itself
to a proxied `content` object.
object = Ember.Object.create({
name: 'Foo'
});
proxy = Ember.ObjectProxy.create({
content: object
});
// Access and change existing properties
proxy.get('name') // => 'Foo'
proxy.set('name', 'Bar');
object.get('name') // => 'Bar'
// Create new 'description' property on `object`
proxy.set('description', 'Foo is a whizboo baz');
object.get('description') // => 'Foo is a whizboo baz'
While `content` is unset, setting a property to be delegated will throw an Error.
proxy = Ember.ObjectProxy.create({
content: null,
flag: null
});
proxy.set('flag', true);
proxy.get('flag'); // => true
proxy.get('foo'); // => undefined
proxy.set('foo', 'data'); // throws Error
Delegated properties can be bound to and will change when content is updated.
Computed properties on the proxy itself can depend on delegated properties.
ProxyWithComputedProperty = Ember.ObjectProxy.extend({
fullName: function () {
var firstName = this.get('firstName'),
lastName = this.get('lastName');
if (firstName && lastName) {
return firstName + ' ' + lastName;
}
return firstName || lastName;
}.property('firstName', 'lastName')
});
proxy = ProxyWithComputedProperty.create();
proxy.get('fullName'); => undefined
proxy.set('content', {
firstName: 'Tom', lastName: 'Dale'
}); // triggers property change for fullName on proxy
proxy.get('fullName'); => 'Tom Dale'
*/
Ember.ObjectProxy = Ember.Object.extend(
/** @scope Ember.ObjectProxy.prototype */ {
/**
The object whose properties will be forwarded.
@type Ember.Object
@default null
*/
content: null,
_contentDidChange: Ember.observer(function() {
Ember.assert("Can't set ObjectProxy's content to itself", this.get('content') !== this);
}, 'content'),
/** @private */
willWatchProperty: function (key) {
var contentKey = 'content.' + key;
addBeforeObserver(this, contentKey, null, contentPropertyWillChange);
addObserver(this, contentKey, null, contentPropertyDidChange);
},
/** @private */
didUnwatchProperty: function (key) {
var contentKey = 'content.' + key;
removeBeforeObserver(this, contentKey, null, contentPropertyWillChange);
removeObserver(this, contentKey, null, contentPropertyDidChange);
},
/** @private */
unknownProperty: function (key) {
var content = get(this, 'content');
if (content) {
return get(content, key);
}
},
/** @private */
setUnknownProperty: function (key, value) {
var content = get(this, 'content');
Ember.assert(fmt("Cannot delegate set('%@', %@) to the 'content' property of object proxy %@: its 'content' is undefined.", [key, value, this]), content);
return set(content, key, value);
}
});
})();
(function() {
// ==========================================================================
// Project: Ember Runtime
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
var set = Ember.set, get = Ember.get, guidFor = Ember.guidFor;
var forEach = Ember.EnumerableUtils.forEach;
var EachArray = Ember.Object.extend(Ember.Array, {
init: function(content, keyName, owner) {
this._super();
this._keyName = keyName;
this._owner = owner;
this._content = content;
},
objectAt: function(idx) {
var item = this._content.objectAt(idx);
return item && get(item, this._keyName);
},
length: Ember.computed(function() {
var content = this._content;
return content ? get(content, 'length') : 0;
}).property().cacheable()
});
var IS_OBSERVER = /^.+:(before|change)$/;
/** @private */
function addObserverForContentKey(content, keyName, proxy, idx, loc) {
var objects = proxy._objects, guid;
if (!objects) objects = proxy._objects = {};
while(--loc>=idx) {
var item = content.objectAt(loc);
if (item) {
Ember.addBeforeObserver(item, keyName, proxy, 'contentKeyWillChange');
Ember.addObserver(item, keyName, proxy, 'contentKeyDidChange');
// keep track of the indicies each item was found at so we can map
// it back when the obj changes.
guid = guidFor(item);
if (!objects[guid]) objects[guid] = [];
objects[guid].push(loc);
}
}
}
/** @private */
function removeObserverForContentKey(content, keyName, proxy, idx, loc) {
var objects = proxy._objects;
if (!objects) objects = proxy._objects = {};
var indicies, guid;
while(--loc>=idx) {
var item = content.objectAt(loc);
if (item) {
Ember.removeBeforeObserver(item, keyName, proxy, 'contentKeyWillChange');
Ember.removeObserver(item, keyName, proxy, 'contentKeyDidChange');
guid = guidFor(item);
indicies = objects[guid];
indicies[indicies.indexOf(loc)] = null;
}
}
}
/**
@private
@class
This is the object instance returned when you get the @each property on an
array. It uses the unknownProperty handler to automatically create
EachArray instances for property names.
@extends Ember.Object
*/
Ember.EachProxy = Ember.Object.extend({
init: function(content) {
this._super();
this._content = content;
content.addArrayObserver(this);
// in case someone is already observing some keys make sure they are
// added
forEach(Ember.watchedEvents(this), function(eventName) {
this.didAddListener(eventName);
}, this);
},
/**
You can directly access mapped properties by simply requesting them.
The unknownProperty handler will generate an EachArray of each item.
*/
unknownProperty: function(keyName, value) {
var ret;
ret = new EachArray(this._content, keyName, this);
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, array, lim;
lim = removedCnt>0 ? idx+removedCnt : -1;
Ember.beginPropertyChanges(this);
for(key in keys) {
if (!keys.hasOwnProperty(key)) { continue; }
if (lim>0) removeObserverForContentKey(content, key, this, idx, lim);
Ember.propertyWillChange(this, key);
}
Ember.propertyWillChange(this._content, '@each');
Ember.endPropertyChanges(this);
},
arrayDidChange: function(content, idx, removedCnt, addedCnt) {
var keys = this._keys, key, array, lim;
lim = addedCnt>0 ? idx+addedCnt : -1;
Ember.beginPropertyChanges(this);
for(key in keys) {
if (!keys.hasOwnProperty(key)) { continue; }
if (lim>0) addObserverForContentKey(content, key, this, idx, lim);
Ember.propertyDidChange(this, key);
}
Ember.propertyDidChange(this._content, '@each');
Ember.endPropertyChanges(this);
},
// ..........................................................
// LISTEN FOR NEW OBSERVERS AND OTHER EVENT LISTENERS
// Start monitoring keys based on who is listening...
didAddListener: function(eventName) {
if (IS_OBSERVER.test(eventName)) {
this.beginObservingContentKey(eventName.slice(0, -7));
}
},
didRemoveListener: function(eventName) {
if (IS_OBSERVER.test(eventName)) {
this.stopObservingContentKey(eventName.slice(0, -7));
}
},
// ..........................................................
// CONTENT KEY OBSERVING
// Actual watch keys on the source content.
beginObservingContentKey: function(keyName) {
var keys = this._keys;
if (!keys) keys = this._keys = {};
if (!keys[keyName]) {
keys[keyName] = 1;
var content = this._content,
len = get(content, 'length');
addObserverForContentKey(content, keyName, this, 0, len);
} else {
keys[keyName]++;
}
},
stopObservingContentKey: function(keyName) {
var keys = this._keys;
if (keys && (keys[keyName]>0) && (--keys[keyName]<=0)) {
var content = this._content,
len = get(content, 'length');
removeObserverForContentKey(content, keyName, this, 0, len);
}
},
contentKeyWillChange: function(obj, keyName) {
Ember.propertyWillChange(this, keyName);
},
contentKeyDidChange: function(obj, keyName) {
Ember.propertyDidChange(this, keyName);
}
});
})();
(function() {
// ==========================================================================
// Project: Ember Runtime
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
var get = Ember.get, set = Ember.set;
// Add Ember.Array to Array.prototype. Remove methods with native
// implementations and supply some more optimized versions of generic methods
// because they are so common.
var NativeArray = Ember.Mixin.create(Ember.MutableArray, Ember.Observable, Ember.Copyable, {
// because length is a built-in property we need to know to just get the
// original property.
get: function(key) {
if (key==='length') return this.length;
else if ('number' === typeof key) return this[key];
else return this._super(key);
},
objectAt: function(idx) {
return this[idx];
},
// primitive for array support.
replace: function(idx, amt, objects) {
if (this.isFrozen) throw Ember.FROZEN_ERROR ;
// if we replaced exactly the same number of items, then pass only the
// replaced range. Otherwise, pass the full remaining array length
// since everything has shifted
var len = objects ? get(objects, 'length') : 0;
this.arrayContentWillChange(idx, amt, len);
if (!objects || objects.length === 0) {
this.splice(idx, amt) ;
} else {
var args = [idx, amt].concat(objects) ;
this.splice.apply(this,args) ;
}
this.arrayContentDidChange(idx, amt, len);
return this ;
},
// If you ask for an unknown property, then try to collect the value
// from member items.
unknownProperty: function(key, value) {
var ret;// = this.reducedProperty(key, value) ;
if ((value !== undefined) && ret === undefined) {
ret = this[key] = value;
}
return ret ;
},
// If browser did not implement indexOf natively, then override with
// specialized version
indexOf: function(object, startAt) {
var idx, len = this.length;
if (startAt === undefined) startAt = 0;
else startAt = (startAt < 0) ? Math.ceil(startAt) : Math.floor(startAt);
if (startAt < 0) startAt += len;
for(idx=startAt;idx<len;idx++) {
if (this[idx] === object) return idx ;
}
return -1;
},
lastIndexOf: function(object, startAt) {
var idx, len = this.length;
if (startAt === undefined) startAt = len-1;
else startAt = (startAt < 0) ? Math.ceil(startAt) : Math.floor(startAt);
if (startAt < 0) startAt += len;
for(idx=startAt;idx>=0;idx--) {
if (this[idx] === object) return idx ;
}
return -1;
},
copy: function() {
return this.slice();
}
});
// Remove any methods implemented natively so we don't override them
var ignore = ['length'];
Ember.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 set to false, this will be applied automatically.
Otherwise you can apply the mixin at anytime by calling
`Ember.NativeArray.activate`.
@namespace
@extends Ember.MutableArray
@extends Ember.Array
@extends Ember.Enumerable
@extends Ember.MutableEnumerable
@extends Ember.Copyable
@extends Ember.Freezable
*/
Ember.NativeArray = NativeArray;
/**
Creates an Ember.NativeArray from an Array like object.
Does not modify the original object.
@returns {Ember.NativeArray}
*/
Ember.A = function(arr){
if (arr === undefined) { arr = []; }
return Ember.NativeArray.apply(arr);
};
/**
Activates the mixin on the Array.prototype if not already applied. Calling
this method more than once is safe.
@returns {void}
*/
Ember.NativeArray.activate = function() {
NativeArray.apply(Array.prototype);
Ember.A = function(arr) { return arr || []; };
};
if (Ember.EXTEND_PROTOTYPES) Ember.NativeArray.activate();
})();
(function() {
// ==========================================================================
// Project: Ember Runtime
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
var get = Ember.get, set = Ember.set;
Ember._PromiseChain = Ember.Object.extend({
promises: null,
failureCallback: Ember.K,
successCallback: Ember.K,
abortCallback: Ember.K,
promiseSuccessCallback: Ember.K,
/**
@private
*/
runNextPromise: function() {
if (get(this, 'isDestroyed')) { return; }
var item = get(this, 'promises').shiftObject();
if (item) {
var promise = get(item, 'promise') || item;
Ember.assert("Cannot find promise to invoke", Ember.canInvoke(promise, 'then'));
var self = this;
var successCallback = function() {
self.promiseSuccessCallback.call(this, item, arguments);
self.runNextPromise();
};
var failureCallback = get(self, 'failureCallback');
promise.then(successCallback, failureCallback);
} else {
this.successCallback();
}
},
start: function() {
this.runNextPromise();
return this;
},
abort: function() {
this.abortCallback();
this.destroy();
},
init: function() {
set(this, 'promises', Ember.A(get(this, 'promises')));
this._super();
}
});
})();
(function() {
var loadHooks = {};
var loaded = {};
Ember.onLoad = function(name, callback) {
var object;
loadHooks[name] = loadHooks[name] || Ember.A();
loadHooks[name].pushObject(callback);
if (object = loaded[name]) {
callback(object);
}
};
Ember.runLoadHooks = function(name, object) {
var hooks;
loaded[name] = object;
if (hooks = loadHooks[name]) {
loadHooks[name].forEach(function(callback) {
callback(object);
});
}
};
})();
(function() {
// ==========================================================================
// Project: Ember Runtime
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
})();
(function() {
Ember.ControllerMixin = Ember.Mixin.create({
/**
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`.
*/
target: null,
store: null
});
Ember.Controller = Ember.Object.extend(Ember.ControllerMixin);
})();
(function() {
var get = Ember.get, set = Ember.set, forEach = Ember.EnumerableUtils.forEach;
/**
@class
@extends Ember.Mixin
@extends Ember.MutableEnumerable
*/
Ember.SortableMixin = Ember.Mixin.create(Ember.MutableEnumerable,
/** @scope Ember.Observable.prototype */ {
sortProperties: null,
sortAscending: true,
addObject: function(obj) {
var content = get(this, 'content');
content.pushObject(obj);
},
removeObject: function(obj) {
var content = get(this, 'content');
content.removeObject(obj);
},
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('sortProperties', function() {
return !!get(this, '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;
}).cacheable(),
_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);
});
}
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);
var arrangedContent = get(this, 'arrangedContent');
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'),
index = arrangedContent.indexOf(item);
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() {
// ==========================================================================
// Project: Ember Runtime
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
var get = Ember.get, set = Ember.set;
/**
@class
Ember.ArrayController provides a way for you to publish a collection of objects
so that you can easily bind to the collection from a Handlebars #each helper,
an Ember.CollectionView, or other controllers.
The advantage of using an ArrayController is that you only have to set up
your view bindings once; to change what's displayed, simply swap out the
`content` property on the controller.
For example, imagine you wanted to display a list of items fetched via an XHR
request. Create an Ember.ArrayController and set its `content` property:
MyApp.listController = Ember.ArrayController.create();
$.get('people.json', function(data) {
MyApp.listController.set('content', data);
});
Then, create a view that binds to your new controller:
{{#each MyApp.listController}}
{{firstName}} {{lastName}}
{{/each}}
Although you are binding to the controller, the behavior of this controller
is to pass through any methods or properties to the underlying array. This
capability comes from `Ember.ArrayProxy`, which this class inherits from.
Note: As of this writing, `ArrayController` does not add any functionality
to its superclass, `ArrayProxy`. The Ember team plans to add additional
controller-specific functionality in the future, e.g. single or multiple
selection support. If you are creating something that is conceptually a
controller, use this class.
@extends Ember.ArrayProxy
*/
Ember.ArrayController = Ember.ArrayProxy.extend(Ember.ControllerMixin,
Ember.SortableMixin);
})();
(function() {
Ember.ObjectController = Ember.ObjectProxy.extend(Ember.ControllerMixin);
})();
(function() {
})();
(function() {
// ==========================================================================
// Project: Ember Runtime
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
})();
(function() {
// ==========================================================================
// Project: Ember - JavaScript Application Framework
// Copyright: ©2006-2011 Strobe Inc. and contributors.
// Portions ©2008-2011 Apple Inc. All rights reserved.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
var get = Ember.get, set = Ember.set;
/**
@class
An Ember.Application instance serves as the namespace in which you define your
application's classes. You can also override the configuration of your
application.
By default, Ember.Application will begin listening for events on the document.
If your application is embedded inside a page, instead of controlling the
entire document, you can specify which DOM element to attach to by setting
the `rootElement` property:
MyApp = Ember.Application.create({
rootElement: $('#my-app')
});
The root of an Ember.Application must not be removed during the course of the
page's lifetime. If you have only a single conceptual application for the
entire page, and are not embedding any third-party Ember applications
in your page, use the default document root for your application.
You only need to specify the root if your page contains multiple instances
of Ember.Application.
@extends Ember.Object
*/
Ember.Application = Ember.Namespace.extend(
/** @scope Ember.Application.prototype */{
/**
The root DOM element of the Application.
Can be specified as DOMElement or a selector string.
@type DOMElement
@default 'body'
*/
rootElement: 'body',
/**
@type Ember.EventDispatcher
@default null
*/
eventDispatcher: null,
/**
@type Object
@default null
*/
customEvents: null,
/** @private */
init: function() {
var eventDispatcher,
rootElement = get(this, 'rootElement');
this._super();
eventDispatcher = Ember.EventDispatcher.create({
rootElement: rootElement
});
set(this, 'eventDispatcher', eventDispatcher);
// jQuery 1.7 doesn't call the ready callback if already ready
if (Ember.$.isReady) {
Ember.run.once(this, this.didBecomeReady);
} else {
var self = this;
Ember.$(document).ready(function() {
Ember.run.once(self, self.didBecomeReady);
});
}
},
/**
Instantiate all controllers currently available on the namespace
and inject them onto a router.
Example:
App.PostsController = Ember.ArrayController.extend();
App.CommentsController = Ember.ArrayController.extend();
var router = Ember.Router.create({
...
});
App.initialize(router);
router.get('postsController') // <App.PostsController:ember1234>
router.get('commentsController') // <App.CommentsController:ember1235>
router.get('postsController.router') // router
*/
initialize: function(router) {
var properties = Ember.A(Ember.keys(this)),
injections = get(this.constructor, 'injections'),
namespace = this, controller, name;
if (!router && Ember.Router.detect(namespace['Router'])) {
router = namespace['Router'].create();
this._createdRouter = router;
}
if (router) {
set(this, 'router', router);
// By default, the router's namespace is the current application.
//
// This allows it to find model classes when a state has a
// route like `/posts/:post_id`. In that case, it would first
// convert `post_id` into `Post`, and then look it up on its
// namespace.
set(router, 'namespace', this);
}
Ember.runLoadHooks('application', this);
injections.forEach(function(injection) {
properties.forEach(function(property) {
injection[1](namespace, router, property);
});
});
if (router && router instanceof Ember.Router) {
this.startRouting(router);
}
},
/** @private */
didBecomeReady: function() {
var eventDispatcher = get(this, 'eventDispatcher'),
customEvents = get(this, 'customEvents');
eventDispatcher.setup(customEvents);
this.ready();
},
/**
@private
If the application has a router, use it to route to the current URL, and
trigger a new call to `route` whenever the URL changes.
*/
startRouting: function(router) {
var location = get(router, 'location'),
rootElement = get(this, 'rootElement'),
applicationController = get(router, 'applicationController');
Ember.assert("ApplicationView and ApplicationController must be defined on your application", (this.ApplicationView && applicationController) );
var applicationView = this.ApplicationView.create({
controller: applicationController
});
this._createdApplicationView = applicationView;
applicationView.appendTo(rootElement);
router.route(location.getURL());
location.onUpdateURL(function(url) {
router.route(url);
});
},
/**
Called when the Application has become ready.
The call will be delayed until the DOM has become ready.
*/
ready: Ember.K,
/** @private */
willDestroy: function() {
get(this, 'eventDispatcher').destroy();
if (this._createdRouter) { this._createdRouter.destroy(); }
if (this._createdApplicationView) { this._createdApplicationView.destroy(); }
},
registerInjection: function(options) {
this.constructor.registerInjection(options);
}
});
Ember.Application.reopenClass({
concatenatedProperties: ['injections'],
injections: Ember.A(),
registerInjection: function(options) {
var injections = get(this, 'injections'),
before = options.before,
name = options.name,
injection = options.injection,
location;
if (before) {
location = injections.find(function(item) {
if (item[0] === before) { return true; }
});
location = injections.indexOf(location);
} else {
location = get(injections, 'length');
}
injections.splice(location, 0, [name, injection]);
}
});
Ember.Application.registerInjection({
name: 'controllers',
injection: function(app, router, property) {
if (!/^[A-Z].*Controller$/.test(property)) { return; }
var name = property.charAt(0).toLowerCase() + property.substr(1),
controller = app[property].create();
router.set(name, controller);
controller.setProperties({
target: router,
controllers: router,
namespace: app
});
}
});
})();
(function() {
var get = Ember.get, set = Ember.set;
/**
This file implements the `location` API used by Ember's router.
That API is:
getURL: returns the current URL
setURL(path): sets the current URL
onUpdateURL(callback): triggers the callback when the URL changes
formatURL(url): formats `url` to be placed into `href` attribute
Calling setURL will not trigger onUpdateURL callbacks.
TODO: This, as well as the Ember.Location documentation below, should
perhaps be moved so that it's visible in the JsDoc output.
*/
/**
@class
Ember.Location returns an instance of the correct implementation of
the `location` API.
You can pass it a `implementation` ('hash', 'history', 'none') to force a
particular implementation.
*/
Ember.Location = {
create: function(options) {
var implementation = options && options.implementation;
Ember.assert("Ember.Location.create: you must specify a 'implementation' option", !!implementation);
var implementationClass = this.implementations[implementation];
Ember.assert("Ember.Location.create: " + implementation + " is not a valid implementation", !!implementationClass);
return implementationClass.create.apply(implementationClass, arguments);
},
registerImplementation: function(name, implementation) {
this.implementations[name] = implementation;
},
implementations: {}
};
})();
(function() {
var get = Ember.get, set = Ember.set;
/**
@class
Ember.HashLocation implements the location API using the browser's
hash. At present, it relies on a hashchange event existing in the
browser.
@extends Ember.Object
*/
Ember.HashLocation = Ember.Object.extend(
/** @scope Ember.HashLocation.prototype */ {
/** @private */
init: function() {
set(this, 'location', get(this, 'location') || window.location);
},
/**
@private
Returns the current `location.hash`, minus the '#' at the front.
*/
getURL: function() {
return get(this, 'location').hash.substr(1);
},
/**
@private
Set the `location.hash` and remembers what was set. This prevents
`onUpdateURL` callbacks from triggering when the hash was set by
`HashLocation`.
*/
setURL: function(path) {
get(this, 'location').hash = path;
set(this, 'lastSetURL', path);
},
/**
@private
Register a callback to be invoked when the hash changes. These
callbacks will execute when the user presses the back or forward
button, but not after `setURL` is invoked.
*/
onUpdateURL: function(callback) {
var self = this;
var guid = Ember.guidFor(this);
Ember.$(window).bind('hashchange.ember-location-'+guid, function() {
var path = location.hash.substr(1);
if (get(self, 'lastSetURL') === path) { return; }
set(self, 'lastSetURL', null);
callback(location.hash.substr(1));
});
},
/**
@private
Given a URL, formats it to be placed into the page as part
of an element's `href` attribute.
This is used, for example, when using the {{action}} helper
to generate a URL based on an event.
*/
formatURL: function(url) {
return '#'+url;
},
/** @private */
willDestroy: function() {
var guid = Ember.guidFor(this);
Ember.$(window).unbind('hashchange.ember-location-'+guid);
}
});
Ember.Location.registerImplementation('hash', Ember.HashLocation);
})();
(function() {
var get = Ember.get, set = Ember.set;
/**
@class
Ember.HistoryLocation implements the location API using the browser's
history.pushState API.
@extends Ember.Object
*/
Ember.HistoryLocation = Ember.Object.extend(
/** @scope Ember.HistoryLocation.prototype */ {
/** @private */
init: function() {
set(this, 'location', get(this, 'location') || window.location);
set(this, '_initialURL', get(this, 'location').pathname);
},
/**
Will be pre-pended to path upon state change
*/
rootURL: '/',
/**
@private
Used to give history a starting reference
*/
_initialURL: null,
/**
@private
Returns the current `location.pathname`.
*/
getURL: function() {
return get(this, 'location').pathname;
},
/**
@private
Uses `history.pushState` to update the url without a page reload.
*/
setURL: function(path) {
var state = window.history.state,
initialURL = get(this, '_initialURL');
path = this.formatPath(path);
if ((initialURL !== path && !state) || (state && state.path !== path)) {
window.history.pushState({ path: path }, null, path);
}
},
/**
@private
Register a callback to be invoked whenever the browser
history changes, including using forward and back buttons.
*/
onUpdateURL: function(callback) {
var guid = Ember.guidFor(this);
Ember.$(window).bind('popstate.ember-location-'+guid, function(e) {
callback(location.pathname);
});
},
/**
@private
returns the given path appended to rootURL
*/
formatPath: function(path) {
var rootURL = get(this, 'rootURL');
if (path !== '') {
rootURL = rootURL.replace(/\/$/, '');
}
return rootURL + path;
},
/**
@private
Used when using {{action}} helper. Since no formatting
is required we just return the url given.
*/
formatURL: function(url) {
return url;
},
/** @private */
willDestroy: function() {
var guid = Ember.guidFor(this);
Ember.$(window).unbind('popstate.ember-location-'+guid);
}
});
Ember.Location.registerImplementation('history', Ember.HistoryLocation);
})();
(function() {
var get = Ember.get, set = Ember.set;
/**
@class
Ember.NoneLocation does not interact with the browser. It is useful for
testing, or when you need to manage state with your Router, but temporarily
don't want it to muck with the URL (for example when you embed your
application in a larger page).
@extends Ember.Object
*/
Ember.NoneLocation = Ember.Object.extend(
/** @scope Ember.NoneLocation.prototype */ {
path: '',
getURL: function() {
return get(this, 'path');
},
setURL: function(path) {
set(this, 'path', path);
},
onUpdateURL: function(callback) {
// We are not wired up to the browser, so we'll never trigger the callback.
},
formatURL: function(url) {
// The return value is not overly meaningful, but we do not want to throw
// errors when test code renders templates containing {{action href=true}}
// helpers.
return url;
}
});
Ember.Location.registerImplementation('none', Ember.NoneLocation);
})();
(function() {
})();
(function() {
})();
(function() {
// ==========================================================================
// Project: Ember - JavaScript Application Framework
// Copyright: ©2006-2011 Strobe Inc. and contributors.
// Portions ©2008-2011 Apple Inc. All rights reserved.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
Ember.assert("Ember Views require jQuery 1.7", window.jQuery && (window.jQuery().jquery.match(/^1\.7(\.\d+)?(pre|rc\d?)?/) || Ember.ENV.FORCE_JQUERY));
Ember.$ = window.jQuery;
})();
(function() {
// ==========================================================================
// Project: Ember - JavaScript Application Framework
// Copyright: ©2006-2011 Strobe Inc. and contributors.
// Portions ©2008-2011 Apple Inc. All rights reserved.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
// http://www.whatwg.org/specs/web-apps/current-work/multipage/dnd.html#dndevents
var dragEvents = Ember.String.w('dragstart drag dragenter dragleave dragover drop dragend');
// Copies the `dataTransfer` property from a browser event object onto the
// jQuery event object for the specified events
Ember.EnumerableUtils.forEach(dragEvents, function(eventName) {
Ember.$.event.fixHooks[eventName] = { props: ['dataTransfer'] };
});
})();
(function() {
// ==========================================================================
// Project: Ember - JavaScript Application Framework
// Copyright: ©2006-2011 Strobe Inc. and contributors.
// Portions ©2008-2011 Apple Inc. All rights reserved.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
var get = Ember.get, set = Ember.set;
var indexOf = Ember.ArrayPolyfills.indexOf;
/** @private */
var ClassSet = function() {
this.seen = {};
this.list = [];
};
ClassSet.prototype = {
add: function(string) {
if (string in this.seen) { return; }
this.seen[string] = true;
this.list.push(string);
},
toDOM: function() {
return this.list.join(" ");
}
};
/**
@class
Ember.RenderBuffer gathers information regarding the a view and generates the
final representation. Ember.RenderBuffer will generate HTML which can be pushed
to the DOM.
@extends Ember.Object
*/
Ember.RenderBuffer = function(tagName) {
return new Ember._RenderBuffer(tagName);
};
Ember._RenderBuffer = function(tagName) {
this.elementTag = tagName;
this.childBuffers = [];
};
Ember._RenderBuffer.prototype =
/** @scope Ember.RenderBuffer.prototype */ {
/**
Array of class-names which will be applied in the class="" attribute
You should not maintain this array yourself, rather, you should use
the addClass() method of Ember.RenderBuffer.
@type Array
@default []
*/
elementClasses: null,
/**
The id in of the element, to be applied in the id="" attribute
You should not set this property yourself, rather, you should use
the id() method of Ember.RenderBuffer.
@type String
@default null
*/
elementId: null,
/**
A hash keyed on the name of the attribute and whose value will be
applied to that attribute. For example, if you wanted to apply a
data-view="Foo.bar" property to an element, you would set the
elementAttributes hash to {'data-view':'Foo.bar'}
You should not maintain this hash yourself, rather, you should use
the attr() method of Ember.RenderBuffer.
@type Hash
@default {}
*/
elementAttributes: null,
/**
The tagname of the element an instance of Ember.RenderBuffer represents.
Usually, this gets set as the first parameter to Ember.RenderBuffer. For
example, if you wanted to create a `p` tag, then you would call
Ember.RenderBuffer('p')
@type String
@default null
*/
elementTag: null,
/**
A hash keyed on the name of the style attribute and whose value will
be applied to that attribute. For example, if you wanted to apply a
background-color:black;" style to an element, you would set the
elementStyle hash to {'background-color':'black'}
You should not maintain this hash yourself, rather, you should use
the style() method of Ember.RenderBuffer.
@type Hash
@default {}
*/
elementStyle: null,
/**
Nested RenderBuffers will set this to their parent RenderBuffer
instance.
@type Ember._RenderBuffer
*/
parentBuffer: null,
/**
Adds a string of HTML to the RenderBuffer.
@param {String} string HTML to push into the buffer
@returns {Ember.RenderBuffer} this
*/
push: function(string) {
this.childBuffers.push(String(string));
return this;
},
/**
Adds a class to the buffer, which will be rendered to the class attribute.
@param {String} className Class name to add to the buffer
@returns {Ember.RenderBuffer} this
*/
addClass: function(className) {
// lazily create elementClasses
var elementClasses = this.elementClasses = (this.elementClasses || new ClassSet());
this.elementClasses.add(className);
return this;
},
/**
Sets the elementID to be used for the element.
@param {String} id
@returns {Ember.RenderBuffer} this
*/
id: function(id) {
this.elementId = id;
return this;
},
// duck type attribute functionality like jQuery so a render buffer
// can be used like a jQuery object in attribute binding scenarios.
/**
Adds an attribute which will be rendered to the element.
@param {String} name The name of the attribute
@param {String} value The value to add to the attribute
@returns {Ember.RenderBuffer|String} this or the current attribute value
*/
attr: function(name, value) {
var attributes = this.elementAttributes = (this.elementAttributes || {});
if (arguments.length === 1) {
return attributes[name];
} else {
attributes[name] = value;
}
return this;
},
/**
Remove an attribute from the list of attributes to render.
@param {String} name The name of the attribute
@returns {Ember.RenderBuffer} this
*/
removeAttr: function(name) {
var attributes = this.elementAttributes;
if (attributes) { delete attributes[name]; }
return this;
},
/**
Adds a style to the style attribute which will be rendered to the element.
@param {String} name Name of the style
@param {String} value
@returns {Ember.RenderBuffer} this
*/
style: function(name, value) {
var style = this.elementStyle = (this.elementStyle || {});
this.elementStyle[name] = value;
return this;
},
/**
Create a new child render buffer from a parent buffer. Optionally set
additional properties on the buffer. Optionally invoke a callback
with the newly created buffer.
This is a primitive method used by other public methods: `begin`,
`prepend`, `replaceWith`, `insertAfter`.
@private
@param {String} tagName Tag name to use for the child buffer's element
@param {Ember._RenderBuffer} parent The parent render buffer that this
buffer should be appended to.
@param {Function} fn A callback to invoke with the newly created buffer.
@param {Object} other Additional properties to add to the newly created
buffer.
*/
newBuffer: function(tagName, parent, fn, other) {
var buffer = new Ember._RenderBuffer(tagName);
buffer.parentBuffer = parent;
if (other) { Ember.$.extend(buffer, other); }
if (fn) { fn.call(this, buffer); }
return buffer;
},
/**
Replace the current buffer with a new buffer. This is a primitive
used by `remove`, which passes `null` for `newBuffer`, and `replaceWith`,
which passes the new buffer it created.
@private
@param {Ember._RenderBuffer} buffer The buffer to insert in place of
the existing buffer.
*/
replaceWithBuffer: function(newBuffer) {
var parent = this.parentBuffer;
if (!parent) { return; }
var childBuffers = parent.childBuffers;
var index = indexOf.call(childBuffers, this);
if (newBuffer) {
childBuffers.splice(index, 1, newBuffer);
} else {
childBuffers.splice(index, 1);
}
},
/**
Creates a new Ember.RenderBuffer object with the provided tagName as
the element tag and with its parentBuffer property set to the current
Ember.RenderBuffer.
@param {String} tagName Tag name to use for the child buffer's element
@returns {Ember.RenderBuffer} A new RenderBuffer object
*/
begin: function(tagName) {
return this.newBuffer(tagName, this, function(buffer) {
this.childBuffers.push(buffer);
});
},
/**
Prepend a new child buffer to the current render buffer.
@param {String} tagName Tag name to use for the child buffer's element
*/
prepend: function(tagName) {
return this.newBuffer(tagName, this, function(buffer) {
this.childBuffers.splice(0, 0, buffer);
});
},
/**
Replace the current buffer with a new render buffer.
@param {String} tagName Tag name to use for the new buffer's element
*/
replaceWith: function(tagName) {
var parentBuffer = this.parentBuffer;
return this.newBuffer(tagName, parentBuffer, function(buffer) {
this.replaceWithBuffer(buffer);
});
},
/**
Insert a new render buffer after the current render buffer.
@param {String} tagName Tag name to use for the new buffer's element
*/
insertAfter: function(tagName) {
var parentBuffer = get(this, 'parentBuffer');
return this.newBuffer(tagName, parentBuffer, function(buffer) {
var siblings = parentBuffer.childBuffers;
var index = indexOf.call(siblings, this);
siblings.splice(index + 1, 0, buffer);
});
},
/**
Closes the current buffer and adds its content to the parentBuffer.
@returns {Ember.RenderBuffer} The parentBuffer, if one exists. Otherwise, this
*/
end: function() {
var parent = this.parentBuffer;
return parent || this;
},
remove: function() {
this.replaceWithBuffer(null);
},
/**
@returns {DOMElement} The element corresponding to the generated HTML
of this buffer
*/
element: function() {
return Ember.$(this.string())[0];
},
/**
Generates the HTML content for this buffer.
@returns {String} The generated HTMl
*/
string: function() {
var content = '', tag = this.elementTag, openTag;
if (tag) {
var id = this.elementId,
classes = this.elementClasses,
attrs = this.elementAttributes,
style = this.elementStyle,
styleBuffer = '', prop;
openTag = ["<" + tag];
if (id) { openTag.push('id="' + this._escapeAttribute(id) + '"'); }
if (classes) { openTag.push('class="' + this._escapeAttribute(classes.toDOM()) + '"'); }
if (style) {
for (prop in style) {
if (style.hasOwnProperty(prop)) {
styleBuffer += (prop + ':' + this._escapeAttribute(style[prop]) + ';');
}
}
openTag.push('style="' + styleBuffer + '"');
}
if (attrs) {
for (prop in attrs) {
if (attrs.hasOwnProperty(prop)) {
openTag.push(prop + '="' + this._escapeAttribute(attrs[prop]) + '"');
}
}
}
openTag = openTag.join(" ") + '>';
}
var childBuffers = this.childBuffers;
Ember.ArrayPolyfills.forEach.call(childBuffers, function(buffer) {
var stringy = typeof buffer === 'string';
content += (stringy ? buffer : buffer.string());
});
if (tag) {
return openTag + content + "</" + tag + ">";
} else {
return content;
}
},
_escapeAttribute: function(value) {
// Stolen shamelessly from Handlebars
var escape = {
"<": "&lt;",
">": "&gt;",
'"': "&quot;",
"'": "&#x27;",
"`": "&#x60;"
};
var badChars = /&(?!\w+;)|[<>"'`]/g;
var possible = /[&<>"'`]/;
var escapeChar = function(chr) {
return escape[chr] || "&amp;";
};
var string = value.toString();
if(!possible.test(string)) { return string; }
return string.replace(badChars, escapeChar);
}
};
})();
(function() {
// ==========================================================================
// Project: Ember - JavaScript Application Framework
// Copyright: ©2006-2011 Strobe Inc. and contributors.
// Portions ©2008-2011 Apple Inc. All rights reserved.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
var get = Ember.get, set = Ember.set, fmt = Ember.String.fmt;
/**
@ignore
Ember.EventDispatcher handles delegating browser events to their corresponding
Ember.Views. For example, when you click on a view, Ember.EventDispatcher ensures
that that view's `mouseDown` method gets called.
*/
Ember.EventDispatcher = Ember.Object.extend(
/** @scope Ember.EventDispatcher.prototype */{
/**
@private
The root DOM element to which event listeners should be attached. Event
listeners will be attached to the document unless this is overridden.
Can be specified as a DOMElement or a selector string.
The default body is a string since this may be evaluated before document.body
exists in the DOM.
@type DOMElement
@default 'body'
*/
rootElement: 'body',
/**
@private
Sets up event listeners for standard browser events.
This will be called after the browser sends a DOMContentReady event. By
default, it will set up all of the listeners on the document body. If you
would like to register the listeners on a different element, set the event
dispatcher's `root` property.
*/
setup: function(addedEvents) {
var event, events = {
touchstart : 'touchStart',
touchmove : 'touchMove',
touchend : 'touchEnd',
touchcancel : 'touchCancel',
keydown : 'keyDown',
keyup : 'keyUp',
keypress : 'keyPress',
mousedown : 'mouseDown',
mouseup : 'mouseUp',
contextmenu : 'contextMenu',
click : 'click',
dblclick : 'doubleClick',
mousemove : 'mouseMove',
focusin : 'focusIn',
focusout : 'focusOut',
mouseenter : 'mouseEnter',
mouseleave : 'mouseLeave',
submit : 'submit',
input : 'input',
change : 'change',
dragstart : 'dragStart',
drag : 'drag',
dragenter : 'dragEnter',
dragleave : 'dragLeave',
dragover : 'dragOver',
drop : 'drop',
dragend : 'dragEnd'
};
Ember.$.extend(events, addedEvents || {});
var rootElement = Ember.$(get(this, 'rootElement'));
Ember.assert(fmt('You cannot use the same root element (%@) multiple times in an Ember.Application', [rootElement.selector || rootElement[0].tagName]), !rootElement.is('.ember-application'));
Ember.assert('You cannot make a new Ember.Application using a root element that is a descendent of an existing Ember.Application', !rootElement.closest('.ember-application').length);
Ember.assert('You cannot make a new Ember.Application using a root element that is an ancestor of an existing Ember.Application', !rootElement.find('.ember-application').length);
rootElement.addClass('ember-application');
Ember.assert('Unable to add "ember-application" class to rootElement. Make sure you set rootElement to the body or an element in the body.', rootElement.is('.ember-application'));
for (event in events) {
if (events.hasOwnProperty(event)) {
this.setupHandler(rootElement, event, events[event]);
}
}
},
/**
@private
Registers an event listener on the document. If the given event is
triggered, the provided event handler will be triggered on the target
view.
If the target view does not implement the event handler, or if the handler
returns false, the parent view will be called. The event will continue to
bubble to each successive parent view until it reaches the top.
For example, to have the `mouseDown` method called on the target view when
a `mousedown` event is received from the browser, do the following:
setupHandler('mousedown', 'mouseDown');
@param {String} event the browser-originated event to listen to
@param {String} eventName the name of the method to call on the view
*/
setupHandler: function(rootElement, event, eventName) {
var self = this;
rootElement.delegate('.ember-view', event + '.ember', function(evt, triggeringManager) {
var view = Ember.View.views[this.id],
result = true, manager = null;
manager = self._findNearestEventManager(view,eventName);
if (manager && manager !== triggeringManager) {
result = self._dispatchEvent(manager, evt, eventName, view);
} else if (view) {
result = self._bubbleEvent(view,evt,eventName);
} else {
evt.stopPropagation();
}
return result;
});
rootElement.delegate('[data-ember-action]', event + '.ember', function(evt) {
var actionId = Ember.$(evt.currentTarget).attr('data-ember-action'),
action = Ember.Handlebars.ActionHelper.registeredActions[actionId],
handler = action.handler;
if (action.eventName === eventName) {
return handler(evt);
}
});
},
/** @private */
_findNearestEventManager: function(view, eventName) {
var manager = null;
while (view) {
manager = get(view, 'eventManager');
if (manager && manager[eventName]) { break; }
view = get(view, 'parentView');
}
return manager;
},
/** @private */
_dispatchEvent: function(object, evt, eventName, view) {
var result = true;
var handler = object[eventName];
if (Ember.typeOf(handler) === 'function') {
result = handler.call(object, evt, view);
// Do not preventDefault in eventManagers.
evt.stopPropagation();
}
else {
result = this._bubbleEvent(view, evt, eventName);
}
return result;
},
/** @private */
_bubbleEvent: function(view, evt, eventName) {
return Ember.run(function() {
return view.handleEvent(eventName, evt);
});
},
/** @private */
destroy: function() {
var rootElement = get(this, 'rootElement');
Ember.$(rootElement).undelegate('.ember').removeClass('ember-application');
return this._super();
}
});
})();
(function() {
// ==========================================================================
// Project: Ember - JavaScript Application Framework
// Copyright: ©2006-2011 Strobe Inc. and contributors.
// Portions ©2008-2011 Apple Inc. All rights reserved.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
// Add a new named queue for rendering views that happens
// after bindings have synced.
var queues = Ember.run.queues;
queues.splice(Ember.$.inArray('actions', queues)+1, 0, 'render');
})();
(function() {
var get = Ember.get, set = Ember.set;
Ember.ControllerMixin.reopen({
target: null,
controllers: null,
namespace: null,
view: null,
/**
`connectOutlet` creates a new instance of a provided view
class, wires it up to its associated controller, and
assigns the new view to a property on the current controller.
The purpose of this method is to enable views that use
outlets to quickly assign new views for a given outlet.
For example, an application view's template may look like
this:
<h1>My Blog</h1>
{{outlet}}
The view for this outlet is specified by assigning a
`view` property to the application's controller. The
following code will assign a new `App.PostsView` to
that outlet:
applicationController.connectOutlet('posts');
In general, you will also want to assign a controller
to the newly created view. By convention, a controller
named `postsController` will be assigned as the view's
controller.
In an application initialized using `app.initialize(router)`,
`connectOutlet` will look for `postsController` on the
router. The initialization process will automatically
create an instance of `App.PostsController` called
`postsController`, so you don't need to do anything
beyond `connectOutlet` to assign your view and wire it
up to its associated controller.
You can supply a `content` for the controller by supplying
a final argument after the view class:
applicationController.connectOutlet('posts', App.Post.find());
You can specify a particular outlet to use. For example, if your main
template looks like:
<h1>My Blog</h1>
{{outlet master}}
{{outlet detail}}
You can assign an `App.PostsView` to the master outlet:
applicationController.connectOutlet({
name: 'posts',
outletName: 'master',
context: App.Post.find()
});
You can write this as:
applicationController.connectOutlet('master', 'posts', App.Post.find());
@param {String} outletName a name for the outlet to set
@param {String} name a view/controller pair name
@param {Object} context a context object to assign to the
controller's `content` property, if a controller can be
found (optional)
*/
connectOutlet: function(name, context) {
// Normalize arguments. Supported arguments:
//
// name
// name, context
// outletName, name
// outletName, name, context
// options
//
// The options hash has the following keys:
//
// name: the name of the controller and view
// to use. If this is passed, the name
// determines the view and controller.
// outletName: the name of the outlet to
// fill in. default: 'view'
// viewClass: the class of the view to instantiate
// controller: the controller instance to pass
// to the view
// context: an object that should become the
// controller's `content` and thus the
// template's context.
var outletName, viewClass, view, controller, options;
if (Ember.typeOf(context) === 'string') {
outletName = name;
name = context;
context = arguments[2];
}
if (arguments.length === 1) {
if (Ember.typeOf(name) === 'object') {
options = name;
outletName = options.outletName;
name = options.name;
viewClass = options.viewClass;
controller = options.controller;
context = options.context;
}
} else {
options = {};
}
outletName = outletName || 'view';
Ember.assert("You must supply a name or a view class to connectOutlets, but not both", (!!name && !viewClass && !controller) || (!name && !!viewClass));
if (name) {
var namespace = get(this, 'namespace'),
controllers = get(this, 'controllers');
var viewClassName = name.charAt(0).toUpperCase() + name.substr(1) + "View";
viewClass = get(namespace, viewClassName);
controller = get(controllers, name + 'Controller');
Ember.assert("The name you supplied " + name + " did not resolve to a view " + viewClassName, !!viewClass);
Ember.assert("The name you supplied " + name + " did not resolve to a controller " + name + 'Controller', (!!controller && !!context) || !context);
}
if (controller && context) { controller.set('content', context); }
view = viewClass.create();
if (controller) { set(view, 'controller', controller); }
set(this, outletName, view);
return view;
},
/**
Convenience method to connect controllers. This method makes other controllers
available on the controller the method was invoked on.
For example, to make the `personController` and the `postController` available
on the `overviewController`, you would call:
overviewController.connectControllers('person', 'post');
@param {String...} controllerNames the controllers to make available
*/
connectControllers: function() {
var controllers = get(this, 'controllers'),
controllerNames = Array.prototype.slice.apply(arguments),
controllerName;
for (var i=0, l=controllerNames.length; i<l; i++) {
controllerName = controllerNames[i] + 'Controller';
set(this, controllerName, get(controllers, controllerName));
}
}
});
})();
(function() {
// ==========================================================================
// Project: Ember - JavaScript Application Framework
// Copyright: ©2006-2011 Strobe Inc. and contributors.
// Portions ©2008-2011 Apple Inc. All rights reserved.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
})();
(function() {
// ==========================================================================
// Project: Ember - JavaScript Application Framework
// Copyright: ©2006-2011 Strobe Inc. and contributors.
// Portions ©2008-2011 Apple Inc. All rights reserved.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
var get = Ember.get, set = Ember.set, addObserver = Ember.addObserver;
var meta = Ember.meta, fmt = Ember.String.fmt;
var a_slice = [].slice;
var a_forEach = Ember.EnumerableUtils.forEach;
var childViewsProperty = Ember.computed(function() {
var childViews = this._childViews;
var ret = Ember.A();
a_forEach(childViews, function(view) {
if (view.isVirtual) {
ret.pushObjects(get(view, 'childViews'));
} else {
ret.push(view);
}
});
return ret;
}).property().cacheable();
var VIEW_PRESERVES_CONTEXT = Ember.VIEW_PRESERVES_CONTEXT;
Ember.warn("The way that the {{view}} helper affects templates is about to change. Previously, templates inside child views would use the new view as the context. Soon, views will preserve their parent context when rendering their template. You can opt-in early to the new behavior by setting `ENV.VIEW_PRESERVES_CONTEXT = true`. For more information, see https://gist.github.com/2494968. You should update your templates as soon as possible; this default will change soon, and the option will be eliminated entirely before the 1.0 release.", VIEW_PRESERVES_CONTEXT);
/**
@static
Global hash of shared templates. This will automatically be populated
by the build tools so that you can store your Handlebars templates in
separate files that get loaded into JavaScript at buildtime.
@type Hash
*/
Ember.TEMPLATES = {};
var invokeForState = {
preRender: {},
inBuffer: {},
hasElement: {},
inDOM: {},
destroyed: {}
};
/**
@class
`Ember.View` is the class in Ember responsible for encapsulating templates of HTML
content, combining templates with data to render as sections of a page's DOM, and
registering and responding to user-initiated events.
## HTML Tag
The default HTML tag name used for a view's DOM representation is `div`. This can be
customized by setting the `tagName` property. The following view class:
ParagraphView = Ember.View.extend({
tagName: 'em'
})
Would result in instances with the following HTML:
<em id="ember1" class="ember-view"></em>
## HTML `class` Attribute
The HTML `class` attribute of a view's tag can be set by providing a `classNames` property
that is set to an array of strings:
MyView = Ember.View.extend({
classNames: ['my-class', 'my-other-class']
})
Will result in view instances with an HTML representation of:
<div id="ember1" class="ember-view my-class my-other-class"></div>
`class` attribute values can also be set by providing a `classNameBindings` property
set to an array of properties names for the view. The return value of these properties
will be added as part of the value for the view's `class` attribute. These properties
can be computed properties:
MyView = Ember.View.extend({
classNameBindings: ['propertyA', 'propertyB'],
propertyA: 'from-a',
propertyB: function(){
if(someLogic){ return 'from-b'; }
}.property()
})
Will result in view instances with an HTML representation of:
<div id="ember1" class="ember-view from-a from-b"></div>
If the value of a class name binding returns a boolean the property name itself
will be used as the class name if the property is true. The class name will
not be added if the value is `false` or `undefined`.
MyView = Ember.View.extend({
classNameBindings: ['hovered'],
hovered: true
})
Will result in view instances with an HTML representation of:
<div id="ember1" class="ember-view hovered"></div>
When using boolean class name bindings you can supply a string value other than the
property name for use as the `class` HTML attribute by appending the preferred value after
a ":" character when defining the binding:
MyView = Ember.View.extend({
classNameBindings: ['awesome:so-very-cool'],
awesome: true
})
Will result in view instances with an HTML representation of:
<div id="ember1" class="ember-view so-very-cool"></div>
Boolean value class name bindings whose property names are in a camelCase-style
format will be converted to a dasherized format:
MyView = Ember.View.extend({
classNameBindings: ['isUrgent'],
isUrgent: true
})
Will result in view instances with an HTML representation of:
<div id="ember1" class="ember-view is-urgent"></div>
Class name bindings can also refer to object values that are found by
traversing a path relative to the view itself:
MyView = Ember.View.extend({
classNameBindings: ['messages.empty']
messages: Ember.Object.create({
empty: true
})
})
Will result in view instances with an HTML representation of:
<div id="ember1" class="ember-view empty"></div>
If you want to add a class name for a property which evaluates to true and
and a different class name if it evaluates to false, you can pass a binding
like this:
// Applies 'enabled' class when isEnabled is true and 'disabled' when isEnabled is false
Ember.View.create({
classNameBindings: ['isEnabled:enabled:disabled']
isEnabled: true
});
Will result in view instances with an HTML representation of:
<div id="ember1" class="ember-view enabled"></div>
When isEnabled is `false`, the resulting HTML reprensentation looks like this:
<div id="ember1" class="ember-view disabled"></div>
This syntax offers the convenience to add a class if a property is `false`:
// Applies no class when isEnabled is true and class 'disabled' when isEnabled is false
Ember.View.create({
classNameBindings: ['isEnabled::disabled']
isEnabled: true
});
Will result in view instances with an HTML representation of:
<div id="ember1" class="ember-view"></div>
When the `isEnabled` property on the view is set to `false`, it will result
in view instances with an HTML representation of:
<div id="ember1" class="ember-view disabled"></div>
Updates to the the value of a class name binding will result in automatic update
of the HTML `class` attribute in the view's rendered HTML representation.
If the value becomes `false` or `undefined` the class name will be removed.
Both `classNames` and `classNameBindings` are concatenated properties.
See `Ember.Object` documentation for more information about concatenated properties.
## HTML Attributes
The HTML attribute section of a view's tag can be set by providing an `attributeBindings`
property set to an array of property names on the view. The return value of these properties
will be used as the value of the view's HTML associated attribute:
AnchorView = Ember.View.extend({
tagName: 'a',
attributeBindings: ['href'],
href: 'http://google.com'
})
Will result in view instances with an HTML representation of:
<a id="ember1" class="ember-view" href="http://google.com"></a>
If the return value of an `attributeBindings` monitored property is a boolean
the property will follow HTML's pattern of repeating the attribute's name as
its value:
MyTextInput = Ember.View.extend({
tagName: 'input',
attributeBindings: ['disabled'],
disabled: true
})
Will result in view instances with an HTML representation of:
<input id="ember1" class="ember-view" disabled="disabled" />
`attributeBindings` can refer to computed properties:
MyTextInput = Ember.View.extend({
tagName: 'input',
attributeBindings: ['disabled'],
disabled: function(){
if (someLogic) {
return true;
} else {
return false;
}
}.property()
})
Updates to the the property of an attribute binding will result in automatic update
of the HTML attribute in the view's rendered HTML representation.
`attributeBindings` is a concatenated property. See `Ember.Object` documentation
for more information about concatenated properties.
## Templates
The HTML contents of a view's rendered representation are determined by its template.
Templates can be any function that accepts an optional context parameter and returns
a string of HTML that will be inserted within the view's tag. Most
typically in Ember this function will be a compiled Ember.Handlebars template.
AView = Ember.View.extend({
template: Ember.Handlebars.compile('I am the template')
})
Will result in view instances with an HTML representation of:
<div id="ember1" class="ember-view">I am the template</div>
The default context of the compiled template will be the view instance itself:
AView = Ember.View.extend({
template: Ember.Handlebars.compile('Hello {{excitedGreeting}}')
})
aView = AView.create({
content: Ember.Object.create({
firstName: 'Barry'
})
excitedGreeting: function(){
return this.get("content.firstName") + "!!!"
}
})
Will result in an HTML representation of:
<div id="ember1" class="ember-view">Hello Barry!!!</div>
Within an Ember application is more common to define a Handlebars templates as
part of a page:
<script type='text/x-handlebars' data-template-name='some-template'>
Hello
</script>
And associate it by name using a view's `templateName` property:
AView = Ember.View.extend({
templateName: 'some-template'
})
Using a value for `templateName` that does not have a Handlebars template with a
matching `data-template-name` attribute will throw an error.
Assigning a value to both `template` and `templateName` properties will throw an error.
For views classes that may have a template later defined (e.g. as the block portion of a `{{view}}`
Handlebars helper call in another template or in a subclass), you can provide a `defaultTemplate`
property set to compiled template function. If a template is not later provided for the view
instance the `defaultTemplate` value will be used:
AView = Ember.View.extend({
defaultTemplate: Ember.Handlebars.compile('I was the default'),
template: null,
templateName: null
})
Will result in instances with an HTML representation of:
<div id="ember1" class="ember-view">I was the default</div>
If a `template` or `templateName` is provided it will take precedence over `defaultTemplate`:
AView = Ember.View.extend({
defaultTemplate: Ember.Handlebars.compile('I was the default')
})
aView = AView.create({
template: Ember.Handlebars.compile('I was the template, not default')
})
Will result in the following HTML representation when rendered:
<div id="ember1" class="ember-view">I was the template, not default</div>
## Layouts
Views can have a secondary template that wraps their main template. Like
primary templates, layouts can be any function that accepts an optional context
parameter and returns a string of HTML that will be inserted inside view's tag. Views whose HTML
element is self closing (e.g. `<input />`) cannot have a layout and this property will be ignored.
Most typically in Ember a layout will be a compiled Ember.Handlebars template.
A view's layout can be set directly with the `layout` property or reference an
existing Handlebars template by name with the `layoutName` property.
A template used as a layout must contain a single use of the Handlebars `{{yield}}`
helper. The HTML contents of a view's rendered `template` will be inserted at this location:
AViewWithLayout = Ember.View.extend({
layout: Ember.Handlebars.compile("<div class='my-decorative-class'>{{yield}}</div>")
template: Ember.Handlebars.compile("I got wrapped"),
})
Will result in view instances with an HTML representation of:
<div id="ember1" class="ember-view">
<div class="my-decorative-class">
I got wrapped
</div>
</div>
See `Handlebars.helpers.yield` for more information.
## Responding to Browser Events
Views can respond to user-initiated events in one of three ways: method implementation,
through an event manager, and through `{{action}}` helper use in their template or layout.
### Method Implementation
Views can respond to user-initiated events by implementing a method that matches the
event name. A `jQuery.Event` object will be passed as the argument to this method.
AView = Ember.View.extend({
click: function(event){
// will be called when when an instance's
// rendered element is clicked
}
})
### Event Managers
Views can define an object as their `eventManager` property. This object can then
implement methods that match the desired event names. Matching events that occur
on the view's rendered HTML or the rendered HTML of any of its DOM descendants
will trigger this method. A `jQuery.Event` object will be passed as the first
argument to the method and an `Ember.View` object as the second. The `Ember.View`
will be the view whose rendered HTML was interacted with. This may be the view with
the `eventManager` property or one of its descendent views.
AView = Ember.View.extend({
eventManager: Ember.Object.create({
doubleClick: function(event, view){
// will be called when when an instance's
// rendered element or any rendering
// of this views's descendent
// elements is clicked
}
})
})
An event defined for an event manager takes precedence over events of the same
name handled through methods on the view.
AView = Ember.View.extend({
mouseEnter: function(event){
// will never trigger.
},
eventManager: Ember.Object.create({
mouseEnter: function(event, view){
// takes presedence over AView#mouseEnter
}
})
})
Similarly a view's event manager will take precedence for events of any views
rendered as a descendent. A method name that matches an event name will not be called
if the view instance was rendered inside the HTML representation of a view that has
an `eventManager` property defined that handles events of the name. Events not handled
by the event manager will still trigger method calls on the descendent.
OuterView = Ember.View.extend({
template: Ember.Handlebars.compile("outer {{#view InnerView}}inner{{/view}} outer"),
eventManager: Ember.Object.create({
mouseEnter: function(event, view){
// view might be instance of either
// OutsideView or InnerView depending on
// where on the page the user interaction occured
}
})
})
InnerView = Ember.View.extend({
click: function(event){
// will be called if rendered inside
// an OuterView because OuterView's
// eventManager doesn't handle click events
},
mouseEnter: function(event){
// will never be called if rendered inside
// an OuterView.
}
})
### Handlebars `{{action}}` Helper
See `Handlebars.helpers.action`.
### Event Names
Possible events names for any of the responding approaches described above are:
Touch events: 'touchStart', 'touchMove', 'touchEnd', 'touchCancel'
Keyboard events: 'keyDown', 'keyUp', 'keyPress'
Mouse events: 'mouseDown', 'mouseUp', 'contextMenu', 'click', 'doubleClick', 'mouseMove',
'focusIn', 'focusOut', 'mouseEnter', 'mouseLeave'
Form events: 'submit', 'change', 'focusIn', 'focusOut', 'input'
HTML5 drag and drop events: 'dragStart', 'drag', 'dragEnter', 'dragLeave', 'drop', 'dragEnd'
## Handlebars `{{view}}` Helper
Other `Ember.View` instances can be included as part of a view's template by using the `{{view}}`
Handlebars helper. See `Handlebars.helpers.view` for additional information.
@extends Ember.Object
@extends Ember.Evented
*/
Ember.View = Ember.Object.extend(Ember.Evented,
/** @scope Ember.View.prototype */ {
/** @private */
concatenatedProperties: ['classNames', 'classNameBindings', 'attributeBindings'],
/**
@type Boolean
@default true
@constant
*/
isView: true,
// ..........................................................
// TEMPLATE SUPPORT
//
/**
The name of the template to lookup if no template is provided.
Ember.View will look for a template with this name in this view's
`templates` object. By default, this will be a global object
shared in `Ember.TEMPLATES`.
@type String
@default null
*/
templateName: null,
/**
The name of the layout to lookup if no layout is provided.
Ember.View will look for a template with this name in this view's
`templates` object. By default, this will be a global object
shared in `Ember.TEMPLATES`.
@type String
@default null
*/
layoutName: null,
/**
The hash in which to look for `templateName`.
@type Ember.Object
@default Ember.TEMPLATES
*/
templates: Ember.TEMPLATES,
/**
The template used to render the view. This should be a function that
accepts an optional context parameter and returns a string of HTML that
will be inserted into the DOM relative to its parent view.
In general, you should set the `templateName` property instead of setting
the template yourself.
@field
@type Function
*/
template: Ember.computed(function(key, value) {
if (value !== undefined) { return value; }
var templateName = get(this, 'templateName'),
template = this.templateForName(templateName, 'template');
return template || get(this, 'defaultTemplate');
}).property('templateName').cacheable(),
/**
The controller managing this view. If this property is set, it will be
made available for use by the template.
@type Object
*/
controller: Ember.computed(function(key, value) {
var parentView;
if (arguments.length === 2) {
return value;
} else {
parentView = get(this, 'parentView');
return parentView ? get(parentView, 'controller') : null;
}
}).property().cacheable(),
/**
A view may contain a layout. A layout is a regular template but
supersedes the `template` property during rendering. It is the
responsibility of the layout template to retrieve the `template`
property from the view (or alternatively, call `Handlebars.helpers.yield`,
`{{yield}}`) to render it in the correct location.
This is useful for a view that has a shared wrapper, but which delegates
the rendering of the contents of the wrapper to the `template` property
on a subclass.
@field
@type Function
*/
layout: Ember.computed(function(key, value) {
if (arguments.length === 2) { return value; }
var layoutName = get(this, 'layoutName'),
layout = this.templateForName(layoutName, 'layout');
return layout || get(this, 'defaultLayout');
}).property('layoutName').cacheable(),
templateForName: function(name, type) {
if (!name) { return; }
var templates = get(this, 'templates'),
template = get(templates, name);
if (!template) {
throw new Ember.Error(fmt('%@ - Unable to find %@ "%@".', [this, type, name]));
}
return template;
},
/**
The object from which templates should access properties.
This object will be passed to the template function each time the render
method is called, but it is up to the individual function to decide what
to do with it.
By default, this will be the view itself.
@type Object
*/
context: Ember.computed(function(key, value) {
if (arguments.length === 2) {
set(this, '_context', value);
return value;
} else {
return get(this, '_context');
}
}).cacheable(),
/**
@private
Private copy of the view's template context. This can be set directly
by Handlebars without triggering the observer that causes the view
to be re-rendered.
The context of a view is looked up as follows:
1. Specified controller
2. Supplied context (usually by Handlebars)
3. `parentView`'s context (for a child of a ContainerView)
The code in Handlebars that overrides the `_context` property first
checks to see whether the view has a specified controller. This is
something of a hack and should be revisited.
*/
_context: Ember.computed(function(key, value) {
var parentView, controller, context;
if (arguments.length === 2) {
return value;
}
if (VIEW_PRESERVES_CONTEXT) {
if (controller = get(this, 'controller')) {
return controller;
}
parentView = get(this, '_parentView');
if (parentView) {
return get(parentView, '_context');
}
}
return this;
}).cacheable(),
/**
If a value that affects template rendering changes, the view should be
re-rendered to reflect the new value.
@private
*/
_displayPropertyDidChange: Ember.observer(function() {
this.rerender();
}, 'context', 'controller'),
/**
If the view is currently inserted into the DOM of a parent view, this
property will point to the parent of the view.
@type Ember.View
@default null
*/
parentView: Ember.computed(function() {
var parent = get(this, '_parentView');
if (parent && parent.isVirtual) {
return get(parent, 'parentView');
} else {
return parent;
}
}).property('_parentView').volatile(),
_parentView: null,
// return the current view, not including virtual views
concreteView: Ember.computed(function() {
if (!this.isVirtual) { return this; }
else { return get(this, 'parentView'); }
}).property('_parentView').volatile(),
/**
If false, the view will appear hidden in DOM.
@type Boolean
@default null
*/
isVisible: true,
/**
Array of child views. You should never edit this array directly.
Instead, use appendChild and removeFromParent.
@private
@type Array
@default []
*/
childViews: childViewsProperty,
_childViews: [],
/**
When it's a virtual view, we need to notify the parent that their
childViews will change.
*/
_childViewsWillChange: Ember.beforeObserver(function() {
if (this.isVirtual) {
var parentView = get(this, 'parentView');
if (parentView) { Ember.propertyWillChange(parentView, 'childViews'); }
}
}, 'childViews'),
/**
When it's a virtual view, we need to notify the parent that their
childViews did change.
*/
_childViewsDidChange: Ember.observer(function() {
if (this.isVirtual) {
var parentView = get(this, 'parentView');
if (parentView) { Ember.propertyDidChange(parentView, 'childViews'); }
}
}, 'childViews'),
/**
Return the nearest ancestor that is an instance of the provided
class.
@param {Class} klass Subclass of Ember.View (or Ember.View itself)
@returns Ember.View
*/
nearestInstanceOf: function(klass) {
var view = get(this, 'parentView');
while (view) {
if(view instanceof klass) { return view; }
view = get(view, 'parentView');
}
},
/**
Return the nearest ancestor that has a given property.
@param {String} property A property name
@returns Ember.View
*/
nearestWithProperty: function(property) {
var view = get(this, 'parentView');
while (view) {
if (property in view) { return view; }
view = get(view, 'parentView');
}
},
/**
Return the nearest ancestor whose parent is an instance of
`klass`.
@param {Class} klass Subclass of Ember.View (or Ember.View itself)
@returns Ember.View
*/
nearestChildOf: function(klass) {
var view = get(this, 'parentView');
while (view) {
if(get(view, 'parentView') instanceof klass) { return view; }
view = get(view, 'parentView');
}
},
/**
Return the nearest ancestor that is an Ember.CollectionView
@returns Ember.CollectionView
*/
collectionView: Ember.computed(function() {
return this.nearestInstanceOf(Ember.CollectionView);
}).cacheable(),
/**
Return the nearest ancestor that is a direct child of
an Ember.CollectionView
@returns Ember.View
*/
itemView: Ember.computed(function() {
return this.nearestChildOf(Ember.CollectionView);
}).cacheable(),
/**
Return the nearest ancestor that has the property
`content`.
@returns Ember.View
*/
contentView: Ember.computed(function() {
return this.nearestWithProperty('content');
}).cacheable(),
/**
@private
When the parent view changes, recursively invalidate
collectionView, itemView, and contentView
*/
_parentViewDidChange: Ember.observer(function() {
if (this.isDestroying) { return; }
this.invokeRecursively(function(view) {
view.propertyDidChange('collectionView');
view.propertyDidChange('itemView');
view.propertyDidChange('contentView');
});
if (get(this, 'parentView.controller') && !get(this, 'controller')) {
this.notifyPropertyChange('controller');
}
}, '_parentView'),
_controllerDidChange: Ember.observer(function() {
if (this.isDestroying) { return; }
this.forEachChildView(function(view) {
view.propertyDidChange('controller');
});
}, 'controller'),
cloneKeywords: function() {
var templateData = get(this, 'templateData');
var keywords = templateData ? Ember.copy(templateData.keywords) : {};
set(keywords, 'view', get(this, 'concreteView'));
set(keywords, 'controller', get(this, 'controller'));
return keywords;
},
/**
Called on your view when it should push strings of HTML into a
Ember.RenderBuffer. Most users will want to override the `template`
or `templateName` properties instead of this method.
By default, Ember.View will look for a function in the `template`
property and invoke it with the value of `context`. The value of
`context` will be the view's controller unless you override it.
@param {Ember.RenderBuffer} buffer The render buffer
*/
render: function(buffer) {
// If this view has a layout, it is the responsibility of the
// the layout to render the view's template. Otherwise, render the template
// directly.
var template = get(this, 'layout') || get(this, 'template');
if (template) {
var context = get(this, '_context');
var keywords = this.cloneKeywords();
var data = {
view: this,
buffer: buffer,
isRenderData: true,
keywords: keywords
};
// Invoke the template with the provided template context, which
// is the view by default. A hash of data is also passed that provides
// the template with access to the view and render buffer.
Ember.assert('template must be a function. Did you mean to call Ember.Handlebars.compile("...") or specify templateName instead?', typeof template === 'function');
// The template should write directly to the render buffer instead
// of returning a string.
var output = template(context, { data: data });
// If the template returned a string instead of writing to the buffer,
// push the string onto the buffer.
if (output !== undefined) { buffer.push(output); }
}
},
invokeForState: function(name) {
var stateName = this.state, args, fn;
// try to find the function for the state in the cache
if (fn = invokeForState[stateName][name]) {
args = a_slice.call(arguments);
args[0] = this;
return fn.apply(this, args);
}
// otherwise, find and cache the function for this state
var parent = this, states = parent.states, state;
while (states) {
state = states[stateName];
while (state) {
fn = state[name];
if (fn) {
invokeForState[stateName][name] = fn;
args = a_slice.call(arguments, 1);
args.unshift(this);
return fn.apply(this, args);
}
state = state.parentState;
}
states = states.parent;
}
},
/**
Renders the view again. This will work regardless of whether the
view is already in the DOM or not. If the view is in the DOM, the
rendering process will be deferred to give bindings a chance
to synchronize.
If children were added during the rendering process using `appendChild`,
`rerender` will remove them, because they will be added again
if needed by the next `render`.
In general, if the display of your view changes, you should modify
the DOM element directly instead of manually calling `rerender`, which can
be slow.
*/
rerender: function() {
return this.invokeForState('rerender');
},
clearRenderedChildren: function() {
var lengthBefore = this.lengthBeforeRender,
lengthAfter = this.lengthAfterRender;
// If there were child views created during the last call to render(),
// remove them under the assumption that they will be re-created when
// we re-render.
// VIEW-TODO: Unit test this path.
var childViews = this._childViews;
for (var i=lengthAfter-1; i>=lengthBefore; i--) {
if (childViews[i]) { childViews[i].destroy(); }
}
},
/**
@private
Iterates over the view's `classNameBindings` array, inserts the value
of the specified property into the `classNames` array, then creates an
observer to update the view's element if the bound property ever changes
in the future.
*/
_applyClassNameBindings: function() {
var classBindings = get(this, 'classNameBindings'),
classNames = get(this, 'classNames'),
elem, newClass, dasherizedClass;
if (!classBindings) { return; }
// Loop through all of the configured bindings. These will be either
// property names ('isUrgent') or property paths relative to the view
// ('content.isUrgent')
a_forEach(classBindings, function(binding) {
// Variable in which the old class value is saved. The observer function
// closes over this variable, so it knows which string to remove when
// the property changes.
var oldClass;
// Set up an observer on the context. If the property changes, toggle the
// class name.
var observer = function() {
// Get the current value of the property
newClass = this._classStringForProperty(binding);
elem = this.$();
// If we had previously added a class to the element, remove it.
if (oldClass) {
elem.removeClass(oldClass);
// Also remove from classNames so that if the view gets rerendered,
// the class doesn't get added back to the DOM.
classNames.removeObject(oldClass);
}
// If necessary, add a new class. Make sure we keep track of it so
// it can be removed in the future.
if (newClass) {
elem.addClass(newClass);
oldClass = newClass;
} else {
oldClass = null;
}
};
// Get the class name for the property at its current value
dasherizedClass = this._classStringForProperty(binding);
if (dasherizedClass) {
// Ensure that it gets into the classNames array
// so it is displayed when we render.
classNames.push(dasherizedClass);
// Save a reference to the class name so we can remove it
// if the observer fires. Remember that this variable has
// been closed over by the observer.
oldClass = dasherizedClass;
}
// Extract just the property name from bindings like 'foo:bar'
var parsedPath = Ember.View._parsePropertyPath(binding);
addObserver(this, parsedPath.path, observer);
}, this);
},
/**
Iterates through the view's attribute bindings, sets up observers for each,
then applies the current value of the attributes to the passed render buffer.
@param {Ember.RenderBuffer} buffer
*/
_applyAttributeBindings: function(buffer) {
var attributeBindings = get(this, 'attributeBindings'),
attributeValue, elem, type;
if (!attributeBindings) { return; }
a_forEach(attributeBindings, function(binding) {
var split = binding.split(':'),
property = split[0],
attributeName = split[1] || property;
// Create an observer to add/remove/change the attribute if the
// JavaScript property changes.
var observer = function() {
elem = this.$();
if (!elem) { return; }
attributeValue = get(this, property);
Ember.View.applyAttributeBindings(elem, attributeName, attributeValue);
};
addObserver(this, property, observer);
// Determine the current value and add it to the render buffer
// if necessary.
attributeValue = get(this, property);
Ember.View.applyAttributeBindings(buffer, attributeName, attributeValue);
}, this);
},
/**
@private
Given a property name, returns a dasherized version of that
property name if the property evaluates to a non-falsy value.
For example, if the view has property `isUrgent` that evaluates to true,
passing `isUrgent` to this method will return `"is-urgent"`.
*/
_classStringForProperty: function(property) {
var parsedPath = Ember.View._parsePropertyPath(property);
var path = parsedPath.path;
var val = get(this, path);
if (val === undefined && Ember.isGlobalPath(path)) {
val = get(window, path);
}
return Ember.View._classStringForValue(path, val, parsedPath.className, parsedPath.falsyClassName);
},
// ..........................................................
// ELEMENT SUPPORT
//
/**
Returns the current DOM element for the view.
@field
@type DOMElement
*/
element: Ember.computed(function(key, value) {
if (value !== undefined) {
return this.invokeForState('setElement', value);
} else {
return this.invokeForState('getElement');
}
}).property('_parentView').cacheable(),
/**
Returns a jQuery object for this view's element. If you pass in a selector
string, this method will return a jQuery object, using the current element
as its buffer.
For example, calling `view.$('li')` will return a jQuery object containing
all of the `li` elements inside the DOM element of this view.
@param {String} [selector] a jQuery-compatible selector string
@returns {Ember.CoreQuery} the CoreQuery object for the DOM node
*/
$: function(sel) {
return this.invokeForState('$', sel);
},
/** @private */
mutateChildViews: function(callback) {
var childViews = this._childViews,
idx = childViews.length,
view;
while(--idx >= 0) {
view = childViews[idx];
callback.call(this, view, idx);
}
return this;
},
/** @private */
forEachChildView: function(callback) {
var childViews = this._childViews;
if (!childViews) { return this; }
var len = childViews.length,
view, idx;
for(idx = 0; idx < len; idx++) {
view = childViews[idx];
callback.call(this, view);
}
return this;
},
/**
Appends the view's element to the specified parent element.
If the view does not have an HTML representation yet, `createElement()`
will be called automatically.
Note that this method just schedules the view to be appended; the DOM
element will not be appended to the given element until all bindings have
finished synchronizing.
This is not typically a function that you will need to call directly
when building your application. You might consider using Ember.ContainerView
instead. If you do need to use appendTo, be sure that the target element you
are providing is associated with an Ember.Application and does not have an
ancestor element that is associated with an Ember view.
@param {String|DOMElement|jQuery} A selector, element, HTML string, or jQuery object
@returns {Ember.View} receiver
*/
appendTo: function(target) {
// Schedule the DOM element to be created and appended to the given
// element after bindings have synchronized.
this._insertElementLater(function() {
Ember.assert("You cannot append to an existing Ember.View. Consider using Ember.ContainerView instead.", !Ember.$(target).is('.ember-view') && !Ember.$(target).parents().is('.ember-view'));
this.$().appendTo(target);
});
return this;
},
/**
Replaces the content of the specified parent element with this view's element.
If the view does not have an HTML representation yet, `createElement()`
will be called automatically.
Note that this method just schedules the view to be appended; the DOM
element will not be appended to the given element until all bindings have
finished synchronizing
@param {String|DOMElement|jQuery} A selector, element, HTML string, or jQuery object
@returns {Ember.View} received
*/
replaceIn: function(target) {
Ember.assert("You cannot replace an existing Ember.View. Consider using Ember.ContainerView instead.", !Ember.$(target).is('.ember-view') && !Ember.$(target).parents().is('.ember-view'));
this._insertElementLater(function() {
Ember.$(target).empty();
this.$().appendTo(target);
});
return this;
},
/**
@private
Schedules a DOM operation to occur during the next render phase. This
ensures that all bindings have finished synchronizing before the view is
rendered.
To use, pass a function that performs a DOM operation..
Before your function is called, this view and all child views will receive
the `willInsertElement` event. After your function is invoked, this view
and all of its child views will receive the `didInsertElement` event.
view._insertElementLater(function() {
this.createElement();
this.$().appendTo('body');
});
@param {Function} fn the function that inserts the element into the DOM
*/
_insertElementLater: function(fn) {
this._lastInsert = Ember.guidFor(fn);
Ember.run.schedule('render', this, this.invokeForState, 'insertElement', fn);
},
/**
Appends the view's element to the document body. If the view does
not have an HTML representation yet, `createElement()` will be called
automatically.
Note that this method just schedules the view to be appended; the DOM
element will not be appended to the document body until all bindings have
finished synchronizing.
@returns {Ember.View} receiver
*/
append: function() {
return this.appendTo(document.body);
},
/**
Removes the view's element from the element to which it is attached.
@returns {Ember.View} receiver
*/
remove: function() {
// What we should really do here is wait until the end of the run loop
// to determine if the element has been re-appended to a different
// element.
// In the interim, we will just re-render if that happens. It is more
// important than elements get garbage collected.
this.destroyElement();
this.invokeRecursively(function(view) {
view.clearRenderedChildren();
});
},
/**
The ID to use when trying to locate the element in the DOM. If you do not
set the elementId explicitly, then the view's GUID will be used instead.
This ID must be set at the time the view is created.
@type String
@readOnly
*/
elementId: Ember.computed(function(key, value) {
return value !== undefined ? value : Ember.guidFor(this);
}).cacheable(),
/**
@private
TODO: Perhaps this should be removed from the production build somehow.
*/
_elementIdDidChange: Ember.beforeObserver(function() {
throw "Changing a view's elementId after creation is not allowed.";
}, 'elementId'),
/**
Attempts to discover the element in the parent element. The default
implementation looks for an element with an ID of elementId (or the view's
guid if elementId is null). You can override this method to provide your
own form of lookup. For example, if you want to discover your element
using a CSS class name instead of an ID.
@param {DOMElement} parentElement The parent's DOM element
@returns {DOMElement} The discovered element
*/
findElementInParentElement: function(parentElem) {
var id = "#" + get(this, 'elementId');
return Ember.$(id)[0] || Ember.$(id, parentElem)[0];
},
/**
Creates a new renderBuffer with the passed tagName. You can override this
method to provide further customization to the buffer if needed. Normally
you will not need to call or override this method.
@returns {Ember.RenderBuffer}
*/
renderBuffer: function(tagName) {
tagName = tagName || get(this, 'tagName');
// Explicitly check for null or undefined, as tagName
// may be an empty string, which would evaluate to false.
if (tagName === null || tagName === undefined) {
tagName = 'div';
}
return Ember.RenderBuffer(tagName);
},
/**
Creates a DOM representation of the view and all of its
child views by recursively calling the `render()` method.
After the element has been created, `didInsertElement` will
be called on this view and all of its child views.
@returns {Ember.View} receiver
*/
createElement: function() {
if (get(this, 'element')) { return this; }
var buffer = this.renderToBuffer();
set(this, 'element', buffer.element());
return this;
},
/**
Called when a view is going to insert an element into the DOM.
*/
willInsertElement: Ember.K,
/**
Called when the element of the view has been inserted into the DOM.
Override this function to do any set up that requires an element in the
document body.
*/
didInsertElement: Ember.K,
/**
Called when the view is about to rerender, but before anything has
been torn down. This is a good opportunity to tear down any manual
observers you have installed based on the DOM state
*/
willRerender: Ember.K,
/**
Run this callback on the current view and recursively on child views.
@private
*/
invokeRecursively: function(fn) {
fn.call(this, this);
this.forEachChildView(function(view) {
view.invokeRecursively(fn);
});
},
/**
Invalidates the cache for a property on all child views.
*/
invalidateRecursively: function(key) {
this.forEachChildView(function(view) {
view.propertyDidChange(key);
});
},
/**
@private
Invokes the receiver's willInsertElement() method if it exists and then
invokes the same on all child views.
NOTE: In some cases this was called when the element existed. This no longer
works so we let people know. We can remove this warning code later.
*/
_notifyWillInsertElement: function() {
this.invokeRecursively(function(view) {
view.trigger('willInsertElement');
});
},
/**
@private
Invokes the receiver's didInsertElement() method if it exists and then
invokes the same on all child views.
*/
_notifyDidInsertElement: function() {
this.invokeRecursively(function(view) {
view.trigger('didInsertElement');
});
},
/**
@private
Invokes the receiver's willRerender() method if it exists and then
invokes the same on all child views.
*/
_notifyWillRerender: function() {
this.invokeRecursively(function(view) {
view.trigger('willRerender');
});
},
/**
Destroys any existing element along with the element for any child views
as well. If the view does not currently have a element, then this method
will do nothing.
If you implement willDestroyElement() on your view, then this method will
be invoked on your view before your element is destroyed to give you a
chance to clean up any event handlers, etc.
If you write a willDestroyElement() handler, you can assume that your
didInsertElement() handler was called earlier for the same element.
Normally you will not call or override this method yourself, but you may
want to implement the above callbacks when it is run.
@returns {Ember.View} receiver
*/
destroyElement: function() {
return this.invokeForState('destroyElement');
},
/**
Called when the element of the view is going to be destroyed. Override
this function to do any teardown that requires an element, like removing
event listeners.
*/
willDestroyElement: function() {},
/**
@private
Invokes the `willDestroyElement` callback on the view and child views.
*/
_notifyWillDestroyElement: function() {
this.invokeRecursively(function(view) {
view.trigger('willDestroyElement');
});
},
/** @private (nodoc) */
_elementWillChange: Ember.beforeObserver(function() {
this.forEachChildView(function(view) {
Ember.propertyWillChange(view, 'element');
});
}, 'element'),
/**
@private
If this view's element changes, we need to invalidate the caches of our
child views so that we do not retain references to DOM elements that are
no longer needed.
@observes element
*/
_elementDidChange: Ember.observer(function() {
this.forEachChildView(function(view) {
Ember.propertyDidChange(view, 'element');
});
}, 'element'),
/**
Called when the parentView property has changed.
@function
*/
parentViewDidChange: Ember.K,
/**
@private
Invoked by the view system when this view needs to produce an HTML
representation. This method will create a new render buffer, if needed,
then apply any default attributes, such as class names and visibility.
Finally, the `render()` method is invoked, which is responsible for
doing the bulk of the rendering.
You should not need to override this method; instead, implement the
`template` property, or if you need more control, override the `render`
method.
@param {Ember.RenderBuffer} buffer the render buffer. If no buffer is
passed, a default buffer, using the current view's `tagName`, will
be used.
*/
renderToBuffer: function(parentBuffer, bufferOperation) {
var buffer;
Ember.run.sync();
// Determine where in the parent buffer to start the new buffer.
// By default, a new buffer will be appended to the parent buffer.
// The buffer operation may be changed if the child views array is
// mutated by Ember.ContainerView.
bufferOperation = bufferOperation || 'begin';
// If this is the top-most view, start a new buffer. Otherwise,
// create a new buffer relative to the original using the
// provided buffer operation (for example, `insertAfter` will
// insert a new buffer after the "parent buffer").
if (parentBuffer) {
var tagName = get(this, 'tagName');
if (tagName === null || tagName === undefined) {
tagName = 'div';
}
buffer = parentBuffer[bufferOperation](tagName);
} else {
buffer = this.renderBuffer();
}
this.buffer = buffer;
this.transitionTo('inBuffer', false);
this.lengthBeforeRender = this._childViews.length;
this.beforeRender(buffer);
this.render(buffer);
this.afterRender(buffer);
this.lengthAfterRender = this._childViews.length;
return buffer;
},
beforeRender: function(buffer) {
this.applyAttributesToBuffer(buffer);
},
afterRender: Ember.K,
/**
@private
*/
applyAttributesToBuffer: function(buffer) {
// Creates observers for all registered class name and attribute bindings,
// then adds them to the element.
this._applyClassNameBindings();
// Pass the render buffer so the method can apply attributes directly.
// This isn't needed for class name bindings because they use the
// existing classNames infrastructure.
this._applyAttributeBindings(buffer);
a_forEach(get(this, 'classNames'), function(name){ buffer.addClass(name); });
buffer.id(get(this, 'elementId'));
var role = get(this, 'ariaRole');
if (role) {
buffer.attr('role', role);
}
if (get(this, 'isVisible') === false) {
buffer.style('display', 'none');
}
},
// ..........................................................
// STANDARD RENDER PROPERTIES
//
/**
Tag name for the view's outer element. The tag name is only used when
an element is first created. If you change the tagName for an element, you
must destroy and recreate the view element.
By default, the render buffer will use a `<div>` tag for views.
@type String
@default null
*/
// We leave this null by default so we can tell the difference between
// the default case and a user-specified tag.
tagName: null,
/**
The WAI-ARIA role of the control represented by this view. For example, a
button may have a role of type 'button', or a pane may have a role of
type 'alertdialog'. This property is used by assistive software to help
visually challenged users navigate rich web applications.
The full list of valid WAI-ARIA roles is available at:
http://www.w3.org/TR/wai-aria/roles#roles_categorization
@type String
@default null
*/
ariaRole: null,
/**
Standard CSS class names to apply to the view's outer element. This
property automatically inherits any class names defined by the view's
superclasses as well.
@type Array
@default ['ember-view']
*/
classNames: ['ember-view'],
/**
A list of properties of the view to apply as class names. If the property
is a string value, the value of that string will be applied as a class
name.
// Applies the 'high' class to the view element
Ember.View.create({
classNameBindings: ['priority']
priority: 'high'
});
If the value of the property is a Boolean, the name of that property is
added as a dasherized class name.
// Applies the 'is-urgent' class to the view element
Ember.View.create({
classNameBindings: ['isUrgent']
isUrgent: true
});
If you would prefer to use a custom value instead of the dasherized
property name, you can pass a binding like this:
// Applies the 'urgent' class to the view element
Ember.View.create({
classNameBindings: ['isUrgent:urgent']
isUrgent: true
});
This list of properties is inherited from the view's superclasses as well.
@type Array
@default []
*/
classNameBindings: [],
/**
A list of properties of the view to apply as attributes. If the property is
a string value, the value of that string will be applied as the attribute.
// Applies the type attribute to the element
// with the value "button", like <div type="button">
Ember.View.create({
attributeBindings: ['type'],
type: 'button'
});
If the value of the property is a Boolean, the name of that property is
added as an attribute.
// Renders something like <div enabled="enabled">
Ember.View.create({
attributeBindings: ['enabled'],
enabled: true
});
*/
attributeBindings: [],
state: 'preRender',
// .......................................................
// CORE DISPLAY METHODS
//
/**
@private
Setup a view, but do not finish waking it up.
- configure childViews
- register the view with the global views hash, which is used for event
dispatch
*/
init: function() {
this._super();
// Register the view for event handling. This hash is used by
// Ember.EventDispatcher to dispatch incoming events.
if (!this.isVirtual) Ember.View.views[get(this, 'elementId')] = this;
// setup child views. be sure to clone the child views array first
this._childViews = this._childViews.slice();
Ember.assert("Only arrays are allowed for 'classNameBindings'", Ember.typeOf(this.classNameBindings) === 'array');
this.classNameBindings = Ember.A(this.classNameBindings.slice());
Ember.assert("Only arrays are allowed for 'classNames'", Ember.typeOf(this.classNames) === 'array');
this.classNames = Ember.A(this.classNames.slice());
var viewController = get(this, 'viewController');
if (viewController) {
viewController = get(viewController);
if (viewController) {
set(viewController, 'view', this);
}
}
},
appendChild: function(view, options) {
return this.invokeForState('appendChild', view, options);
},
/**
Removes the child view from the parent view.
@param {Ember.View} view
@returns {Ember.View} receiver
*/
removeChild: function(view) {
// If we're destroying, the entire subtree will be
// freed, and the DOM will be handled separately,
// so no need to mess with childViews.
if (this.isDestroying) { return; }
// update parent node
set(view, '_parentView', null);
// remove view from childViews array.
var childViews = this._childViews;
Ember.EnumerableUtils.removeObject(childViews, view);
this.propertyDidChange('childViews'); // HUH?! what happened to will change?
return this;
},
/**
Removes all children from the parentView.
@returns {Ember.View} receiver
*/
removeAllChildren: function() {
return this.mutateChildViews(function(view) {
this.removeChild(view);
});
},
destroyAllChildren: function() {
return this.mutateChildViews(function(view) {
view.destroy();
});
},
/**
Removes the view from its parentView, if one is found. Otherwise
does nothing.
@returns {Ember.View} receiver
*/
removeFromParent: function() {
var parent = get(this, '_parentView');
// Remove DOM element from parent
this.remove();
if (parent) { parent.removeChild(this); }
return this;
},
/**
You must call `destroy` on a view to destroy the view (and all of its
child views). This will remove the view from any parent node, then make
sure that the DOM element managed by the view can be released by the
memory manager.
*/
willDestroy: function() {
// calling this._super() will nuke computed properties and observers,
// so collect any information we need before calling super.
var childViews = this._childViews,
parent = get(this, '_parentView'),
childLen;
// destroy the element -- this will avoid each child view destroying
// the element over and over again...
if (!this.removedFromDOM) { this.destroyElement(); }
// remove from non-virtual parent view if viewName was specified
if (this.viewName) {
var nonVirtualParentView = get(this, 'parentView');
if (nonVirtualParentView) {
set(nonVirtualParentView, this.viewName, null);
}
}
// remove from parent if found. Don't call removeFromParent,
// as removeFromParent will try to remove the element from
// the DOM again.
if (parent) { parent.removeChild(this); }
this.state = 'destroyed';
childLen = childViews.length;
for (var i=childLen-1; i>=0; i--) {
childViews[i].removedFromDOM = true;
childViews[i].destroy();
}
// next remove view from global hash
if (!this.isVirtual) delete Ember.View.views[get(this, 'elementId')];
},
/**
Instantiates a view to be added to the childViews array during view
initialization. You generally will not call this method directly unless
you are overriding createChildViews(). Note that this method will
automatically configure the correct settings on the new view instance to
act as a child of the parent.
@param {Class} viewClass
@param {Hash} [attrs] Attributes to add
@returns {Ember.View} new instance
@test in createChildViews
*/
createChildView: function(view, attrs) {
if (Ember.View.detect(view)) {
attrs = attrs || {};
attrs._parentView = this;
attrs.templateData = attrs.templateData || get(this, 'templateData');
view = view.create(attrs);
// don't set the property on a virtual view, as they are invisible to
// consumers of the view API
if (view.viewName) { set(get(this, 'concreteView'), view.viewName, view); }
} else {
Ember.assert('You must pass instance or subclass of View', view instanceof Ember.View);
Ember.assert("You can only pass attributes when a class is provided", !attrs);
if (!get(view, 'templateData')) {
set(view, 'templateData', get(this, 'templateData'));
}
set(view, '_parentView', this);
}
return view;
},
becameVisible: Ember.K,
becameHidden: Ember.K,
/**
@private
When the view's `isVisible` property changes, toggle the visibility
element of the actual DOM element.
*/
_isVisibleDidChange: Ember.observer(function() {
var $el = this.$();
if (!$el) { return; }
var isVisible = get(this, 'isVisible');
$el.toggle(isVisible);
if (this._isAncestorHidden()) { return; }
if (isVisible) {
this._notifyBecameVisible();
} else {
this._notifyBecameHidden();
}
}, 'isVisible'),
_notifyBecameVisible: function() {
this.trigger('becameVisible');
this.forEachChildView(function(view) {
var isVisible = get(view, 'isVisible');
if (isVisible || isVisible === null) {
view._notifyBecameVisible();
}
});
},
_notifyBecameHidden: function() {
this.trigger('becameHidden');
this.forEachChildView(function(view) {
var isVisible = get(view, 'isVisible');
if (isVisible || isVisible === null) {
view._notifyBecameHidden();
}
});
},
_isAncestorHidden: function() {
var parent = get(this, 'parentView');
while (parent) {
if (get(parent, 'isVisible') === false) { return true; }
parent = get(parent, 'parentView');
}
return false;
},
clearBuffer: function() {
this.invokeRecursively(function(view) {
this.buffer = null;
});
},
transitionTo: function(state, children) {
this.state = state;
if (children !== false) {
this.forEachChildView(function(view) {
view.transitionTo(state);
});
}
},
/**
@private
Override the default event firing from Ember.Evented to
also call methods with the given name.
*/
trigger: function(name) {
this._super.apply(this, arguments);
var method = this[name];
if (method) {
var args = [], i, l;
for (i = 1, l = arguments.length; i < l; i++) {
args.push(arguments[i]);
}
return method.apply(this, args);
}
},
has: function(name) {
return Ember.typeOf(this[name]) === 'function' || this._super(name);
},
// .......................................................
// EVENT HANDLING
//
/**
@private
Handle events from `Ember.EventDispatcher`
*/
handleEvent: function(eventName, evt) {
return this.invokeForState('handleEvent', eventName, evt);
}
});
/**
Describe how the specified actions should behave in the various
states that a view can exist in. Possible states:
* preRender: when a view is first instantiated, and after its
element was destroyed, it is in the preRender state
* inBuffer: once a view has been rendered, but before it has
been inserted into the DOM, it is in the inBuffer state
* inDOM: once a view has been inserted into the DOM it is in
the inDOM state. A view spends the vast majority of its
existence in this state.
* destroyed: once a view has been destroyed (using the destroy
method), it is in this state. No further actions can be invoked
on a destroyed view.
*/
// in the destroyed state, everything is illegal
// before rendering has begun, all legal manipulations are noops.
// inside the buffer, legal manipulations are done on the buffer
// once the view has been inserted into the DOM, legal manipulations
// are done on the DOM element.
/** @private */
var DOMManager = {
prepend: function(view, childView) {
childView._insertElementLater(function() {
var element = view.$();
element.prepend(childView.$());
});
},
after: function(view, nextView) {
nextView._insertElementLater(function() {
var element = view.$();
element.after(nextView.$());
});
},
replace: function(view) {
var element = get(view, 'element');
set(view, 'element', null);
view._insertElementLater(function() {
Ember.$(element).replaceWith(get(view, 'element'));
});
},
remove: function(view) {
var elem = get(view, 'element');
set(view, 'element', null);
view._lastInsert = null;
Ember.$(elem).remove();
},
empty: function(view) {
view.$().empty();
}
};
Ember.View.reopen({
states: Ember.View.states,
domManager: DOMManager
});
Ember.View.reopenClass({
/**
@private
Parse a path and return an object which holds the parsed properties.
For example a path like "content.isEnabled:enabled:disabled" wil return the
following object:
{
path: "content.isEnabled",
className: "enabled",
falsyClassName: "disabled",
classNames: ":enabled:disabled"
}
*/
_parsePropertyPath: function(path) {
var split = path.split(/:/),
propertyPath = split[0],
classNames = "",
className,
falsyClassName;
// check if the property is defined as prop:class or prop:trueClass:falseClass
if (split.length > 1) {
className = split[1];
if (split.length === 3) { falsyClassName = split[2]; }
classNames = ':' + className;
if (falsyClassName) { classNames += ":" + falsyClassName; }
}
return {
path: propertyPath,
classNames: classNames,
className: (className === '') ? undefined : className,
falsyClassName: falsyClassName
};
},
/**
@private
Get the class name for a given value, based on the path, optional className
and optional falsyClassName.
- if the value is truthy and a className is defined, the className is returned
- if the value is true, the dasherized last part of the supplied path is returned
- if the value is false and a falsyClassName is supplied, the falsyClassName is returned
- if the value is truthy, the value is returned
- if none of the above rules apply, null is returned
*/
_classStringForValue: function(path, val, className, falsyClassName) {
// If the value is truthy and we're using the colon syntax,
// we should return the className directly
if (!!val && className) {
return className;
// If value is a Boolean and true, return the dasherized property
// name.
} else if (val === true) {
// catch syntax like isEnabled::not-enabled
if (val === true && !className && falsyClassName) { return null; }
// Normalize property path to be suitable for use
// as a class name. For exaple, content.foo.barBaz
// becomes bar-baz.
var parts = path.split('.');
return Ember.String.dasherize(parts[parts.length-1]);
// If the value is false and a falsyClassName is specified, return it
} else if (val === false && falsyClassName) {
return falsyClassName;
// If the value is not false, undefined, or null, return the current
// value of the property.
} else if (val !== false && val !== undefined && val !== null) {
return val;
// Nothing to display. Return null so that the old class is removed
// but no new class is added.
} else {
return null;
}
}
});
// Create a global view hash.
Ember.View.views = {};
// If someone overrides the child views computed property when
// defining their class, we want to be able to process the user's
// supplied childViews and then restore the original computed property
// at view initialization time. This happens in Ember.ContainerView's init
// method.
Ember.View.childViewsProperty = childViewsProperty;
Ember.View.applyAttributeBindings = function(elem, name, value) {
var type = Ember.typeOf(value);
var currentValue = elem.attr(name);
// if this changes, also change the logic in ember-handlebars/lib/helpers/binding.js
if ((type === 'string' || (type === 'number' && !isNaN(value))) && value !== currentValue) {
elem.attr(name, value);
} else if (value && type === 'boolean') {
elem.attr(name, name);
} else if (!value) {
elem.removeAttr(name);
}
};
})();
(function() {
// ==========================================================================
// Project: Ember - JavaScript Application Framework
// Copyright: ©2006-2011 Strobe Inc. and contributors.
// Portions ©2008-2011 Apple Inc. All rights reserved.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
var get = Ember.get, set = Ember.set;
Ember.View.states = {
_default: {
// appendChild is only legal while rendering the buffer.
appendChild: function() {
throw "You can't use appendChild outside of the rendering process";
},
$: function() {
return undefined;
},
getElement: function() {
return null;
},
// Handle events from `Ember.EventDispatcher`
handleEvent: function() {
return true; // continue event propagation
},
destroyElement: function(view) {
set(view, 'element', null);
view._lastInsert = null;
return view;
}
}
};
Ember.View.reopen({
states: Ember.View.states
});
})();
(function() {
// ==========================================================================
// Project: Ember - JavaScript Application Framework
// Copyright: ©2006-2011 Strobe Inc. and contributors.
// Portions ©2008-2011 Apple Inc. All rights reserved.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
Ember.View.states.preRender = {
parentState: Ember.View.states._default,
// a view leaves the preRender state once its element has been
// created (createElement).
insertElement: function(view, fn) {
if (view._lastInsert !== Ember.guidFor(fn)){
return;
}
view.createElement();
view._notifyWillInsertElement();
// after createElement, the view will be in the hasElement state.
fn.call(view);
view.transitionTo('inDOM');
view._notifyDidInsertElement();
},
empty: Ember.K,
setElement: function(view, value) {
if (value !== null) {
view.transitionTo('hasElement');
}
return value;
}
};
})();
(function() {
// ==========================================================================
// Project: Ember - JavaScript Application Framework
// Copyright: ©2006-2011 Strobe Inc. and contributors.
// Portions ©2008-2011 Apple Inc. All rights reserved.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
var get = Ember.get, set = Ember.set, meta = Ember.meta;
Ember.View.states.inBuffer = {
parentState: Ember.View.states._default,
$: function(view, sel) {
// if we don't have an element yet, someone calling this.$() is
// trying to update an element that isn't in the DOM. Instead,
// rerender the view to allow the render method to reflect the
// changes.
view.rerender();
return Ember.$();
},
// when a view is rendered in a buffer, rerendering it simply
// replaces the existing buffer with a new one
rerender: function(view) {
Ember.deprecate("Something you did caused a view to re-render after it rendered but before it was inserted into the DOM. Because this is avoidable and the cause of significant performance issues in applications, this behavior is deprecated. If you want to use the debugger to find out what caused this, you can set ENV.RAISE_ON_DEPRECATION to true.");
view._notifyWillRerender();
view.clearRenderedChildren();
view.renderToBuffer(view.buffer, 'replaceWith');
},
// when a view is rendered in a buffer, appending a child
// view will render that view and append the resulting
// buffer into its buffer.
appendChild: function(view, childView, options) {
var buffer = view.buffer;
childView = this.createChildView(childView, options);
view._childViews.push(childView);
childView.renderToBuffer(buffer);
view.propertyDidChange('childViews');
return childView;
},
// when a view is rendered in a buffer, destroying the
// element will simply destroy the buffer and put the
// state back into the preRender state.
destroyElement: function(view) {
view.clearBuffer();
view._notifyWillDestroyElement();
view.transitionTo('preRender');
return view;
},
empty: function() {
Ember.assert("Emptying a view in the inBuffer state is not allowed and should not happen under normal circumstances. Most likely there is a bug in your application. This may be due to excessive property change notifications.");
},
// It should be impossible for a rendered view to be scheduled for
// insertion.
insertElement: function() {
throw "You can't insert an element that has already been rendered";
},
setElement: function(view, value) {
if (value === null) {
view.transitionTo('preRender');
} else {
view.clearBuffer();
view.transitionTo('hasElement');
}
return value;
}
};
})();
(function() {
// ==========================================================================
// Project: Ember - JavaScript Application Framework
// Copyright: ©2006-2011 Strobe Inc. and contributors.
// Portions ©2008-2011 Apple Inc. All rights reserved.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
var get = Ember.get, set = Ember.set, meta = Ember.meta;
Ember.View.states.hasElement = {
parentState: Ember.View.states._default,
$: function(view, sel) {
var elem = get(view, 'element');
return sel ? Ember.$(sel, elem) : Ember.$(elem);
},
getElement: function(view) {
var parent = get(view, 'parentView');
if (parent) { parent = get(parent, 'element'); }
if (parent) { return view.findElementInParentElement(parent); }
return Ember.$("#" + get(view, 'elementId'))[0];
},
setElement: function(view, value) {
if (value === null) {
view.transitionTo('preRender');
} else {
throw "You cannot set an element to a non-null value when the element is already in the DOM.";
}
return value;
},
// once the view has been inserted into the DOM, rerendering is
// deferred to allow bindings to synchronize.
rerender: function(view) {
view._notifyWillRerender();
view.clearRenderedChildren();
view.domManager.replace(view);
return view;
},
// once the view is already in the DOM, destroying it removes it
// from the DOM, nukes its element, and puts it back into the
// preRender state if inDOM.
destroyElement: function(view) {
view._notifyWillDestroyElement();
view.domManager.remove(view);
return view;
},
empty: function(view) {
var _childViews = view._childViews, len, idx;
if (_childViews) {
len = _childViews.length;
for (idx = 0; idx < len; idx++) {
_childViews[idx]._notifyWillDestroyElement();
}
}
view.domManager.empty(view);
},
// Handle events from `Ember.EventDispatcher`
handleEvent: function(view, eventName, evt) {
if (view.has(eventName)) {
// Handler should be able to re-dispatch events, so we don't
// preventDefault or stopPropagation.
return view.trigger(eventName, evt);
} else {
return true; // continue event propagation
}
}
};
Ember.View.states.inDOM = {
parentState: Ember.View.states.hasElement,
insertElement: function(view, fn) {
if (view._lastInsert !== Ember.guidFor(fn)){
return;
}
throw "You can't insert an element into the DOM that has already been inserted";
}
};
})();
(function() {
// ==========================================================================
// Project: Ember - JavaScript Application Framework
// Copyright: ©2006-2011 Strobe Inc. and contributors.
// Portions ©2008-2011 Apple Inc. All rights reserved.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
var destroyedError = "You can't call %@ on a destroyed view", fmt = Ember.String.fmt;
Ember.View.states.destroyed = {
parentState: Ember.View.states._default,
appendChild: function() {
throw fmt(destroyedError, ['appendChild']);
},
rerender: function() {
throw fmt(destroyedError, ['rerender']);
},
destroyElement: function() {
throw fmt(destroyedError, ['destroyElement']);
},
empty: function() {
throw fmt(destroyedError, ['empty']);
},
setElement: function() {
throw fmt(destroyedError, ["set('element', ...)"]);
},
// Since element insertion is scheduled, don't do anything if
// the view has been destroyed between scheduling and execution
insertElement: Ember.K
};
})();
(function() {
// ==========================================================================
// Project: Ember - JavaScript Application Framework
// Copyright: ©2006-2011 Strobe Inc. and contributors.
// Portions ©2008-2011 Apple Inc. All rights reserved.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
})();
(function() {
// ==========================================================================
// Project: Ember - JavaScript Application Framework
// Copyright: ©2006-2011 Strobe Inc. and contributors.
// Portions ©2008-2011 Apple Inc. All rights reserved.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
var get = Ember.get, set = Ember.set, meta = Ember.meta;
var forEach = Ember.EnumerableUtils.forEach;
var childViewsProperty = Ember.computed(function() {
return get(this, '_childViews');
}).property('_childViews').cacheable();
/**
@class
A `ContainerView` is an `Ember.View` subclass that allows for manual or programatic
management of a view's `childViews` array that will correctly update the `ContainerView`
instance's rendered DOM representation.
## Setting Initial Child Views
The initial array of child views can be set in one of two ways. You can provide
a `childViews` property at creation time that contains instance of `Ember.View`:
aContainer = Ember.ContainerView.create({
childViews: [Ember.View.create(), Ember.View.create()]
})
You can also provide a list of property names whose values are instances of `Ember.View`:
aContainer = Ember.ContainerView.create({
childViews: ['aView', 'bView', 'cView'],
aView: Ember.View.create(),
bView: Ember.View.create()
cView: Ember.View.create()
})
The two strategies can be combined:
aContainer = Ember.ContainerView.create({
childViews: ['aView', Ember.View.create()],
aView: Ember.View.create()
})
Each child view's rendering will be inserted into the container's rendered HTML in the same
order as its position in the `childViews` property.
## Adding and Removing Child Views
The views in a container's `childViews` array should be added and removed by manipulating
the `childViews` property directly.
To remove a view pass that view into a `removeObject` call on the container's `childViews` property.
Given an empty `<body>` the following code
aContainer = Ember.ContainerView.create({
classNames: ['the-container'],
childViews: ['aView', 'bView'],
aView: Ember.View.create({
template: Ember.Handlebars.compile("A")
}),
bView: Ember.View.create({
template: Ember.Handlebars.compile("B")
})
})
aContainer.appendTo('body')
Results in the HTML
<div class="ember-view the-container">
<div class="ember-view">A</div>
<div class="ember-view">B</div>
</div>
Removing a view
aContainer.get('childViews') // [aContainer.aView, aContainer.bView]
aContainer.get('childViews').removeObject(aContainer.get('bView'))
aContainer.get('childViews') // [aContainer.aView]
Will result in the following HTML
<div class="ember-view the-container">
<div class="ember-view">A</div>
</div>
Similarly, adding a child view is accomplished by adding `Ember.View` instances to the
container's `childViews` property.
Given an empty `<body>` the following code
aContainer = Ember.ContainerView.create({
classNames: ['the-container'],
childViews: ['aView', 'bView'],
aView: Ember.View.create({
template: Ember.Handlebars.compile("A")
}),
bView: Ember.View.create({
template: Ember.Handlebars.compile("B")
})
})
aContainer.appendTo('body')
Results in the HTML
<div class="ember-view the-container">
<div class="ember-view">A</div>
<div class="ember-view">B</div>
</div>
Adding a view
AnotherViewClass = Ember.View.extend({
template: Ember.Handlebars.compile("Another view")
})
aContainer.get('childViews') // [aContainer.aView, aContainer.bView]
aContainer.get('childViews').pushObject(AnotherViewClass.create())
aContainer.get('childViews') // [aContainer.aView, aContainer.bView, <AnotherViewClass instance>]
Will result in the following HTML
<div class="ember-view the-container">
<div class="ember-view">A</div>
<div class="ember-view">B</div>
<div class="ember-view">Another view</div>
</div>
Direct manipulation of childViews presence or absence in the DOM via calls to
`remove` or `removeFromParent` or calls to a container's `removeChild` may not behave
correctly.
Calling `remove()` on a child view will remove the view's HTML, but it will remain as part of its
container's `childView`s property.
Calling `removeChild()` on the container will remove the passed view instance from the container's
`childView`s but keep its HTML within the container's rendered view.
Calling `removeFromParent()` behaves as expected but should be avoided in favor of direct
manipulation of a container's `childViews` property.
aContainer = Ember.ContainerView.create({
classNames: ['the-container'],
childViews: ['aView', 'bView'],
aView: Ember.View.create({
template: Ember.Handlebars.compile("A")
}),
bView: Ember.View.create({
template: Ember.Handlebars.compile("B")
})
})
aContainer.appendTo('body')
Results in the HTML
<div class="ember-view the-container">
<div class="ember-view">A</div>
<div class="ember-view">B</div>
</div>
Calling `aContainer.get('aView').removeFromParent()` will result in the following HTML
<div class="ember-view the-container">
<div class="ember-view">B</div>
</div>
And the `Ember.View` instance stored in `aContainer.aView` will be removed from `aContainer`'s
`childViews` array.
## Templates and Layout
A `template`, `templateName`, `defaultTemplate`, `layout`, `layoutName` or `defaultLayout`
property on a container view will not result in the template or layout being rendered.
The HTML contents of a `Ember.ContainerView`'s DOM representation will only be the rendered HTML
of its child views.
## Binding a View to Display
If you would like to display a single view in your ContainerView, you can set its `currentView`
property. When the `currentView` property is set to a view instance, it will be added to the
ContainerView's `childViews` array. If the `currentView` property is later changed to a
different view, the new view will replace the old view. If `currentView` is set to `null`, the
last `currentView` will be removed.
This functionality is useful for cases where you want to bind the display of a ContainerView to
a controller or state manager. For example, you can bind the `currentView` of a container to
a controller like this:
// Controller
App.appController = Ember.Object.create({
view: Ember.View.create({
templateName: 'person_template'
})
});
// Handlebars template
{{view Ember.ContainerView currentViewBinding="App.appController.view"}}
@extends Ember.View
*/
Ember.ContainerView = Ember.View.extend({
init: function() {
this._super();
var childViews = get(this, 'childViews');
Ember.defineProperty(this, 'childViews', childViewsProperty);
var _childViews = this._childViews;
forEach(childViews, function(viewName, idx) {
var view;
if ('string' === typeof viewName) {
view = get(this, viewName);
view = this.createChildView(view);
set(this, viewName, view);
} else {
view = this.createChildView(viewName);
}
_childViews[idx] = view;
}, this);
var currentView = get(this, 'currentView');
if (currentView) _childViews.push(this.createChildView(currentView));
// Make the _childViews array observable
Ember.A(_childViews);
// Sets up an array observer on the child views array. This
// observer will detect when child views are added or removed
// and update the DOM to reflect the mutation.
get(this, 'childViews').addArrayObserver(this, {
willChange: 'childViewsWillChange',
didChange: 'childViewsDidChange'
});
},
/**
Instructs each child view to render to the passed render buffer.
@param {Ember.RenderBuffer} buffer the buffer to render to
@private
*/
render: function(buffer) {
this.forEachChildView(function(view) {
view.renderToBuffer(buffer);
});
},
/**
When the container view is destroyed, tear down the child views
array observer.
@private
*/
willDestroy: function() {
get(this, 'childViews').removeArrayObserver(this, {
willChange: 'childViewsWillChange',
didChange: 'childViewsDidChange'
});
this._super();
},
/**
When a child view is removed, destroy its element so that
it is removed from the DOM.
The array observer that triggers this action is set up in the
`renderToBuffer` method.
@private
@param {Ember.Array} views the child views array before mutation
@param {Number} start the start position of the mutation
@param {Number} removed the number of child views removed
**/
childViewsWillChange: function(views, start, removed) {
if (removed === 0) { return; }
var changedViews = views.slice(start, start+removed);
this.initializeViews(changedViews, null, null);
this.invokeForState('childViewsWillChange', views, start, removed);
},
/**
When a child view is added, make sure the DOM gets updated appropriately.
If the view has already rendered an element, we tell the child view to
create an element and insert it into the DOM. If the enclosing container view
has already written to a buffer, but not yet converted that buffer into an
element, we insert the string representation of the child into the appropriate
place in the buffer.
@private
@param {Ember.Array} views the array of child views afte the mutation has occurred
@param {Number} start the start position of the mutation
@param {Number} removed the number of child views removed
@param {Number} the number of child views added
*/
childViewsDidChange: function(views, start, removed, added) {
var len = get(views, 'length');
// No new child views were added; bail out.
if (added === 0) return;
var changedViews = views.slice(start, start+added);
this.initializeViews(changedViews, this, get(this, 'templateData'));
// Let the current state handle the changes
this.invokeForState('childViewsDidChange', views, start, added);
},
initializeViews: function(views, parentView, templateData) {
forEach(views, function(view) {
set(view, '_parentView', parentView);
if (!get(view, 'templateData')) {
set(view, 'templateData', templateData);
}
});
},
/**
Schedules a child view to be inserted into the DOM after bindings have
finished syncing for this run loop.
@param {Ember.View} view the child view to insert
@param {Ember.View} prev the child view after which the specified view should
be inserted
@private
*/
_scheduleInsertion: function(view, prev) {
if (prev) {
prev.domManager.after(prev, view);
} else {
this.domManager.prepend(this, view);
}
},
currentView: null,
_currentViewWillChange: Ember.beforeObserver(function() {
var childViews = get(this, 'childViews'),
currentView = get(this, 'currentView');
if (currentView) {
childViews.removeObject(currentView);
currentView.destroy();
}
}, 'currentView'),
_currentViewDidChange: Ember.observer(function() {
var childViews = get(this, 'childViews'),
currentView = get(this, 'currentView');
if (currentView) {
childViews.pushObject(currentView);
}
}, 'currentView')
});
// Ember.ContainerView extends the default view states to provide different
// behavior for childViewsWillChange and childViewsDidChange.
Ember.ContainerView.states = {
parent: Ember.View.states,
inBuffer: {
childViewsDidChange: function(parentView, views, start, added) {
var buffer = parentView.buffer,
startWith, prev, prevBuffer, view;
// Determine where to begin inserting the child view(s) in the
// render buffer.
if (start === 0) {
// If views were inserted at the beginning, prepend the first
// view to the render buffer, then begin inserting any
// additional views at the beginning.
view = views[start];
startWith = start + 1;
view.renderToBuffer(buffer, 'prepend');
} else {
// Otherwise, just insert them at the same place as the child
// views mutation.
view = views[start - 1];
startWith = start;
}
for (var i=startWith; i<start+added; i++) {
prev = view;
view = views[i];
prevBuffer = prev.buffer;
view.renderToBuffer(prevBuffer, 'insertAfter');
}
}
},
hasElement: {
childViewsWillChange: function(view, views, start, removed) {
for (var i=start; i<start+removed; i++) {
views[i].remove();
}
},
childViewsDidChange: function(view, views, start, added) {
// If the DOM element for this container view already exists,
// schedule each child view to insert its DOM representation after
// bindings have finished syncing.
var prev = start === 0 ? null : views[start-1];
for (var i=start; i<start+added; i++) {
view = views[i];
this._scheduleInsertion(view, prev);
prev = view;
}
}
}
};
Ember.ContainerView.states.inDOM = {
parentState: Ember.ContainerView.states.hasElement
};
Ember.ContainerView.reopen({
states: Ember.ContainerView.states
});
})();
(function() {
// ==========================================================================
// Project: Ember - JavaScript Application Framework
// Copyright: ©2006-2011 Strobe Inc. and contributors.
// Portions ©2008-2011 Apple Inc. All rights reserved.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
var get = Ember.get, set = Ember.set, fmt = Ember.String.fmt;
/**
@class
`Ember.CollectionView` is an `Ember.View` descendent responsible for managing a
collection (an array or array-like object) by maintaing a child view object and
associated DOM representation for each item in the array and ensuring that child
views and their associated rendered HTML are updated when items in the array
are added, removed, or replaced.
## Setting content
The managed collection of objects is referenced as the `Ember.CollectionView` instance's
`content` property.
someItemsView = Ember.CollectionView.create({
content: ['A', 'B','C']
})
The view for each item in the collection will have its `content` property set
to the item.
## Specifying itemViewClass
By default the view class for each item in the managed collection will be an instance
of `Ember.View`. You can supply a different class by setting the `CollectionView`'s
`itemViewClass` property.
Given an empty `<body>` and the following code:
someItemsView = Ember.CollectionView.create({
classNames: ['a-collection'],
content: ['A','B','C'],
itemViewClass: Ember.View.extend({
template: Ember.Handlebars.compile("the letter: {{view.content}}")
})
})
someItemsView.appendTo('body')
Will result in the following HTML structure
<div class="ember-view a-collection">
<div class="ember-view">the letter: A</div>
<div class="ember-view">the letter: B</div>
<div class="ember-view">the letter: C</div>
</div>
## Automatic matching of parent/child tagNames
Setting the `tagName` property of a `CollectionView` to any of
"ul", "ol", "table", "thead", "tbody", "tfoot", "tr", or "select" will result
in the item views receiving an appropriately matched `tagName` property.
Given an empty `<body>` and the following code:
anUndorderedListView = Ember.CollectionView.create({
tagName: 'ul',
content: ['A','B','C'],
itemViewClass: Ember.View.extend({
template: Ember.Handlebars.compile("the letter: {{view.content}}")
})
})
anUndorderedListView.appendTo('body')
Will result in the following HTML structure
<ul class="ember-view a-collection">
<li class="ember-view">the letter: A</li>
<li class="ember-view">the letter: B</li>
<li class="ember-view">the letter: C</li>
</ul>
Additional tagName pairs can be provided by adding to `Ember.CollectionView.CONTAINER_MAP `
Ember.CollectionView.CONTAINER_MAP['article'] = 'section'
## Empty View
You can provide an `Ember.View` subclass to the `Ember.CollectionView` instance as its
`emptyView` property. If the `content` property of a `CollectionView` is set to `null`
or an empty array, an instance of this view will be the `CollectionView`s only child.
aListWithNothing = Ember.CollectionView.create({
classNames: ['nothing']
content: null,
emptyView: Ember.View.extend({
template: Ember.Handlebars.compile("The collection is empty")
})
})
aListWithNothing.appendTo('body')
Will result in the following HTML structure
<div class="ember-view nothing">
<div class="ember-view">
The collection is empty
</div>
</div>
## Adding and Removing items
The `childViews` property of a `CollectionView` should not be directly manipulated. Instead,
add, remove, replace items from its `content` property. This will trigger
appropriate changes to its rendered HTML.
## Use in templates via the `{{collection}}` Ember.Handlebars helper
Ember.Handlebars provides a helper specifically for adding `CollectionView`s to templates.
See `Ember.Handlebars.collection` for more details
@since Ember 0.9
@extends Ember.ContainerView
*/
Ember.CollectionView = Ember.ContainerView.extend(
/** @scope Ember.CollectionView.prototype */ {
/**
A list of items to be displayed by the Ember.CollectionView.
@type Ember.Array
@default null
*/
content: null,
/**
@private
This provides metadata about what kind of empty view class this
collection would like if it is being instantiated from another
system (like Handlebars)
*/
emptyViewClass: Ember.View,
/**
An optional view to display if content is set to an empty array.
@type Ember.View
@default null
*/
emptyView: null,
/**
@type Ember.View
@default Ember.View
*/
itemViewClass: Ember.View,
/** @private */
init: function() {
var ret = this._super();
this._contentDidChange();
return ret;
},
_contentWillChange: Ember.beforeObserver(function() {
var content = this.get('content');
if (content) { content.removeArrayObserver(this); }
var len = content ? get(content, 'length') : 0;
this.arrayWillChange(content, 0, len);
}, 'content'),
/**
@private
Check to make sure that the content has changed, and if so,
update the children directly. This is always scheduled
asynchronously, to allow the element to be created before
bindings have synchronized and vice versa.
*/
_contentDidChange: Ember.observer(function() {
var content = get(this, 'content');
if (content) {
Ember.assert(fmt("an Ember.CollectionView's content must implement Ember.Array. You passed %@", [content]), Ember.Array.detect(content));
content.addArrayObserver(this);
}
var len = content ? get(content, 'length') : 0;
this.arrayDidChange(content, 0, null, len);
}, 'content'),
willDestroy: function() {
var content = get(this, 'content');
if (content) { content.removeArrayObserver(this); }
this._super();
},
arrayWillChange: function(content, start, removedCount) {
// If the contents were empty before and this template collection has an
// empty view remove it now.
var emptyView = get(this, 'emptyView');
if (emptyView && emptyView instanceof Ember.View) {
emptyView.removeFromParent();
}
// Loop through child views that correspond with the removed items.
// Note that we loop from the end of the array to the beginning because
// we are mutating it as we go.
var childViews = get(this, 'childViews'), childView, idx, len;
len = get(childViews, 'length');
var removingAll = removedCount === len;
if (removingAll) {
this.invokeForState('empty');
}
for (idx = start + removedCount - 1; idx >= start; idx--) {
childView = childViews[idx];
if (removingAll) { childView.removedFromDOM = true; }
childView.destroy();
}
},
/**
Called when a mutation to the underlying content array occurs.
This method will replay that mutation against the views that compose the
Ember.CollectionView, ensuring that the view reflects the model.
This array observer is added in contentDidChange.
@param {Array} addedObjects
the objects that were added to the content
@param {Array} removedObjects
the objects that were removed from the content
@param {Number} changeIndex
the index at which the changes occurred
*/
arrayDidChange: function(content, start, removed, added) {
var itemViewClass = get(this, 'itemViewClass'),
childViews = get(this, 'childViews'),
addedViews = [], view, item, idx, len, itemTagName;
if ('string' === typeof itemViewClass) {
itemViewClass = get(itemViewClass);
}
Ember.assert(fmt("itemViewClass must be a subclass of Ember.View, not %@", [itemViewClass]), Ember.View.detect(itemViewClass));
len = content ? get(content, 'length') : 0;
if (len) {
for (idx = start; idx < start+added; idx++) {
item = content.objectAt(idx);
view = this.createChildView(itemViewClass, {
content: item,
contentIndex: idx
});
addedViews.push(view);
}
} else {
var emptyView = get(this, 'emptyView');
if (!emptyView) { return; }
emptyView = this.createChildView(emptyView);
addedViews.push(emptyView);
set(this, 'emptyView', emptyView);
}
childViews.replace(start, 0, addedViews);
},
createChildView: function(view, attrs) {
view = this._super(view, attrs);
var itemTagName = get(view, 'tagName');
var tagName = (itemTagName === null || itemTagName === undefined) ? Ember.CollectionView.CONTAINER_MAP[get(this, 'tagName')] : itemTagName;
set(view, 'tagName', tagName);
return view;
}
});
/**
@static
A map of parent tags to their default child tags. You can add
additional parent tags if you want collection views that use
a particular parent tag to default to a child tag.
@type Hash
@constant
*/
Ember.CollectionView.CONTAINER_MAP = {
ul: 'li',
ol: 'li',
table: 'tr',
thead: 'tr',
tbody: 'tr',
tfoot: 'tr',
tr: 'td',
select: 'option'
};
})();
(function() {
// ==========================================================================
// Project: Ember - JavaScript Application Framework
// Copyright: ©2006-2011 Strobe Inc. and contributors.
// Portions ©2008-2011 Apple Inc. All rights reserved.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
})();
(function() {
// ==========================================================================
// Project: Ember - JavaScript Application Framework
// Copyright: ©2006-2011 Strobe Inc. and contributors.
// Portions ©2008-2011 Apple Inc. All rights reserved.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
/*globals jQuery*/
})();
(function() {
var get = Ember.get, set = Ember.set;
/**
@class
@extends Ember.Object
*/
Ember.State = Ember.Object.extend(Ember.Evented,
/** @scope Ember.State.prototype */{
isState: true,
/**
A reference to the parent state.
@type Ember.State
*/
parentState: null,
start: null,
/**
The name of this state.
@type String
*/
name: null,
/**
The full path to this state.
@type String
@readOnly
*/
path: Ember.computed(function() {
var parentPath = get(this, 'parentState.path'),
path = get(this, 'name');
if (parentPath) {
path = parentPath + '.' + path;
}
return path;
}).property().cacheable(),
/**
@private
Override the default event firing from Ember.Evented to
also call methods with the given name.
*/
trigger: function(name) {
if (this[name]) {
this[name].apply(this, [].slice.call(arguments, 1));
}
this._super.apply(this, arguments);
},
/** @private */
init: function() {
var states = get(this, 'states'), foundStates;
set(this, 'childStates', Ember.A());
set(this, 'eventTransitions', get(this, 'eventTransitions') || {});
var name, value, transitionTarget;
// As a convenience, loop over the properties
// of this state and look for any that are other
// Ember.State instances or classes, and move them
// to the `states` hash. This avoids having to
// create an explicit separate hash.
if (!states) {
states = {};
for (name in this) {
if (name === "constructor") { continue; }
if (value = this[name]) {
if (transitionTarget = value.transitionTarget) {
this.eventTransitions[name] = transitionTarget;
}
this.setupChild(states, name, value);
}
}
set(this, 'states', states);
} else {
for (name in states) {
this.setupChild(states, name, states[name]);
}
}
set(this, 'pathsCache', {});
set(this, 'pathsCacheNoContext', {});
},
/** @private */
setupChild: function(states, name, value) {
if (!value) { return false; }
if (value.isState) {
set(value, 'name', name);
} else if (Ember.State.detect(value)) {
value = value.create({
name: name
});
}
if (value.isState) {
set(value, 'parentState', this);
get(this, 'childStates').pushObject(value);
states[name] = value;
}
},
lookupEventTransition: function(name) {
var path, state = this;
while(state && !path) {
path = state.eventTransitions[name];
state = state.get('parentState');
}
return path;
},
/**
A Boolean value indicating whether the state is a leaf state
in the state hierarchy. This is false if the state has child
states; otherwise it is true.
@type Boolean
*/
isLeaf: Ember.computed(function() {
return !get(this, 'childStates').length;
}).cacheable(),
/**
A boolean value indicating whether the state takes a context.
By default we assume all states take contexts.
*/
hasContext: true,
/**
This is the default transition event.
@event
@param {Ember.StateManager} manager
@param context
@see Ember.StateManager#transitionEvent
*/
setup: Ember.K,
/**
This event fires when the state is entered.
@event
@param {Ember.StateManager} manager
*/
enter: Ember.K,
/**
This event fires when the state is exited.
@event
@param {Ember.StateManager} manager
*/
exit: Ember.K
});
var Event = Ember.$ && Ember.$.Event;
Ember.State.reopenClass(
/** @scope Ember.State */{
/**
@static
Creates an action function for transitioning to the named state while preserving context.
The following example StateManagers are equivalent:
aManager = Ember.StateManager.create({
stateOne: Ember.State.create({
changeToStateTwo: Ember.State.transitionTo('stateTwo')
}),
stateTwo: Ember.State.create({})
})
bManager = Ember.StateManager.create({
stateOne: Ember.State.create({
changeToStateTwo: function(manager, context){
manager.transitionTo('stateTwo', context)
}
}),
stateTwo: Ember.State.create({})
})
@param {String} target
*/
transitionTo: function(target) {
var event = function(stateManager, context) {
if (Event && context instanceof Event) {
if (context.hasOwnProperty('context')) {
context = context.context;
} else {
// If we received an event and it doesn't contain
// a context, don't pass along a superfluous
// context to the target of the event.
return stateManager.transitionTo(target);
}
}
stateManager.transitionTo(target, context);
};
event.transitionTarget = target;
return event;
}
});
})();
(function() {
var get = Ember.get, set = Ember.set, fmt = Ember.String.fmt;
var arrayForEach = Ember.ArrayPolyfills.forEach;
/**
@private
A Transition takes the enter, exit and resolve states and normalizes
them:
* takes any passed in contexts into consideration
* adds in `initialState`s
*/
var Transition = function(raw) {
this.enterStates = raw.enterStates.slice();
this.exitStates = raw.exitStates.slice();
this.resolveState = raw.resolveState;
this.finalState = raw.enterStates[raw.enterStates.length - 1] || raw.resolveState;
};
Transition.prototype = {
/**
@private
Normalize the passed in enter, exit and resolve states.
This process also adds `finalState` and `contexts` to the Transition object.
@param {Ember.StateManager} manager the state manager running the transition
@param {Array} contexts a list of contexts passed into `transitionTo`
*/
normalize: function(manager, contexts) {
this.matchContextsToStates(contexts);
this.addInitialStates();
this.removeUnchangedContexts(manager);
return this;
},
/**
@private
Match each of the contexts passed to `transitionTo` to a state.
This process may also require adding additional enter and exit
states if there are more contexts than enter states.
@param {Array} contexts a list of contexts passed into `transitionTo`
*/
matchContextsToStates: function(contexts) {
var stateIdx = this.enterStates.length - 1,
matchedContexts = [],
state,
context;
// Next, we will match the passed in contexts to the states they
// represent.
//
// First, assign a context to each enter state in reverse order. If
// any contexts are left, add a parent state to the list of states
// to enter and exit, and assign a context to the parent state.
//
// If there are still contexts left when the state manager is
// reached, raise an exception.
//
// This allows the following:
//
// |- root
// | |- post
// | | |- comments
// | |- about (* current state)
//
// For `transitionTo('post.comments', post, post.get('comments')`,
// the first context (`post`) will be assigned to `root.post`, and
// the second context (`post.get('comments')`) will be assigned
// to `root.post.comments`.
//
// For the following:
//
// |- root
// | |- post
// | | |- index (* current state)
// | | |- comments
//
// For `transitionTo('post.comments', otherPost, otherPost.get('comments')`,
// the `<root.post>` state will be added to the list of enter and exit
// states because its context has changed.
while (contexts.length > 0) {
if (stateIdx >= 0) {
state = this.enterStates[stateIdx--];
} else {
if (this.enterStates.length) {
state = get(this.enterStates[0], 'parentState');
if (!state) { throw "Cannot match all contexts to states"; }
} else {
// If re-entering the current state with a context, the resolve
// state will be the current state.
state = this.resolveState;
}
this.enterStates.unshift(state);
this.exitStates.unshift(state);
}
// in routers, only states with dynamic segments have a context
if (get(state, 'hasContext')) {
context = contexts.pop();
} else {
context = null;
}
matchedContexts.unshift(context);
}
this.contexts = matchedContexts;
},
/**
@private
Add any `initialState`s to the list of enter states.
*/
addInitialStates: function() {
var finalState = this.finalState, initialState;
while(true) {
initialState = get(finalState, 'initialState') || 'start';
finalState = get(finalState, 'states.' + initialState);
if (!finalState) { break; }
this.finalState = finalState;
this.enterStates.push(finalState);
this.contexts.push(undefined);
}
},
/**
@private
Remove any states that were added because the number of contexts
exceeded the number of explicit enter states, but the context has
not changed since the last time the state was entered.
@param {Ember.StateManager} manager passed in to look up the last
context for a states
*/
removeUnchangedContexts: function(manager) {
// Start from the beginning of the enter states. If the state was added
// to the list during the context matching phase, make sure the context
// has actually changed since the last time the state was entered.
while (this.enterStates.length > 0) {
if (this.enterStates[0] !== this.exitStates[0]) { break; }
if (this.enterStates.length === this.contexts.length) {
if (manager.getStateMeta(this.enterStates[0], 'context') !== this.contexts[0]) { break; }
this.contexts.shift();
}
this.resolveState = this.enterStates.shift();
this.exitStates.shift();
}
}
};
/**
@class
StateManager is part of Ember's implementation of a finite state machine. A StateManager
instance manages a number of properties that are instances of `Ember.State`,
tracks the current active state, and triggers callbacks when states have changed.
## Defining States
The states of StateManager can be declared in one of two ways. First, you can define
a `states` property that contains all the states:
managerA = Ember.StateManager.create({
states: {
stateOne: Ember.State.create(),
stateTwo: Ember.State.create()
}
})
managerA.get('states')
// {
// stateOne: Ember.State.create(),
// stateTwo: Ember.State.create()
// }
You can also add instances of `Ember.State` (or an `Ember.State` subclass) directly as properties
of a StateManager. These states will be collected into the `states` property for you.
managerA = Ember.StateManager.create({
stateOne: Ember.State.create(),
stateTwo: Ember.State.create()
})
managerA.get('states')
// {
// stateOne: Ember.State.create(),
// stateTwo: Ember.State.create()
// }
## The Initial State
When created a StateManager instance will immediately enter into the state
defined as its `start` property or the state referenced by name in its
`initialState` property:
managerA = Ember.StateManager.create({
start: Ember.State.create({})
})
managerA.get('currentState.name') // 'start'
managerB = Ember.StateManager.create({
initialState: 'beginHere',
beginHere: Ember.State.create({})
})
managerB.get('currentState.name') // 'beginHere'
Because it is a property you may also provide a computed function if you wish to derive
an `initialState` programmatically:
managerC = Ember.StateManager.create({
initialState: function(){
if (someLogic) {
return 'active';
} else {
return 'passive';
}
}.property(),
active: Ember.State.create({}),
passive: Ember.State.create({})
})
## Moving Between States
A StateManager can have any number of Ember.State objects as properties
and can have a single one of these states as its current state.
Calling `transitionTo` transitions between states:
robotManager = Ember.StateManager.create({
initialState: 'poweredDown',
poweredDown: Ember.State.create({}),
poweredUp: Ember.State.create({})
})
robotManager.get('currentState.name') // 'poweredDown'
robotManager.transitionTo('poweredUp')
robotManager.get('currentState.name') // 'poweredUp'
Before transitioning into a new state the existing `currentState` will have its
`exit` method called with the StateManager instance as its first argument and
an object representing the transition as its second argument.
After transitioning into a new state the new `currentState` will have its
`enter` method called with the StateManager instance as its first argument and
an object representing the transition as its second argument.
robotManager = Ember.StateManager.create({
initialState: 'poweredDown',
poweredDown: Ember.State.create({
exit: function(stateManager){
console.log("exiting the poweredDown state")
}
}),
poweredUp: Ember.State.create({
enter: function(stateManager){
console.log("entering the poweredUp state. Destroy all humans.")
}
})
})
robotManager.get('currentState.name') // 'poweredDown'
robotManager.transitionTo('poweredUp')
// will log
// 'exiting the poweredDown state'
// 'entering the poweredUp state. Destroy all humans.'
Once a StateManager is already in a state, subsequent attempts to enter that state will
not trigger enter or exit method calls. Attempts to transition into a state that the
manager does not have will result in no changes in the StateManager's current state:
robotManager = Ember.StateManager.create({
initialState: 'poweredDown',
poweredDown: Ember.State.create({
exit: function(stateManager){
console.log("exiting the poweredDown state")
}
}),
poweredUp: Ember.State.create({
enter: function(stateManager){
console.log("entering the poweredUp state. Destroy all humans.")
}
})
})
robotManager.get('currentState.name') // 'poweredDown'
robotManager.transitionTo('poweredUp')
// will log
// 'exiting the poweredDown state'
// 'entering the poweredUp state. Destroy all humans.'
robotManager.transitionTo('poweredUp') // no logging, no state change
robotManager.transitionTo('someUnknownState') // silently fails
robotManager.get('currentState.name') // 'poweredUp'
Each state property may itself contain properties that are instances of Ember.State.
The StateManager can transition to specific sub-states in a series of transitionTo method calls or
via a single transitionTo with the full path to the specific state. The StateManager will also
keep track of the full path to its currentState
robotManager = Ember.StateManager.create({
initialState: 'poweredDown',
poweredDown: Ember.State.create({
charging: Ember.State.create(),
charged: Ember.State.create()
}),
poweredUp: Ember.State.create({
mobile: Ember.State.create(),
stationary: Ember.State.create()
})
})
robotManager.get('currentState.name') // 'poweredDown'
robotManager.transitionTo('poweredUp')
robotManager.get('currentState.name') // 'poweredUp'
robotManager.transitionTo('mobile')
robotManager.get('currentState.name') // 'mobile'
// transition via a state path
robotManager.transitionTo('poweredDown.charging')
robotManager.get('currentState.name') // 'charging'
robotManager.get('currentState.path') // 'poweredDown.charging'
Enter transition methods will be called for each state and nested child state in their
hierarchical order. Exit methods will be called for each state and its nested states in
reverse hierarchical order.
Exit transitions for a parent state are not called when entering into one of its child states,
only when transitioning to a new section of possible states in the hierarchy.
robotManager = Ember.StateManager.create({
initialState: 'poweredDown',
poweredDown: Ember.State.create({
enter: function(){},
exit: function(){
console.log("exited poweredDown state")
},
charging: Ember.State.create({
enter: function(){},
exit: function(){}
}),
charged: Ember.State.create({
enter: function(){
console.log("entered charged state")
},
exit: function(){
console.log("exited charged state")
}
})
}),
poweredUp: Ember.State.create({
enter: function(){
console.log("entered poweredUp state")
},
exit: function(){},
mobile: Ember.State.create({
enter: function(){
console.log("entered mobile state")
},
exit: function(){}
}),
stationary: Ember.State.create({
enter: function(){},
exit: function(){}
})
})
})
robotManager.get('currentState.path') // 'poweredDown'
robotManager.transitionTo('charged')
// logs 'entered charged state'
// but does *not* log 'exited poweredDown state'
robotManager.get('currentState.name') // 'charged
robotManager.transitionTo('poweredUp.mobile')
// logs
// 'exited charged state'
// 'exited poweredDown state'
// 'entered poweredUp state'
// 'entered mobile state'
During development you can set a StateManager's `enableLogging` property to `true` to
receive console messages of state transitions.
robotManager = Ember.StateManager.create({
enableLogging: true
})
## Managing currentState with Actions
To control which transitions between states are possible for a given state, StateManager
can receive and route action messages to its states via the `send` method. Calling to `send` with
an action name will begin searching for a method with the same name starting at the current state
and moving up through the parent states in a state hierarchy until an appropriate method is found
or the StateManager instance itself is reached.
If an appropriately named method is found it will be called with the state manager as the first
argument and an optional `context` object as the second argument.
managerA = Ember.StateManager.create({
initialState: 'stateOne.substateOne.subsubstateOne',
stateOne: Ember.State.create({
substateOne: Ember.State.create({
anAction: function(manager, context){
console.log("an action was called")
},
subsubstateOne: Ember.State.create({})
})
})
})
managerA.get('currentState.name') // 'subsubstateOne'
managerA.send('anAction')
// 'stateOne.substateOne.subsubstateOne' has no anAction method
// so the 'anAction' method of 'stateOne.substateOne' is called
// and logs "an action was called"
// with managerA as the first argument
// and no second argument
someObject = {}
managerA.send('anAction', someObject)
// the 'anAction' method of 'stateOne.substateOne' is called again
// with managerA as the first argument and
// someObject as the second argument.
If the StateManager attempts to send an action but does not find an appropriately named
method in the current state or while moving upwards through the state hierarchy
it will throw a new Ember.Error. Action detection only moves upwards through the state hierarchy
from the current state. It does not search in other portions of the hierarchy.
managerB = Ember.StateManager.create({
initialState: 'stateOne.substateOne.subsubstateOne',
stateOne: Ember.State.create({
substateOne: Ember.State.create({
subsubstateOne: Ember.State.create({})
})
}),
stateTwo: Ember.State.create({
anAction: function(manager, context){
// will not be called below because it is
// not a parent of the current state
}
})
})
managerB.get('currentState.name') // 'subsubstateOne'
managerB.send('anAction')
// Error: <Ember.StateManager:ember132> could not
// respond to event anAction in state stateOne.substateOne.subsubstateOne.
Inside of an action method the given state should delegate `transitionTo` calls on its
StateManager.
robotManager = Ember.StateManager.create({
initialState: 'poweredDown.charging',
poweredDown: Ember.State.create({
charging: Ember.State.create({
chargeComplete: function(manager, context){
manager.transitionTo('charged')
}
}),
charged: Ember.State.create({
boot: function(manager, context){
manager.transitionTo('poweredUp')
}
})
}),
poweredUp: Ember.State.create({
beginExtermination: function(manager, context){
manager.transitionTo('rampaging')
},
rampaging: Ember.State.create()
})
})
robotManager.get('currentState.name') // 'charging'
robotManager.send('boot') // throws error, no boot action
// in current hierarchy
robotManager.get('currentState.name') // remains 'charging'
robotManager.send('beginExtermination') // throws error, no beginExtermination
// action in current hierarchy
robotManager.get('currentState.name') // remains 'charging'
robotManager.send('chargeComplete')
robotManager.get('currentState.name') // 'charged'
robotManager.send('boot')
robotManager.get('currentState.name') // 'poweredUp'
robotManager.send('beginExtermination', allHumans)
robotManager.get('currentState.name') // 'rampaging'
Transition actions can also be created using the `transitionTo` method of the Ember.State class. The
following example StateManagers are equivalent:
aManager = Ember.StateManager.create({
stateOne: Ember.State.create({
changeToStateTwo: Ember.State.transitionTo('stateTwo')
}),
stateTwo: Ember.State.create({})
})
bManager = Ember.StateManager.create({
stateOne: Ember.State.create({
changeToStateTwo: function(manager, context){
manager.transitionTo('stateTwo', context)
}
}),
stateTwo: Ember.State.create({})
})
**/
Ember.StateManager = Ember.State.extend(
/** @scope Ember.StateManager.prototype */ {
/**
When creating a new statemanager, look for a default state to transition
into. This state can either be named `start`, or can be specified using the
`initialState` property.
*/
init: function() {
this._super();
set(this, 'stateMeta', Ember.Map.create());
var initialState = get(this, 'initialState');
if (!initialState && get(this, 'states.start')) {
initialState = 'start';
}
if (initialState) {
this.transitionTo(initialState);
Ember.assert('Failed to transition to initial state "' + initialState + '"', !!get(this, 'currentState'));
}
},
stateMetaFor: function(state) {
var meta = get(this, 'stateMeta'),
stateMeta = meta.get(state);
if (!stateMeta) {
stateMeta = {};
meta.set(state, stateMeta);
}
return stateMeta;
},
setStateMeta: function(state, key, value) {
return set(this.stateMetaFor(state), key, value);
},
getStateMeta: function(state, key) {
return get(this.stateMetaFor(state), key);
},
/**
The current state from among the manager's possible states. This property should
not be set directly. Use `transitionTo` to move between states by name.
@type Ember.State
@readOnly
*/
currentState: null,
/**
The name of transitionEvent that this stateManager will dispatch
@property {String}
@default 'setup'
*/
transitionEvent: 'setup',
/**
If set to true, `errorOnUnhandledEvents` will cause an exception to be
raised if you attempt to send an event to a state manager that is not
handled by the current state or any of its parent states.
@type Boolean
@default true
*/
errorOnUnhandledEvent: true,
send: function(event, context) {
Ember.assert('Cannot send event "' + event + '" while currentState is ' + get(this, 'currentState'), get(this, 'currentState'));
return this.sendRecursively(event, get(this, 'currentState'), context);
},
sendRecursively: function(event, currentState, context) {
var log = this.enableLogging,
action = currentState[event];
// Test to see if the action is a method that
// can be invoked. Don't blindly check just for
// existence, because it is possible the state
// manager has a child state of the given name,
// and we should still raise an exception in that
// case.
if (typeof action === 'function') {
if (log) { Ember.Logger.log(fmt("STATEMANAGER: Sending event '%@' to state %@.", [event, get(currentState, 'path')])); }
return action.call(currentState, this, context);
} else {
var parentState = get(currentState, 'parentState');
if (parentState) {
return this.sendRecursively(event, parentState, context);
} else if (get(this, 'errorOnUnhandledEvent')) {
throw new Ember.Error(this.toString() + " could not respond to event " + event + " in state " + get(this, 'currentState.path') + ".");
}
}
},
/**
Finds a state by its state path.
Example:
manager = Ember.StateManager.create({
root: Ember.State.create({
dashboard: Ember.State.create()
})
});
manager.getStateByPath(manager, "root.dashboard")
// returns the dashboard state
@param {Ember.State} root the state to start searching from
@param {String} path the state path to follow
@returns {Ember.State} the state at the end of the path
*/
getStateByPath: function(root, path) {
var parts = path.split('.'),
state = root;
for (var i=0, l=parts.length; i<l; i++) {
state = get(get(state, 'states'), parts[i]);
if (!state) { break; }
}
return state;
},
findStateByPath: function(state, path) {
var possible;
while (!possible && state) {
possible = this.getStateByPath(state, path);
state = get(state, 'parentState');
}
return possible;
},
/**
@private
A state stores its child states in its `states` hash.
This code takes a path like `posts.show` and looks
up `origin.states.posts.states.show`.
It returns a list of all of the states from the
origin, which is the list of states to call `enter`
on.
*/
findStatesByPath: function(origin, path) {
if (!path || path === "") { return undefined; }
var r = path.split('.'),
ret = [];
for (var i=0, len = r.length; i < len; i++) {
var states = get(origin, 'states');
if (!states) { return undefined; }
var s = get(states, r[i]);
if (s) { origin = s; ret.push(s); }
else { return undefined; }
}
return ret;
},
goToState: function() {
// not deprecating this yet so people don't constantly need to
// make trivial changes for little reason.
return this.transitionTo.apply(this, arguments);
},
transitionTo: function(path, context) {
// XXX When is transitionTo called with no path
if (Ember.empty(path)) { return; }
// The ES6 signature of this function is `path, ...contexts`
var contexts = context ? Array.prototype.slice.call(arguments, 1) : [],
currentState = get(this, 'currentState') || this;
// First, get the enter, exit and resolve states for the current state
// and specified path. If possible, use an existing cache.
var hash = this.contextFreeTransition(currentState, path);
// Next, process the raw state information for the contexts passed in.
var transition = new Transition(hash).normalize(this, contexts);
this.enterState(transition);
this.triggerSetupContext(transition);
},
contextFreeTransition: function(currentState, path) {
var cache = currentState.pathsCache[path];
if (cache) { return cache; }
var enterStates = this.findStatesByPath(currentState, path),
exitStates = [],
resolveState = currentState;
// Walk up the states. For each state, check whether a state matching
// the `path` is nested underneath. This will find the closest
// parent state containing `path`.
//
// This allows the user to pass in a relative path. For example, for
// the following state hierarchy:
//
// | |root
// | |- posts
// | | |- show (* current)
// | |- comments
// | | |- show
//
// If the current state is `<root.posts.show>`, an attempt to
// transition to `comments.show` will match `<root.comments.show>`.
//
// First, this code will look for root.posts.show.comments.show.
// Next, it will look for root.posts.comments.show. Finally,
// it will look for `root.comments.show`, and find the state.
//
// After this process, the following variables will exist:
//
// * resolveState: a common parent state between the current
// and target state. In the above example, `<root>` is the
// `resolveState`.
// * enterStates: a list of all of the states represented
// by the path from the `resolveState`. For example, for
// the path `root.comments.show`, `enterStates` would have
// `[<root.comments>, <root.comments.show>]`
// * exitStates: a list of all of the states from the
// `resolveState` to the `currentState`. In the above
// example, `exitStates` would have
// `[<root.posts>`, `<root.posts.show>]`.
while (resolveState && !enterStates) {
exitStates.unshift(resolveState);
resolveState = get(resolveState, 'parentState');
if (!resolveState) {
enterStates = this.findStatesByPath(this, path);
if (!enterStates) {
Ember.assert('Could not find state for path: "'+path+'"');
return;
}
}
enterStates = this.findStatesByPath(resolveState, path);
}
// If the path contains some states that are parents of both the
// current state and the target state, remove them.
//
// For example, in the following hierarchy:
//
// |- root
// | |- post
// | | |- index (* current)
// | | |- show
//
// If the `path` is `root.post.show`, the three variables will
// be:
//
// * resolveState: `<state manager>`
// * enterStates: `[<root>, <root.post>, <root.post.show>]`
// * exitStates: `[<root>, <root.post>, <root.post.index>]`
//
// The goal of this code is to remove the common states, so we
// have:
//
// * resolveState: `<root.post>`
// * enterStates: `[<root.post.show>]`
// * exitStates: `[<root.post.index>]`
//
// This avoid unnecessary calls to the enter and exit transitions.
while (enterStates.length > 0 && enterStates[0] === exitStates[0]) {
resolveState = enterStates.shift();
exitStates.shift();
}
// Cache the enterStates, exitStates, and resolveState for the
// current state and the `path`.
var transitions = currentState.pathsCache[path] = {
exitStates: exitStates,
enterStates: enterStates,
resolveState: resolveState
};
return transitions;
},
triggerSetupContext: function(transitions) {
var contexts = transitions.contexts,
offset = transitions.enterStates.length - contexts.length,
enterStates = transitions.enterStates,
transitionEvent = get(this, 'transitionEvent');
Ember.assert("More contexts provided than states", offset >= 0);
arrayForEach.call(enterStates, function(state, idx) {
state.trigger(transitionEvent, this, contexts[idx-offset]);
}, this);
},
getState: function(name) {
var state = get(this, name),
parentState = get(this, 'parentState');
if (state) {
return state;
} else if (parentState) {
return parentState.getState(name);
}
},
enterState: function(transition) {
var log = this.enableLogging;
var exitStates = transition.exitStates.slice(0).reverse();
arrayForEach.call(exitStates, function(state) {
state.trigger('exit', this);
}, this);
arrayForEach.call(transition.enterStates, function(state) {
if (log) { Ember.Logger.log("STATEMANAGER: Entering " + get(state, 'path')); }
state.trigger('enter', this);
}, this);
set(this, 'currentState', transition.finalState);
}
});
})();
(function() {
// ==========================================================================
// Project: Ember Statecharts
// Copyright: ©2011 Living Social Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
})();
(function() {
var get = Ember.get;
Ember._ResolvedState = Ember.Object.extend({
manager: null,
state: null,
match: null,
object: Ember.computed(function(key, value) {
if (arguments.length === 2) {
this._object = value;
return value;
} else {
if (this._object) {
return this._object;
} else {
var state = get(this, 'state'),
match = get(this, 'match'),
manager = get(this, 'manager');
return state.deserialize(manager, match.hash);
}
}
}).property(),
hasPromise: Ember.computed(function() {
return Ember.canInvoke(get(this, 'object'), 'then');
}).property('object'),
promise: Ember.computed(function() {
var object = get(this, 'object');
if (Ember.canInvoke(object, 'then')) {
return object;
} else {
return {
then: function(success) { success(object); }
};
}
}).property('object'),
transition: function() {
var manager = get(this, 'manager'),
path = get(this, 'state.path'),
object = get(this, 'object');
manager.transitionTo(path, object);
}
});
})();
(function() {
var get = Ember.get;
// The Ember Routable mixin assumes the existance of a simple
// routing shim that supports the following three behaviors:
//
// * .getURL() - this is called when the page loads
// * .setURL(newURL) - this is called from within the state
// manager when the state changes to a routable state
// * .onURLChange(callback) - this happens when the user presses
// the back or forward button
var paramForClass = function(classObject) {
var className = classObject.toString(),
parts = className.split("."),
last = parts[parts.length - 1];
return Ember.String.underscore(last) + "_id";
};
var merge = function(original, hash) {
for (var prop in hash) {
if (!hash.hasOwnProperty(prop)) { continue; }
if (original.hasOwnProperty(prop)) { continue; }
original[prop] = hash[prop];
}
};
/**
@class
@extends Ember.Mixin
*/
Ember.Routable = Ember.Mixin.create({
init: function() {
var redirection;
this.on('connectOutlets', this, this.stashContext);
if (redirection = get(this, 'redirectsTo')) {
Ember.assert("You cannot use `redirectsTo` if you already have a `connectOutlets` method", this.connectOutlets === Ember.K);
this.connectOutlets = function(router) {
router.transitionTo(redirection);
};
}
// normalize empty route to '/'
var route = get(this, 'route');
if (route === '') {
route = '/';
}
this._super();
Ember.assert("You cannot use `redirectsTo` on a state that has child states", !redirection || (!!redirection && !!get(this, 'isLeaf')));
},
/**
@private
Whenever a routable state is entered, the context it was entered with
is stashed so that we can regenerate the state's `absoluteURL` on
demand.
*/
stashContext: function(manager, context) {
var serialized = this.serialize(manager, context);
Ember.assert('serialize must return a hash', !serialized || typeof serialized === 'object');
manager.setStateMeta(this, 'context', context);
manager.setStateMeta(this, 'serialized', serialized);
if (get(this, 'isRoutable') && !get(manager, 'isRouting')) {
this.updateRoute(manager, get(manager, 'location'));
}
},
/**
@private
Whenever a routable state is entered, the router's location object
is notified to set the URL to the current absolute path.
In general, this will update the browser's URL.
*/
updateRoute: function(manager, location) {
if (get(this, 'isLeafRoute')) {
var path = this.absoluteRoute(manager);
location.setURL(path);
}
},
/**
@private
Get the absolute route for the current state and a given
hash.
This method is private, as it expects a serialized hash,
not the original context object.
*/
absoluteRoute: function(manager, hash) {
var parentState = get(this, 'parentState');
var path = '', generated;
// If the parent state is routable, use its current path
// as this route's prefix.
if (get(parentState, 'isRoutable')) {
path = parentState.absoluteRoute(manager, hash);
}
var matcher = get(this, 'routeMatcher'),
serialized = manager.getStateMeta(this, 'serialized');
// merge the existing serialized object in with the passed
// in hash.
hash = hash || {};
merge(hash, serialized);
generated = matcher && matcher.generate(hash);
if (generated) {
path = path + '/' + generated;
}
return path;
},
/**
@private
At the moment, a state is routable if it has a string `route`
property. This heuristic may change.
*/
isRoutable: Ember.computed(function() {
return typeof get(this, 'route') === 'string';
}).cacheable(),
/**
@private
Determine if this is the last routeable state
*/
isLeafRoute: Ember.computed(function() {
if (get(this, 'isLeaf')) { return true; }
return !get(this, 'childStates').findProperty('isRoutable');
}).cacheable(),
/**
@private
A _RouteMatcher object generated from the current route's `route`
string property.
*/
routeMatcher: Ember.computed(function() {
var route = get(this, 'route');
if (route) {
return Ember._RouteMatcher.create({ route: route });
}
}).cacheable(),
/**
@private
Check whether the route has dynamic segments and therefore takes
a context.
*/
hasContext: Ember.computed(function() {
var routeMatcher = get(this, 'routeMatcher');
if (routeMatcher) {
return routeMatcher.identifiers.length > 0;
}
}).cacheable(),
/**
@private
The model class associated with the current state. This property
uses the `modelType` property, in order to allow it to be
specified as a String.
*/
modelClass: Ember.computed(function() {
var modelType = get(this, 'modelType');
if (typeof modelType === 'string') {
return Ember.get(window, modelType);
} else {
return modelType;
}
}).cacheable(),
/**
@private
Get the model class for the state. The heuristic is:
* The state must have a single dynamic segment
* The dynamic segment must end in `_id`
* A dynamic segment like `blog_post_id` is converted into `BlogPost`
* The name is then looked up on the passed in namespace
The process of initializing an application with a router will
pass the application's namespace into the router, which will be
used here.
*/
modelClassFor: function(namespace) {
var modelClass, routeMatcher, identifiers, match, className;
// if an explicit modelType was specified, use that
if (modelClass = get(this, 'modelClass')) { return modelClass; }
// if the router has no lookup namespace, we won't be able to guess
// the modelType
if (!namespace) { return; }
// make sure this state is actually a routable state
routeMatcher = get(this, 'routeMatcher');
if (!routeMatcher) { return; }
// only guess modelType for states with a single dynamic segment
// (no more, no fewer)
identifiers = routeMatcher.identifiers;
if (identifiers.length !== 2) { return; }
// extract the `_id` from the end of the dynamic segment; if the
// dynamic segment does not end in `_id`, we can't guess the
// modelType
match = identifiers[1].match(/^(.*)_id$/);
if (!match) { return; }
// convert the underscored type into a class form and look it up
// on the router's namespace
className = Ember.String.classify(match[1]);
return get(namespace, className);
},
/**
The default method that takes a `params` object and converts
it into an object.
By default, a params hash that looks like `{ post_id: 1 }`
will be looked up as `namespace.Post.find(1)`. This is
designed to work seamlessly with Ember Data, but will work
fine with any class that has a `find` method.
*/
deserialize: function(manager, params) {
var modelClass, routeMatcher, param;
if (modelClass = this.modelClassFor(get(manager, 'namespace'))) {
Ember.assert("Expected "+modelClass.toString()+" to implement `find` for use in '"+this.get('path')+"' `deserialize`. Please implement the `find` method or overwrite `deserialize`.", modelClass.find);
return modelClass.find(params[paramForClass(modelClass)]);
}
return params;
},
/**
The default method that takes an object and converts it into
a params hash.
By default, if there is a single dynamic segment named
`blog_post_id` and the object is a `BlogPost` with an
`id` of `12`, the serialize method will produce:
{ blog_post_id: 12 }
*/
serialize: function(manager, context) {
var modelClass, routeMatcher, namespace, param, id;
if (Ember.empty(context)) { return ''; }
if (modelClass = this.modelClassFor(get(manager, 'namespace'))) {
param = paramForClass(modelClass);
id = get(context, 'id');
context = {};
context[param] = id;
}
return context;
},
/**
@private
*/
resolvePath: function(manager, path) {
if (get(this, 'isLeafRoute')) { return Ember.A(); }
var childStates = get(this, 'childStates'), match;
childStates = Ember.A(childStates.filterProperty('isRoutable'));
childStates = childStates.sort(function(a, b) {
var aDynamicSegments = get(a, 'routeMatcher.identifiers.length'),
bDynamicSegments = get(b, 'routeMatcher.identifiers.length'),
aRoute = get(a, 'route'),
bRoute = get(b, 'route');
if (aRoute.indexOf(bRoute) === 0) {
return -1;
} else if (bRoute.indexOf(aRoute) === 0) {
return 1;
}
if (aDynamicSegments !== bDynamicSegments) {
return aDynamicSegments - bDynamicSegments;
}
return get(b, 'route.length') - get(a, 'route.length');
});
var state = childStates.find(function(state) {
var matcher = get(state, 'routeMatcher');
if (match = matcher.match(path)) { return true; }
});
Ember.assert("Could not find state for path " + path, !!state);
var resolvedState = Ember._ResolvedState.create({
manager: manager,
state: state,
match: match
});
var states = state.resolvePath(manager, match.remaining);
return Ember.A([resolvedState]).pushObjects(states);
},
/**
@private
Once `unroute` has finished unwinding, `routePath` will be called
with the remainder of the route.
For example, if you were in the /posts/1/comments state, and you
moved into the /posts/2/comments state, `routePath` will be called
on the state whose path is `/posts` with the path `/2/comments`.
*/
routePath: function(manager, path) {
if (get(this, 'isLeafRoute')) { return; }
var resolvedStates = this.resolvePath(manager, path),
hasPromises = resolvedStates.some(function(s) { return get(s, 'hasPromise'); });
function runTransition() {
resolvedStates.forEach(function(rs) { rs.transition(); });
}
if (hasPromises) {
manager.transitionTo('loading');
Ember.assert('Loading state should be the child of a route', Ember.Routable.detect(get(manager, 'currentState.parentState')));
Ember.assert('Loading state should not be a route', !Ember.Routable.detect(get(manager, 'currentState')));
manager.handleStatePromises(resolvedStates, runTransition);
} else {
runTransition();
}
},
/**
@private
When you move to a new route by pressing the back
or forward button, this method is called first.
Its job is to move the state manager into a parent
state of the state it will eventually move into.
*/
unroutePath: function(router, path) {
var parentState = get(this, 'parentState');
// If we're at the root state, we're done
if (parentState === router) {
return;
}
path = path.replace(/^(?=[^\/])/, "/");
var absolutePath = this.absoluteRoute(router);
var route = get(this, 'route');
// If the current path is empty, move up one state,
// because the index ('/') state must be a leaf node.
if (route !== '/') {
// If the current path is a prefix of the path we're trying
// to go to, we're done.
var index = path.indexOf(absolutePath),
next = path.charAt(absolutePath.length);
if (index === 0 && (next === "/" || next === "")) {
return;
}
}
// Transition to the parent and call unroute again.
router.enterState({
exitStates: [this],
enterStates: [],
finalState: parentState
});
router.send('unroutePath', path);
},
/**
The `connectOutlets` event will be triggered once a
state has been entered. It will be called with the
route's context.
*/
connectOutlets: Ember.K,
/**
The `navigateAway` event will be triggered when the
URL changes due to the back/forward button
*/
navigateAway: Ember.K
});
})();
(function() {
/**
@class
@extends Ember.Routable
*/
Ember.Route = Ember.State.extend(Ember.Routable);
})();
(function() {
var escapeForRegex = function(text) {
return text.replace(/[\-\[\]{}()*+?.,\\\^\$|#\s]/g, "\\$&");
};
Ember._RouteMatcher = Ember.Object.extend({
state: null,
init: function() {
var route = this.route,
identifiers = [],
count = 1,
escaped;
// Strip off leading slash if present
if (route.charAt(0) === '/') {
route = this.route = route.substr(1);
}
escaped = escapeForRegex(route);
var regex = escaped.replace(/:([a-z_]+)(?=$|\/)/gi, function(match, id) {
identifiers[count++] = id;
return "([^/]+)";
});
this.identifiers = identifiers;
this.regex = new RegExp("^/?" + regex);
},
match: function(path) {
var match = path.match(this.regex);
if (match) {
var identifiers = this.identifiers,
hash = {};
for (var i=1, l=identifiers.length; i<l; i++) {
hash[identifiers[i]] = match[i];
}
return {
remaining: path.substr(match[0].length),
hash: identifiers.length > 0 ? hash : null
};
}
},
generate: function(hash) {
var identifiers = this.identifiers, route = this.route, id;
for (var i=1, l=identifiers.length; i<l; i++) {
id = identifiers[i];
route = route.replace(new RegExp(":" + id), hash[id]);
}
return route;
}
});
})();
(function() {
var get = Ember.get, set = Ember.set;
var merge = function(original, hash) {
for (var prop in hash) {
if (!hash.hasOwnProperty(prop)) { continue; }
if (original.hasOwnProperty(prop)) { continue; }
original[prop] = hash[prop];
}
};
/**
@class
`Ember.Router` is the subclass of `Ember.StateManager` responsible for providing URL-based
application state detection. The `Ember.Router` instance of an application detects the browser URL
at application load time and attempts to match it to a specific application state. Additionally
the router will update the URL to reflect an application's state changes over time.
## Adding a Router Instance to Your Application
An instance of Ember.Router can be associated with an instance of Ember.Application in one of two ways:
You can provide a subclass of Ember.Router as the `Router` property of your application. An instance
of this Router class will be instantiated and route detection will be enabled when the application's
`initialize` method is called. The Router instance will be available as the `router` property
of the application:
App = Ember.Application.create({
Router: Ember.Router.extend({ ... })
});
App.initialize();
App.get('router') // an instance of App.Router
If you want to define a Router instance elsewhere, you can pass the instance to the application's
`initialize` method:
App = Ember.Application.create();
aRouter = Ember.Router.create({ ... });
App.initialize(aRouter);
App.get('router') // aRouter
## Adding Routes to a Router
The `initialState` property of Ember.Router instances is named `root`. The state stored in this
property must be a subclass of Ember.Route. The `root` route acts as the container for the
set of routable states but is not routable itself. It should have states that are also subclasses
of Ember.Route which each have a `route` property describing the URL pattern you would like to detect.
App = Ember.Application.create({
Router: Ember.Router.extend({
root: Ember.Route.extend({
index: Ember.Route.extend({
route: '/'
}),
... additional Ember.Routes ...
})
})
});
App.initialize();
When an application loads, Ember will parse the URL and attempt to find an Ember.Route within
the application's states that matches. (The example URL-matching below will use the default
'hash syntax' provided by `Ember.HashLocation`.)
In the following route structure:
App = Ember.Application.create({
Router: Ember.Router.extend({
root: Ember.Route.extend({
aRoute: Ember.Route.extend({
route: '/'
}),
bRoute: Ember.Route.extend({
route: '/alphabeta'
})
})
})
});
App.initialize();
Loading the page at the URL '#/' will detect the route property of 'root.aRoute' ('/') and
transition the router first to the state named 'root' and then to the substate 'aRoute'.
Respectively, loading the page at the URL '#/alphabeta' would detect the route property of
'root.bRoute' ('/alphabeta') and transition the router first to the state named 'root' and
then to the substate 'bRoute'.
## Adding Nested Routes to a Router
Routes can contain nested subroutes each with their own `route` property describing the nested
portion of the URL they would like to detect and handle. Router, like all instances of StateManager,
cannot call `transitonTo` with an intermediary state. To avoid transitioning the Router into an
intermediary state when detecting URLs, a Route with nested routes must define both a base `route`
property for itself and a child Route with a `route` property of `'/'` which will be transitioned
to when the base route is detected in the URL:
Given the following application code:
App = Ember.Application.create({
Router: Ember.Router.extend({
root: Ember.Route.extend({
aRoute: Ember.Route.extend({
route: '/theBaseRouteForThisSet',
indexSubRoute: Ember.Route.extend({
route: '/',
}),
subRouteOne: Ember.Route.extend({
route: '/subroute1
}),
subRouteTwo: Ember.Route.extend({
route: '/subRoute2'
})
})
})
})
});
App.initialize();
When the application is loaded at '/theBaseRouteForThisSet' the Router will transition to the route
at path 'root.aRoute' and then transition to state 'indexSubRoute'.
When the application is loaded at '/theBaseRouteForThisSet/subRoute1' the Router will transition to
the route at path 'root.aRoute' and then transition to state 'subRouteOne'.
## Route Transition Events
Transitioning between Ember.Route instances (including the transition into the detected
route when loading the application) triggers the same transition events as state transitions for
base `Ember.State`s. However, the default `setup` transition event is named `connectOutlets` on
Ember.Router instances (see 'Changing View Hierarchy in Response To State Change').
The following route structure when loaded with the URL "#/"
App = Ember.Application.create({
Router: Ember.Router.extend({
root: Ember.Route.extend({
aRoute: Ember.Route.extend({
route: '/',
enter: function(router) {
console.log("entering root.aRoute from", router.get('currentState.name'));
},
connectOutlets: function(router) {
console.log("entered root.aRoute, fully transitioned to", router.get('currentState.path'));
}
})
})
})
});
App.initialize();
Will result in console output of:
'entering root.aRoute from root'
'entered root.aRoute, fully transitioned to root.aRoute '
Ember.Route has two additional callbacks for handling URL serialization and deserialization. See
'Serializing/Deserializing URLs'
## Routes With Dynamic Segments
An Ember.Route's `route` property can reference dynamic sections of the URL by prefacing a URL segment
with the ':' character. The values of these dynamic segments will be passed as a hash to the
`deserialize` method of the matching Route (see 'Serializing/Deserializing URLs').
## Serializing/Deserializing URLs
Ember.Route has two callbacks for associating a particular object context with a URL: `serialize`
for converting an object into a parameters hash to fill dynamic segments of a URL and `deserialize`
for converting a hash of dynamic segments from the URL into the appropriate object.
### Deserializing A URL's Dynamic Segments
When an application is first loaded or the URL is changed manually (e.g. through the browser's
back button) the `deserialize` method of the URL's matching Ember.Route will be called with
the application's router as its first argument and a hash of the URLs dynamic segments and values
as its second argument.
The following route structure when loaded with the URL "#/fixed/thefirstvalue/anotherFixed/thesecondvalue":
App = Ember.Application.create({
Router: Ember.Router.extend({
root: Ember.Route.extend({
aRoute: Ember.Route.extend({
route: '/fixed/:dynamicSectionA/anotherFixed/:dynamicSectionB',
deserialize: function(router, params) {}
})
})
})
});
App.initialize();
Will call the 'deserialize' method of the Route instance at the path 'root.aRoute' with the
following hash as its second argument:
{
dynamicSectionA: 'thefirstvalue',
dynamicSectionB: 'thesecondvalue'
}
Within `deserialize` you should use this information to retrieve or create an appropriate context
object for the given URL (e.g. by loading from a remote API or accessing the browser's
`localStorage`). This object must be the `return` value of `deserialize` and will be
passed to the Route's `connectOutlets` and `serialize` methods.
When an application's state is changed from within the application itself, the context provided for
the transition will be passed and `deserialize` is not called (see 'Transitions Between States').
### Serializing An Object For URLs with Dynamic Segments
When transitioning into a Route whose `route` property contains dynamic segments the Route's
`serialize` method is called with the Route's router as the first argument and the Route's
context as the second argument. The return value of `serialize` will be use to populate the
dynamic segments and should be a object with keys that match the names of the dynamic sections.
Given the following route structure:
App = Ember.Application.create({
Router: Ember.Router.extend({
root: Ember.Route.extend({
aRoute: Ember.Route.extend({
route: '/'
}),
bRoute: Ember.Route.extend({
route: '/staticSection/:someDynamicSegment',
serialize: function(router, context) {
return {
someDynamicSegment: context.get('name')
}
}
})
})
})
});
App.initialize();
Transitioning to "root.bRoute" with a context of `Object.create({name: 'Yehuda'})` will call
the Route's `serialize` method with the context as its second argument and update the URL to
'#/staticSection/Yehuda'.
## Transitions Between States
Once a routed application has initialized its state based on the entry URL, subsequent transitions to other
states will update the URL if the entered Route has a `route` property. Given the following route structure
loaded at the URL '#/':
App = Ember.Application.create({
Router: Ember.Router.extend({
root: Ember.Route.extend({
aRoute: Ember.Route.extend({
route: '/',
moveElsewhere: Ember.Route.transitionTo('bRoute')
}),
bRoute: Ember.Route.extend({
route: '/someOtherLocation'
})
})
})
});
App.initialize();
And application code:
App.get('router').send('moveElsewhere');
Will transition the application's state to 'root.bRoute' and trigger an update of the URL to
'#/someOtherLocation'.
For URL patterns with dynamic segments a context can be supplied as the second argument to `send`.
The router will match dynamic segments names to keys on this object and fill in the URL with the
supplied values. Given the following state structure loaded at the URL '#/':
App = Ember.Application.create({
Router: Ember.Router.extend({
root: Ember.Route.extend({
aRoute: Ember.Route.extend({
route: '/',
moveElsewhere: Ember.Route.transitionTo('bRoute')
}),
bRoute: Ember.Route.extend({
route: '/a/route/:dynamicSection/:anotherDynamicSection',
connectOutlets: function(router, context) {},
})
})
})
});
App.initialize();
And application code:
App.get('router').send('moveElsewhere', {
dynamicSection: '42',
anotherDynamicSection: 'Life'
});
Will transition the application's state to 'root.bRoute' and trigger an update of the URL to
'#/a/route/42/Life'.
The context argument will also be passed as the second argument to the `serialize` method call.
## Injection of Controller Singletons
During application initialization Ember will detect properties of the application ending in 'Controller',
create singleton instances of each class, and assign them as a properties on the router. The property name
will be the UpperCamel name converted to lowerCamel format. These controller classes should be subclasses
of Ember.ObjectController, Ember.ArrayController, Ember.Controller, or a custom Ember.Object that includes the
Ember.ControllerMixin mixin.
App = Ember.Application.create({
FooController: Ember.Object.create(Ember.ControllerMixin),
Router: Ember.Router.extend({ ... })
});
App.get('router.fooController'); // instance of App.FooController
The controller singletons will have their `namespace` property set to the application and their `target`
property set to the application's router singleton for easy integration with Ember's user event system.
See 'Changing View Hierarchy in Response To State Change' and 'Responding to User-initiated Events'
## Responding to User-initiated Events
Controller instances injected into the router at application initialization have their `target` property
set to the application's router instance. These controllers will also be the default `context` for their
associated views. Uses of the `{{action}}` helper will automatically target the application's router.
Given the following application entered at the URL '#/':
App = Ember.Application.create({
Router: Ember.Router.extend({
root: Ember.Route.extend({
aRoute: Ember.Route.extend({
route: '/',
anActionOnTheRouter: function(router, context) {
router.transitionTo('anotherState', context);
}
})
anotherState: Ember.Route.extend({
route: '/differentUrl',
connectOutlets: function(router, context) {
}
})
})
})
});
App.initialize();
The following template:
<script type="text/x-handlebars" data-template-name="aView">
<h1><a {{action anActionOnTheRouter}}>{{title}}</a></h1>
</script>
Will delegate `click` events on the rendered `h1` to the application's router instance. In this case the
`anActionOnTheRouter` method of the state at 'root.aRoute' will be called with the view's controller
as the context argument. This context will be passed to the `connectOutlets` as its second argument.
Different `context` can be supplied from within the `{{action}}` helper, allowing specific context passing
between application states:
<script type="text/x-handlebars" data-template-name="photos">
{{#each photo in controller}}
<h1><a {{action showPhoto photo}}>{{title}}</a></h1>
{{/each}}
</script>
See Handlebars.helpers.action for additional usage examples.
## Changing View Hierarchy in Response To State Change
Changes in application state that change the URL should be accompanied by associated changes in view
hierarchy. This can be accomplished by calling 'connectOutlet' on the injected controller singletons from
within the 'connectOutlets' event of an Ember.Route:
App = Ember.Application.create({
OneController: Ember.ObjectController.extend(),
OneView: Ember.View.extend(),
AnotherController: Ember.ObjectController.extend(),
AnotherView: Ember.View.extend(),
Router: Ember.Router.extend({
root: Ember.Route.extend({
aRoute: Ember.Route.extend({
route: '/',
connectOutlets: function(router, context) {
router.get('oneController').connectOutlet('another');
},
})
})
})
});
App.initialize();
This will detect the '{{outlet}}' portion of `oneController`'s view (an instance of `App.OneView`) and
fill it with a rendered instance of `App.AnotherView` whose `context` will be the single instance of
`App.AnotherController` stored on the router in the `anotherController` property.
For more information about Outlets, see `Ember.Handlebars.helpers.outlet`. For additional information on
the `connectOutlet` method, see `Ember.Controller.connectOutlet`. For more information on
controller injections, see `Ember.Application#initialize()`. For additional information about view context,
see `Ember.View`.
@extends Ember.StateManager
*/
Ember.Router = Ember.StateManager.extend(
/** @scope Ember.Router.prototype */ {
/**
@property {String}
@default 'root'
*/
initialState: 'root',
/**
The `Ember.Location` implementation to be used to manage the application
URL state. The following values are supported:
* 'hash': Uses URL fragment identifiers (like #/blog/1) for routing.
* 'none': Does not read or set the browser URL, but still allows for
routing to happen. Useful for testing.
@type String
@default 'hash'
*/
location: 'hash',
/**
This is only used when a history location is used so that applications that
don't live at the root of the domain can append paths to their root.
@type String
@default '/'
*/
rootURL: '/',
/**
On router, transitionEvent should be called connectOutlets
@property {String}
@default 'connectOutlets'
*/
transitionEvent: 'connectOutlets',
transitionTo: function() {
this.abortRoutingPromises();
this._super.apply(this, arguments);
},
route: function(path) {
this.abortRoutingPromises();
set(this, 'isRouting', true);
var routableState;
try {
path = path.replace(/^(?=[^\/])/, "/");
this.send('navigateAway');
this.send('unroutePath', path);
routableState = get(this, 'currentState');
while (routableState && !routableState.get('isRoutable')) {
routableState = get(routableState, 'parentState');
}
var currentURL = routableState ? routableState.absoluteRoute(this) : '';
var rest = path.substr(currentURL.length);
this.send('routePath', rest);
} finally {
set(this, 'isRouting', false);
}
routableState = get(this, 'currentState');
while (routableState && !routableState.get('isRoutable')) {
routableState = get(routableState, 'parentState');
}
if (routableState) {
routableState.updateRoute(this, get(this, 'location'));
}
},
urlFor: function(path, hash) {
var currentState = get(this, 'currentState') || this,
state = this.findStateByPath(currentState, path);
Ember.assert(Ember.String.fmt("Could not find route with path '%@'", [path]), !!state);
Ember.assert("To get a URL for a state, it must have a `route` property.", !!get(state, 'routeMatcher'));
var location = get(this, 'location'),
absoluteRoute = state.absoluteRoute(this, hash);
return location.formatURL(absoluteRoute);
},
urlForEvent: function(eventName) {
var contexts = Array.prototype.slice.call(arguments, 1);
var currentState = get(this, 'currentState');
var targetStateName = currentState.lookupEventTransition(eventName);
Ember.assert(Ember.String.fmt("You must specify a target state for event '%@' in order to link to it in the current state '%@'.", [eventName, get(currentState, 'path')]), !!targetStateName);
var targetState = this.findStateByPath(currentState, targetStateName);
Ember.assert("Your target state name " + targetStateName + " for event " + eventName + " did not resolve to a state", !!targetState);
var hash = this.serializeRecursively(targetState, contexts, {});
return this.urlFor(targetStateName, hash);
},
/** @private */
serializeRecursively: function(state, contexts, hash) {
var parentState,
context = get(state, 'hasContext') ? contexts.pop() : null;
merge(hash, state.serialize(this, context));
parentState = state.get("parentState");
if (parentState && parentState instanceof Ember.Route) {
return this.serializeRecursively(parentState, contexts, hash);
} else {
return hash;
}
},
abortRoutingPromises: function() {
if (this._routingPromises) {
this._routingPromises.abort();
this._routingPromises = null;
}
},
/**
@private
*/
handleStatePromises: function(states, complete) {
this.abortRoutingPromises();
this.set('isLocked', true);
var manager = this;
this._routingPromises = Ember._PromiseChain.create({
promises: states.slice(),
successCallback: function() {
manager.set('isLocked', false);
complete();
},
failureCallback: function() {
throw "Unable to load object";
},
promiseSuccessCallback: function(item, args) {
set(item, 'object', args[0]);
},
abortCallback: function() {
manager.set('isLocked', false);
}
}).start();
},
/** @private */
init: function() {
this._super();
var location = get(this, 'location'),
rootURL = get(this, 'rootURL');
if ('string' === typeof location) {
set(this, 'location', Ember.Location.create({
implementation: location,
rootURL: rootURL
}));
}
},
/** @private */
willDestroy: function() {
get(this, 'location').destroy();
}
});
})();
(function() {
// ==========================================================================
// Project: Ember Routing
// Copyright: ©2012 Tilde Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
})();
(function() {
var get = Ember.get;
Ember.StateManager.reopen(
/** @scope Ember.StateManager.prototype */ {
/**
If the current state is a view state or the descendent of a view state,
this property will be the view associated with it. If there is no
view state active in this state manager, this value will be null.
@type Ember.View
*/
currentView: Ember.computed(function() {
var currentState = get(this, 'currentState'),
view;
while (currentState) {
// TODO: Remove this when view state is removed
if (get(currentState, 'isViewState')) {
view = get(currentState, 'view');
if (view) { return view; }
}
currentState = get(currentState, 'parentState');
}
return null;
}).property('currentState').cacheable()
});
})();
(function() {
var get = Ember.get, set = Ember.set;
/**
@class
@deprecated
Ember.ViewState extends Ember.State to control the presence of a childView within a
container based on the current state of the ViewState's StateManager.
## Interactions with Ember's View System.
When combined with instances of `Ember.StateManager`, ViewState is designed to
interact with Ember's view system to control which views are added to
and removed from the DOM based on the manager's current state.
By default, a StateManager will manage views inside the 'body' element. This can be
customized by setting the `rootElement` property to a CSS selector of an existing
HTML element you would prefer to receive view rendering.
viewStates = Ember.StateManager.create({
rootElement: '#some-other-element'
})
You can also specify a particular instance of `Ember.ContainerView` you would like to receive
view rendering by setting the `rootView` property. You will be responsible for placing
this element into the DOM yourself.
aLayoutView = Ember.ContainerView.create()
// make sure this view instance is added to the browser
aLayoutView.appendTo('body')
App.viewStates = Ember.StateManager.create({
rootView: aLayoutView
})
Once you have an instance of StateManager controlling a view, you can provide states
that are instances of `Ember.ViewState`. When the StateManager enters a state
that is an instance of `Ember.ViewState` that `ViewState`'s `view` property will be
instantiated and inserted into the StateManager's `rootView` or `rootElement`.
When a state is exited, the `ViewState`'s view will be removed from the StateManager's
view.
ContactListView = Ember.View.extend({
classNames: ['my-contacts-css-class'],
template: Ember.Handlebars.compile('<h2>People</h2>')
})
PhotoListView = Ember.View.extend({
classNames: ['my-photos-css-class'],
template: Ember.Handlebars.compile('<h2>Photos</h2>')
})
viewStates = Ember.StateManager.create({
showingPeople: Ember.ViewState.create({
view: ContactListView
}),
showingPhotos: Ember.ViewState.create({
view: PhotoListView
})
})
viewStates.transitionTo('showingPeople')
The above code will change the rendered HTML from
<body></body>
to
<body>
<div id="ember1" class="ember-view my-contacts-css-class">
<h2>People</h2>
</div>
</body>
Changing the current state via `transitionTo` from `showingPeople` to
`showingPhotos` will remove the `showingPeople` view and add the `showingPhotos` view:
viewStates.transitionTo('showingPhotos')
will change the rendered HTML to
<body>
<div id="ember2" class="ember-view my-photos-css-class">
<h2>Photos</h2>
</div>
</body>
When entering nested `ViewState`s, each state's view will be draw into the the StateManager's
`rootView` or `rootElement` as siblings.
ContactListView = Ember.View.extend({
classNames: ['my-contacts-css-class'],
template: Ember.Handlebars.compile('<h2>People</h2>')
})
EditAContactView = Ember.View.extend({
classNames: ['editing-a-contact-css-class'],
template: Ember.Handlebars.compile('Editing...')
})
viewStates = Ember.StateManager.create({
showingPeople: Ember.ViewState.create({
view: ContactListView,
withEditingPanel: Ember.ViewState.create({
view: EditAContactView
})
})
})
viewStates.transitionTo('showingPeople.withEditingPanel')
Will result in the following rendered HTML:
<body>
<div id="ember2" class="ember-view my-contacts-css-class">
<h2>People</h2>
</div>
<div id="ember2" class="ember-view editing-a-contact-css-class">
Editing...
</div>
</body>
ViewState views are added and removed from their StateManager's view via their
`enter` and `exit` methods. If you need to override these methods, be sure to call
`_super` to maintain the adding and removing behavior:
viewStates = Ember.StateManager.create({
aState: Ember.ViewState.create({
view: Ember.View.extend({}),
enter: function(manager){
// calling _super ensures this view will be
// properly inserted
this._super(manager);
// now you can do other things
}
})
})
## Managing Multiple Sections of A Page With States
Multiple StateManagers can be combined to control multiple areas of an application's rendered views.
Given the following HTML body:
<body>
<div id='sidebar-nav'>
</div>
<div id='content-area'>
</div>
</body>
You could separately manage view state for each section with two StateManagers
navigationStates = Ember.StateManager.create({
rootElement: '#sidebar-nav',
userAuthenticated: Em.ViewState.create({
view: Ember.View.extend({})
}),
userNotAuthenticated: Em.ViewState.create({
view: Ember.View.extend({})
})
})
contentStates = Ember.StateManager.create({
rootElement: '#content-area',
books: Em.ViewState.create({
view: Ember.View.extend({})
}),
music: Em.ViewState.create({
view: Ember.View.extend({})
})
})
If you prefer to start with an empty body and manage state programmatically you
can also take advantage of StateManager's `rootView` property and the ability of
`Ember.ContainerView`s to manually manage their child views.
dashboard = Ember.ContainerView.create({
childViews: ['navigationAreaView', 'contentAreaView'],
navigationAreaView: Ember.ContainerView.create({}),
contentAreaView: Ember.ContainerView.create({})
})
navigationStates = Ember.StateManager.create({
rootView: dashboard.get('navigationAreaView'),
userAuthenticated: Em.ViewState.create({
view: Ember.View.extend({})
}),
userNotAuthenticated: Em.ViewState.create({
view: Ember.View.extend({})
})
})
contentStates = Ember.StateManager.create({
rootView: dashboard.get('contentAreaView'),
books: Em.ViewState.create({
view: Ember.View.extend({})
}),
music: Em.ViewState.create({
view: Ember.View.extend({})
})
})
dashboard.appendTo('body')
## User Manipulation of State via `{{action}}` Helpers
The Handlebars `{{action}}` helper is StateManager-aware and will use StateManager action sending
to connect user interaction to action-based state transitions.
Given the following body and handlebars template
<body>
<script type='text/x-handlebars'>
<a href="#" {{action "anAction" target="App.appStates"}}> Go </a>
</script>
</body>
And application code
App = Ember.Application.create()
App.appStates = Ember.StateManager.create({
initialState: 'aState',
aState: Ember.State.create({
anAction: function(manager, context){}
}),
bState: Ember.State.create({})
})
A user initiated click or touch event on "Go" will trigger the 'anAction' method of
`App.appStates.aState` with `App.appStates` as the first argument and a
`jQuery.Event` object as the second object. The `jQuery.Event` will include a property
`view` that references the `Ember.View` object that was interacted with.
**/
Ember.ViewState = Ember.State.extend(
/** @scope Ember.ViewState.prototype */ {
isViewState: true,
init: function() {
Ember.deprecate("Ember.ViewState is deprecated and will be removed from future releases. Consider using the outlet pattern to display nested views instead. For more information, see http://emberjs.com/guides/outlets/.");
return this._super();
},
enter: function(stateManager) {
var view = get(this, 'view'), root, childViews;
if (view) {
if (Ember.View.detect(view)) {
view = view.create();
set(this, 'view', view);
}
Ember.assert('view must be an Ember.View', view instanceof Ember.View);
root = stateManager.get('rootView');
if (root) {
childViews = get(root, 'childViews');
childViews.pushObject(view);
} else {
root = stateManager.get('rootElement') || 'body';
view.appendTo(root);
}
}
},
exit: function(stateManager) {
var view = get(this, 'view');
if (view) {
// If the view has a parent view, then it is
// part of a view hierarchy and should be removed
// from its parent.
if (get(view, 'parentView')) {
view.removeFromParent();
} else {
// Otherwise, the view is a "root view" and
// was appended directly to the DOM.
view.remove();
}
}
}
});
})();
(function() {
// ==========================================================================
// Project: Ember Statecharts
// Copyright: ©2011 Living Social Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
})();
(function() {
// ==========================================================================
// Project: metamorph
// Copyright: ©2011 My Company Inc. All rights reserved.
// ==========================================================================
(function(window) {
var K = function(){},
guid = 0,
document = window.document,
// Feature-detect the W3C range API, the extended check is for IE9 which only partially supports ranges
supportsRange = ('createRange' in document) && (typeof Range !== 'undefined') && Range.prototype.createContextualFragment,
// Internet Explorer prior to 9 does not allow setting innerHTML if the first element
// is a "zero-scope" element. This problem can be worked around by making
// the first node an invisible text node. We, like Modernizr, use &shy;
needsShy = (function(){
var testEl = document.createElement('div');
testEl.innerHTML = "<div></div>";
testEl.firstChild.innerHTML = "<script></script>";
return testEl.firstChild.innerHTML === '';
})();
// Constructor that supports either Metamorph('foo') or new
// Metamorph('foo');
//
// Takes a string of HTML as the argument.
var Metamorph = function(html) {
var self;
if (this instanceof Metamorph) {
self = this;
} else {
self = new K();
}
self.innerHTML = html;
var myGuid = 'metamorph-'+(guid++);
self.start = myGuid + '-start';
self.end = myGuid + '-end';
return self;
};
K.prototype = Metamorph.prototype;
var rangeFor, htmlFunc, removeFunc, outerHTMLFunc, appendToFunc, afterFunc, prependFunc, startTagFunc, endTagFunc;
outerHTMLFunc = function() {
return this.startTag() + this.innerHTML + this.endTag();
};
startTagFunc = function() {
return "<script id='" + this.start + "' type='text/x-placeholder'></script>";
};
endTagFunc = function() {
return "<script id='" + this.end + "' type='text/x-placeholder'></script>";
};
// If we have the W3C range API, this process is relatively straight forward.
if (supportsRange) {
// Get a range for the current morph. Optionally include the starting and
// ending placeholders.
rangeFor = function(morph, outerToo) {
var range = document.createRange();
var before = document.getElementById(morph.start);
var after = document.getElementById(morph.end);
if (outerToo) {
range.setStartBefore(before);
range.setEndAfter(after);
} else {
range.setStartAfter(before);
range.setEndBefore(after);
}
return range;
};
htmlFunc = function(html, outerToo) {
// get a range for the current metamorph object
var range = rangeFor(this, outerToo);
// delete the contents of the range, which will be the
// nodes between the starting and ending placeholder.
range.deleteContents();
// create a new document fragment for the HTML
var fragment = range.createContextualFragment(html);
// insert the fragment into the range
range.insertNode(fragment);
};
removeFunc = function() {
// get a range for the current metamorph object including
// the starting and ending placeholders.
var range = rangeFor(this, true);
// delete the entire range.
range.deleteContents();
};
appendToFunc = function(node) {
var range = document.createRange();
range.setStart(node);
range.collapse(false);
var frag = range.createContextualFragment(this.outerHTML());
node.appendChild(frag);
};
afterFunc = function(html) {
var range = document.createRange();
var after = document.getElementById(this.end);
range.setStartAfter(after);
range.setEndAfter(after);
var fragment = range.createContextualFragment(html);
range.insertNode(fragment);
};
prependFunc = function(html) {
var range = document.createRange();
var start = document.getElementById(this.start);
range.setStartAfter(start);
range.setEndAfter(start);
var fragment = range.createContextualFragment(html);
range.insertNode(fragment);
};
} else {
/**
* This code is mostly taken from jQuery, with one exception. In jQuery's case, we
* have some HTML and we need to figure out how to convert it into some nodes.
*
* In this case, jQuery needs to scan the HTML looking for an opening tag and use
* that as the key for the wrap map. In our case, we know the parent node, and
* can use its type as the key for the wrap map.
**/
var wrapMap = {
select: [ 1, "<select multiple='multiple'>", "</select>" ],
fieldset: [ 1, "<fieldset>", "</fieldset>" ],
table: [ 1, "<table>", "</table>" ],
tbody: [ 2, "<table><tbody>", "</tbody></table>" ],
tr: [ 3, "<table><tbody><tr>", "</tr></tbody></table>" ],
colgroup: [ 2, "<table><tbody></tbody><colgroup>", "</colgroup></table>" ],
map: [ 1, "<map>", "</map>" ],
_default: [ 0, "", "" ]
};
/**
* Given a parent node and some HTML, generate a set of nodes. Return the first
* node, which will allow us to traverse the rest using nextSibling.
*
* We need to do this because innerHTML in IE does not really parse the nodes.
**/
var firstNodeFor = function(parentNode, html) {
var arr = wrapMap[parentNode.tagName.toLowerCase()] || wrapMap._default;
var depth = arr[0], start = arr[1], end = arr[2];
if (needsShy) { html = '&shy;'+html; }
var element = document.createElement('div');
element.innerHTML = start + html + end;
for (var i=0; i<=depth; i++) {
element = element.firstChild;
}
// Look for &shy; to remove it.
if (needsShy) {
var shyElement = element;
// Sometimes we get nameless elements with the shy inside
while (shyElement.nodeType === 1 && !shyElement.nodeName) {
shyElement = shyElement.firstChild;
}
// At this point it's the actual unicode character.
if (shyElement.nodeType === 3 && shyElement.nodeValue.charAt(0) === "\u00AD") {
shyElement.nodeValue = shyElement.nodeValue.slice(1);
}
}
return element;
};
/**
* In some cases, Internet Explorer can create an anonymous node in
* the hierarchy with no tagName. You can create this scenario via:
*
* div = document.createElement("div");
* div.innerHTML = "<table>&shy<script></script><tr><td>hi</td></tr></table>";
* div.firstChild.firstChild.tagName //=> ""
*
* If our script markers are inside such a node, we need to find that
* node and use *it* as the marker.
**/
var realNode = function(start) {
while (start.parentNode.tagName === "") {
start = start.parentNode;
}
return start;
};
/**
* When automatically adding a tbody, Internet Explorer inserts the
* tbody immediately before the first <tr>. Other browsers create it
* before the first node, no matter what.
*
* This means the the following code:
*
* div = document.createElement("div");
* div.innerHTML = "<table><script id='first'></script><tr><td>hi</td></tr><script id='last'></script></table>
*
* Generates the following DOM in IE:
*
* + div
* + table
* - script id='first'
* + tbody
* + tr
* + td
* - "hi"
* - script id='last'
*
* Which means that the two script tags, even though they were
* inserted at the same point in the hierarchy in the original
* HTML, now have different parents.
*
* This code reparents the first script tag by making it the tbody's
* first child.
**/
var fixParentage = function(start, end) {
if (start.parentNode !== end.parentNode) {
end.parentNode.insertBefore(start, end.parentNode.firstChild);
}
};
htmlFunc = function(html, outerToo) {
// get the real starting node. see realNode for details.
var start = realNode(document.getElementById(this.start));
var end = document.getElementById(this.end);
var parentNode = end.parentNode;
var node, nextSibling, last;
// make sure that the start and end nodes share the same
// parent. If not, fix it.
fixParentage(start, end);
// remove all of the nodes after the starting placeholder and
// before the ending placeholder.
node = start.nextSibling;
while (node) {
nextSibling = node.nextSibling;
last = node === end;
// if this is the last node, and we want to remove it as well,
// set the `end` node to the next sibling. This is because
// for the rest of the function, we insert the new nodes
// before the end (note that insertBefore(node, null) is
// the same as appendChild(node)).
//
// if we do not want to remove it, just break.
if (last) {
if (outerToo) { end = node.nextSibling; } else { break; }
}
node.parentNode.removeChild(node);
// if this is the last node and we didn't break before
// (because we wanted to remove the outer nodes), break
// now.
if (last) { break; }
node = nextSibling;
}
// get the first node for the HTML string, even in cases like
// tables and lists where a simple innerHTML on a div would
// swallow some of the content.
node = firstNodeFor(start.parentNode, html);
// copy the nodes for the HTML between the starting and ending
// placeholder.
while (node) {
nextSibling = node.nextSibling;
parentNode.insertBefore(node, end);
node = nextSibling;
}
};
// remove the nodes in the DOM representing this metamorph.
//
// this includes the starting and ending placeholders.
removeFunc = function() {
var start = realNode(document.getElementById(this.start));
var end = document.getElementById(this.end);
this.html('');
start.parentNode.removeChild(start);
end.parentNode.removeChild(end);
};
appendToFunc = function(parentNode) {
var node = firstNodeFor(parentNode, this.outerHTML());
while (node) {
nextSibling = node.nextSibling;
parentNode.appendChild(node);
node = nextSibling;
}
};
afterFunc = function(html) {
// get the real starting node. see realNode for details.
var end = document.getElementById(this.end);
var insertBefore = end.nextSibling;
var parentNode = end.parentNode;
var nextSibling;
var node;
// get the first node for the HTML string, even in cases like
// tables and lists where a simple innerHTML on a div would
// swallow some of the content.
node = firstNodeFor(parentNode, html);
// copy the nodes for the HTML between the starting and ending
// placeholder.
while (node) {
nextSibling = node.nextSibling;
parentNode.insertBefore(node, insertBefore);
node = nextSibling;
}
};
prependFunc = function(html) {
var start = document.getElementById(this.start);
var parentNode = start.parentNode;
var nextSibling;
var node;
node = firstNodeFor(parentNode, html);
var insertBefore = start.nextSibling;
while (node) {
nextSibling = node.nextSibling;
parentNode.insertBefore(node, insertBefore);
node = nextSibling;
}
}
}
Metamorph.prototype.html = function(html) {
this.checkRemoved();
if (html === undefined) { return this.innerHTML; }
htmlFunc.call(this, html);
this.innerHTML = html;
};
Metamorph.prototype.replaceWith = function(html) {
this.checkRemoved();
htmlFunc.call(this, html, true);
};
Metamorph.prototype.remove = removeFunc;
Metamorph.prototype.outerHTML = outerHTMLFunc;
Metamorph.prototype.appendTo = appendToFunc;
Metamorph.prototype.after = afterFunc;
Metamorph.prototype.prepend = prependFunc;
Metamorph.prototype.startTag = startTagFunc;
Metamorph.prototype.endTag = endTagFunc;
Metamorph.prototype.isRemoved = function() {
var before = document.getElementById(this.start);
var after = document.getElementById(this.end);
return !before || !after;
};
Metamorph.prototype.checkRemoved = function() {
if (this.isRemoved()) {
throw new Error("Cannot perform operations on a Metamorph that is not in the DOM.");
}
};
window.Metamorph = Metamorph;
})(this);
})();
(function() {
// ==========================================================================
// Project: Ember Handlebars Views
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
/*globals Handlebars */
var objectCreate = Ember.create;
/**
@namespace
@name Handlebars
@private
*/
/**
@namespace
@name Handlebars.helpers
@description Helpers for Handlebars templates
*/
Ember.assert("Ember Handlebars requires Handlebars 1.0.beta.5 or greater", window.Handlebars && window.Handlebars.VERSION.match(/^1\.0\.beta\.[56789]$|^1\.0\.rc\.[123456789]+/));
/**
@class
Prepares the Handlebars templating library for use inside Ember's view
system.
The Ember.Handlebars object is the standard Handlebars library, extended to use
Ember's get() method instead of direct property access, which allows
computed properties to be used inside templates.
To create an Ember.Handlebars template, call Ember.Handlebars.compile(). This will
return a function that can be used by Ember.View for rendering.
*/
Ember.Handlebars = objectCreate(Handlebars);
Ember.Handlebars.helpers = objectCreate(Handlebars.helpers);
/**
Override the the opcode compiler and JavaScript compiler for Handlebars.
@private
*/
Ember.Handlebars.Compiler = function() {};
Ember.Handlebars.Compiler.prototype = objectCreate(Handlebars.Compiler.prototype);
Ember.Handlebars.Compiler.prototype.compiler = Ember.Handlebars.Compiler;
/** @private */
Ember.Handlebars.JavaScriptCompiler = function() {};
Ember.Handlebars.JavaScriptCompiler.prototype = objectCreate(Handlebars.JavaScriptCompiler.prototype);
Ember.Handlebars.JavaScriptCompiler.prototype.compiler = Ember.Handlebars.JavaScriptCompiler;
Ember.Handlebars.JavaScriptCompiler.prototype.namespace = "Ember.Handlebars";
Ember.Handlebars.JavaScriptCompiler.prototype.initializeBuffer = function() {
return "''";
};
/**
Override the default buffer for Ember Handlebars. By default, Handlebars creates
an empty String at the beginning of each invocation and appends to it. Ember's
Handlebars overrides this to append to a single shared buffer.
@private
*/
Ember.Handlebars.JavaScriptCompiler.prototype.appendToBuffer = function(string) {
return "data.buffer.push("+string+");";
};
/**
Rewrite simple mustaches from {{foo}} to {{bind "foo"}}. This means that all simple
mustaches in Ember's Handlebars will also set up an observer to keep the DOM
up to date when the underlying property changes.
@private
*/
Ember.Handlebars.Compiler.prototype.mustache = function(mustache) {
if (mustache.params.length || mustache.hash) {
return Handlebars.Compiler.prototype.mustache.call(this, mustache);
} else {
var id = new Handlebars.AST.IdNode(['_triageMustache']);
// Update the mustache node to include a hash value indicating whether the original node
// was escaped. This will allow us to properly escape values when the underlying value
// changes and we need to re-render the value.
if(!mustache.escaped) {
mustache.hash = mustache.hash || new Handlebars.AST.HashNode([]);
mustache.hash.pairs.push(["unescaped", new Handlebars.AST.StringNode("true")]);
}
mustache = new Handlebars.AST.MustacheNode([id].concat([mustache.id]), mustache.hash, !mustache.escaped);
return Handlebars.Compiler.prototype.mustache.call(this, mustache);
}
};
/**
Used for precompilation of Ember Handlebars templates. This will not be used during normal
app execution.
@param {String} string The template to precompile
*/
Ember.Handlebars.precompile = function(string) {
var ast = Handlebars.parse(string);
var options = {
knownHelpers: {
action: true,
unbound: true,
bindAttr: true,
template: true,
view: true,
_triageMustache: true
},
data: true,
stringParams: true
};
var environment = new Ember.Handlebars.Compiler().compile(ast, options);
return new Ember.Handlebars.JavaScriptCompiler().compile(environment, options, undefined, true);
};
/**
The entry point for Ember Handlebars. This replaces the default Handlebars.compile and turns on
template-local data and String parameters.
@param {String} string The template to compile
*/
Ember.Handlebars.compile = function(string) {
var ast = Handlebars.parse(string);
var options = { data: true, stringParams: true };
var environment = new Ember.Handlebars.Compiler().compile(ast, options);
var templateSpec = new Ember.Handlebars.JavaScriptCompiler().compile(environment, options, undefined, true);
return Handlebars.template(templateSpec);
};
/**
If a path starts with a reserved keyword, returns the root
that should be used.
@private
*/
var normalizePath = Ember.Handlebars.normalizePath = function(root, path, data) {
var keywords = (data && data.keywords) || {},
keyword, isKeyword;
// Get the first segment of the path. For example, if the
// path is "foo.bar.baz", returns "foo".
keyword = path.split('.', 1)[0];
// Test to see if the first path is a keyword that has been
// passed along in the view's data hash. If so, we will treat
// that object as the new root.
if (keywords.hasOwnProperty(keyword)) {
// Look up the value in the template's data hash.
root = keywords[keyword];
isKeyword = true;
// Handle cases where the entire path is the reserved
// word. In that case, return the object itself.
if (path === keyword) {
path = '';
} else {
// Strip the keyword from the path and look up
// the remainder from the newly found root.
path = path.substr(keyword.length+1);
}
}
return { root: root, path: path, isKeyword: isKeyword };
};
/**
Lookup both on root and on window. If the path starts with
a keyword, the corresponding object will be looked up in the
template's data hash and used to resolve the path.
@param {Object} root The object to look up the property on
@param {String} path The path to be lookedup
@param {Object} options The template's option hash
*/
Ember.Handlebars.getPath = function(root, path, options) {
var data = options && options.data,
normalizedPath = normalizePath(root, path, data),
value;
// In cases where the path begins with a keyword, change the
// root to the value represented by that keyword, and ensure
// the path is relative to it.
root = normalizedPath.root;
path = normalizedPath.path;
value = Ember.get(root, path);
if (value === undefined && root !== window && Ember.isGlobalPath(path)) {
value = Ember.get(window, path);
}
return value;
};
/**
Registers a helper in Handlebars that will be called if no property with the
given name can be found on the current context object, and no helper with
that name is registered.
This throws an exception with a more helpful error message so the user can
track down where the problem is happening.
@name Handlebars.helpers.helperMissing
@param {String} path
@param {Hash} options
*/
Ember.Handlebars.registerHelper('helperMissing', function(path, options) {
var error, view = "";
error = "%@ Handlebars error: Could not find property '%@' on object %@.";
if (options.data){
view = options.data.view;
}
throw new Ember.Error(Ember.String.fmt(error, [view, path, this]));
});
})();
(function() {
Ember.String.htmlSafe = function(str) {
return new Handlebars.SafeString(str);
};
var htmlSafe = Ember.String.htmlSafe;
if (Ember.EXTEND_PROTOTYPES) {
/**
@see Ember.String.htmlSafe
*/
String.prototype.htmlSafe = function() {
return htmlSafe(this);
};
}
})();
(function() {
/*jshint newcap:false*/
var set = Ember.set, get = Ember.get;
var DOMManager = {
remove: function(view) {
var morph = view.morph;
if (morph.isRemoved()) { return; }
set(view, 'element', null);
view._lastInsert = null;
morph.remove();
},
prepend: function(view, childView) {
childView._insertElementLater(function() {
var morph = view.morph;
morph.prepend(childView.outerHTML);
childView.outerHTML = null;
});
},
after: function(view, nextView) {
nextView._insertElementLater(function() {
var morph = view.morph;
morph.after(nextView.outerHTML);
nextView.outerHTML = null;
});
},
replace: function(view) {
var morph = view.morph;
view.transitionTo('preRender');
view.clearRenderedChildren();
var buffer = view.renderToBuffer();
Ember.run.schedule('render', this, function() {
if (get(view, 'isDestroyed')) { return; }
view.invalidateRecursively('element');
view._notifyWillInsertElement();
morph.replaceWith(buffer.string());
view.transitionTo('inDOM');
view._notifyDidInsertElement();
});
},
empty: function(view) {
view.morph.html("");
}
};
// The `morph` and `outerHTML` properties are internal only
// and not observable.
Ember._Metamorph = Ember.Mixin.create({
isVirtual: true,
tagName: '',
init: function() {
this._super();
this.morph = Metamorph();
},
beforeRender: function(buffer) {
buffer.push(this.morph.startTag());
},
afterRender: function(buffer) {
buffer.push(this.morph.endTag());
},
createElement: function() {
var buffer = this.renderToBuffer();
this.outerHTML = buffer.string();
this.clearBuffer();
},
domManager: DOMManager
});
Ember._MetamorphView = Ember.View.extend(Ember._Metamorph);
})();
(function() {
// ==========================================================================
// Project: Ember Handlebars Views
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
/*globals Handlebars */
var get = Ember.get, set = Ember.set, getPath = Ember.Handlebars.getPath;
/**
@ignore
@private
@class
Ember._HandlebarsBoundView is a private view created by the Handlebars `{{bind}}`
helpers that is used to keep track of bound properties.
Every time a property is bound using a `{{mustache}}`, an anonymous subclass
of Ember._HandlebarsBoundView is created with the appropriate sub-template and
context set up. When the associated property changes, just the template for
this view will re-render.
*/
Ember._HandlebarsBoundView = Ember._MetamorphView.extend({
/** @scope Ember._HandlebarsBoundView.prototype */
/**
The function used to determine if the `displayTemplate` or
`inverseTemplate` should be rendered. This should be a function that takes
a value and returns a Boolean.
@type Function
@default null
*/
shouldDisplayFunc: null,
/**
Whether the template rendered by this view gets passed the context object
of its parent template, or gets passed the value of retrieving `path`
from the `pathRoot`.
For example, this is true when using the `{{#if}}` helper, because the
template inside the helper should look up properties relative to the same
object as outside the block. This would be false when used with `{{#with
foo}}` because the template should receive the object found by evaluating
`foo`.
@type Boolean
@default false
*/
preserveContext: false,
/**
If `preserveContext` is true, this is the object that will be used
to render the template.
@type Object
*/
previousContext: null,
/**
The template to render when `shouldDisplayFunc` evaluates to true.
@type Function
@default null
*/
displayTemplate: null,
/**
The template to render when `shouldDisplayFunc` evaluates to false.
@type Function
@default null
*/
inverseTemplate: null,
/**
The path to look up on `pathRoot` that is passed to
`shouldDisplayFunc` to determine which template to render.
In addition, if `preserveContext` is false, the object at this path will
be passed to the template when rendering.
@type String
@default null
*/
path: null,
/**
The object from which the `path` will be looked up. Sometimes this is the
same as the `previousContext`, but in cases where this view has been generated
for paths that start with a keyword such as `view` or `controller`, the
path root will be that resolved object.
@type Object
*/
pathRoot: null,
normalizedValue: Ember.computed(function() {
var path = get(this, 'path'),
pathRoot = get(this, 'pathRoot'),
valueNormalizer = get(this, 'valueNormalizerFunc'),
result, templateData;
// Use the pathRoot as the result if no path is provided. This
// happens if the path is `this`, which gets normalized into
// a `pathRoot` of the current Handlebars context and a path
// of `''`.
if (path === '') {
result = pathRoot;
} else {
templateData = get(this, 'templateData');
result = getPath(pathRoot, path, { data: templateData });
}
return valueNormalizer ? valueNormalizer(result) : result;
}).property('path', 'pathRoot', 'valueNormalizerFunc').volatile(),
rerenderIfNeeded: function() {
if (!get(this, 'isDestroyed') && get(this, 'normalizedValue') !== this._lastNormalizedValue) {
this.rerender();
}
},
/**
Determines which template to invoke, sets up the correct state based on
that logic, then invokes the default Ember.View `render` implementation.
This method will first look up the `path` key on `pathRoot`,
then pass that value to the `shouldDisplayFunc` function. If that returns
true, the `displayTemplate` function will be rendered to DOM. Otherwise,
`inverseTemplate`, if specified, will be rendered.
For example, if this Ember._HandlebarsBoundView represented the {{#with foo}}
helper, it would look up the `foo` property of its context, and
`shouldDisplayFunc` would always return true. The object found by looking
up `foo` would be passed to `displayTemplate`.
@param {Ember.RenderBuffer} buffer
*/
render: function(buffer) {
// If not invoked via a triple-mustache ({{{foo}}}), escape
// the content of the template.
var escape = get(this, 'isEscaped');
var shouldDisplay = get(this, 'shouldDisplayFunc'),
preserveContext = get(this, 'preserveContext'),
context = get(this, 'previousContext');
var inverseTemplate = get(this, 'inverseTemplate'),
displayTemplate = get(this, 'displayTemplate');
var result = get(this, 'normalizedValue');
this._lastNormalizedValue = result;
// First, test the conditional to see if we should
// render the template or not.
if (shouldDisplay(result)) {
set(this, 'template', displayTemplate);
// If we are preserving the context (for example, if this
// is an #if block, call the template with the same object.
if (preserveContext) {
set(this, '_context', context);
} else {
// Otherwise, determine if this is a block bind or not.
// If so, pass the specified object to the template
if (displayTemplate) {
set(this, '_context', result);
} else {
// This is not a bind block, just push the result of the
// expression to the render context and return.
if (result === null || result === undefined) {
result = "";
} else if (!(result instanceof Handlebars.SafeString)) {
result = String(result);
}
if (escape) { result = Handlebars.Utils.escapeExpression(result); }
buffer.push(result);
return;
}
}
} else if (inverseTemplate) {
set(this, 'template', inverseTemplate);
if (preserveContext) {
set(this, '_context', context);
} else {
set(this, '_context', result);
}
} else {
set(this, 'template', function() { return ''; });
}
return this._super(buffer);
}
});
})();
(function() {
// ==========================================================================
// Project: Ember Handlebars Views
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
var get = Ember.get, set = Ember.set, fmt = Ember.String.fmt;
var getPath = Ember.Handlebars.getPath, normalizePath = Ember.Handlebars.normalizePath;
var forEach = Ember.ArrayPolyfills.forEach;
var EmberHandlebars = Ember.Handlebars, helpers = EmberHandlebars.helpers;
// Binds a property into the DOM. This will create a hook in DOM that the
// KVO system will look for and update if the property changes.
/** @private */
function bind(property, options, preserveContext, shouldDisplay, valueNormalizer) {
var data = options.data,
fn = options.fn,
inverse = options.inverse,
view = data.view,
currentContext = this,
pathRoot, path, normalized;
normalized = normalizePath(currentContext, property, data);
pathRoot = normalized.root;
path = normalized.path;
// Set up observers for observable objects
if ('object' === typeof this) {
// Create the view that will wrap the output of this template/property
// and add it to the nearest view's childViews array.
// See the documentation of Ember._HandlebarsBoundView for more.
var bindView = view.createChildView(Ember._HandlebarsBoundView, {
preserveContext: preserveContext,
shouldDisplayFunc: shouldDisplay,
valueNormalizerFunc: valueNormalizer,
displayTemplate: fn,
inverseTemplate: inverse,
path: path,
pathRoot: pathRoot,
previousContext: currentContext,
isEscaped: !options.hash.unescaped,
templateData: options.data
});
view.appendChild(bindView);
/** @private */
var observer = function() {
Ember.run.once(bindView, 'rerenderIfNeeded');
};
// Observes the given property on the context and
// tells the Ember._HandlebarsBoundView to re-render. If property
// is an empty string, we are printing the current context
// object ({{this}}) so updating it is not our responsibility.
if (path !== '') {
Ember.addObserver(pathRoot, path, observer);
}
} else {
// The object is not observable, so just render it out and
// be done with it.
data.buffer.push(getPath(pathRoot, path, options));
}
}
/**
'_triageMustache' is used internally select between a binding and helper for
the given context. Until this point, it would be hard to determine if the
mustache is a property reference or a regular helper reference. This triage
helper resolves that.
This would not be typically invoked by directly.
@private
@name Handlebars.helpers._triageMustache
@param {String} property Property/helperID to triage
@param {Function} fn Context to provide for rendering
@returns {String} HTML string
*/
EmberHandlebars.registerHelper('_triageMustache', function(property, fn) {
Ember.assert("You cannot pass more than one argument to the _triageMustache helper", arguments.length <= 2);
if (helpers[property]) {
return helpers[property].call(this, fn);
}
else {
return helpers.bind.apply(this, arguments);
}
});
/**
`bind` can be used to display a value, then update that value if it
changes. For example, if you wanted to print the `title` property of
`content`:
{{bind "content.title"}}
This will return the `title` property as a string, then create a new
observer at the specified path. If it changes, it will update the value in
DOM. Note that if you need to support IE7 and IE8 you must modify the
model objects properties using Ember.get() and Ember.set() for this to work as
it relies on Ember's KVO system. For all other browsers this will be handled
for you automatically.
@private
@name Handlebars.helpers.bind
@param {String} property Property to bind
@param {Function} fn Context to provide for rendering
@returns {String} HTML string
*/
EmberHandlebars.registerHelper('bind', function(property, fn) {
Ember.assert("You cannot pass more than one argument to the bind helper", arguments.length <= 2);
var context = (fn.contexts && fn.contexts[0]) || this;
return bind.call(context, property, fn, false, function(result) {
return !Ember.none(result);
});
});
/**
Use the `boundIf` helper to create a conditional that re-evaluates
whenever the bound value changes.
{{#boundIf "content.shouldDisplayTitle"}}
{{content.title}}
{{/boundIf}}
@private
@name Handlebars.helpers.boundIf
@param {String} property Property to bind
@param {Function} fn Context to provide for rendering
@returns {String} HTML string
*/
EmberHandlebars.registerHelper('boundIf', function(property, fn) {
var context = (fn.contexts && fn.contexts[0]) || this;
var func = function(result) {
if (Ember.typeOf(result) === 'array') {
return get(result, 'length') !== 0;
} else {
return !!result;
}
};
return bind.call(context, property, fn, true, func, func);
});
/**
@name Handlebars.helpers.with
@param {Function} context
@param {Hash} options
@returns {String} HTML string
*/
EmberHandlebars.registerHelper('with', function(context, options) {
if (arguments.length === 4) {
var keywordName, path, rootPath, normalized;
Ember.assert("If you pass more than one argument to the with helper, it must be in the form #with foo as bar", arguments[1] === "as");
options = arguments[3];
keywordName = arguments[2];
path = arguments[0];
Ember.assert("You must pass a block to the with helper", options.fn && options.fn !== Handlebars.VM.noop);
if (Ember.isGlobalPath(path)) {
Ember.bind(options.data.keywords, keywordName, path);
} else {
normalized = normalizePath(this, path, options.data);
path = normalized.path;
rootPath = normalized.root;
// This is a workaround for the fact that you cannot bind separate objects
// together. When we implement that functionality, we should use it here.
var contextKey = Ember.$.expando + Ember.guidFor(rootPath);
options.data.keywords[contextKey] = rootPath;
// if the path is '' ("this"), just bind directly to the current context
var contextPath = path ? contextKey + '.' + path : contextKey;
Ember.bind(options.data.keywords, keywordName, contextPath);
}
return bind.call(this, path, options.fn, true, function(result) {
return !Ember.none(result);
});
} else {
Ember.assert("You must pass exactly one argument to the with helper", arguments.length === 2);
Ember.assert("You must pass a block to the with helper", options.fn && options.fn !== Handlebars.VM.noop);
return helpers.bind.call(options.contexts[0], context, options);
}
});
/**
@name Handlebars.helpers.if
@param {Function} context
@param {Hash} options
@returns {String} HTML string
*/
EmberHandlebars.registerHelper('if', function(context, options) {
Ember.assert("You must pass exactly one argument to the if helper", arguments.length === 2);
Ember.assert("You must pass a block to the if helper", options.fn && options.fn !== Handlebars.VM.noop);
return helpers.boundIf.call(options.contexts[0], context, options);
});
/**
@name Handlebars.helpers.unless
@param {Function} context
@param {Hash} options
@returns {String} HTML string
*/
EmberHandlebars.registerHelper('unless', function(context, options) {
Ember.assert("You must pass exactly one argument to the unless helper", arguments.length === 2);
Ember.assert("You must pass a block to the unless helper", options.fn && options.fn !== Handlebars.VM.noop);
var fn = options.fn, inverse = options.inverse;
options.fn = inverse;
options.inverse = fn;
return helpers.boundIf.call(options.contexts[0], context, options);
});
/**
`bindAttr` allows you to create a binding between DOM element attributes and
Ember objects. For example:
<img {{bindAttr src="imageUrl" alt="imageTitle"}}>
@name Handlebars.helpers.bindAttr
@param {Hash} options
@returns {String} HTML string
*/
EmberHandlebars.registerHelper('bindAttr', function(options) {
var attrs = options.hash;
Ember.assert("You must specify at least one hash argument to bindAttr", !!Ember.keys(attrs).length);
var view = options.data.view;
var ret = [];
var ctx = this;
// Generate a unique id for this element. This will be added as a
// data attribute to the element so it can be looked up when
// the bound property changes.
var dataId = ++Ember.$.uuid;
// Handle classes differently, as we can bind multiple classes
var classBindings = attrs['class'];
if (classBindings !== null && classBindings !== undefined) {
var classResults = EmberHandlebars.bindClasses(this, classBindings, view, dataId, options);
ret.push('class="' + Handlebars.Utils.escapeExpression(classResults.join(' ')) + '"');
delete attrs['class'];
}
var attrKeys = Ember.keys(attrs);
// For each attribute passed, create an observer and emit the
// current value of the property as an attribute.
forEach.call(attrKeys, function(attr) {
var path = attrs[attr],
pathRoot, normalized;
Ember.assert(fmt("You must provide a String for a bound attribute, not %@", [path]), typeof path === 'string');
normalized = normalizePath(ctx, path, options.data);
pathRoot = normalized.root;
path = normalized.path;
var value = (path === 'this') ? pathRoot : getPath(pathRoot, path, options),
type = Ember.typeOf(value);
Ember.assert(fmt("Attributes must be numbers, strings or booleans, not %@", [value]), value === null || value === undefined || type === 'number' || type === 'string' || type === 'boolean');
var observer, invoker;
/** @private */
observer = function observer() {
var result = getPath(pathRoot, path, options);
Ember.assert(fmt("Attributes must be numbers, strings or booleans, not %@", [result]), result === null || result === undefined || typeof result === 'number' || typeof result === 'string' || typeof result === 'boolean');
var elem = view.$("[data-bindattr-" + dataId + "='" + dataId + "']");
// If we aren't able to find the element, it means the element
// to which we were bound has been removed from the view.
// In that case, we can assume the template has been re-rendered
// and we need to clean up the observer.
if (!elem || elem.length === 0) {
Ember.removeObserver(pathRoot, path, invoker);
return;
}
Ember.View.applyAttributeBindings(elem, attr, result);
};
/** @private */
invoker = function() {
Ember.run.once(observer);
};
// Add an observer to the view for when the property changes.
// When the observer fires, find the element using the
// unique data id and update the attribute to the new value.
if (path !== 'this') {
Ember.addObserver(pathRoot, path, invoker);
}
// if this changes, also change the logic in ember-views/lib/views/view.js
if ((type === 'string' || (type === 'number' && !isNaN(value)))) {
ret.push(attr + '="' + Handlebars.Utils.escapeExpression(value) + '"');
} else if (value && type === 'boolean') {
// The developer controls the attr name, so it should always be safe
ret.push(attr + '="' + attr + '"');
}
}, this);
// Add the unique identifier
// NOTE: We use all lower-case since Firefox has problems with mixed case in SVG
ret.push('data-bindattr-' + dataId + '="' + dataId + '"');
return new EmberHandlebars.SafeString(ret.join(' '));
});
/**
Helper that, given a space-separated string of property paths and a context,
returns an array of class names. Calling this method also has the side
effect of setting up observers at those property paths, such that if they
change, the correct class name will be reapplied to the DOM element.
For example, if you pass the string "fooBar", it will first look up the
"fooBar" value of the context. If that value is true, it will add the
"foo-bar" class to the current element (i.e., the dasherized form of
"fooBar"). If the value is a string, it will add that string as the class.
Otherwise, it will not add any new class name.
@param {Ember.Object} context
The context from which to lookup properties
@param {String} classBindings
A string, space-separated, of class bindings to use
@param {Ember.View} view
The view in which observers should look for the element to update
@param {Srting} bindAttrId
Optional bindAttr id used to lookup elements
@returns {Array} An array of class names to add
*/
EmberHandlebars.bindClasses = function(context, classBindings, view, bindAttrId, options) {
var ret = [], newClass, value, elem;
// Helper method to retrieve the property from the context and
// determine which class string to return, based on whether it is
// a Boolean or not.
var classStringForPath = function(root, parsedPath, options) {
var val,
path = parsedPath.path;
if (path === 'this') {
val = root;
} else if (path === '') {
val = true;
} else {
val = getPath(root, path, options);
}
return Ember.View._classStringForValue(path, val, parsedPath.className, parsedPath.falsyClassName);
};
// For each property passed, loop through and setup
// an observer.
forEach.call(classBindings.split(' '), function(binding) {
// Variable in which the old class value is saved. The observer function
// closes over this variable, so it knows which string to remove when
// the property changes.
var oldClass;
var observer, invoker;
var parsedPath = Ember.View._parsePropertyPath(binding),
path = parsedPath.path,
pathRoot = context,
normalized;
if (path !== '' && path !== 'this') {
normalized = normalizePath(context, path, options.data);
pathRoot = normalized.root;
path = normalized.path;
}
// Set up an observer on the context. If the property changes, toggle the
// class name.
/** @private */
observer = function() {
// Get the current value of the property
newClass = classStringForPath(pathRoot, parsedPath, options);
elem = bindAttrId ? view.$("[data-bindattr-" + bindAttrId + "='" + bindAttrId + "']") : view.$();
// If we can't find the element anymore, a parent template has been
// re-rendered and we've been nuked. Remove the observer.
if (!elem || elem.length === 0) {
Ember.removeObserver(pathRoot, path, invoker);
} else {
// If we had previously added a class to the element, remove it.
if (oldClass) {
elem.removeClass(oldClass);
}
// If necessary, add a new class. Make sure we keep track of it so
// it can be removed in the future.
if (newClass) {
elem.addClass(newClass);
oldClass = newClass;
} else {
oldClass = null;
}
}
};
/** @private */
invoker = function() {
Ember.run.once(observer);
};
if (path !== '' && path !== 'this') {
Ember.addObserver(pathRoot, path, invoker);
}
// We've already setup the observer; now we just need to figure out the
// correct behavior right now on the first pass through.
value = classStringForPath(pathRoot, parsedPath, options);
if (value) {
ret.push(value);
// Make sure we save the current value so that it can be removed if the
// observer fires.
oldClass = value;
}
});
return ret;
};
})();
(function() {
// ==========================================================================
// Project: Ember Handlebars Views
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
/*globals Handlebars */
// TODO: Don't require the entire module
var get = Ember.get, set = Ember.set;
var PARENT_VIEW_PATH = /^parentView\./;
var EmberHandlebars = Ember.Handlebars;
var VIEW_PRESERVES_CONTEXT = Ember.VIEW_PRESERVES_CONTEXT;
/** @private */
EmberHandlebars.ViewHelper = Ember.Object.create({
propertiesFromHTMLOptions: function(options, thisContext) {
var hash = options.hash, data = options.data;
var extensions = {},
classes = hash['class'],
dup = false;
if (hash.id) {
extensions.elementId = hash.id;
dup = true;
}
if (classes) {
classes = classes.split(' ');
extensions.classNames = classes;
dup = true;
}
if (hash.classBinding) {
extensions.classNameBindings = hash.classBinding.split(' ');
dup = true;
}
if (hash.classNameBindings) {
if (extensions.classNameBindings === undefined) extensions.classNameBindings = [];
extensions.classNameBindings = extensions.classNameBindings.concat(hash.classNameBindings.split(' '));
dup = true;
}
if (hash.attributeBindings) {
Ember.assert("Setting 'attributeBindings' via Handlebars is not allowed. Please subclass Ember.View and set it there instead.");
extensions.attributeBindings = null;
dup = true;
}
if (dup) {
hash = Ember.$.extend({}, hash);
delete hash.id;
delete hash['class'];
delete hash.classBinding;
}
// Set the proper context for all bindings passed to the helper. This applies to regular attribute bindings
// as well as class name bindings. If the bindings are local, make them relative to the current context
// instead of the view.
var path;
// Evaluate the context of regular attribute bindings:
for (var prop in hash) {
if (!hash.hasOwnProperty(prop)) { continue; }
// Test if the property ends in "Binding"
if (Ember.IS_BINDING.test(prop) && typeof hash[prop] === 'string') {
path = this.contextualizeBindingPath(hash[prop], data);
if (path) { hash[prop] = path; }
}
}
// Evaluate the context of class name bindings:
if (extensions.classNameBindings) {
for (var b in extensions.classNameBindings) {
var full = extensions.classNameBindings[b];
if (typeof full === 'string') {
// Contextualize the path of classNameBinding so this:
//
// classNameBinding="isGreen:green"
//
// is converted to this:
//
// classNameBinding="bindingContext.isGreen:green"
var parsedPath = Ember.View._parsePropertyPath(full);
path = this.contextualizeBindingPath(parsedPath.path, data);
if (path) { extensions.classNameBindings[b] = path + parsedPath.classNames; }
}
}
}
// Make the current template context available to the view
// for the bindings set up above.
extensions.bindingContext = thisContext;
return Ember.$.extend(hash, extensions);
},
// Transform bindings from the current context to a context that can be evaluated within the view.
// Returns null if the path shouldn't be changed.
//
// TODO: consider the addition of a prefix that would allow this method to return `path`.
contextualizeBindingPath: function(path, data) {
var normalized = Ember.Handlebars.normalizePath(null, path, data);
if (normalized.isKeyword) {
return 'templateData.keywords.' + path;
} else if (Ember.isGlobalPath(path)) {
return null;
} else if (path === 'this') {
return 'bindingContext';
} else {
return 'bindingContext.' + path;
}
},
helper: function(thisContext, path, options) {
var inverse = options.inverse,
data = options.data,
view = data.view,
fn = options.fn,
hash = options.hash,
newView;
if ('string' === typeof path) {
newView = EmberHandlebars.getPath(thisContext, path, options);
Ember.assert("Unable to find view at path '" + path + "'", !!newView);
} else {
newView = path;
}
Ember.assert(Ember.String.fmt('You must pass a view class to the #view helper, not %@ (%@)', [path, newView]), Ember.View.detect(newView));
var viewOptions = this.propertiesFromHTMLOptions(options, thisContext);
var currentView = data.view;
viewOptions.templateData = options.data;
if (fn) {
Ember.assert("You cannot provide a template block if you also specified a templateName", !get(viewOptions, 'templateName') && !get(newView.proto(), 'templateName'));
viewOptions.template = fn;
}
// We only want to override the `_context` computed property if there is
// no specified controller. See View#_context for more information.
if (VIEW_PRESERVES_CONTEXT && !newView.proto().controller && !newView.proto().controllerBinding && !viewOptions.controller && !viewOptions.controllerBinding) {
viewOptions._context = thisContext;
}
currentView.appendChild(newView, viewOptions);
}
});
/**
`{{view}}` inserts a new instance of `Ember.View` into a template passing its options
to the `Ember.View`'s `create` method and using the supplied block as the view's own template.
An empty `<body>` and the following template:
<script type="text/x-handlebars">
A span:
{{#view tagName="span"}}
hello.
{{/view}}
</script>
Will result in HTML structure:
<body>
<!-- Note: the handlebars template script
also results in a rendered Ember.View
which is the outer <div> here -->
<div class="ember-view">
A span:
<span id="ember1" class="ember-view">
Hello.
</span>
</div>
</body>
### parentView setting
The `parentView` property of the new `Ember.View` instance created through `{{view}}`
will be set to the `Ember.View` instance of the template where `{{view}}` was called.
aView = Ember.View.create({
template: Ember.Handlebars.compile("{{#view}} my parent: {{parentView.elementId}} {{/view}}")
})
aView.appendTo('body')
Will result in HTML structure:
<div id="ember1" class="ember-view">
<div id="ember2" class="ember-view">
my parent: ember1
</div>
</div>
### Setting CSS id and class attributes
The HTML `id` attribute can be set on the `{{view}}`'s resulting element with the `id` option.
This option will _not_ be passed to `Ember.View.create`.
<script type="text/x-handlebars">
{{#view tagName="span" id="a-custom-id"}}
hello.
{{/view}}
</script>
Results in the following HTML structure:
<div class="ember-view">
<span id="a-custom-id" class="ember-view">
hello.
</span>
</div>
The HTML `class` attribute can be set on the `{{view}}`'s resulting element with
the `class` or `classNameBindings` options. The `class` option
will directly set the CSS `class` attribute and will not be passed to
`Ember.View.create`. `classNameBindings` will be passed to `create` and use
`Ember.View`'s class name binding functionality:
<script type="text/x-handlebars">
{{#view tagName="span" class="a-custom-class"}}
hello.
{{/view}}
</script>
Results in the following HTML structure:
<div class="ember-view">
<span id="ember2" class="ember-view a-custom-class">
hello.
</span>
</div>
### Supplying a different view class
`{{view}}` can take an optional first argument before its supplied options to specify a
path to a custom view class.
<script type="text/x-handlebars">
{{#view "MyApp.CustomView"}}
hello.
{{/view}}
</script>
The first argument can also be a relative path. Ember will search for the view class
starting at the `Ember.View` of the template where `{{view}}` was used as the root object:
MyApp = Ember.Application.create({})
MyApp.OuterView = Ember.View.extend({
innerViewClass: Ember.View.extend({
classNames: ['a-custom-view-class-as-property']
}),
template: Ember.Handlebars.compile('{{#view "innerViewClass"}} hi {{/view}}')
})
MyApp.OuterView.create().appendTo('body')
Will result in the following HTML:
<div id="ember1" class="ember-view">
<div id="ember2" class="ember-view a-custom-view-class-as-property">
hi
</div>
</div>
### Blockless use
If you supply a custom `Ember.View` subclass that specifies its own template
or provide a `templateName` option to `{{view}}` it can be used without supplying a block.
Attempts to use both a `templateName` option and supply a block will throw an error.
<script type="text/x-handlebars">
{{view "MyApp.ViewWithATemplateDefined"}}
</script>
### viewName property
You can supply a `viewName` option to `{{view}}`. The `Ember.View` instance will
be referenced as a property of its parent view by this name.
aView = Ember.View.create({
template: Ember.Handlebars.compile('{{#view viewName="aChildByName"}} hi {{/view}}')
})
aView.appendTo('body')
aView.get('aChildByName') // the instance of Ember.View created by {{view}} helper
@name Handlebars.helpers.view
@param {String} path
@param {Hash} options
@returns {String} HTML string
*/
EmberHandlebars.registerHelper('view', function(path, options) {
Ember.assert("The view helper only takes a single argument", arguments.length <= 2);
// If no path is provided, treat path param as options.
if (path && path.data && path.data.isRenderData) {
options = path;
path = "Ember.View";
}
return EmberHandlebars.ViewHelper.helper(this, path, options);
});
})();
(function() {
// ==========================================================================
// Project: Ember Handlebars Views
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
/*globals Handlebars */
// TODO: Don't require all of this module
var get = Ember.get, getPath = Ember.Handlebars.getPath, fmt = Ember.String.fmt;
/**
`{{collection}}` is a `Ember.Handlebars` helper for adding instances of
`Ember.CollectionView` to a template. See `Ember.CollectionView` for additional
information on how a `CollectionView` functions.
`{{collection}}`'s primary use is as a block helper with a `contentBinding` option
pointing towards an `Ember.Array`-compatible object. An `Ember.View` instance will
be created for each item in its `content` property. Each view will have its own
`content` property set to the appropriate item in the collection.
The provided block will be applied as the template for each item's view.
Given an empty `<body>` the following template:
<script type="text/x-handlebars">
{{#collection contentBinding="App.items"}}
Hi {{content.name}}
{{/collection}}
</script>
And the following application code
App = Ember.Application.create()
App.items = [
Ember.Object.create({name: 'Dave'}),
Ember.Object.create({name: 'Mary'}),
Ember.Object.create({name: 'Sara'})
]
Will result in the HTML structure below
<div class="ember-view">
<div class="ember-view">Hi Dave</div>
<div class="ember-view">Hi Mary</div>
<div class="ember-view">Hi Sara</div>
</div>
### Blockless Use
If you provide an `itemViewClass` option that has its own `template` you can omit
the block.
The following template:
<script type="text/x-handlebars">
{{collection contentBinding="App.items" itemViewClass="App.AnItemView"}}
</script>
And application code
App = Ember.Application.create()
App.items = [
Ember.Object.create({name: 'Dave'}),
Ember.Object.create({name: 'Mary'}),
Ember.Object.create({name: 'Sara'})
]
App.AnItemView = Ember.View.extend({
template: Ember.Handlebars.compile("Greetings {{content.name}}")
})
Will result in the HTML structure below
<div class="ember-view">
<div class="ember-view">Greetings Dave</div>
<div class="ember-view">Greetings Mary</div>
<div class="ember-view">Greetings Sara</div>
</div>
### Specifying a CollectionView subclass
By default the `{{collection}}` helper will create an instance of `Ember.CollectionView`.
You can supply a `Ember.CollectionView` subclass to the helper by passing it
as the first argument:
<script type="text/x-handlebars">
{{#collection App.MyCustomCollectionClass contentBinding="App.items"}}
Hi {{content.name}}
{{/collection}}
</script>
### Forwarded `item.*`-named Options
As with the `{{view}}`, helper options passed to the `{{collection}}` will be set on
the resulting `Ember.CollectionView` as properties. Additionally, options prefixed with
`item` will be applied to the views rendered for each item (note the camelcasing):
<script type="text/x-handlebars">
{{#collection contentBinding="App.items"
itemTagName="p"
itemClassNames="greeting"}}
Howdy {{content.name}}
{{/collection}}
</script>
Will result in the following HTML structure:
<div class="ember-view">
<p class="ember-view greeting">Howdy Dave</p>
<p class="ember-view greeting">Howdy Mary</p>
<p class="ember-view greeting">Howdy Sara</p>
</div>
@name Handlebars.helpers.collection
@param {String} path
@param {Hash} options
@returns {String} HTML string
*/
Ember.Handlebars.registerHelper('collection', function(path, options) {
// If no path is provided, treat path param as options.
if (path && path.data && path.data.isRenderData) {
options = path;
path = undefined;
Ember.assert("You cannot pass more than one argument to the collection helper", arguments.length === 1);
} else {
Ember.assert("You cannot pass more than one argument to the collection helper", arguments.length === 2);
}
var fn = options.fn;
var data = options.data;
var inverse = options.inverse;
// If passed a path string, convert that into an object.
// Otherwise, just default to the standard class.
var collectionClass;
collectionClass = path ? getPath(this, path, options) : Ember.CollectionView;
Ember.assert(fmt("%@ #collection: Could not find collection class %@", [data.view, path]), !!collectionClass);
var hash = options.hash, itemHash = {}, match;
// Extract item view class if provided else default to the standard class
var itemViewClass, itemViewPath = hash.itemViewClass;
var collectionPrototype = collectionClass.proto();
delete hash.itemViewClass;
itemViewClass = itemViewPath ? getPath(collectionPrototype, itemViewPath, options) : collectionPrototype.itemViewClass;
Ember.assert(fmt("%@ #collection: Could not find itemViewClass %@", [data.view, itemViewPath]), !!itemViewClass);
// Go through options passed to the {{collection}} helper and extract options
// that configure item views instead of the collection itself.
for (var prop in hash) {
if (hash.hasOwnProperty(prop)) {
match = prop.match(/^item(.)(.*)$/);
if(match) {
// Convert itemShouldFoo -> shouldFoo
itemHash[match[1].toLowerCase() + match[2]] = hash[prop];
// Delete from hash as this will end up getting passed to the
// {{view}} helper method.
delete hash[prop];
}
}
}
var tagName = hash.tagName || collectionPrototype.tagName;
if (fn) {
itemHash.template = fn;
delete options.fn;
}
var emptyViewClass;
if (inverse && inverse !== Handlebars.VM.noop) {
emptyViewClass = get(collectionPrototype, 'emptyViewClass');
emptyViewClass = emptyViewClass.extend({
template: inverse,
tagName: itemHash.tagName
});
} else if (hash.emptyViewClass) {
emptyViewClass = getPath(this, hash.emptyViewClass, options);
}
hash.emptyView = emptyViewClass;
if (hash.eachHelper === 'each') {
itemHash._context = Ember.computed(function() {
return get(this, 'content');
}).property('content');
delete hash.eachHelper;
}
var viewOptions = Ember.Handlebars.ViewHelper.propertiesFromHTMLOptions({ data: data, hash: itemHash }, this);
hash.itemViewClass = itemViewClass.extend(viewOptions);
return Ember.Handlebars.helpers.view.call(this, collectionClass, options);
});
})();
(function() {
// ==========================================================================
// Project: Ember Handlebars Views
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
/*globals Handlebars */
var getPath = Ember.Handlebars.getPath;
/**
`unbound` allows you to output a property without binding. *Important:* The
output will not be updated if the property changes. Use with caution.
<div>{{unbound somePropertyThatDoesntChange}}</div>
@name Handlebars.helpers.unbound
@param {String} property
@returns {String} HTML string
*/
Ember.Handlebars.registerHelper('unbound', function(property, fn) {
var context = (fn.contexts && fn.contexts[0]) || this;
return getPath(context, property, fn);
});
})();
(function() {
// ==========================================================================
// Project: Ember Handlebars Views
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
/*jshint debug:true*/
var getPath = Ember.Handlebars.getPath, normalizePath = Ember.Handlebars.normalizePath;
/**
`log` allows you to output the value of a value in the current rendering
context.
{{log myVariable}}
@name Handlebars.helpers.log
@param {String} property
*/
Ember.Handlebars.registerHelper('log', function(property, options) {
var context = (options.contexts && options.contexts[0]) || this,
normalized = normalizePath(context, property, options.data),
pathRoot = normalized.root,
path = normalized.path,
value = (path === 'this') ? pathRoot : getPath(pathRoot, path, options);
Ember.Logger.log(value);
});
/**
The `debugger` helper executes the `debugger` statement in the current
context.
{{debugger}}
@name Handlebars.helpers.debugger
@param {String} property
*/
Ember.Handlebars.registerHelper('debugger', function() {
debugger;
});
})();
(function() {
var get = Ember.get, set = Ember.set;
Ember.Handlebars.EachView = Ember.CollectionView.extend(Ember._Metamorph, {
itemViewClass: Ember._MetamorphView,
emptyViewClass: Ember._MetamorphView,
createChildView: function(view, attrs) {
view = this._super(view, attrs);
// At the moment, if a container view subclass wants
// to insert keywords, it is responsible for cloning
// the keywords hash. This will be fixed momentarily.
var keyword = get(this, 'keyword');
if (keyword) {
var data = get(view, 'templateData');
data = Ember.copy(data);
data.keywords = view.cloneKeywords();
set(view, 'templateData', data);
var content = get(view, 'content');
// In this case, we do not bind, because the `content` of
// a #each item cannot change.
data.keywords[keyword] = content;
}
return view;
}
});
Ember.Handlebars.registerHelper('each', function(path, options) {
if (arguments.length === 4) {
Ember.assert("If you pass more than one argument to the each helper, it must be in the form #each foo in bar", arguments[1] === "in");
var keywordName = arguments[0];
options = arguments[3];
path = arguments[2];
if (path === '') { path = "this"; }
options.hash.keyword = keywordName;
} else {
options.hash.eachHelper = 'each';
}
Ember.assert("You must pass a block to the each helper", options.fn && options.fn !== Handlebars.VM.noop);
options.hash.contentBinding = path;
// Set up emptyView as a metamorph with no tag
//options.hash.emptyViewClass = Ember._MetamorphView;
return Ember.Handlebars.helpers.collection.call(this, 'Ember.Handlebars.EachView', options);
});
})();
(function() {
/**
`template` allows you to render a template from inside another template.
This allows you to re-use the same template in multiple places. For example:
<script type="text/x-handlebars">
{{#with loggedInUser}}
Last Login: {{lastLogin}}
User Info: {{template "user_info"}}
{{/with}}
</script>
<script type="text/x-handlebars" data-template-name="user_info">
Name: <em>{{name}}</em>
Karma: <em>{{karma}}</em>
</script>
This helper looks for templates in the global Ember.TEMPLATES hash. If you
add &lt;script&gt; tags to your page with the `data-template-name` attribute set,
they will be compiled and placed in this hash automatically.
You can also manually register templates by adding them to the hash:
Ember.TEMPLATES["my_cool_template"] = Ember.Handlebars.compile('<b>{{user}}</b>');
@name Handlebars.helpers.template
@param {String} templateName the template to render
*/
Ember.Handlebars.registerHelper('template', function(name, options) {
var template = Ember.TEMPLATES[name];
Ember.assert("Unable to find template with name '"+name+"'.", !!template);
Ember.TEMPLATES[name](this, { data: options.data });
});
})();
(function() {
var EmberHandlebars = Ember.Handlebars,
getPath = EmberHandlebars.getPath,
get = Ember.get,
a_slice = Array.prototype.slice;
var ActionHelper = EmberHandlebars.ActionHelper = {
registeredActions: {}
};
ActionHelper.registerAction = function(actionName, options) {
var actionId = (++Ember.$.uuid).toString();
ActionHelper.registeredActions[actionId] = {
eventName: options.eventName,
handler: function(event) {
var modifier = event.shiftKey || event.metaKey || event.altKey || event.ctrlKey,
secondaryClick = event.which > 1, // IE9 may return undefined
nonStandard = modifier || secondaryClick;
if (options.link && nonStandard) {
// Allow the browser to handle special link clicks normally
return;
}
event.preventDefault();
event.view = options.view;
if (options.hasOwnProperty('context')) {
event.context = options.context;
}
if (options.hasOwnProperty('contexts')) {
event.contexts = options.contexts;
}
var target = options.target;
// Check for StateManager (or compatible object)
if (target.isState && typeof target.send === 'function') {
return target.send(actionName, event);
} else {
Ember.assert(Ember.String.fmt('Target %@ does not have action %@', [target, actionName]), target[actionName]);
return target[actionName].call(target, event);
}
}
};
options.view.on('willRerender', function() {
delete ActionHelper.registeredActions[actionId];
});
return actionId;
};
/**
The `{{action}}` helper registers an HTML element within a template for
DOM event handling and forwards that interaction to the Application's router,
the template's `Ember.View` instance, or supplied `target` option (see 'Specifiying a Target').
User interaction with that element will invoke the supplied action name on
the appropriate target.
Given the following Handlebars template on the page
<script type="text/x-handlebars" data-template-name='a-template'>
<div {{action anActionName}}>
click me
</div>
</script>
And application code
AView = Ember.View.extend({
templateName; 'a-template',
anActionName: function(event){}
});
aView = AView.create();
aView.appendTo('body');
Will results in the following rendered HTML
<div class="ember-view">
<div data-ember-action="1">
click me
</div>
</div>
Clicking "click me" will trigger the `anActionName` method of the `aView`
object with a `jQuery.Event` object as its argument. The `jQuery.Event`
object will be extended to include a `view` property that is set to the
original view interacted with (in this case the `aView` object).
### Event Propagation
Events triggered through the action helper will automatically have
`.preventDefault()` called on them. You do not need to do so in your event
handlers. To stop propagation of the event, simply return `false` from your
handler.
If you need the default handler to trigger you should either register your
own event handler, or use event methods on your view class. See Ember.View
'Responding to Browser Events' for more information.
### Specifying DOM event type
By default the `{{action}}` helper registers for DOM `click` events. You can
supply an `on` option to the helper to specify a different DOM event name:
<script type="text/x-handlebars" data-template-name='a-template'>
<div {{action anActionName on="doubleClick"}}>
click me
</div>
</script>
See Ember.View 'Responding to Browser Events' for a list of
acceptable DOM event names.
Because `{{action}}` depends on Ember's event dispatch system it will only
function if an `Ember.EventDispatcher` instance is available. An
`Ember.EventDispatcher` instance will be created when a new
`Ember.Application` is created. Having an instance of `Ember.Application`
will satisfy this requirement.
### Specifying a Target
There are several possible target objects for `{{action}}` helpers:
In a typical `Ember.Router`-backed Application where views are managed
through use of the `{{outlet}}` helper, actions will be forwarded to the
current state of the Applications's Router. See Ember.Router 'Responding
to User-initiated Events' for more information.
If you manaully set the `target` property on the controller of a template's
`Ember.View` instance, the specifed `controller.target` will become the target
for any actions. Likely custom values for a controller's `target` are the
controller itself or a StateManager other than the Application's Router.
If the templates's view lacks a controller property the view itself is the target.
Finally, a `target` option can be provided to the helper to change which object
will receive the method call. This option must be a string representing a
path to an object:
<script type="text/x-handlebars" data-template-name='a-template'>
<div {{action anActionName target="MyApplication.someObject"}}>
click me
</div>
</script>
Clicking "click me" in the rendered HTML of the above template will trigger
the `anActionName` method of the object at `MyApplication.someObject`.
The first argument to this method will be a `jQuery.Event` extended to
include a `view` property that is set to the original view interacted with.
A path relative to the template's `Ember.View` instance can also be used as
a target:
<script type="text/x-handlebars" data-template-name='a-template'>
<div {{action anActionName target="parentView"}}>
click me
</div>
</script>
Clicking "click me" in the rendered HTML of the above template will trigger
the `anActionName` method of the view's parent view.
The `{{action}}` helper is `Ember.StateManager` aware. If the target of the
action is an `Ember.StateManager` instance `{{action}}` will use the `send`
functionality of StateManagers. The documentation for `Ember.StateManager`
has additional information about this use.
If an action's target does not implement a method that matches the supplied
action name an error will be thrown.
<script type="text/x-handlebars" data-template-name='a-template'>
<div {{action aMethodNameThatIsMissing}}>
click me
</div>
</script>
With the following application code
AView = Ember.View.extend({
templateName; 'a-template',
// note: no method 'aMethodNameThatIsMissing'
anActionName: function(event){}
});
aView = AView.create();
aView.appendTo('body');
Will throw `Uncaught TypeError: Cannot call method 'call' of undefined` when
"click me" is clicked.
### Specifying a context
By default the `{{action}}` helper passes the current Handlebars context
along in the `jQuery.Event` object. You may specify an alternate object to
pass as the context by providing a property path:
<script type="text/x-handlebars" data-template-name='a-template'>
{{#each person in people}}
<div {{action edit person}}>
click me
</div>
{{/each}}
</script>
@name Handlebars.helpers.action
@param {String} actionName
@param {Object...} contexts
@param {Hash} options
*/
EmberHandlebars.registerHelper('action', function(actionName) {
var options = arguments[arguments.length - 1],
contexts = a_slice.call(arguments, 1, -1);
var hash = options.hash,
view = options.data.view,
target, controller, link;
// create a hash to pass along to registerAction
var action = {
eventName: hash.on || "click"
};
action.view = view = get(view, 'concreteView');
if (hash.target) {
target = getPath(this, hash.target, options);
} else if (controller = options.data.keywords.controller) {
target = get(controller, 'target');
}
action.target = target = target || view;
if (contexts.length) {
action.contexts = contexts = Ember.EnumerableUtils.map(contexts, function(context) {
return getPath(this, context, options);
}, this);
action.context = contexts[0];
}
var output = [], url;
if (hash.href && target.urlForEvent) {
url = target.urlForEvent.apply(target, [actionName].concat(contexts));
output.push('href="' + url + '"');
action.link = true;
}
var actionId = ActionHelper.registerAction(actionName, action);
output.push('data-ember-action="' + actionId + '"');
return new EmberHandlebars.SafeString(output.join(" "));
});
})();
(function() {
var get = Ember.get, set = Ember.set;
/**
When used in a Handlebars template that is assigned to an `Ember.View` instance's
`layout` property Ember will render the layout template first, inserting the view's
own rendered output at the `{{ yield }}` location.
An empty `<body>` and the following application code:
AView = Ember.View.extend({
classNames: ['a-view-with-layout'],
layout: Ember.Handlebars.compile('<div class="wrapper">{{ yield }}</div>'),
template: Ember.Handlebars.compile('<span>I am wrapped</span>')
})
aView = AView.create()
aView.appendTo('body')
Will result in the following HTML output:
<body>
<div class='ember-view a-view-with-layout'>
<div class="wrapper">
<span>I am wrapped</span>
</div>
</div>
</body>
The yield helper cannot be used outside of a template assigned to an `Ember.View`'s `layout` property
and will throw an error if attempted.
BView = Ember.View.extend({
classNames: ['a-view-with-layout'],
template: Ember.Handlebars.compile('{{yield}}')
})
bView = BView.create()
bView.appendTo('body')
// throws
// Uncaught Error: assertion failed: You called yield in a template that was not a layout
@name Handlebars.helpers.yield
@param {Hash} options
@returns {String} HTML string
*/
Ember.Handlebars.registerHelper('yield', function(options) {
var view = options.data.view, template;
while (view && !get(view, 'layout')) {
view = get(view, 'parentView');
}
Ember.assert("You called yield in a template that was not a layout", !!view);
template = get(view, 'template');
if (template) { template(this, options); }
});
})();
(function() {
/**
The `outlet` helper allows you to specify that the current
view's controller will fill in the view for a given area.
{{outlet}}
By default, when the the current controller's `view`
property changes, the outlet will replace its current
view with the new view.
controller.set('view', someView);
You can also specify a particular name, other than view:
{{outlet masterView}}
{{outlet detailView}}
Then, you can control several outlets from a single
controller:
controller.set('masterView', postsView);
controller.set('detailView', postView);
@name Handlebars.helpers.outlet
@param {String} property the property on the controller
that holds the view for this outlet
*/
Ember.Handlebars.registerHelper('outlet', function(property, options) {
if (property && property.data && property.data.isRenderData) {
options = property;
property = 'view';
}
options.hash.currentViewBinding = "controller." + property;
return Ember.Handlebars.helpers.view.call(this, Ember.ContainerView, options);
});
})();
(function() {
// ==========================================================================
// Project: Ember Handlebars Views
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
})();
(function() {
// ==========================================================================
// Project: Ember Handlebars Views
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
})();
(function() {
// ==========================================================================
// Project: Ember Handlebars Views
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
var set = Ember.set, get = Ember.get;
/**
@class
Creates an HTML input of type 'checkbox' with HTML related properties
applied directly to the input.
{{view Ember.Checkbox classNames="applicaton-specific-checkbox"}}
<input id="ember1" class="ember-view ember-checkbox applicaton-specific-checkbox" type="checkbox">
You can add a `label` tag yourself in the template where the Ember.Checkbox is being used.
<label>
Some Title
{{view Ember.Checkbox classNames="applicaton-specific-checkbox"}}
</label>
The `checked` attribute of an Ember.Checkbox object should always be set
through the Ember object or by interacting with its rendered element representation
via the mouse, keyboard, or touch. Updating the value of the checkbox via jQuery will
result in the checked value of the object and its element losing synchronization.
## Layout and LayoutName properties
Because HTML `input` elements are self closing `layout` and `layoutName` properties will
not be applied. See `Ember.View`'s layout section for more information.
@extends Ember.View
*/
Ember.Checkbox = Ember.View.extend({
classNames: ['ember-checkbox'],
tagName: 'input',
attributeBindings: ['type', 'checked', 'disabled', 'tabindex'],
type: "checkbox",
checked: false,
disabled: false,
init: function() {
this._super();
this.on("change", this, this._updateElementValue);
},
/**
@private
*/
_updateElementValue: function() {
set(this, 'checked', this.$().prop('checked'));
}
});
})();
(function() {
// ==========================================================================
// Project: Ember Handlebars Views
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
var get = Ember.get, set = Ember.set;
/** @class */
Ember.TextSupport = Ember.Mixin.create(
/** @scope Ember.TextSupport.prototype */ {
value: "",
attributeBindings: ['placeholder', 'disabled', 'maxlength', 'tabindex'],
placeholder: null,
disabled: false,
maxlength: null,
insertNewline: Ember.K,
cancel: Ember.K,
/** @private */
init: function() {
this._super();
this.on("focusOut", this, this._elementValueDidChange);
this.on("change", this, this._elementValueDidChange);
this.on("keyUp", this, this.interpretKeyEvents);
},
/**
@private
*/
interpretKeyEvents: function(event) {
var map = Ember.TextSupport.KEY_EVENTS;
var method = map[event.keyCode];
this._elementValueDidChange();
if (method) { return this[method](event); }
},
_elementValueDidChange: function() {
set(this, 'value', this.$().val());
}
});
Ember.TextSupport.KEY_EVENTS = {
13: 'insertNewline',
27: 'cancel'
};
})();
(function() {
// ==========================================================================
// Project: Ember Handlebars Views
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
var get = Ember.get, set = Ember.set;
/**
@class
The `Ember.TextField` view class renders a text
[input](https://developer.mozilla.org/en/HTML/Element/Input) element. It
allows for binding Ember properties to the text field contents (`value`),
live-updating as the user inputs text.
Example:
{{view Ember.TextField valueBinding="firstName"}}
## Layout and LayoutName properties
Because HTML `input` elements are self closing `layout` and `layoutName` properties will
not be applied. See `Ember.View`'s layout section for more information.
@extends Ember.View
@extends Ember.TextSupport
*/
Ember.TextField = Ember.View.extend(Ember.TextSupport,
/** @scope Ember.TextField.prototype */ {
classNames: ['ember-text-field'],
tagName: "input",
attributeBindings: ['type', 'value', 'size'],
/**
The value attribute of the input element. As the user inputs text, this
property is updated live.
@type String
@default ""
*/
value: "",
/**
The type attribute of the input element.
@type String
@default "text"
*/
type: "text",
/**
The size of the text field in characters.
@type String
@default null
*/
size: null
});
})();
(function() {
// ==========================================================================
// Project: Ember Handlebars Views
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
var get = Ember.get, set = Ember.set;
Ember.Button = Ember.View.extend(Ember.TargetActionSupport, {
classNames: ['ember-button'],
classNameBindings: ['isActive'],
tagName: 'button',
propagateEvents: false,
attributeBindings: ['type', 'disabled', 'href', 'tabindex'],
/** @private
Overrides TargetActionSupport's targetObject computed
property to use Handlebars-specific path resolution.
*/
targetObject: Ember.computed(function() {
var target = get(this, 'target'),
root = get(this, 'context'),
data = get(this, 'templateData');
if (typeof target !== 'string') { return target; }
return Ember.Handlebars.getPath(root, target, { data: data });
}).property('target').cacheable(),
// Defaults to 'button' if tagName is 'input' or 'button'
type: Ember.computed(function(key, value) {
var tagName = this.get('tagName');
if (value !== undefined) { this._type = value; }
if (this._type !== undefined) { return this._type; }
if (tagName === 'input' || tagName === 'button') { return 'button'; }
}).property('tagName').cacheable(),
disabled: false,
// Allow 'a' tags to act like buttons
href: Ember.computed(function() {
return this.get('tagName') === 'a' ? '#' : null;
}).property('tagName').cacheable(),
mouseDown: function() {
if (!get(this, 'disabled')) {
set(this, 'isActive', true);
this._mouseDown = true;
this._mouseEntered = true;
}
return get(this, 'propagateEvents');
},
mouseLeave: function() {
if (this._mouseDown) {
set(this, 'isActive', false);
this._mouseEntered = false;
}
},
mouseEnter: function() {
if (this._mouseDown) {
set(this, 'isActive', true);
this._mouseEntered = true;
}
},
mouseUp: function(event) {
if (get(this, 'isActive')) {
// Actually invoke the button's target and action.
// This method comes from the Ember.TargetActionSupport mixin.
this.triggerAction();
set(this, 'isActive', false);
}
this._mouseDown = false;
this._mouseEntered = false;
return get(this, 'propagateEvents');
},
keyDown: function(event) {
// Handle space or enter
if (event.keyCode === 13 || event.keyCode === 32) {
this.mouseDown();
}
},
keyUp: function(event) {
// Handle space or enter
if (event.keyCode === 13 || event.keyCode === 32) {
this.mouseUp();
}
},
// TODO: Handle proper touch behavior. Including should make inactive when
// finger moves more than 20x outside of the edge of the button (vs mouse
// which goes inactive as soon as mouse goes out of edges.)
touchStart: function(touch) {
return this.mouseDown(touch);
},
touchEnd: function(touch) {
return this.mouseUp(touch);
},
init: function() {
Ember.deprecate("Ember.Button is deprecated and will be removed from future releases. Consider using the `{{action}}` helper.");
this._super();
}
});
})();
(function() {
// ==========================================================================
// Project: Ember Handlebars Views
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
var get = Ember.get, set = Ember.set;
/**
@class
The `Ember.TextArea` view class renders a
[textarea](https://developer.mozilla.org/en/HTML/Element/textarea) element.
It allows for binding Ember properties to the text area contents (`value`),
live-updating as the user inputs text.
## Layout and LayoutName properties
Because HTML `textarea` elements do not contain inner HTML the `layout` and `layoutName`
properties will not be applied. See `Ember.View`'s layout section for more information.
@extends Ember.View
@extends Ember.TextSupport
*/
Ember.TextArea = Ember.View.extend(Ember.TextSupport,
/** @scope Ember.TextArea.prototype */ {
classNames: ['ember-text-area'],
tagName: "textarea",
attributeBindings: ['rows', 'cols'],
rows: null,
cols: null,
_updateElementValue: Ember.observer(function() {
// We do this check so cursor position doesn't get affected in IE
var value = get(this, 'value'),
$el = this.$();
if ($el && value !== $el.val()) {
$el.val(value);
}
}, 'value'),
/** @private */
init: function() {
this._super();
this.on("didInsertElement", this, this._updateElementValue);
}
});
})();
(function() {
Ember.TabContainerView = Ember.View.extend({
init: function() {
Ember.deprecate("Ember.TabContainerView is deprecated and will be removed from future releases.");
this._super();
}
});
})();
(function() {
var get = Ember.get;
Ember.TabPaneView = Ember.View.extend({
tabsContainer: Ember.computed(function() {
return this.nearestInstanceOf(Ember.TabContainerView);
}).property().volatile(),
isVisible: Ember.computed(function() {
return get(this, 'viewName') === get(this, 'tabsContainer.currentView');
}).property('tabsContainer.currentView').volatile(),
init: function() {
Ember.deprecate("Ember.TabPaneView is deprecated and will be removed from future releases.");
this._super();
}
});
})();
(function() {
var get = Ember.get, setPath = Ember.setPath;
Ember.TabView = Ember.View.extend({
tabsContainer: Ember.computed(function() {
return this.nearestInstanceOf(Ember.TabContainerView);
}).property().volatile(),
mouseUp: function() {
setPath(this, 'tabsContainer.currentView', get(this, 'value'));
},
init: function() {
Ember.deprecate("Ember.TabView is deprecated and will be removed from future releases.");
this._super();
}
});
})();
(function() {
})();
(function() {
/*jshint eqeqeq:false */
var set = Ember.set, get = Ember.get;
var indexOf = Ember.EnumerableUtils.indexOf, indexesOf = Ember.EnumerableUtils.indexesOf;
/**
@class
The Ember.Select view class renders a
[select](https://developer.mozilla.org/en/HTML/Element/select) HTML element,
allowing the user to choose from a list of options. The selected option(s)
are updated live in the `selection` property, while the corresponding value
is updated in the `value` property.
### Using Strings
The simplest version of an Ember.Select takes an array of strings for the options
of a select box and a valueBinding to set the value.
Example:
App.controller = Ember.Object.create({
selected: null,
content: [
"Yehuda",
"Tom"
]
})
{{view Ember.Select
contentBinding="App.controller.content"
valueBinding="App.controller.selected"
}}
Would result in the following HTML:
<select class="ember-select">
<option value="Yehuda">Yehuda</option>
<option value="Tom">Tom</option>
</select>
Selecting Yehuda from the select box will set `App.controller.selected` to "Yehuda"
### Using Objects
An Ember.Select can also take an array of JS or Ember objects.
When using objects you need to supply optionLabelPath and optionValuePath parameters
which will be used to get the label and value for each of the options.
Usually you will bind to either the selection or the value attribute of the select.
Use selectionBinding if you would like to set the whole object as a property on the target.
Use valueBinding if you would like to set just the value.
Example using selectionBinding:
App.controller = Ember.Object.create({
selectedPerson: null,
selectedPersonId: null,
content: [
Ember.Object.create({firstName: "Yehuda", id: 1}),
Ember.Object.create({firstName: "Tom", id: 2})
]
})
{{view Ember.Select
contentBinding="App.controller.content"
optionLabelPath="content.firstName"
optionValuePath="content.id"
selectionBinding="App.controller.selectedPerson"
prompt="Please Select"}}
<select class="ember-select">
<option value>Please Select</option>
<option value="1">Yehuda</option>
<option value="2">Tom</option>
</select>
Selecting Yehuda here will set `App.controller.selectedPerson` to
the Yehuda object.
Example using valueBinding:
{{view Ember.Select
contentBinding="App.controller.content"
optionLabelPath="content.firstName"
optionValuePath="content.id"
valueBinding="App.controller.selectedPersonId"
prompt="Please Select"}}
Selecting Yehuda in this case will set `App.controller.selectedPersonId` to 1.
@extends Ember.View
*/
Ember.Select = Ember.View.extend(
/** @scope Ember.Select.prototype */ {
tagName: 'select',
classNames: ['ember-select'],
defaultTemplate: Ember.Handlebars.compile('{{#if view.prompt}}<option value>{{view.prompt}}</option>{{/if}}{{#each view.content}}{{view Ember.SelectOption contentBinding="this"}}{{/each}}'),
attributeBindings: ['multiple', 'tabindex'],
/**
The `multiple` attribute of the select element. Indicates whether multiple
options can be selected.
@type Boolean
@default false
*/
multiple: false,
/**
The list of options.
If `optionLabelPath` and `optionValuePath` are not overridden, this should
be a list of strings, which will serve simultaneously as labels and values.
Otherwise, this should be a list of objects. For instance:
content: Ember.A([
{ id: 1, firstName: 'Yehuda' },
{ id: 2, firstName: 'Tom' }
]),
optionLabelPath: 'content.firstName',
optionValuePath: 'content.id'
@type Array
@default null
*/
content: null,
/**
When `multiple` is false, the element of `content` that is currently
selected, if any.
When `multiple` is true, an array of such elements.
@type Object or Array
@default null
*/
selection: null,
/**
In single selection mode (when `multiple` is false), value can be used to get
the current selection's value or set the selection by it's value.
It is not currently supported in multiple selection mode.
@type String
@default null
*/
value: Ember.computed(function(key, value) {
if (arguments.length === 2) { return value; }
var valuePath = get(this, 'optionValuePath').replace(/^content\.?/, '');
return valuePath ? get(this, 'selection.' + valuePath) : get(this, 'selection');
}).property('selection').cacheable(),
/**
If given, a top-most dummy option will be rendered to serve as a user
prompt.
@type String
@default null
*/
prompt: null,
/**
The path of the option labels. See `content`.
@type String
@default 'content'
*/
optionLabelPath: 'content',
/**
The path of the option values. See `content`.
@type String
@default 'content'
*/
optionValuePath: 'content',
_change: function() {
if (get(this, 'multiple')) {
this._changeMultiple();
} else {
this._changeSingle();
}
},
selectionDidChange: Ember.observer(function() {
var selection = get(this, 'selection'),
isArray = Ember.isArray(selection);
if (get(this, 'multiple')) {
if (!isArray) {
set(this, 'selection', Ember.A([selection]));
return;
}
this._selectionDidChangeMultiple();
} else {
this._selectionDidChangeSingle();
}
}, 'selection'),
valueDidChange: Ember.observer(function() {
var content = get(this, 'content'),
value = get(this, 'value'),
valuePath = get(this, 'optionValuePath').replace(/^content\.?/, ''),
selectedValue = (valuePath ? get(this, 'selection.' + valuePath) : get(this, 'selection')),
selection;
if (value !== selectedValue) {
selection = content.find(function(obj) {
return value === (valuePath ? get(obj, valuePath) : obj);
});
this.set('selection', selection);
}
}, 'value'),
_triggerChange: function() {
var selection = get(this, 'selection');
if (selection) { this.selectionDidChange(); }
this._change();
},
_changeSingle: function() {
var selectedIndex = this.$()[0].selectedIndex,
content = get(this, 'content'),
prompt = get(this, 'prompt');
if (!content) { return; }
if (prompt && selectedIndex === 0) { set(this, 'selection', null); return; }
if (prompt) { selectedIndex -= 1; }
set(this, 'selection', content.objectAt(selectedIndex));
},
_changeMultiple: function() {
var options = this.$('option:selected'),
prompt = get(this, 'prompt'),
offset = prompt ? 1 : 0,
content = get(this, 'content');
if (!content){ return; }
if (options) {
var selectedIndexes = options.map(function(){
return this.index - offset;
}).toArray();
set(this, 'selection', content.objectsAt(selectedIndexes));
}
},
_selectionDidChangeSingle: function() {
var el = this.get('element');
if (!el) { return; }
var content = get(this, 'content'),
selection = get(this, 'selection'),
selectionIndex = content ? indexOf(content, selection) : -1,
prompt = get(this, 'prompt');
if (prompt) { selectionIndex += 1; }
if (el) { el.selectedIndex = selectionIndex; }
},
_selectionDidChangeMultiple: function() {
var content = get(this, 'content'),
selection = get(this, 'selection'),
selectedIndexes = content ? indexesOf(content, selection) : [-1],
prompt = get(this, 'prompt'),
offset = prompt ? 1 : 0,
options = this.$('option'),
adjusted;
if (options) {
options.each(function() {
adjusted = this.index > -1 ? this.index + offset : -1;
this.selected = indexOf(selectedIndexes, adjusted) > -1;
});
}
},
init: function() {
this._super();
this.on("didInsertElement", this, this._triggerChange);
this.on("change", this, this._change);
}
});
Ember.SelectOption = Ember.View.extend({
tagName: 'option',
attributeBindings: ['value', 'selected'],
defaultTemplate: function(context, options) {
options = { data: options.data, hash: {} };
Ember.Handlebars.helpers.bind.call(context, "view.label", options);
},
init: function() {
this.labelPathDidChange();
this.valuePathDidChange();
this._super();
},
selected: Ember.computed(function() {
var content = get(this, 'content'),
selection = get(this, 'parentView.selection');
if (get(this, 'parentView.multiple')) {
return selection && indexOf(selection, content) > -1;
} else {
// Primitives get passed through bindings as objects... since
// `new Number(4) !== 4`, we use `==` below
return content == selection;
}
}).property('content', 'parentView.selection').volatile(),
labelPathDidChange: Ember.observer(function() {
var labelPath = get(this, 'parentView.optionLabelPath');
if (!labelPath) { return; }
Ember.defineProperty(this, 'label', Ember.computed(function() {
return get(this, labelPath);
}).property(labelPath).cacheable());
}, 'parentView.optionLabelPath'),
valuePathDidChange: Ember.observer(function() {
var valuePath = get(this, 'parentView.optionValuePath');
if (!valuePath) { return; }
Ember.defineProperty(this, 'value', Ember.computed(function() {
return get(this, valuePath);
}).property(valuePath).cacheable());
}, 'parentView.optionValuePath')
});
})();
(function() {
// ==========================================================================
// Project: Ember Handlebars Views
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
})();
(function() {
// ==========================================================================
// Project: Ember Handlebars Views
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
/*globals Handlebars */
// Find templates stored in the head tag as script tags and make them available
// to Ember.CoreView in the global Ember.TEMPLATES object. This will be run as as
// jQuery DOM-ready callback.
//
// Script tags with "text/x-handlebars" will be compiled
// with Ember's Handlebars and are suitable for use as a view's template.
// Those with type="text/x-raw-handlebars" will be compiled with regular
// Handlebars and are suitable for use in views' computed properties.
Ember.Handlebars.bootstrap = function(ctx) {
var selectors = 'script[type="text/x-handlebars"], script[type="text/x-raw-handlebars"]';
Ember.$(selectors, ctx)
.each(function() {
// Get a reference to the script tag
var script = Ember.$(this),
type = script.attr('type');
var compile = (script.attr('type') === 'text/x-raw-handlebars') ?
Ember.$.proxy(Handlebars.compile, Handlebars) :
Ember.$.proxy(Ember.Handlebars.compile, Ember.Handlebars),
// Get the name of the script, used by Ember.View's templateName property.
// First look for data-template-name attribute, then fall back to its
// id if no name is found.
templateName = script.attr('data-template-name') || script.attr('id'),
template = compile(script.html()),
view, viewPath, elementId, options;
if (templateName) {
// For templates which have a name, we save them and then remove them from the DOM
Ember.TEMPLATES[templateName] = template;
// Remove script tag from DOM
script.remove();
} else {
if (script.parents('head').length !== 0) {
// don't allow inline templates in the head
throw new Ember.Error("Template found in <head> without a name specified. " +
"Please provide a data-template-name attribute.\n" +
script.html());
}
// For templates which will be evaluated inline in the HTML document, instantiates a new
// view, and replaces the script tag holding the template with the new
// view's DOM representation.
//
// Users can optionally specify a custom view subclass to use by setting the
// data-view attribute of the script tag.
viewPath = script.attr('data-view');
view = viewPath ? Ember.get(viewPath) : Ember.View;
// Get the id of the script, used by Ember.View's elementId property,
// Look for data-element-id attribute.
elementId = script.attr('data-element-id');
options = { template: template };
if (elementId) { options.elementId = elementId; }
view = view.create(options);
view._insertElementLater(function() {
script.replaceWith(this.$());
// Avoid memory leak in IE
script = null;
});
}
});
};
/** @private */
function bootstrap() {
Ember.Handlebars.bootstrap( Ember.$(document) );
}
/*
We tie this to application.load to ensure that we've at least
attempted to bootstrap at the point that the application is loaded.
We also tie this to document ready since we're guaranteed that all
the inline templates are present at this point.
There's no harm to running this twice, since we remove the templates
from the DOM after processing.
*/
Ember.$(document).ready(bootstrap);
Ember.onLoad('application', bootstrap);
})();
(function() {
// ==========================================================================
// Project: Ember Handlebars Views
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
})();
// Version: v1.0.pre
// Last commit: 7955b85 (2012-08-03 14:50:17 -0700)
(function() {
// ==========================================================================
// Project: Ember
// Copyright: ©2011 Strobe Inc. and contributors.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
})();