Last active
August 29, 2015 14:01
-
-
Save GavinJoyce/4402343abaaad17bdae8 to your computer and use it in GitHub Desktop.
This file has been truncated, but you can view the full file.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
alert(1); | |
/*! | |
* @overview Ember - JavaScript Application Framework | |
* @copyright Copyright 2011-2014 Tilde Inc. and contributors | |
* Portions Copyright 2006-2011 Strobe Inc. | |
* Portions Copyright 2008-2011 Apple Inc. All rights reserved. | |
* @license Licensed under MIT license | |
* See https://raw.github.com/emberjs/ember.js/master/LICENSE | |
* @version 1.7.0-beta.1+canary.6555b15a | |
*/ | |
(function() { | |
var define, requireModule, require, requirejs, Ember; | |
(function() { | |
Ember = this.Ember = this.Ember || {}; | |
if (typeof Ember === 'undefined') { Ember = {} }; | |
if (typeof Ember.__loader === 'undefined') { | |
var registry = {}, seen = {}; | |
define = function(name, deps, callback) { | |
registry[name] = { deps: deps, callback: callback }; | |
}; | |
requirejs = require = requireModule = function(name) { | |
if (seen.hasOwnProperty(name)) { return seen[name]; } | |
seen[name] = {}; | |
if (!registry[name]) { | |
throw new Error("Could not find module " + name); | |
} | |
var mod = registry[name], | |
deps = mod.deps, | |
callback = mod.callback, | |
reified = [], | |
exports; | |
for (var i=0, l=deps.length; i<l; i++) { | |
if (deps[i] === 'exports') { | |
reified.push(exports = {}); | |
} else { | |
reified.push(requireModule(resolve(deps[i]))); | |
} | |
} | |
var value = callback.apply(this, reified); | |
return seen[name] = exports || value; | |
function resolve(child) { | |
if (child.charAt(0) !== '.') { return child; } | |
var parts = child.split("/"); | |
var parentBase = name.split("/").slice(0, -1); | |
for (var i=0, l=parts.length; i<l; i++) { | |
var part = parts[i]; | |
if (part === '..') { parentBase.pop(); } | |
else if (part === '.') { continue; } | |
else { parentBase.push(part); } | |
} | |
return parentBase.join("/"); | |
} | |
}; | |
requirejs._eak_seen = registry; | |
Ember.__loader = {define: define, require: require, registry: registry}; | |
} else { | |
define = Ember.__loader.define; | |
requirejs = require = requireModule = Ember.__loader.require; | |
} | |
})(); | |
define("backburner", | |
["backburner/utils","backburner/deferred_action_queues","exports"], | |
function(__dependency1__, __dependency2__, __exports__) { | |
"use strict"; | |
var Utils = __dependency1__["default"]; | |
var DeferredActionQueues = __dependency2__.DeferredActionQueues; | |
var slice = [].slice, | |
pop = [].pop, | |
each = Utils.each, | |
isString = Utils.isString, | |
isFunction = Utils.isFunction, | |
isNumber = Utils.isNumber, | |
timers = [], | |
global = this, | |
NUMBER = /\d+/; | |
// In IE 6-8, try/finally doesn't work without a catch. | |
// Unfortunately, this is impossible to test for since wrapping it in a parent try/catch doesn't trigger the bug. | |
// This tests for another broken try/catch behavior that only exhibits in the same versions of IE. | |
var needsIETryCatchFix = (function(e,x){ | |
try{ x(); } | |
catch(e) { } // jshint ignore:line | |
return !!e; | |
})(); | |
function isCoercableNumber(number) { | |
return isNumber(number) || NUMBER.test(number); | |
} | |
function Backburner(queueNames, options) { | |
this.queueNames = queueNames; | |
this.options = options || {}; | |
if (!this.options.defaultQueue) { | |
this.options.defaultQueue = queueNames[0]; | |
} | |
this.instanceStack = []; | |
this._debouncees = []; | |
this._throttlers = []; | |
} | |
Backburner.prototype = { | |
queueNames: null, | |
options: null, | |
currentInstance: null, | |
instanceStack: null, | |
begin: function() { | |
var options = this.options, | |
onBegin = options && options.onBegin, | |
previousInstance = this.currentInstance; | |
if (previousInstance) { | |
this.instanceStack.push(previousInstance); | |
} | |
this.currentInstance = new DeferredActionQueues(this.queueNames, options); | |
if (onBegin) { | |
onBegin(this.currentInstance, previousInstance); | |
} | |
}, | |
end: function() { | |
var options = this.options, | |
onEnd = options && options.onEnd, | |
currentInstance = this.currentInstance, | |
nextInstance = null; | |
// Prevent double-finally bug in Safari 6.0.2 and iOS 6 | |
// This bug appears to be resolved in Safari 6.0.5 and iOS 7 | |
var finallyAlreadyCalled = false; | |
try { | |
currentInstance.flush(); | |
} finally { | |
if (!finallyAlreadyCalled) { | |
finallyAlreadyCalled = true; | |
this.currentInstance = null; | |
if (this.instanceStack.length) { | |
nextInstance = this.instanceStack.pop(); | |
this.currentInstance = nextInstance; | |
} | |
if (onEnd) { | |
onEnd(currentInstance, nextInstance); | |
} | |
} | |
} | |
}, | |
run: function(target, method /*, args */) { | |
var onError = getOnError(this.options); | |
this.begin(); | |
if (!method) { | |
method = target; | |
target = null; | |
} | |
if (isString(method)) { | |
method = target[method]; | |
} | |
var args = slice.call(arguments, 2); | |
// guard against Safari 6's double-finally bug | |
var didFinally = false; | |
if (onError) { | |
try { | |
return method.apply(target, args); | |
} catch(error) { | |
onError(error); | |
} finally { | |
if (!didFinally) { | |
didFinally = true; | |
this.end(); | |
} | |
} | |
} else { | |
try { | |
return method.apply(target, args); | |
} finally { | |
if (!didFinally) { | |
didFinally = true; | |
this.end(); | |
} | |
} | |
} | |
}, | |
defer: function(queueName, target, method /* , args */) { | |
if (!method) { | |
method = target; | |
target = null; | |
} | |
if (isString(method)) { | |
method = target[method]; | |
} | |
var stack = this.DEBUG ? new Error() : undefined, | |
args = arguments.length > 3 ? slice.call(arguments, 3) : undefined; | |
if (!this.currentInstance) { createAutorun(this); } | |
return this.currentInstance.schedule(queueName, target, method, args, false, stack); | |
}, | |
deferOnce: function(queueName, target, method /* , args */) { | |
if (!method) { | |
method = target; | |
target = null; | |
} | |
if (isString(method)) { | |
method = target[method]; | |
} | |
var stack = this.DEBUG ? new Error() : undefined, | |
args = arguments.length > 3 ? slice.call(arguments, 3) : undefined; | |
if (!this.currentInstance) { createAutorun(this); } | |
return this.currentInstance.schedule(queueName, target, method, args, true, stack); | |
}, | |
setTimeout: function() { | |
var args = slice.call(arguments), | |
length = args.length, | |
method, wait, target, | |
methodOrTarget, methodOrWait, methodOrArgs; | |
if (length === 0) { | |
return; | |
} else if (length === 1) { | |
method = args.shift(); | |
wait = 0; | |
} else if (length === 2) { | |
methodOrTarget = args[0]; | |
methodOrWait = args[1]; | |
if (isFunction(methodOrWait) || isFunction(methodOrTarget[methodOrWait])) { | |
target = args.shift(); | |
method = args.shift(); | |
wait = 0; | |
} else if (isCoercableNumber(methodOrWait)) { | |
method = args.shift(); | |
wait = args.shift(); | |
} else { | |
method = args.shift(); | |
wait = 0; | |
} | |
} else { | |
var last = args[args.length - 1]; | |
if (isCoercableNumber(last)) { | |
wait = args.pop(); | |
} else { | |
wait = 0; | |
} | |
methodOrTarget = args[0]; | |
methodOrArgs = args[1]; | |
if (isFunction(methodOrArgs) || (isString(methodOrArgs) && | |
methodOrTarget !== null && | |
methodOrArgs in methodOrTarget)) { | |
target = args.shift(); | |
method = args.shift(); | |
} else { | |
method = args.shift(); | |
} | |
} | |
var executeAt = (+new Date()) + parseInt(wait, 10); | |
if (isString(method)) { | |
method = target[method]; | |
} | |
var onError = getOnError(this.options); | |
function fn() { | |
if (onError) { | |
try { | |
method.apply(target, args); | |
} catch (e) { | |
onError(e); | |
} | |
} else { | |
method.apply(target, args); | |
} | |
} | |
// find position to insert | |
var i = searchTimer(executeAt, timers); | |
timers.splice(i, 0, executeAt, fn); | |
updateLaterTimer(this, executeAt, wait); | |
return fn; | |
}, | |
throttle: function(target, method /* , args, wait, [immediate] */) { | |
var self = this, | |
args = arguments, | |
immediate = pop.call(args), | |
wait, | |
throttler, | |
index, | |
timer; | |
if (isNumber(immediate) || isString(immediate)) { | |
wait = immediate; | |
immediate = true; | |
} else { | |
wait = pop.call(args); | |
} | |
wait = parseInt(wait, 10); | |
index = findThrottler(target, method, this._throttlers); | |
if (index > -1) { return this._throttlers[index]; } // throttled | |
timer = global.setTimeout(function() { | |
if (!immediate) { | |
self.run.apply(self, args); | |
} | |
var index = findThrottler(target, method, self._throttlers); | |
if (index > -1) { | |
self._throttlers.splice(index, 1); | |
} | |
}, wait); | |
if (immediate) { | |
self.run.apply(self, args); | |
} | |
throttler = [target, method, timer]; | |
this._throttlers.push(throttler); | |
return throttler; | |
}, | |
debounce: function(target, method /* , args, wait, [immediate] */) { | |
var self = this, | |
args = arguments, | |
immediate = pop.call(args), | |
wait, | |
index, | |
debouncee, | |
timer; | |
if (isNumber(immediate) || isString(immediate)) { | |
wait = immediate; | |
immediate = false; | |
} else { | |
wait = pop.call(args); | |
} | |
wait = parseInt(wait, 10); | |
// Remove debouncee | |
index = findDebouncee(target, method, this._debouncees); | |
if (index > -1) { | |
debouncee = this._debouncees[index]; | |
this._debouncees.splice(index, 1); | |
clearTimeout(debouncee[2]); | |
} | |
timer = global.setTimeout(function() { | |
if (!immediate) { | |
self.run.apply(self, args); | |
} | |
var index = findDebouncee(target, method, self._debouncees); | |
if (index > -1) { | |
self._debouncees.splice(index, 1); | |
} | |
}, wait); | |
if (immediate && index === -1) { | |
self.run.apply(self, args); | |
} | |
debouncee = [target, method, timer]; | |
self._debouncees.push(debouncee); | |
return debouncee; | |
}, | |
cancelTimers: function() { | |
var clearItems = function(item) { | |
clearTimeout(item[2]); | |
}; | |
each(this._throttlers, clearItems); | |
this._throttlers = []; | |
each(this._debouncees, clearItems); | |
this._debouncees = []; | |
if (this._laterTimer) { | |
clearTimeout(this._laterTimer); | |
this._laterTimer = null; | |
} | |
timers = []; | |
if (this._autorun) { | |
clearTimeout(this._autorun); | |
this._autorun = null; | |
} | |
}, | |
hasTimers: function() { | |
return !!timers.length || !!this._debouncees.length || !!this._throttlers.length || this._autorun; | |
}, | |
cancel: function(timer) { | |
var timerType = typeof timer; | |
if (timer && timerType === 'object' && timer.queue && timer.method) { // we're cancelling a deferOnce | |
return timer.queue.cancel(timer); | |
} else if (timerType === 'function') { // we're cancelling a setTimeout | |
for (var i = 0, l = timers.length; i < l; i += 2) { | |
if (timers[i + 1] === timer) { | |
timers.splice(i, 2); // remove the two elements | |
return true; | |
} | |
} | |
} else if (Object.prototype.toString.call(timer) === "[object Array]"){ // we're cancelling a throttle or debounce | |
return this._cancelItem(findThrottler, this._throttlers, timer) || | |
this._cancelItem(findDebouncee, this._debouncees, timer); | |
} else { | |
return; // timer was null or not a timer | |
} | |
}, | |
_cancelItem: function(findMethod, array, timer){ | |
var item, | |
index; | |
if (timer.length < 3) { return false; } | |
index = findMethod(timer[0], timer[1], array); | |
if(index > -1) { | |
item = array[index]; | |
if(item[2] === timer[2]){ | |
array.splice(index, 1); | |
clearTimeout(timer[2]); | |
return true; | |
} | |
} | |
return false; | |
} | |
}; | |
Backburner.prototype.schedule = Backburner.prototype.defer; | |
Backburner.prototype.scheduleOnce = Backburner.prototype.deferOnce; | |
Backburner.prototype.later = Backburner.prototype.setTimeout; | |
if (needsIETryCatchFix) { | |
var originalRun = Backburner.prototype.run; | |
Backburner.prototype.run = wrapInTryCatch(originalRun); | |
var originalEnd = Backburner.prototype.end; | |
Backburner.prototype.end = wrapInTryCatch(originalEnd); | |
} | |
function wrapInTryCatch(func) { | |
return function () { | |
try { | |
return func.apply(this, arguments); | |
} catch (e) { | |
throw e; | |
} | |
}; | |
} | |
function getOnError(options) { | |
return options.onError || (options.onErrorTarget && options.onErrorTarget[options.onErrorMethod]); | |
} | |
function createAutorun(backburner) { | |
backburner.begin(); | |
backburner._autorun = global.setTimeout(function() { | |
backburner._autorun = null; | |
backburner.end(); | |
}); | |
} | |
function updateLaterTimer(self, executeAt, wait) { | |
if (!self._laterTimer || executeAt < self._laterTimerExpiresAt) { | |
self._laterTimer = global.setTimeout(function() { | |
self._laterTimer = null; | |
self._laterTimerExpiresAt = null; | |
executeTimers(self); | |
}, wait); | |
self._laterTimerExpiresAt = executeAt; | |
} | |
} | |
function executeTimers(self) { | |
var now = +new Date(), | |
time, fns, i, l; | |
self.run(function() { | |
i = searchTimer(now, timers); | |
fns = timers.splice(0, i); | |
for (i = 1, l = fns.length; i < l; i += 2) { | |
self.schedule(self.options.defaultQueue, null, fns[i]); | |
} | |
}); | |
if (timers.length) { | |
updateLaterTimer(self, timers[0], timers[0] - now); | |
} | |
} | |
function findDebouncee(target, method, debouncees) { | |
return findItem(target, method, debouncees); | |
} | |
function findThrottler(target, method, throttlers) { | |
return findItem(target, method, throttlers); | |
} | |
function findItem(target, method, collection) { | |
var item, | |
index = -1; | |
for (var i = 0, l = collection.length; i < l; i++) { | |
item = collection[i]; | |
if (item[0] === target && item[1] === method) { | |
index = i; | |
break; | |
} | |
} | |
return index; | |
} | |
function searchTimer(time, timers) { | |
var start = 0, | |
end = timers.length - 2, | |
middle, l; | |
while (start < end) { | |
// since timers is an array of pairs 'l' will always | |
// be an integer | |
l = (end - start) / 2; | |
// compensate for the index in case even number | |
// of pairs inside timers | |
middle = start + l - (l % 2); | |
if (time >= timers[middle]) { | |
start = middle + 2; | |
} else { | |
end = middle; | |
} | |
} | |
return (time >= timers[start]) ? start + 2 : start; | |
} | |
__exports__.Backburner = Backburner; | |
}); | |
define("backburner/deferred_action_queues", | |
["backburner/utils","backburner/queue","exports"], | |
function(__dependency1__, __dependency2__, __exports__) { | |
"use strict"; | |
var Utils = __dependency1__["default"]; | |
var Queue = __dependency2__.Queue; | |
var each = Utils.each, | |
isString = Utils.isString; | |
function DeferredActionQueues(queueNames, options) { | |
var queues = this.queues = {}; | |
this.queueNames = queueNames = queueNames || []; | |
this.options = options; | |
each(queueNames, function(queueName) { | |
queues[queueName] = new Queue(this, queueName, options); | |
}); | |
} | |
DeferredActionQueues.prototype = { | |
queueNames: null, | |
queues: null, | |
options: null, | |
schedule: function(queueName, target, method, args, onceFlag, stack) { | |
var queues = this.queues, | |
queue = queues[queueName]; | |
if (!queue) { throw new Error("You attempted to schedule an action in a queue (" + queueName + ") that doesn't exist"); } | |
if (onceFlag) { | |
return queue.pushUnique(target, method, args, stack); | |
} else { | |
return queue.push(target, method, args, stack); | |
} | |
}, | |
invoke: function(target, method, args, _) { | |
if (args && args.length > 0) { | |
method.apply(target, args); | |
} else { | |
method.call(target); | |
} | |
}, | |
invokeWithOnError: function(target, method, args, onError) { | |
try { | |
if (args && args.length > 0) { | |
method.apply(target, args); | |
} else { | |
method.call(target); | |
} | |
} catch(error) { | |
onError(error); | |
} | |
}, | |
flush: function() { | |
var queues = this.queues, | |
queueNames = this.queueNames, | |
queueName, queue, queueItems, priorQueueNameIndex, | |
queueNameIndex = 0, numberOfQueues = queueNames.length, | |
options = this.options, | |
onError = options.onError || (options.onErrorTarget && options.onErrorTarget[options.onErrorMethod]), | |
invoke = onError ? this.invokeWithOnError : this.invoke; | |
outerloop: | |
while (queueNameIndex < numberOfQueues) { | |
queueName = queueNames[queueNameIndex]; | |
queue = queues[queueName]; | |
queueItems = queue._queueBeingFlushed = queue._queue.slice(); | |
queue._queue = []; | |
var queueOptions = queue.options, // TODO: write a test for this | |
before = queueOptions && queueOptions.before, | |
after = queueOptions && queueOptions.after, | |
target, method, args, stack, | |
queueIndex = 0, numberOfQueueItems = queueItems.length; | |
if (numberOfQueueItems && before) { before(); } | |
while (queueIndex < numberOfQueueItems) { | |
target = queueItems[queueIndex]; | |
method = queueItems[queueIndex+1]; | |
args = queueItems[queueIndex+2]; | |
stack = queueItems[queueIndex+3]; // Debugging assistance | |
if (isString(method)) { method = target[method]; } | |
// method could have been nullified / canceled during flush | |
if (method) { | |
invoke(target, method, args, onError); | |
} | |
queueIndex += 4; | |
} | |
queue._queueBeingFlushed = null; | |
if (numberOfQueueItems && after) { after(); } | |
if ((priorQueueNameIndex = indexOfPriorQueueWithActions(this, queueNameIndex)) !== -1) { | |
queueNameIndex = priorQueueNameIndex; | |
continue outerloop; | |
} | |
queueNameIndex++; | |
} | |
} | |
}; | |
function indexOfPriorQueueWithActions(daq, currentQueueIndex) { | |
var queueName, queue; | |
for (var i = 0, l = currentQueueIndex; i <= l; i++) { | |
queueName = daq.queueNames[i]; | |
queue = daq.queues[queueName]; | |
if (queue._queue.length) { return i; } | |
} | |
return -1; | |
} | |
__exports__.DeferredActionQueues = DeferredActionQueues; | |
}); | |
define("backburner/queue", | |
["exports"], | |
function(__exports__) { | |
"use strict"; | |
function Queue(daq, name, options) { | |
this.daq = daq; | |
this.name = name; | |
this.globalOptions = options; | |
this.options = options[name]; | |
this._queue = []; | |
} | |
Queue.prototype = { | |
daq: null, | |
name: null, | |
options: null, | |
onError: null, | |
_queue: null, | |
push: function(target, method, args, stack) { | |
var queue = this._queue; | |
queue.push(target, method, args, stack); | |
return {queue: this, target: target, method: method}; | |
}, | |
pushUnique: function(target, method, args, stack) { | |
var queue = this._queue, currentTarget, currentMethod, i, l; | |
for (i = 0, l = queue.length; i < l; i += 4) { | |
currentTarget = queue[i]; | |
currentMethod = queue[i+1]; | |
if (currentTarget === target && currentMethod === method) { | |
queue[i+2] = args; // replace args | |
queue[i+3] = stack; // replace stack | |
return {queue: this, target: target, method: method}; | |
} | |
} | |
queue.push(target, method, args, stack); | |
return {queue: this, target: target, method: method}; | |
}, | |
// TODO: remove me, only being used for Ember.run.sync | |
flush: function() { | |
var queue = this._queue, | |
globalOptions = this.globalOptions, | |
options = this.options, | |
before = options && options.before, | |
after = options && options.after, | |
onError = globalOptions.onError || (globalOptions.onErrorTarget && globalOptions.onErrorTarget[globalOptions.onErrorMethod]), | |
target, method, args, stack, i, l = queue.length; | |
if (l && before) { before(); } | |
for (i = 0; i < l; i += 4) { | |
target = queue[i]; | |
method = queue[i+1]; | |
args = queue[i+2]; | |
stack = queue[i+3]; // Debugging assistance | |
// TODO: error handling | |
if (args && args.length > 0) { | |
if (onError) { | |
try { | |
method.apply(target, args); | |
} catch (e) { | |
onError(e); | |
} | |
} else { | |
method.apply(target, args); | |
} | |
} else { | |
if (onError) { | |
try { | |
method.call(target); | |
} catch(e) { | |
onError(e); | |
} | |
} else { | |
method.call(target); | |
} | |
} | |
} | |
if (l && after) { after(); } | |
// check if new items have been added | |
if (queue.length > l) { | |
this._queue = queue.slice(l); | |
this.flush(); | |
} else { | |
this._queue.length = 0; | |
} | |
}, | |
cancel: function(actionToCancel) { | |
var queue = this._queue, currentTarget, currentMethod, i, l; | |
for (i = 0, l = queue.length; i < l; i += 4) { | |
currentTarget = queue[i]; | |
currentMethod = queue[i+1]; | |
if (currentTarget === actionToCancel.target && currentMethod === actionToCancel.method) { | |
queue.splice(i, 4); | |
return true; | |
} | |
} | |
// if not found in current queue | |
// could be in the queue that is being flushed | |
queue = this._queueBeingFlushed; | |
if (!queue) { | |
return; | |
} | |
for (i = 0, l = queue.length; i < l; i += 4) { | |
currentTarget = queue[i]; | |
currentMethod = queue[i+1]; | |
if (currentTarget === actionToCancel.target && currentMethod === actionToCancel.method) { | |
// don't mess with array during flush | |
// just nullify the method | |
queue[i+1] = null; | |
return true; | |
} | |
} | |
} | |
}; | |
__exports__.Queue = Queue; | |
}); | |
define("backburner/utils", | |
["exports"], | |
function(__exports__) { | |
"use strict"; | |
__exports__["default"] = { | |
each: function(collection, callback) { | |
for (var i = 0; i < collection.length; i++) { | |
callback(collection[i]); | |
} | |
}, | |
isString: function(suspect) { | |
return typeof suspect === 'string'; | |
}, | |
isFunction: function(suspect) { | |
return typeof suspect === 'function'; | |
}, | |
isNumber: function(suspect) { | |
return typeof suspect === 'number'; | |
} | |
}; | |
}); | |
define("container", | |
["container/container","exports"], | |
function(__dependency1__, __exports__) { | |
"use strict"; | |
/* | |
Public api for the container is still in flux. | |
The public api, specified on the application namespace should be considered the stable api. | |
// @module container | |
@private | |
*/ | |
/* | |
Flag to enable/disable model factory injections (disabled by default) | |
If model factory injections are enabled, models should not be | |
accessed globally (only through `container.lookupFactory('model:modelName'))`); | |
*/ | |
Ember.MODEL_FACTORY_INJECTIONS = false; | |
if (Ember.ENV && typeof Ember.ENV.MODEL_FACTORY_INJECTIONS !== 'undefined') { | |
Ember.MODEL_FACTORY_INJECTIONS = !!Ember.ENV.MODEL_FACTORY_INJECTIONS; | |
} | |
var Container = __dependency1__["default"]; | |
__exports__["default"] = Container; | |
}); | |
define("container/container", | |
["container/inheriting_dict","exports"], | |
function(__dependency1__, __exports__) { | |
"use strict"; | |
var InheritingDict = __dependency1__["default"]; | |
// A lightweight container that helps to assemble and decouple components. | |
// Public api for the container is still in flux. | |
// The public api, specified on the application namespace should be considered the stable api. | |
function Container(parent) { | |
this.parent = parent; | |
this.children = []; | |
this.resolver = parent && parent.resolver || function() {}; | |
this.registry = new InheritingDict(parent && parent.registry); | |
this.cache = new InheritingDict(parent && parent.cache); | |
this.factoryCache = new InheritingDict(parent && parent.factoryCache); | |
this.resolveCache = new InheritingDict(parent && parent.resolveCache); | |
this.typeInjections = new InheritingDict(parent && parent.typeInjections); | |
this.injections = {}; | |
this.factoryTypeInjections = new InheritingDict(parent && parent.factoryTypeInjections); | |
this.factoryInjections = {}; | |
this._options = new InheritingDict(parent && parent._options); | |
this._typeOptions = new InheritingDict(parent && parent._typeOptions); | |
} | |
Container.prototype = { | |
/** | |
@property parent | |
@type Container | |
@default null | |
*/ | |
parent: null, | |
/** | |
@property children | |
@type Array | |
@default [] | |
*/ | |
children: null, | |
/** | |
@property resolver | |
@type function | |
*/ | |
resolver: null, | |
/** | |
@property registry | |
@type InheritingDict | |
*/ | |
registry: null, | |
/** | |
@property cache | |
@type InheritingDict | |
*/ | |
cache: null, | |
/** | |
@property typeInjections | |
@type InheritingDict | |
*/ | |
typeInjections: null, | |
/** | |
@property injections | |
@type Object | |
@default {} | |
*/ | |
injections: null, | |
/** | |
@private | |
@property _options | |
@type InheritingDict | |
@default null | |
*/ | |
_options: null, | |
/** | |
@private | |
@property _typeOptions | |
@type InheritingDict | |
*/ | |
_typeOptions: null, | |
/** | |
Returns a new child of the current container. These children are configured | |
to correctly inherit from the current container. | |
@method child | |
@return {Container} | |
*/ | |
child: function() { | |
var container = new Container(this); | |
this.children.push(container); | |
return container; | |
}, | |
/** | |
Sets a key-value pair on the current container. If a parent container, | |
has the same key, once set on a child, the parent and child will diverge | |
as expected. | |
@method set | |
@param {Object} object | |
@param {String} key | |
@param {any} value | |
*/ | |
set: function(object, key, value) { | |
object[key] = value; | |
}, | |
/** | |
Registers a factory for later injection. | |
Example: | |
```javascript | |
var container = new Container(); | |
container.register('model:user', Person, {singleton: false }); | |
container.register('fruit:favorite', Orange); | |
container.register('communication:main', Email, {singleton: false}); | |
``` | |
@method register | |
@param {String} fullName | |
@param {Function} factory | |
@param {Object} options | |
*/ | |
register: function(fullName, factory, options) { | |
validateFullName(fullName); | |
if (factory === undefined) { | |
throw new TypeError('Attempting to register an unknown factory: `' + fullName + '`'); | |
} | |
var normalizedName = this.normalize(fullName); | |
if (this.cache.has(normalizedName)) { | |
throw new Error('Cannot re-register: `' + fullName +'`, as it has already been looked up.'); | |
} | |
this.registry.set(normalizedName, factory); | |
this._options.set(normalizedName, options || {}); | |
}, | |
/** | |
Unregister a fullName | |
```javascript | |
var container = new Container(); | |
container.register('model:user', User); | |
container.lookup('model:user') instanceof User //=> true | |
container.unregister('model:user') | |
container.lookup('model:user') === undefined //=> true | |
``` | |
@method unregister | |
@param {String} fullName | |
*/ | |
unregister: function(fullName) { | |
validateFullName(fullName); | |
var normalizedName = this.normalize(fullName); | |
this.registry.remove(normalizedName); | |
this.cache.remove(normalizedName); | |
this.factoryCache.remove(normalizedName); | |
this.resolveCache.remove(normalizedName); | |
this._options.remove(normalizedName); | |
}, | |
/** | |
Given a fullName return the corresponding factory. | |
By default `resolve` will retrieve the factory from | |
its container's registry. | |
```javascript | |
var container = new Container(); | |
container.register('api:twitter', Twitter); | |
container.resolve('api:twitter') // => Twitter | |
``` | |
Optionally the container can be provided with a custom resolver. | |
If provided, `resolve` will first provide the custom resolver | |
the oppertunity to resolve the fullName, otherwise it will fallback | |
to the registry. | |
```javascript | |
var container = new Container(); | |
container.resolver = function(fullName) { | |
// lookup via the module system of choice | |
}; | |
// the twitter factory is added to the module system | |
container.resolve('api:twitter') // => Twitter | |
``` | |
@method resolve | |
@param {String} fullName | |
@return {Function} fullName's factory | |
*/ | |
resolve: function(fullName) { | |
validateFullName(fullName); | |
var normalizedName = this.normalize(fullName); | |
var cached = this.resolveCache.get(normalizedName); | |
if (cached) { return cached; } | |
var resolved = this.resolver(normalizedName) || this.registry.get(normalizedName); | |
this.resolveCache.set(normalizedName, resolved); | |
return resolved; | |
}, | |
/** | |
A hook that can be used to describe how the resolver will | |
attempt to find the factory. | |
For example, the default Ember `.describe` returns the full | |
class name (including namespace) where Ember's resolver expects | |
to find the `fullName`. | |
@method describe | |
@param {String} fullName | |
@return {string} described fullName | |
*/ | |
describe: function(fullName) { | |
return fullName; | |
}, | |
/** | |
A hook to enable custom fullName normalization behaviour | |
@method normalize | |
@param {String} fullName | |
@return {string} normalized fullName | |
*/ | |
normalize: function(fullName) { | |
return fullName; | |
}, | |
/** | |
@method makeToString | |
@param {any} factory | |
@param {string} fullName | |
@return {function} toString function | |
*/ | |
makeToString: function(factory, fullName) { | |
return factory.toString(); | |
}, | |
/** | |
Given a fullName return a corresponding instance. | |
The default behaviour is for lookup to return a singleton instance. | |
The singleton is scoped to the container, allowing multiple containers | |
to all have their own locally scoped singletons. | |
```javascript | |
var container = new Container(); | |
container.register('api:twitter', Twitter); | |
var twitter = container.lookup('api:twitter'); | |
twitter instanceof Twitter; // => true | |
// by default the container will return singletons | |
var twitter2 = container.lookup('api:twitter'); | |
twitter instanceof Twitter; // => true | |
twitter === twitter2; //=> true | |
``` | |
If singletons are not wanted an optional flag can be provided at lookup. | |
```javascript | |
var container = new Container(); | |
container.register('api:twitter', Twitter); | |
var twitter = container.lookup('api:twitter', { singleton: false }); | |
var twitter2 = container.lookup('api:twitter', { singleton: false }); | |
twitter === twitter2; //=> false | |
``` | |
@method lookup | |
@param {String} fullName | |
@param {Object} options | |
@return {any} | |
*/ | |
lookup: function(fullName, options) { | |
validateFullName(fullName); | |
return lookup(this, this.normalize(fullName), options); | |
}, | |
/** | |
Given a fullName return the corresponding factory. | |
@method lookupFactory | |
@param {String} fullName | |
@return {any} | |
*/ | |
lookupFactory: function(fullName) { | |
validateFullName(fullName); | |
return factoryFor(this, this.normalize(fullName)); | |
}, | |
/** | |
Given a fullName check if the container is aware of its factory | |
or singleton instance. | |
@method has | |
@param {String} fullName | |
@return {Boolean} | |
*/ | |
has: function(fullName) { | |
validateFullName(fullName); | |
return has(this, this.normalize(fullName)); | |
}, | |
/** | |
Allow registering options for all factories of a type. | |
```javascript | |
var container = new Container(); | |
// if all of type `connection` must not be singletons | |
container.optionsForType('connection', { singleton: false }); | |
container.register('connection:twitter', TwitterConnection); | |
container.register('connection:facebook', FacebookConnection); | |
var twitter = container.lookup('connection:twitter'); | |
var twitter2 = container.lookup('connection:twitter'); | |
twitter === twitter2; // => false | |
var facebook = container.lookup('connection:facebook'); | |
var facebook2 = container.lookup('connection:facebook'); | |
facebook === facebook2; // => false | |
``` | |
@method optionsForType | |
@param {String} type | |
@param {Object} options | |
*/ | |
optionsForType: function(type, options) { | |
if (this.parent) { illegalChildOperation('optionsForType'); } | |
this._typeOptions.set(type, options); | |
}, | |
/** | |
@method options | |
@param {String} type | |
@param {Object} options | |
*/ | |
options: function(type, options) { | |
this.optionsForType(type, options); | |
}, | |
/** | |
Used only via `injection`. | |
Provides a specialized form of injection, specifically enabling | |
all objects of one type to be injected with a reference to another | |
object. | |
For example, provided each object of type `controller` needed a `router`. | |
one would do the following: | |
```javascript | |
var container = new Container(); | |
container.register('router:main', Router); | |
container.register('controller:user', UserController); | |
container.register('controller:post', PostController); | |
container.typeInjection('controller', 'router', 'router:main'); | |
var user = container.lookup('controller:user'); | |
var post = container.lookup('controller:post'); | |
user.router instanceof Router; //=> true | |
post.router instanceof Router; //=> true | |
// both controllers share the same router | |
user.router === post.router; //=> true | |
``` | |
@private | |
@method typeInjection | |
@param {String} type | |
@param {String} property | |
@param {String} fullName | |
*/ | |
typeInjection: function(type, property, fullName) { | |
validateFullName(fullName); | |
if (this.parent) { illegalChildOperation('typeInjection'); } | |
var fullNameType = fullName.split(':')[0]; | |
if(fullNameType === type) { | |
throw new Error('Cannot inject a `' + fullName + '` on other ' + type + '(s). Register the `' + fullName + '` as a different type and perform the typeInjection.'); | |
} | |
addTypeInjection(this.typeInjections, type, property, fullName); | |
}, | |
/** | |
Defines injection rules. | |
These rules are used to inject dependencies onto objects when they | |
are instantiated. | |
Two forms of injections are possible: | |
* Injecting one fullName on another fullName | |
* Injecting one fullName on a type | |
Example: | |
```javascript | |
var container = new Container(); | |
container.register('source:main', Source); | |
container.register('model:user', User); | |
container.register('model:post', Post); | |
// injecting one fullName on another fullName | |
// eg. each user model gets a post model | |
container.injection('model:user', 'post', 'model:post'); | |
// injecting one fullName on another type | |
container.injection('model', 'source', 'source:main'); | |
var user = container.lookup('model:user'); | |
var post = container.lookup('model:post'); | |
user.source instanceof Source; //=> true | |
post.source instanceof Source; //=> true | |
user.post instanceof Post; //=> true | |
// and both models share the same source | |
user.source === post.source; //=> true | |
``` | |
@method injection | |
@param {String} factoryName | |
@param {String} property | |
@param {String} injectionName | |
*/ | |
injection: function(fullName, property, injectionName) { | |
if (this.parent) { illegalChildOperation('injection'); } | |
validateFullName(injectionName); | |
var normalizedInjectionName = this.normalize(injectionName); | |
if (fullName.indexOf(':') === -1) { | |
return this.typeInjection(fullName, property, normalizedInjectionName); | |
} | |
validateFullName(fullName); | |
var normalizedName = this.normalize(fullName); | |
if (this.cache.has(normalizedName)) { | |
throw new Error("Attempted to register an injection for a type that has already been looked up. ('" + normalizedName + "', '" + property + "', '" + injectionName + "')"); | |
} | |
addInjection(this.injections, normalizedName, property, normalizedInjectionName); | |
}, | |
/** | |
Used only via `factoryInjection`. | |
Provides a specialized form of injection, specifically enabling | |
all factory of one type to be injected with a reference to another | |
object. | |
For example, provided each factory of type `model` needed a `store`. | |
one would do the following: | |
```javascript | |
var container = new Container(); | |
container.register('store:main', SomeStore); | |
container.factoryTypeInjection('model', 'store', 'store:main'); | |
var store = container.lookup('store:main'); | |
var UserFactory = container.lookupFactory('model:user'); | |
UserFactory.store instanceof SomeStore; //=> true | |
``` | |
@private | |
@method factoryTypeInjection | |
@param {String} type | |
@param {String} property | |
@param {String} fullName | |
*/ | |
factoryTypeInjection: function(type, property, fullName) { | |
if (this.parent) { illegalChildOperation('factoryTypeInjection'); } | |
addTypeInjection(this.factoryTypeInjections, type, property, this.normalize(fullName)); | |
}, | |
/** | |
Defines factory injection rules. | |
Similar to regular injection rules, but are run against factories, via | |
`Container#lookupFactory`. | |
These rules are used to inject objects onto factories when they | |
are looked up. | |
Two forms of injections are possible: | |
* Injecting one fullName on another fullName | |
* Injecting one fullName on a type | |
Example: | |
```javascript | |
var container = new Container(); | |
container.register('store:main', Store); | |
container.register('store:secondary', OtherStore); | |
container.register('model:user', User); | |
container.register('model:post', Post); | |
// injecting one fullName on another type | |
container.factoryInjection('model', 'store', 'store:main'); | |
// injecting one fullName on another fullName | |
container.factoryInjection('model:post', 'secondaryStore', 'store:secondary'); | |
var UserFactory = container.lookupFactory('model:user'); | |
var PostFactory = container.lookupFactory('model:post'); | |
var store = container.lookup('store:main'); | |
UserFactory.store instanceof Store; //=> true | |
UserFactory.secondaryStore instanceof OtherStore; //=> false | |
PostFactory.store instanceof Store; //=> true | |
PostFactory.secondaryStore instanceof OtherStore; //=> true | |
// and both models share the same source instance | |
UserFactory.store === PostFactory.store; //=> true | |
``` | |
@method factoryInjection | |
@param {String} factoryName | |
@param {String} property | |
@param {String} injectionName | |
*/ | |
factoryInjection: function(fullName, property, injectionName) { | |
if (this.parent) { illegalChildOperation('injection'); } | |
var normalizedName = this.normalize(fullName); | |
var normalizedInjectionName = this.normalize(injectionName); | |
validateFullName(injectionName); | |
if (fullName.indexOf(':') === -1) { | |
return this.factoryTypeInjection(normalizedName, property, normalizedInjectionName); | |
} | |
validateFullName(fullName); | |
if (this.factoryCache.has(normalizedName)) { | |
throw new Error("Attempted to register a factoryInjection for a type that has already been looked up. ('" + normalizedName + "', '" + property + "', '" + injectionName + "')"); | |
} | |
addInjection(this.factoryInjections, normalizedName, property, normalizedInjectionName); | |
}, | |
/** | |
A depth first traversal, destroying the container, its descendant containers and all | |
their managed objects. | |
@method destroy | |
*/ | |
destroy: function() { | |
for (var i=0, l=this.children.length; i<l; i++) { | |
this.children[i].destroy(); | |
} | |
this.children = []; | |
eachDestroyable(this, function(item) { | |
item.destroy(); | |
}); | |
this.parent = undefined; | |
this.isDestroyed = true; | |
}, | |
/** | |
@method reset | |
*/ | |
reset: function() { | |
for (var i=0, l=this.children.length; i<l; i++) { | |
resetCache(this.children[i]); | |
} | |
resetCache(this); | |
} | |
}; | |
function has(container, fullName){ | |
if (container.cache.has(fullName)) { | |
return true; | |
} | |
return !!container.resolve(fullName); | |
} | |
function lookup(container, fullName, options) { | |
options = options || {}; | |
if (container.cache.has(fullName) && options.singleton !== false) { | |
return container.cache.get(fullName); | |
} | |
var value = instantiate(container, fullName); | |
if (value === undefined) { return; } | |
if (isSingleton(container, fullName) && options.singleton !== false) { | |
container.cache.set(fullName, value); | |
} | |
return value; | |
} | |
function illegalChildOperation(operation) { | |
throw new Error(operation + " is not currently supported on child containers"); | |
} | |
function isSingleton(container, fullName) { | |
var singleton = option(container, fullName, 'singleton'); | |
return singleton !== false; | |
} | |
function buildInjections(container, injections) { | |
var hash = {}; | |
if (!injections) { return hash; } | |
var injection, injectable; | |
for (var i=0, l=injections.length; i<l; i++) { | |
injection = injections[i]; | |
injectable = lookup(container, injection.fullName); | |
if (injectable !== undefined) { | |
hash[injection.property] = injectable; | |
} else { | |
throw new Error('Attempting to inject an unknown injection: `' + injection.fullName + '`'); | |
} | |
} | |
return hash; | |
} | |
function option(container, fullName, optionName) { | |
var options = container._options.get(fullName); | |
if (options && options[optionName] !== undefined) { | |
return options[optionName]; | |
} | |
var type = fullName.split(":")[0]; | |
options = container._typeOptions.get(type); | |
if (options) { | |
return options[optionName]; | |
} | |
} | |
function factoryFor(container, fullName) { | |
var name = fullName; | |
var factory = container.resolve(name); | |
var injectedFactory; | |
var cache = container.factoryCache; | |
var type = fullName.split(":")[0]; | |
if (factory === undefined) { return; } | |
if (cache.has(fullName)) { | |
return cache.get(fullName); | |
} | |
if (!factory || typeof factory.extend !== 'function' || (!Ember.MODEL_FACTORY_INJECTIONS && type === 'model')) { | |
// TODO: think about a 'safe' merge style extension | |
// for now just fallback to create time injection | |
return factory; | |
} else { | |
var injections = injectionsFor(container, fullName); | |
var factoryInjections = factoryInjectionsFor(container, fullName); | |
factoryInjections._toString = container.makeToString(factory, fullName); | |
injectedFactory = factory.extend(injections); | |
injectedFactory.reopenClass(factoryInjections); | |
cache.set(fullName, injectedFactory); | |
return injectedFactory; | |
} | |
} | |
function injectionsFor(container, fullName) { | |
var splitName = fullName.split(":"), | |
type = splitName[0], | |
injections = []; | |
injections = injections.concat(container.typeInjections.get(type) || []); | |
injections = injections.concat(container.injections[fullName] || []); | |
injections = buildInjections(container, injections); | |
injections._debugContainerKey = fullName; | |
injections.container = container; | |
return injections; | |
} | |
function factoryInjectionsFor(container, fullName) { | |
var splitName = fullName.split(":"), | |
type = splitName[0], | |
factoryInjections = []; | |
factoryInjections = factoryInjections.concat(container.factoryTypeInjections.get(type) || []); | |
factoryInjections = factoryInjections.concat(container.factoryInjections[fullName] || []); | |
factoryInjections = buildInjections(container, factoryInjections); | |
factoryInjections._debugContainerKey = fullName; | |
return factoryInjections; | |
} | |
function instantiate(container, fullName) { | |
var factory = factoryFor(container, fullName); | |
if (option(container, fullName, 'instantiate') === false) { | |
return factory; | |
} | |
if (factory) { | |
if (typeof factory.extend === 'function') { | |
// assume the factory was extendable and is already injected | |
return factory.create(); | |
} else { | |
// assume the factory was extendable | |
// to create time injections | |
// TODO: support new'ing for instantiation and merge injections for pure JS Functions | |
return factory.create(injectionsFor(container, fullName)); | |
} | |
} | |
} | |
function eachDestroyable(container, callback) { | |
container.cache.eachLocal(function(key, value) { | |
if (option(container, key, 'instantiate') === false) { return; } | |
callback(value); | |
}); | |
} | |
function resetCache(container) { | |
container.cache.eachLocal(function(key, value) { | |
if (option(container, key, 'instantiate') === false) { return; } | |
value.destroy(); | |
}); | |
container.cache.dict = {}; | |
} | |
function addTypeInjection(rules, type, property, fullName) { | |
var injections = rules.get(type); | |
if (!injections) { | |
injections = []; | |
rules.set(type, injections); | |
} | |
injections.push({ | |
property: property, | |
fullName: fullName | |
}); | |
} | |
var VALID_FULL_NAME_REGEXP = /^[^:]+.+:[^:]+$/; | |
function validateFullName(fullName) { | |
if (!VALID_FULL_NAME_REGEXP.test(fullName)) { | |
throw new TypeError('Invalid Fullname, expected: `type:name` got: ' + fullName); | |
} | |
} | |
function addInjection(rules, factoryName, property, injectionName) { | |
var injections = rules[factoryName] = rules[factoryName] || []; | |
injections.push({ property: property, fullName: injectionName }); | |
} | |
__exports__["default"] = Container; | |
}); | |
define("container/inheriting_dict", | |
["exports"], | |
function(__exports__) { | |
"use strict"; | |
// A safe and simple inheriting object. | |
function InheritingDict(parent) { | |
this.parent = parent; | |
this.dict = {}; | |
} | |
InheritingDict.prototype = { | |
/** | |
@property parent | |
@type InheritingDict | |
@default null | |
*/ | |
parent: null, | |
/** | |
Object used to store the current nodes data. | |
@property dict | |
@type Object | |
@default Object | |
*/ | |
dict: null, | |
/** | |
Retrieve the value given a key, if the value is present at the current | |
level use it, otherwise walk up the parent hierarchy and try again. If | |
no matching key is found, return undefined. | |
@method get | |
@param {String} key | |
@return {any} | |
*/ | |
get: function(key) { | |
var dict = this.dict; | |
if (dict.hasOwnProperty(key)) { | |
return dict[key]; | |
} | |
if (this.parent) { | |
return this.parent.get(key); | |
} | |
}, | |
/** | |
Set the given value for the given key, at the current level. | |
@method set | |
@param {String} key | |
@param {Any} value | |
*/ | |
set: function(key, value) { | |
this.dict[key] = value; | |
}, | |
/** | |
Delete the given key | |
@method remove | |
@param {String} key | |
*/ | |
remove: function(key) { | |
delete this.dict[key]; | |
}, | |
/** | |
Check for the existence of given a key, if the key is present at the current | |
level return true, otherwise walk up the parent hierarchy and try again. If | |
no matching key is found, return false. | |
@method has | |
@param {String} key | |
@return {Boolean} | |
*/ | |
has: function(key) { | |
var dict = this.dict; | |
if (dict.hasOwnProperty(key)) { | |
return true; | |
} | |
if (this.parent) { | |
return this.parent.has(key); | |
} | |
return false; | |
}, | |
/** | |
Iterate and invoke a callback for each local key-value pair. | |
@method eachLocal | |
@param {Function} callback | |
@param {Object} binding | |
*/ | |
eachLocal: function(callback, binding) { | |
var dict = this.dict; | |
for (var prop in dict) { | |
if (dict.hasOwnProperty(prop)) { | |
callback.call(binding, prop, dict[prop]); | |
} | |
} | |
} | |
}; | |
__exports__["default"] = InheritingDict; | |
}); | |
define("ember-application", | |
["ember-metal/core","ember-runtime/system/lazy_load","ember-application/system/dag","ember-application/system/resolver","ember-application/system/application","ember-application/ext/controller"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __dependency6__) { | |
"use strict"; | |
var Ember = __dependency1__["default"]; | |
var runLoadHooks = __dependency2__.runLoadHooks; | |
/** | |
Ember Application | |
@module ember | |
@submodule ember-application | |
@requires ember-views, ember-routing | |
*/ | |
var DAG = __dependency3__["default"]; | |
var Resolver = __dependency4__.Resolver; | |
var DefaultResolver = __dependency4__.DefaultResolver; | |
var Application = __dependency5__["default"]; | |
// side effect of extending ControllerMixin | |
Ember.Application = Application; | |
Ember.DAG = DAG; | |
Ember.Resolver = Resolver; | |
Ember.DefaultResolver = DefaultResolver; | |
runLoadHooks('Ember.Application', Application); | |
}); | |
define("ember-application/ext/controller", | |
["ember-metal/core","ember-metal/property_get","ember-metal/property_set","ember-metal/error","ember-metal/utils","ember-metal/computed","ember-runtime/controllers/controller","ember-routing/system/controller_for","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __dependency6__, __dependency7__, __dependency8__, __exports__) { | |
"use strict"; | |
/** | |
@module ember | |
@submodule ember-application | |
*/ | |
var Ember = __dependency1__["default"]; | |
// Ember.assert | |
var get = __dependency2__.get; | |
var set = __dependency3__.set; | |
var EmberError = __dependency4__["default"]; | |
var inspect = __dependency5__.inspect; | |
var computed = __dependency6__.computed; | |
var ControllerMixin = __dependency7__.ControllerMixin; | |
var meta = __dependency5__.meta; | |
var controllerFor = __dependency8__.controllerFor; | |
function verifyNeedsDependencies(controller, container, needs) { | |
var dependency, i, l, missing = []; | |
for (i=0, l=needs.length; i<l; i++) { | |
dependency = needs[i]; | |
Ember.assert(inspect(controller) + "#needs must not specify dependencies with periods in their names (" + dependency + ")", dependency.indexOf('.') === -1); | |
if (dependency.indexOf(':') === -1) { | |
dependency = "controller:" + dependency; | |
} | |
// Structure assert to still do verification but not string concat in production | |
if (!container.has(dependency)) { | |
missing.push(dependency); | |
} | |
} | |
if (missing.length) { | |
throw new EmberError(inspect(controller) + " needs [ " + missing.join(', ') + " ] but " + (missing.length > 1 ? 'they' : 'it') + " could not be found"); | |
} | |
} | |
var defaultControllersComputedProperty = computed(function() { | |
var controller = this; | |
return { | |
needs: get(controller, 'needs'), | |
container: get(controller, 'container'), | |
unknownProperty: function(controllerName) { | |
var needs = this.needs, | |
dependency, i, l; | |
for (i=0, l=needs.length; i<l; i++) { | |
dependency = needs[i]; | |
if (dependency === controllerName) { | |
return this.container.lookup('controller:' + controllerName); | |
} | |
} | |
var errorMessage = inspect(controller) + '#needs does not include `' + controllerName + '`. To access the ' + controllerName + ' controller from ' + inspect(controller) + ', ' + inspect(controller) + ' should have a `needs` property that is an array of the controllers it has access to.'; | |
throw new ReferenceError(errorMessage); | |
}, | |
setUnknownProperty: function (key, value) { | |
throw new Error("You cannot overwrite the value of `controllers." + key + "` of " + inspect(controller)); | |
} | |
}; | |
}); | |
/** | |
@class ControllerMixin | |
@namespace Ember | |
*/ | |
ControllerMixin.reopen({ | |
concatenatedProperties: ['needs'], | |
/** | |
An array of other controller objects available inside | |
instances of this controller via the `controllers` | |
property: | |
For example, when you define a controller: | |
```javascript | |
App.CommentsController = Ember.ArrayController.extend({ | |
needs: ['post'] | |
}); | |
``` | |
The application's single instance of these other | |
controllers are accessible by name through the | |
`controllers` property: | |
```javascript | |
this.get('controllers.post'); // instance of App.PostController | |
``` | |
Given that you have a nested controller (nested resource): | |
```javascript | |
App.CommentsNewController = Ember.ObjectController.extend({ | |
}); | |
``` | |
When you define a controller that requires access to a nested one: | |
```javascript | |
App.IndexController = Ember.ObjectController.extend({ | |
needs: ['commentsNew'] | |
}); | |
``` | |
You will be able to get access to it: | |
```javascript | |
this.get('controllers.commentsNew'); // instance of App.CommentsNewController | |
``` | |
This is only available for singleton controllers. | |
@property {Array} needs | |
@default [] | |
*/ | |
needs: [], | |
init: function() { | |
var needs = get(this, 'needs'), | |
length = get(needs, 'length'); | |
if (length > 0) { | |
Ember.assert(' `' + inspect(this) + ' specifies `needs`, but does ' + | |
"not have a container. Please ensure this controller was " + | |
"instantiated with a container.", | |
this.container || meta(this, false).descs.controllers !== defaultControllersComputedProperty); | |
if (this.container) { | |
verifyNeedsDependencies(this, this.container, needs); | |
} | |
// if needs then initialize controllers proxy | |
get(this, 'controllers'); | |
} | |
this._super.apply(this, arguments); | |
}, | |
/** | |
@method controllerFor | |
@see {Ember.Route#controllerFor} | |
@deprecated Use `needs` instead | |
*/ | |
controllerFor: function(controllerName) { | |
Ember.deprecate("Controller#controllerFor is deprecated, please use Controller#needs instead"); | |
return controllerFor(get(this, 'container'), controllerName); | |
}, | |
/** | |
Stores the instances of other controllers available from within | |
this controller. Any controller listed by name in the `needs` | |
property will be accessible by name through this property. | |
```javascript | |
App.CommentsController = Ember.ArrayController.extend({ | |
needs: ['post'], | |
postTitle: function(){ | |
var currentPost = this.get('controllers.post'); // instance of App.PostController | |
return currentPost.get('title'); | |
}.property('controllers.post.title') | |
}); | |
``` | |
@see {Ember.ControllerMixin#needs} | |
@property {Object} controllers | |
@default null | |
*/ | |
controllers: defaultControllersComputedProperty | |
}); | |
__exports__["default"] = ControllerMixin; | |
}); | |
define("ember-application/system/application", | |
["ember-metal","ember-metal/property_get","ember-metal/property_set","ember-runtime/system/lazy_load","ember-application/system/dag","ember-runtime/system/namespace","ember-runtime/mixins/deferred","ember-application/system/resolver","ember-metal/platform","ember-metal/run_loop","ember-metal/utils","container/container","ember-runtime/controllers/controller","ember-metal/enumerable_utils","ember-runtime/controllers/object_controller","ember-runtime/controllers/array_controller","ember-views/system/event_dispatcher","ember-views/system/jquery","ember-routing/system/route","ember-routing/system/router","ember-routing/location/hash_location","ember-routing/location/history_location","ember-routing/location/auto_location","ember-routing/location/none_location","ember-handlebars-compiler","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __dependency6__, __dependency7__, __dependency8__, __dependency9__, __dependency10__, __dependency11__, __dependency12__, __dependency13__, __dependency14__, __dependency15__, __dependency16__, __dependency17__, __dependency18__, __dependency19__, __dependency20__, __dependency21__, __dependency22__, __dependency23__, __dependency24__, __dependency25__, __exports__) { | |
"use strict"; | |
/** | |
@module ember | |
@submodule ember-application | |
*/ | |
var Ember = __dependency1__["default"]; | |
// Ember.FEATURES, Ember.deprecate, Ember.assert, Ember.libraries, LOG_VERSION, Namespace, BOOTED | |
var get = __dependency2__.get; | |
var set = __dependency3__.set; | |
var runLoadHooks = __dependency4__.runLoadHooks; | |
var DAG = __dependency5__["default"]; | |
var Namespace = __dependency6__["default"]; | |
var DeferredMixin = __dependency7__["default"]; | |
var DefaultResolver = __dependency8__.DefaultResolver; | |
var create = __dependency9__.create; | |
var run = __dependency10__["default"]; | |
var canInvoke = __dependency11__.canInvoke; | |
var Container = __dependency12__["default"]; | |
var Controller = __dependency13__.Controller; | |
var EnumerableUtils = __dependency14__["default"]; | |
var ObjectController = __dependency15__["default"]; | |
var ArrayController = __dependency16__["default"]; | |
var EventDispatcher = __dependency17__["default"]; | |
//import ContainerDebugAdapter from "ember-extension-support/container_debug_adapter"; | |
var jQuery = __dependency18__["default"]; | |
var Route = __dependency19__["default"]; | |
var Router = __dependency20__["default"]; | |
var HashLocation = __dependency21__["default"]; | |
var HistoryLocation = __dependency22__["default"]; | |
var AutoLocation = __dependency23__["default"]; | |
var NoneLocation = __dependency24__["default"]; | |
var EmberHandlebars = __dependency25__["default"]; | |
var K = Ember.K; | |
var ContainerDebugAdapter; | |
function DeprecatedContainer(container) { | |
this._container = container; | |
} | |
DeprecatedContainer.deprecate = function(method) { | |
return function() { | |
var container = this._container; | |
Ember.deprecate('Using the defaultContainer is no longer supported. [defaultContainer#' + method + '] see: http://git.io/EKPpnA', false); | |
return container[method].apply(container, arguments); | |
}; | |
}; | |
DeprecatedContainer.prototype = { | |
_container: null, | |
lookup: DeprecatedContainer.deprecate('lookup'), | |
resolve: DeprecatedContainer.deprecate('resolve'), | |
register: DeprecatedContainer.deprecate('register') | |
}; | |
/** | |
An instance of `Ember.Application` is the starting point for every Ember | |
application. It helps to instantiate, initialize and coordinate the many | |
objects that make up your app. | |
Each Ember app has one and only one `Ember.Application` object. In fact, the | |
very first thing you should do in your application is create the instance: | |
```javascript | |
window.App = Ember.Application.create(); | |
``` | |
Typically, the application object is the only global variable. All other | |
classes in your app should be properties on the `Ember.Application` instance, | |
which highlights its first role: a global namespace. | |
For example, if you define a view class, it might look like this: | |
```javascript | |
App.MyView = Ember.View.extend(); | |
``` | |
By default, calling `Ember.Application.create()` will automatically initialize | |
your application by calling the `Ember.Application.initialize()` method. If | |
you need to delay initialization, you can call your app's `deferReadiness()` | |
method. When you are ready for your app to be initialized, call its | |
`advanceReadiness()` method. | |
You can define a `ready` method on the `Ember.Application` instance, which | |
will be run by Ember when the application is initialized. | |
Because `Ember.Application` inherits from `Ember.Namespace`, any classes | |
you create will have useful string representations when calling `toString()`. | |
See the `Ember.Namespace` documentation for more information. | |
While you can think of your `Ember.Application` as a container that holds the | |
other classes in your application, there are several other responsibilities | |
going on under-the-hood that you may want to understand. | |
### Event Delegation | |
Ember uses a technique called _event delegation_. This allows the framework | |
to set up a global, shared event listener instead of requiring each view to | |
do it manually. For example, instead of each view registering its own | |
`mousedown` listener on its associated element, Ember sets up a `mousedown` | |
listener on the `body`. | |
If a `mousedown` event occurs, Ember will look at the target of the event and | |
start walking up the DOM node tree, finding corresponding views and invoking | |
their `mouseDown` method as it goes. | |
`Ember.Application` has a number of default events that it listens for, as | |
well as a mapping from lowercase events to camel-cased view method names. For | |
example, the `keypress` event causes the `keyPress` method on the view to be | |
called, the `dblclick` event causes `doubleClick` to be called, and so on. | |
If there is a bubbling browser event that Ember does not listen for by | |
default, you can specify custom events and their corresponding view method | |
names by setting the application's `customEvents` property: | |
```javascript | |
App = Ember.Application.create({ | |
customEvents: { | |
// add support for the paste event | |
paste: "paste" | |
} | |
}); | |
``` | |
By default, the application sets up these event listeners on the document | |
body. However, in cases where you are embedding an Ember application inside | |
an existing page, you may want it to set up the listeners on an element | |
inside the body. | |
For example, if only events inside a DOM element with the ID of `ember-app` | |
should be delegated, set your application's `rootElement` property: | |
```javascript | |
window.App = Ember.Application.create({ | |
rootElement: '#ember-app' | |
}); | |
``` | |
The `rootElement` can be either a DOM element or a jQuery-compatible selector | |
string. Note that *views appended to the DOM outside the root element will | |
not receive events.* If you specify a custom root element, make sure you only | |
append views inside it! | |
To learn more about the advantages of event delegation and the Ember view | |
layer, and a list of the event listeners that are setup by default, visit the | |
[Ember View Layer guide](http://emberjs.com/guides/understanding-ember/the-view-layer/#toc_event-delegation). | |
### Initializers | |
Libraries on top of Ember can add initializers, like so: | |
```javascript | |
Ember.Application.initializer({ | |
name: 'api-adapter', | |
initialize: function(container, application) { | |
application.register('api-adapter:main', ApiAdapter); | |
} | |
}); | |
``` | |
Initializers provide an opportunity to access the container, which | |
organizes the different components of an Ember application. Additionally | |
they provide a chance to access the instantiated application. Beyond | |
being used for libraries, initializers are also a great way to organize | |
dependency injection or setup in your own application. | |
### Routing | |
In addition to creating your application's router, `Ember.Application` is | |
also responsible for telling the router when to start routing. Transitions | |
between routes can be logged with the `LOG_TRANSITIONS` flag, and more | |
detailed intra-transition logging can be logged with | |
the `LOG_TRANSITIONS_INTERNAL` flag: | |
```javascript | |
window.App = Ember.Application.create({ | |
LOG_TRANSITIONS: true, // basic logging of successful transitions | |
LOG_TRANSITIONS_INTERNAL: true // detailed logging of all routing steps | |
}); | |
``` | |
By default, the router will begin trying to translate the current URL into | |
application state once the browser emits the `DOMContentReady` event. If you | |
need to defer routing, you can call the application's `deferReadiness()` | |
method. Once routing can begin, call the `advanceReadiness()` method. | |
If there is any setup required before routing begins, you can implement a | |
`ready()` method on your app that will be invoked immediately before routing | |
begins. | |
``` | |
@class Application | |
@namespace Ember | |
@extends Ember.Namespace | |
*/ | |
var Application = Namespace.extend(DeferredMixin, { | |
/** | |
The root DOM element of the Application. This can be specified as an | |
element or a | |
[jQuery-compatible selector string](http://api.jquery.com/category/selectors/). | |
This is the element that will be passed to the Application's, | |
`eventDispatcher`, which sets up the listeners for event delegation. Every | |
view in your application should be a child of the element you specify here. | |
@property rootElement | |
@type DOMElement | |
@default 'body' | |
*/ | |
rootElement: 'body', | |
/** | |
The `Ember.EventDispatcher` responsible for delegating events to this | |
application's views. | |
The event dispatcher is created by the application at initialization time | |
and sets up event listeners on the DOM element described by the | |
application's `rootElement` property. | |
See the documentation for `Ember.EventDispatcher` for more information. | |
@property eventDispatcher | |
@type Ember.EventDispatcher | |
@default null | |
*/ | |
eventDispatcher: null, | |
/** | |
The DOM events for which the event dispatcher should listen. | |
By default, the application's `Ember.EventDispatcher` listens | |
for a set of standard DOM events, such as `mousedown` and | |
`keyup`, and delegates them to your application's `Ember.View` | |
instances. | |
If you would like additional bubbling events to be delegated to your | |
views, set your `Ember.Application`'s `customEvents` property | |
to a hash containing the DOM event name as the key and the | |
corresponding view method name as the value. For example: | |
```javascript | |
App = Ember.Application.create({ | |
customEvents: { | |
// add support for the paste event | |
paste: "paste" | |
} | |
}); | |
``` | |
@property customEvents | |
@type Object | |
@default null | |
*/ | |
customEvents: null, | |
// Start off the number of deferrals at 1. This will be | |
// decremented by the Application's own `initialize` method. | |
_readinessDeferrals: 1, | |
init: function() { | |
if (!this.$) { this.$ = jQuery; } | |
this.__container__ = this.buildContainer(); | |
this.Router = this.defaultRouter(); | |
this._super(); | |
this.scheduleInitialize(); | |
Ember.libraries.registerCoreLibrary('Handlebars', EmberHandlebars.VERSION); | |
Ember.libraries.registerCoreLibrary('jQuery', jQuery().jquery); | |
if ( Ember.LOG_VERSION ) { | |
Ember.LOG_VERSION = false; // we only need to see this once per Application#init | |
var nameLengths = EnumerableUtils.map(Ember.libraries, function(item) { | |
return get(item, "name.length"); | |
}); | |
var maxNameLength = Math.max.apply(this, nameLengths); | |
Ember.debug('-------------------------------'); | |
Ember.libraries.each(function(name, version) { | |
var spaces = new Array(maxNameLength - name.length + 1).join(" "); | |
Ember.debug([name, spaces, ' : ', version].join("")); | |
}); | |
Ember.debug('-------------------------------'); | |
} | |
}, | |
/** | |
Build the container for the current application. | |
Also register a default application view in case the application | |
itself does not. | |
@private | |
@method buildContainer | |
@return {Ember.Container} the configured container | |
*/ | |
buildContainer: function() { | |
var container = this.__container__ = Application.buildContainer(this); | |
return container; | |
}, | |
/** | |
If the application has not opted out of routing and has not explicitly | |
defined a router, supply a default router for the application author | |
to configure. | |
This allows application developers to do: | |
```javascript | |
var App = Ember.Application.create(); | |
App.Router.map(function() { | |
this.resource('posts'); | |
}); | |
``` | |
@private | |
@method defaultRouter | |
@return {Ember.Router} the default router | |
*/ | |
defaultRouter: function() { | |
if (this.Router === false) { return; } | |
var container = this.__container__; | |
if (this.Router) { | |
container.unregister('router:main'); | |
container.register('router:main', this.Router); | |
} | |
return container.lookupFactory('router:main'); | |
}, | |
/** | |
Automatically initialize the application once the DOM has | |
become ready. | |
The initialization itself is scheduled on the actions queue | |
which ensures that application loading finishes before | |
booting. | |
If you are asynchronously loading code, you should call | |
`deferReadiness()` to defer booting, and then call | |
`advanceReadiness()` once all of your code has finished | |
loading. | |
@private | |
@method scheduleInitialize | |
*/ | |
scheduleInitialize: function() { | |
var self = this; | |
if (!this.$ || this.$.isReady) { | |
run.schedule('actions', self, '_initialize'); | |
} else { | |
this.$().ready(function runInitialize() { | |
run(self, '_initialize'); | |
}); | |
} | |
}, | |
/** | |
Use this to defer readiness until some condition is true. | |
Example: | |
```javascript | |
App = Ember.Application.create(); | |
App.deferReadiness(); | |
jQuery.getJSON("/auth-token", function(token) { | |
App.token = token; | |
App.advanceReadiness(); | |
}); | |
``` | |
This allows you to perform asynchronous setup logic and defer | |
booting your application until the setup has finished. | |
However, if the setup requires a loading UI, it might be better | |
to use the router for this purpose. | |
@method deferReadiness | |
*/ | |
deferReadiness: function() { | |
Ember.assert("You must call deferReadiness on an instance of Ember.Application", this instanceof Application); | |
Ember.assert("You cannot defer readiness since the `ready()` hook has already been called.", this._readinessDeferrals > 0); | |
this._readinessDeferrals++; | |
}, | |
/** | |
Call `advanceReadiness` after any asynchronous setup logic has completed. | |
Each call to `deferReadiness` must be matched by a call to `advanceReadiness` | |
or the application will never become ready and routing will not begin. | |
@method advanceReadiness | |
@see {Ember.Application#deferReadiness} | |
*/ | |
advanceReadiness: function() { | |
Ember.assert("You must call advanceReadiness on an instance of Ember.Application", this instanceof Application); | |
this._readinessDeferrals--; | |
if (this._readinessDeferrals === 0) { | |
run.once(this, this.didBecomeReady); | |
} | |
}, | |
/** | |
Registers a factory that can be used for dependency injection (with | |
`App.inject`) or for service lookup. Each factory is registered with | |
a full name including two parts: `type:name`. | |
A simple example: | |
```javascript | |
var App = Ember.Application.create(); | |
App.Orange = Ember.Object.extend(); | |
App.register('fruit:favorite', App.Orange); | |
``` | |
Ember will resolve factories from the `App` namespace automatically. | |
For example `App.CarsController` will be discovered and returned if | |
an application requests `controller:cars`. | |
An example of registering a controller with a non-standard name: | |
```javascript | |
var App = Ember.Application.create(), | |
Session = Ember.Controller.extend(); | |
App.register('controller:session', Session); | |
// The Session controller can now be treated like a normal controller, | |
// despite its non-standard name. | |
App.ApplicationController = Ember.Controller.extend({ | |
needs: ['session'] | |
}); | |
``` | |
Registered factories are **instantiated** by having `create` | |
called on them. Additionally they are **singletons**, each time | |
they are looked up they return the same instance. | |
Some examples modifying that default behavior: | |
```javascript | |
var App = Ember.Application.create(); | |
App.Person = Ember.Object.extend(); | |
App.Orange = Ember.Object.extend(); | |
App.Email = Ember.Object.extend(); | |
App.session = Ember.Object.create(); | |
App.register('model:user', App.Person, {singleton: false }); | |
App.register('fruit:favorite', App.Orange); | |
App.register('communication:main', App.Email, {singleton: false}); | |
App.register('session', App.session, {instantiate: false}); | |
``` | |
@method register | |
@param fullName {String} type:name (e.g., 'model:user') | |
@param factory {Function} (e.g., App.Person) | |
@param options {Object} (optional) disable instantiation or singleton usage | |
**/ | |
register: function() { | |
var container = this.__container__; | |
container.register.apply(container, arguments); | |
}, | |
/** | |
Define a dependency injection onto a specific factory or all factories | |
of a type. | |
When Ember instantiates a controller, view, or other framework component | |
it can attach a dependency to that component. This is often used to | |
provide services to a set of framework components. | |
An example of providing a session object to all controllers: | |
```javascript | |
var App = Ember.Application.create(), | |
Session = Ember.Object.extend({ isAuthenticated: false }); | |
// A factory must be registered before it can be injected | |
App.register('session:main', Session); | |
// Inject 'session:main' onto all factories of the type 'controller' | |
// with the name 'session' | |
App.inject('controller', 'session', 'session:main'); | |
App.IndexController = Ember.Controller.extend({ | |
isLoggedIn: Ember.computed.alias('session.isAuthenticated') | |
}); | |
``` | |
Injections can also be performed on specific factories. | |
```javascript | |
App.inject(<full_name or type>, <property name>, <full_name>) | |
App.inject('route', 'source', 'source:main') | |
App.inject('route:application', 'email', 'model:email') | |
``` | |
It is important to note that injections can only be performed on | |
classes that are instantiated by Ember itself. Instantiating a class | |
directly (via `create` or `new`) bypasses the dependency injection | |
system. | |
Ember-Data instantiates its models in a unique manner, and consequently | |
injections onto models (or all models) will not work as expected. Injections | |
on models can be enabled by setting `Ember.MODEL_FACTORY_INJECTIONS` | |
to `true`. | |
@method inject | |
@param factoryNameOrType {String} | |
@param property {String} | |
@param injectionName {String} | |
**/ | |
inject: function() { | |
var container = this.__container__; | |
container.injection.apply(container, arguments); | |
}, | |
/** | |
Calling initialize manually is not supported. | |
Please see Ember.Application#advanceReadiness and | |
Ember.Application#deferReadiness. | |
@private | |
@deprecated | |
@method initialize | |
**/ | |
initialize: function() { | |
Ember.deprecate('Calling initialize manually is not supported. Please see Ember.Application#advanceReadiness and Ember.Application#deferReadiness'); | |
}, | |
/** | |
Initialize the application. This happens automatically. | |
Run any initializers and run the application load hook. These hooks may | |
choose to defer readiness. For example, an authentication hook might want | |
to defer readiness until the auth token has been retrieved. | |
@private | |
@method _initialize | |
*/ | |
_initialize: function() { | |
if (this.isDestroyed) { return; } | |
// At this point, the App.Router must already be assigned | |
if (this.Router) { | |
var container = this.__container__; | |
container.unregister('router:main'); | |
container.register('router:main', this.Router); | |
} | |
this.runInitializers(); | |
runLoadHooks('application', this); | |
// At this point, any initializers or load hooks that would have wanted | |
// to defer readiness have fired. In general, advancing readiness here | |
// will proceed to didBecomeReady. | |
this.advanceReadiness(); | |
return this; | |
}, | |
/** | |
Reset the application. This is typically used only in tests. It cleans up | |
the application in the following order: | |
1. Deactivate existing routes | |
2. Destroy all objects in the container | |
3. Create a new application container | |
4. Re-route to the existing url | |
Typical Example: | |
```javascript | |
var App; | |
run(function() { | |
App = Ember.Application.create(); | |
}); | |
module("acceptance test", { | |
setup: function() { | |
App.reset(); | |
} | |
}); | |
test("first test", function() { | |
// App is freshly reset | |
}); | |
test("first test", function() { | |
// App is again freshly reset | |
}); | |
``` | |
Advanced Example: | |
Occasionally you may want to prevent the app from initializing during | |
setup. This could enable extra configuration, or enable asserting prior | |
to the app becoming ready. | |
```javascript | |
var App; | |
run(function() { | |
App = Ember.Application.create(); | |
}); | |
module("acceptance test", { | |
setup: function() { | |
run(function() { | |
App.reset(); | |
App.deferReadiness(); | |
}); | |
} | |
}); | |
test("first test", function() { | |
ok(true, 'something before app is initialized'); | |
run(function() { | |
App.advanceReadiness(); | |
}); | |
ok(true, 'something after app is initialized'); | |
}); | |
``` | |
@method reset | |
**/ | |
reset: function() { | |
this._readinessDeferrals = 1; | |
function handleReset() { | |
var router = this.__container__.lookup('router:main'); | |
router.reset(); | |
run(this.__container__, 'destroy'); | |
this.buildContainer(); | |
run.schedule('actions', this, function() { | |
this._initialize(); | |
}); | |
} | |
run.join(this, handleReset); | |
}, | |
/** | |
@private | |
@method runInitializers | |
*/ | |
runInitializers: function() { | |
var initializers = get(this.constructor, 'initializers'), | |
container = this.__container__, | |
graph = new DAG(), | |
namespace = this, | |
name, initializer; | |
for (name in initializers) { | |
initializer = initializers[name]; | |
graph.addEdges(initializer.name, initializer.initialize, initializer.before, initializer.after); | |
} | |
graph.topsort(function (vertex) { | |
var initializer = vertex.value; | |
Ember.assert("No application initializer named '"+vertex.name+"'", initializer); | |
initializer(container, namespace); | |
}); | |
}, | |
/** | |
@private | |
@method didBecomeReady | |
*/ | |
didBecomeReady: function() { | |
this.setupEventDispatcher(); | |
this.ready(); // user hook | |
this.startRouting(); | |
if (!Ember.testing) { | |
// Eagerly name all classes that are already loaded | |
Ember.Namespace.processAll(); | |
Ember.BOOTED = true; | |
} | |
this.resolve(this); | |
}, | |
/** | |
Setup up the event dispatcher to receive events on the | |
application's `rootElement` with any registered | |
`customEvents`. | |
@private | |
@method setupEventDispatcher | |
*/ | |
setupEventDispatcher: function() { | |
var customEvents = get(this, 'customEvents'), | |
rootElement = get(this, 'rootElement'), | |
dispatcher = this.__container__.lookup('event_dispatcher:main'); | |
set(this, 'eventDispatcher', dispatcher); | |
dispatcher.setup(customEvents, rootElement); | |
}, | |
/** | |
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. | |
@private | |
@method startRouting | |
@property router {Ember.Router} | |
*/ | |
startRouting: function() { | |
var router = this.__container__.lookup('router:main'); | |
if (!router) { return; } | |
router.startRouting(); | |
}, | |
handleURL: function(url) { | |
var router = this.__container__.lookup('router:main'); | |
router.handleURL(url); | |
}, | |
/** | |
Called when the Application has become ready. | |
The call will be delayed until the DOM has become ready. | |
@event ready | |
*/ | |
ready: K, | |
/** | |
@deprecated Use 'Resolver' instead | |
Set this to provide an alternate class to `Ember.DefaultResolver` | |
@property resolver | |
*/ | |
resolver: null, | |
/** | |
Set this to provide an alternate class to `Ember.DefaultResolver` | |
@property resolver | |
*/ | |
Resolver: null, | |
willDestroy: function() { | |
Ember.BOOTED = false; | |
// Ensure deactivation of routes before objects are destroyed | |
this.__container__.lookup('router:main').reset(); | |
this.__container__.destroy(); | |
}, | |
initializer: function(options) { | |
this.constructor.initializer(options); | |
} | |
}); | |
Application.reopenClass({ | |
initializers: {}, | |
initializer: function(initializer) { | |
// If this is the first initializer being added to a subclass, we are going to reopen the class | |
// to make sure we have a new `initializers` object, which extends from the parent class' using | |
// prototypal inheritance. Without this, attempting to add initializers to the subclass would | |
// pollute the parent class as well as other subclasses. | |
if (this.superclass.initializers !== undefined && this.superclass.initializers === this.initializers) { | |
this.reopenClass({ | |
initializers: create(this.initializers) | |
}); | |
} | |
Ember.assert("The initializer '" + initializer.name + "' has already been registered", !this.initializers[initializer.name]); | |
Ember.assert("An initializer cannot be registered with both a before and an after", !(initializer.before && initializer.after)); | |
Ember.assert("An initializer cannot be registered without an initialize function", canInvoke(initializer, 'initialize')); | |
this.initializers[initializer.name] = initializer; | |
}, | |
/** | |
This creates a container with the default Ember naming conventions. | |
It also configures the container: | |
* registered views are created every time they are looked up (they are | |
not singletons) | |
* registered templates are not factories; the registered value is | |
returned directly. | |
* the router receives the application as its `namespace` property | |
* all controllers receive the router as their `target` and `controllers` | |
properties | |
* all controllers receive the application as their `namespace` property | |
* the application view receives the application controller as its | |
`controller` property | |
* the application view receives the application template as its | |
`defaultTemplate` property | |
@private | |
@method buildContainer | |
@static | |
@param {Ember.Application} namespace the application to build the | |
container for. | |
@return {Ember.Container} the built container | |
*/ | |
buildContainer: function(namespace) { | |
var container = new Container(); | |
Container.defaultContainer = new DeprecatedContainer(container); | |
container.set = set; | |
container.resolver = resolverFor(namespace); | |
container.normalize = container.resolver.normalize; | |
container.describe = container.resolver.describe; | |
container.makeToString = container.resolver.makeToString; | |
container.optionsForType('component', { singleton: false }); | |
container.optionsForType('view', { singleton: false }); | |
container.optionsForType('template', { instantiate: false }); | |
container.optionsForType('helper', { instantiate: false }); | |
container.register('application:main', namespace, { instantiate: false }); | |
container.register('controller:basic', Controller, { instantiate: false }); | |
container.register('controller:object', ObjectController, { instantiate: false }); | |
container.register('controller:array', ArrayController, { instantiate: false }); | |
container.register('route:basic', Route, { instantiate: false }); | |
container.register('event_dispatcher:main', EventDispatcher); | |
container.register('router:main', Router); | |
container.injection('router:main', 'namespace', 'application:main'); | |
container.register('location:auto', AutoLocation); | |
container.register('location:hash', HashLocation); | |
container.register('location:history', HistoryLocation); | |
container.register('location:none', NoneLocation); | |
container.injection('controller', 'target', 'router:main'); | |
container.injection('controller', 'namespace', 'application:main'); | |
container.injection('route', 'router', 'router:main'); | |
container.injection('location', 'rootURL', '-location-setting:root-url'); | |
// DEBUGGING | |
container.register('resolver-for-debugging:main', container.resolver.__resolver__, { instantiate: false }); | |
container.injection('container-debug-adapter:main', 'resolver', 'resolver-for-debugging:main'); | |
container.injection('data-adapter:main', 'containerDebugAdapter', 'container-debug-adapter:main'); | |
// Custom resolver authors may want to register their own ContainerDebugAdapter with this key | |
// ES6TODO: resolve this via import once ember-application package is ES6'ed | |
if (!ContainerDebugAdapter) { ContainerDebugAdapter = requireModule('ember-extension-support/container_debug_adapter')['default']; } | |
container.register('container-debug-adapter:main', ContainerDebugAdapter); | |
return container; | |
} | |
}); | |
/** | |
This function defines the default lookup rules for container lookups: | |
* templates are looked up on `Ember.TEMPLATES` | |
* other names are looked up on the application after classifying the name. | |
For example, `controller:post` looks up `App.PostController` by default. | |
* if the default lookup fails, look for registered classes on the container | |
This allows the application to register default injections in the container | |
that could be overridden by the normal naming convention. | |
@private | |
@method resolverFor | |
@param {Ember.Namespace} namespace the namespace to look for classes | |
@return {*} the resolved value for a given lookup | |
*/ | |
function resolverFor(namespace) { | |
if (namespace.get('resolver')) { | |
Ember.deprecate('Application.resolver is deprecated in favor of Application.Resolver', false); | |
} | |
var ResolverClass = namespace.get('resolver') || namespace.get('Resolver') || DefaultResolver; | |
var resolver = ResolverClass.create({ | |
namespace: namespace | |
}); | |
function resolve(fullName) { | |
return resolver.resolve(fullName); | |
} | |
resolve.describe = function(fullName) { | |
return resolver.lookupDescription(fullName); | |
}; | |
resolve.makeToString = function(factory, fullName) { | |
return resolver.makeToString(factory, fullName); | |
}; | |
resolve.normalize = function(fullName) { | |
if (resolver.normalize) { | |
return resolver.normalize(fullName); | |
} else { | |
Ember.deprecate('The Resolver should now provide a \'normalize\' function', false); | |
return fullName; | |
} | |
}; | |
resolve.__resolver__ = resolver; | |
return resolve; | |
} | |
__exports__["default"] = Application; | |
}); | |
define("ember-application/system/dag", | |
["ember-metal/error","exports"], | |
function(__dependency1__, __exports__) { | |
"use strict"; | |
var EmberError = __dependency1__["default"]; | |
function visit(vertex, fn, visited, path) { | |
var name = vertex.name, | |
vertices = vertex.incoming, | |
names = vertex.incomingNames, | |
len = names.length, | |
i; | |
if (!visited) { | |
visited = {}; | |
} | |
if (!path) { | |
path = []; | |
} | |
if (visited.hasOwnProperty(name)) { | |
return; | |
} | |
path.push(name); | |
visited[name] = true; | |
for (i = 0; i < len; i++) { | |
visit(vertices[names[i]], fn, visited, path); | |
} | |
fn(vertex, path); | |
path.pop(); | |
} | |
function DAG() { | |
this.names = []; | |
this.vertices = {}; | |
} | |
DAG.prototype.add = function(name) { | |
if (!name) { return; } | |
if (this.vertices.hasOwnProperty(name)) { | |
return this.vertices[name]; | |
} | |
var vertex = { | |
name: name, incoming: {}, incomingNames: [], hasOutgoing: false, value: null | |
}; | |
this.vertices[name] = vertex; | |
this.names.push(name); | |
return vertex; | |
}; | |
DAG.prototype.map = function(name, value) { | |
this.add(name).value = value; | |
}; | |
DAG.prototype.addEdge = function(fromName, toName) { | |
if (!fromName || !toName || fromName === toName) { | |
return; | |
} | |
var from = this.add(fromName), to = this.add(toName); | |
if (to.incoming.hasOwnProperty(fromName)) { | |
return; | |
} | |
function checkCycle(vertex, path) { | |
if (vertex.name === toName) { | |
throw new EmberError("cycle detected: " + toName + " <- " + path.join(" <- ")); | |
} | |
} | |
visit(from, checkCycle); | |
from.hasOutgoing = true; | |
to.incoming[fromName] = from; | |
to.incomingNames.push(fromName); | |
}; | |
DAG.prototype.topsort = function(fn) { | |
var visited = {}, | |
vertices = this.vertices, | |
names = this.names, | |
len = names.length, | |
i, vertex; | |
for (i = 0; i < len; i++) { | |
vertex = vertices[names[i]]; | |
if (!vertex.hasOutgoing) { | |
visit(vertex, fn, visited); | |
} | |
} | |
}; | |
DAG.prototype.addEdges = function(name, value, before, after) { | |
var i; | |
this.map(name, value); | |
if (before) { | |
if (typeof before === 'string') { | |
this.addEdge(name, before); | |
} else { | |
for (i = 0; i < before.length; i++) { | |
this.addEdge(name, before[i]); | |
} | |
} | |
} | |
if (after) { | |
if (typeof after === 'string') { | |
this.addEdge(after, name); | |
} else { | |
for (i = 0; i < after.length; i++) { | |
this.addEdge(after[i], name); | |
} | |
} | |
} | |
}; | |
__exports__["default"] = DAG; | |
}); | |
define("ember-application/system/resolver", | |
["ember-metal/core","ember-metal/property_get","ember-metal/logger","ember-runtime/system/string","ember-runtime/system/object","ember-runtime/system/namespace","ember-handlebars","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __dependency6__, __dependency7__, __exports__) { | |
"use strict"; | |
/** | |
@module ember | |
@submodule ember-application | |
*/ | |
var Ember = __dependency1__["default"]; | |
// Ember.TEMPLATES, Ember.assert | |
var get = __dependency2__.get; | |
var Logger = __dependency3__["default"]; | |
var classify = __dependency4__.classify; | |
var capitalize = __dependency4__.capitalize; | |
var decamelize = __dependency4__.decamelize; | |
var EmberObject = __dependency5__["default"]; | |
var Namespace = __dependency6__["default"]; | |
var EmberHandlebars = __dependency7__["default"]; | |
var Resolver = EmberObject.extend({ | |
/** | |
This will be set to the Application instance when it is | |
created. | |
@property namespace | |
*/ | |
namespace: null, | |
normalize: function(fullName) { | |
throw new Error("Invalid call to `resolver.normalize(fullName)`. Please override the 'normalize' method in subclass of `Ember.Resolver` to prevent falling through to this error."); | |
}, | |
resolve: function(fullName) { | |
throw new Error("Invalid call to `resolver.resolve(parsedName)`. Please override the 'resolve' method in subclass of `Ember.Resolver` to prevent falling through to this error."); | |
}, | |
parseName: function(parsedName) { | |
throw new Error("Invalid call to `resolver.resolveByType(parsedName)`. Please override the 'resolveByType' method in subclass of `Ember.Resolver` to prevent falling through to this error."); | |
}, | |
lookupDescription: function(fullName) { | |
throw new Error("Invalid call to `resolver.lookupDescription(fullName)`. Please override the 'lookupDescription' method in subclass of `Ember.Resolver` to prevent falling through to this error."); | |
}, | |
makeToString: function(factory, fullName) { | |
throw new Error("Invalid call to `resolver.makeToString(factory, fullName)`. Please override the 'makeToString' method in subclass of `Ember.Resolver` to prevent falling through to this error."); | |
}, | |
resolveOther: function(parsedName) { | |
throw new Error("Invalid call to `resolver.resolveOther(parsedName)`. Please override the 'resolveOther' method in subclass of `Ember.Resolver` to prevent falling through to this error."); | |
}, | |
_logLookup: function(found, parsedName) { | |
throw new Error("Invalid call to `resolver._logLookup(found, parsedName)`. Please override the '_logLookup' method in subclass of `Ember.Resolver` to prevent falling through to this error."); | |
} | |
}); | |
__exports__.Resolver = Resolver; | |
/** | |
The DefaultResolver defines the default lookup rules to resolve | |
container lookups before consulting the container for registered | |
items: | |
* templates are looked up on `Ember.TEMPLATES` | |
* other names are looked up on the application after converting | |
the name. For example, `controller:post` looks up | |
`App.PostController` by default. | |
* there are some nuances (see examples below) | |
### How Resolving Works | |
The container calls this object's `resolve` method with the | |
`fullName` argument. | |
It first parses the fullName into an object using `parseName`. | |
Then it checks for the presence of a type-specific instance | |
method of the form `resolve[Type]` and calls it if it exists. | |
For example if it was resolving 'template:post', it would call | |
the `resolveTemplate` method. | |
Its last resort is to call the `resolveOther` method. | |
The methods of this object are designed to be easy to override | |
in a subclass. For example, you could enhance how a template | |
is resolved like so: | |
```javascript | |
App = Ember.Application.create({ | |
Resolver: Ember.DefaultResolver.extend({ | |
resolveTemplate: function(parsedName) { | |
var resolvedTemplate = this._super(parsedName); | |
if (resolvedTemplate) { return resolvedTemplate; } | |
return Ember.TEMPLATES['not_found']; | |
} | |
}) | |
}); | |
``` | |
Some examples of how names are resolved: | |
``` | |
'template:post' //=> Ember.TEMPLATES['post'] | |
'template:posts/byline' //=> Ember.TEMPLATES['posts/byline'] | |
'template:posts.byline' //=> Ember.TEMPLATES['posts/byline'] | |
'template:blogPost' //=> Ember.TEMPLATES['blogPost'] | |
// OR | |
// Ember.TEMPLATES['blog_post'] | |
'controller:post' //=> App.PostController | |
'controller:posts.index' //=> App.PostsIndexController | |
'controller:blog/post' //=> Blog.PostController | |
'controller:basic' //=> Ember.Controller | |
'route:post' //=> App.PostRoute | |
'route:posts.index' //=> App.PostsIndexRoute | |
'route:blog/post' //=> Blog.PostRoute | |
'route:basic' //=> Ember.Route | |
'view:post' //=> App.PostView | |
'view:posts.index' //=> App.PostsIndexView | |
'view:blog/post' //=> Blog.PostView | |
'view:basic' //=> Ember.View | |
'foo:post' //=> App.PostFoo | |
'model:post' //=> App.Post | |
``` | |
@class DefaultResolver | |
@namespace Ember | |
@extends Ember.Object | |
*/ | |
var DefaultResolver = EmberObject.extend({ | |
/** | |
This will be set to the Application instance when it is | |
created. | |
@property namespace | |
*/ | |
namespace: null, | |
normalize: function(fullName) { | |
var split = fullName.split(':', 2), | |
type = split[0], | |
name = split[1]; | |
Ember.assert("Tried to normalize a container name without a colon (:) in it. You probably tried to lookup a name that did not contain a type, a colon, and a name. A proper lookup name would be `view:post`.", split.length === 2); | |
if (type !== 'template') { | |
var result = name; | |
if (result.indexOf('.') > -1) { | |
result = result.replace(/\.(.)/g, function(m) { return m.charAt(1).toUpperCase(); }); | |
} | |
if (name.indexOf('_') > -1) { | |
result = result.replace(/_(.)/g, function(m) { return m.charAt(1).toUpperCase(); }); | |
} | |
return type + ':' + result; | |
} else { | |
return fullName; | |
} | |
}, | |
/** | |
This method is called via the container's resolver method. | |
It parses the provided `fullName` and then looks up and | |
returns the appropriate template or class. | |
@method resolve | |
@param {String} fullName the lookup string | |
@return {Object} the resolved factory | |
*/ | |
resolve: function(fullName) { | |
var parsedName = this.parseName(fullName), | |
resolveMethodName = parsedName.resolveMethodName, | |
resolved; | |
if (!(parsedName.name && parsedName.type)) { | |
throw new TypeError("Invalid fullName: `" + fullName + "`, must be of the form `type:name` "); | |
} | |
if (this[resolveMethodName]) { | |
resolved = this[resolveMethodName](parsedName); | |
} | |
if (!resolved) { | |
resolved = this.resolveOther(parsedName); | |
} | |
if (parsedName.root.LOG_RESOLVER) { | |
this._logLookup(resolved, parsedName); | |
} | |
return resolved; | |
}, | |
/** | |
Convert the string name of the form "type:name" to | |
a Javascript object with the parsed aspects of the name | |
broken out. | |
@protected | |
@param {String} fullName the lookup string | |
@method parseName | |
*/ | |
parseName: function(fullName) { | |
var nameParts = fullName.split(":"), | |
type = nameParts[0], fullNameWithoutType = nameParts[1], | |
name = fullNameWithoutType, | |
namespace = get(this, 'namespace'), | |
root = namespace; | |
if (type !== 'template' && name.indexOf('/') !== -1) { | |
var parts = name.split('/'); | |
name = parts[parts.length - 1]; | |
var namespaceName = capitalize(parts.slice(0, -1).join('.')); | |
root = Namespace.byName(namespaceName); | |
Ember.assert('You are looking for a ' + name + ' ' + type + ' in the ' + namespaceName + ' namespace, but the namespace could not be found', root); | |
} | |
return { | |
fullName: fullName, | |
type: type, | |
fullNameWithoutType: fullNameWithoutType, | |
name: name, | |
root: root, | |
resolveMethodName: "resolve" + classify(type) | |
}; | |
}, | |
/** | |
Returns a human-readable description for a fullName. Used by the | |
Application namespace in assertions to describe the | |
precise name of the class that Ember is looking for, rather than | |
container keys. | |
@protected | |
@param {String} fullName the lookup string | |
@method lookupDescription | |
*/ | |
lookupDescription: function(fullName) { | |
var parsedName = this.parseName(fullName); | |
if (parsedName.type === 'template') { | |
return "template at " + parsedName.fullNameWithoutType.replace(/\./g, '/'); | |
} | |
var description = parsedName.root + "." + classify(parsedName.name); | |
if (parsedName.type !== 'model') { description += classify(parsedName.type); } | |
return description; | |
}, | |
makeToString: function(factory, fullName) { | |
return factory.toString(); | |
}, | |
/** | |
Given a parseName object (output from `parseName`), apply | |
the conventions expected by `Ember.Router` | |
@protected | |
@param {Object} parsedName a parseName object with the parsed | |
fullName lookup string | |
@method useRouterNaming | |
*/ | |
useRouterNaming: function(parsedName) { | |
parsedName.name = parsedName.name.replace(/\./g, '_'); | |
if (parsedName.name === 'basic') { | |
parsedName.name = ''; | |
} | |
}, | |
/** | |
Look up the template in Ember.TEMPLATES | |
@protected | |
@param {Object} parsedName a parseName object with the parsed | |
fullName lookup string | |
@method resolveTemplate | |
*/ | |
resolveTemplate: function(parsedName) { | |
var templateName = parsedName.fullNameWithoutType.replace(/\./g, '/'); | |
if (Ember.TEMPLATES[templateName]) { | |
return Ember.TEMPLATES[templateName]; | |
} | |
templateName = decamelize(templateName); | |
if (Ember.TEMPLATES[templateName]) { | |
return Ember.TEMPLATES[templateName]; | |
} | |
}, | |
/** | |
Lookup the view using `resolveOther` | |
@protected | |
@param {Object} parsedName a parseName object with the parsed | |
fullName lookup string | |
@method resolveView | |
*/ | |
resolveView: function(parsedName) { | |
this.useRouterNaming(parsedName); | |
return this.resolveOther(parsedName); | |
}, | |
/** | |
Lookup the controller using `resolveOther` | |
@protected | |
@param {Object} parsedName a parseName object with the parsed | |
fullName lookup string | |
@method resolveController | |
*/ | |
resolveController: function(parsedName) { | |
this.useRouterNaming(parsedName); | |
return this.resolveOther(parsedName); | |
}, | |
/** | |
Lookup the route using `resolveOther` | |
@protected | |
@param {Object} parsedName a parseName object with the parsed | |
fullName lookup string | |
@method resolveRoute | |
*/ | |
resolveRoute: function(parsedName) { | |
this.useRouterNaming(parsedName); | |
return this.resolveOther(parsedName); | |
}, | |
/** | |
Lookup the model on the Application namespace | |
@protected | |
@param {Object} parsedName a parseName object with the parsed | |
fullName lookup string | |
@method resolveModel | |
*/ | |
resolveModel: function(parsedName) { | |
var className = classify(parsedName.name), | |
factory = get(parsedName.root, className); | |
if (factory) { return factory; } | |
}, | |
/** | |
Look up the specified object (from parsedName) on the appropriate | |
namespace (usually on the Application) | |
@protected | |
@param {Object} parsedName a parseName object with the parsed | |
fullName lookup string | |
@method resolveHelper | |
*/ | |
resolveHelper: function(parsedName) { | |
return this.resolveOther(parsedName) || EmberHandlebars.helpers[parsedName.fullNameWithoutType]; | |
}, | |
/** | |
Look up the specified object (from parsedName) on the appropriate | |
namespace (usually on the Application) | |
@protected | |
@param {Object} parsedName a parseName object with the parsed | |
fullName lookup string | |
@method resolveOther | |
*/ | |
resolveOther: function(parsedName) { | |
var className = classify(parsedName.name) + classify(parsedName.type), | |
factory = get(parsedName.root, className); | |
if (factory) { return factory; } | |
}, | |
/** | |
@method _logLookup | |
@param {Boolean} found | |
@param {Object} parsedName | |
@private | |
*/ | |
_logLookup: function(found, parsedName) { | |
var symbol, padding; | |
if (found) { symbol = '[✓]'; } | |
else { symbol = '[ ]'; } | |
if (parsedName.fullName.length > 60) { | |
padding = '.'; | |
} else { | |
padding = new Array(60 - parsedName.fullName.length).join('.'); | |
} | |
Logger.info(symbol, parsedName.fullName, padding, this.lookupDescription(parsedName.fullName)); | |
} | |
}); | |
__exports__.DefaultResolver = DefaultResolver; | |
}); | |
define("ember-debug", | |
["ember-metal/core","ember-metal/error","ember-metal/logger"], | |
function(__dependency1__, __dependency2__, __dependency3__) { | |
"use strict"; | |
/*global __fail__*/ | |
var Ember = __dependency1__["default"]; | |
var EmberError = __dependency2__["default"]; | |
var Logger = __dependency3__["default"]; | |
/** | |
Ember Debug | |
@module ember | |
@submodule ember-debug | |
*/ | |
/** | |
@class Ember | |
*/ | |
/** | |
Define an assertion that will throw an exception if the condition is not | |
met. Ember build tools will remove any calls to `Ember.assert()` when | |
doing a production build. Example: | |
```javascript | |
// Test for truthiness | |
Ember.assert('Must pass a valid object', obj); | |
// Fail unconditionally | |
Ember.assert('This code path should never be run') | |
``` | |
@method assert | |
@param {String} desc A description of the assertion. This will become | |
the text of the Error thrown if the assertion fails. | |
@param {Boolean} test Must be truthy for the assertion to pass. If | |
falsy, an exception will be thrown. | |
*/ | |
Ember.assert = function(desc, test) { | |
if (!test) { | |
throw new EmberError("Assertion Failed: " + desc); | |
} | |
}; | |
/** | |
Display a warning with the provided message. Ember build tools will | |
remove any calls to `Ember.warn()` when doing a production build. | |
@method warn | |
@param {String} message A warning to display. | |
@param {Boolean} test An optional boolean. If falsy, the warning | |
will be displayed. | |
*/ | |
Ember.warn = function(message, test) { | |
if (!test) { | |
Logger.warn("WARNING: "+message); | |
if ('trace' in Logger) Logger.trace(); | |
} | |
}; | |
/** | |
Display a debug notice. Ember build tools will remove any calls to | |
`Ember.debug()` when doing a production build. | |
```javascript | |
Ember.debug("I'm a debug notice!"); | |
``` | |
@method debug | |
@param {String} message A debug message to display. | |
*/ | |
Ember.debug = function(message) { | |
Logger.debug("DEBUG: "+message); | |
}; | |
/** | |
Display a deprecation warning with the provided message and a stack trace | |
(Chrome and Firefox only). Ember build tools will remove any calls to | |
`Ember.deprecate()` when doing a production build. | |
@method deprecate | |
@param {String} message A description of the deprecation. | |
@param {Boolean} test An optional boolean. If falsy, the deprecation | |
will be displayed. | |
*/ | |
Ember.deprecate = function(message, test) { | |
if (test) { return; } | |
if (Ember.ENV.RAISE_ON_DEPRECATION) { throw new EmberError(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; | |
} | |
Logger.warn("DEPRECATION: "+message); | |
}; | |
/** | |
Alias an old, deprecated method with its new counterpart. | |
Display a deprecation warning with the provided message and a stack trace | |
(Chrome and Firefox only) when the assigned method is called. | |
Ember build tools will not remove calls to `Ember.deprecateFunc()`, though | |
no warnings will be shown in production. | |
```javascript | |
Ember.oldMethod = Ember.deprecateFunc('Please use the new, updated method', Ember.newMethod); | |
``` | |
@method deprecateFunc | |
@param {String} message A description of the deprecation. | |
@param {Function} func The new function called to replace its deprecated counterpart. | |
@return {Function} a new function that wrapped the original function with a deprecation warning | |
*/ | |
Ember.deprecateFunc = function(message, func) { | |
return function() { | |
Ember.deprecate(message); | |
return func.apply(this, arguments); | |
}; | |
}; | |
/** | |
Run a function meant for debugging. Ember build tools will remove any calls to | |
`Ember.runInDebug()` when doing a production build. | |
```javascript | |
Ember.runInDebug(function() { | |
Ember.Handlebars.EachView.reopen({ | |
didInsertElement: function() { | |
console.log("I'm happy"); | |
} | |
}); | |
}); | |
``` | |
@method runInDebug | |
@param {Function} func The function to be executed. | |
@since 1.5.0 | |
*/ | |
Ember.runInDebug = function(func) { | |
func(); | |
}; | |
// Inform the developer about the Ember Inspector if not installed. | |
if (!Ember.testing) { | |
var isFirefox = typeof InstallTrigger !== 'undefined'; | |
var isChrome = !!window.chrome && !window.opera; | |
if (typeof window !== 'undefined' && (isFirefox || isChrome) && window.addEventListener) { | |
window.addEventListener("load", function() { | |
if (document.documentElement && document.documentElement.dataset && !document.documentElement.dataset.emberExtension) { | |
var downloadURL; | |
if(isChrome) { | |
downloadURL = 'https://chrome.google.com/webstore/detail/ember-inspector/bmdblncegkenkacieihfhpjfppoconhi'; | |
} else if(isFirefox) { | |
downloadURL = 'https://addons.mozilla.org/en-US/firefox/addon/ember-inspector/'; | |
} | |
Ember.debug('For more advanced debugging, install the Ember Inspector from ' + downloadURL); | |
} | |
}, false); | |
} | |
} | |
}); | |
define("ember-extension-support", | |
["ember-metal/core","ember-extension-support/data_adapter","ember-extension-support/container_debug_adapter"], | |
function(__dependency1__, __dependency2__, __dependency3__) { | |
"use strict"; | |
/** | |
Ember Extension Support | |
@module ember | |
@submodule ember-extension-support | |
@requires ember-application | |
*/ | |
var Ember = __dependency1__["default"]; | |
var DataAdapter = __dependency2__["default"]; | |
var ContainerDebugAdapter = __dependency3__["default"]; | |
Ember.DataAdapter = DataAdapter; | |
Ember.ContainerDebugAdapter = ContainerDebugAdapter; | |
}); | |
define("ember-extension-support/container_debug_adapter", | |
["ember-metal/core","ember-metal/utils","ember-runtime/system/string","ember-runtime/system/namespace","ember-runtime/system/object","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __exports__) { | |
"use strict"; | |
var Ember = __dependency1__["default"]; | |
var typeOf = __dependency2__.typeOf; | |
var dasherize = __dependency3__.dasherize; | |
var classify = __dependency3__.classify; | |
var Namespace = __dependency4__["default"]; | |
var EmberObject = __dependency5__["default"]; | |
/** | |
@module ember | |
@submodule ember-extension-support | |
*/ | |
/** | |
The `ContainerDebugAdapter` helps the container and resolver interface | |
with tools that debug Ember such as the | |
[Ember Extension](https://github.com/tildeio/ember-extension) | |
for Chrome and Firefox. | |
This class can be extended by a custom resolver implementer | |
to override some of the methods with library-specific code. | |
The methods likely to be overridden are: | |
* `canCatalogEntriesByType` | |
* `catalogEntriesByType` | |
The adapter will need to be registered | |
in the application's container as `container-debug-adapter:main` | |
Example: | |
```javascript | |
Application.initializer({ | |
name: "containerDebugAdapter", | |
initialize: function(container, application) { | |
application.register('container-debug-adapter:main', require('app/container-debug-adapter')); | |
} | |
}); | |
``` | |
@class ContainerDebugAdapter | |
@namespace Ember | |
@extends EmberObject | |
@since 1.5.0 | |
*/ | |
var ContainerDebugAdapter = EmberObject.extend({ | |
/** | |
The container of the application being debugged. | |
This property will be injected | |
on creation. | |
@property container | |
@default null | |
*/ | |
container: null, | |
/** | |
The resolver instance of the application | |
being debugged. This property will be injected | |
on creation. | |
@property resolver | |
@default null | |
*/ | |
resolver: null, | |
/** | |
Returns true if it is possible to catalog a list of available | |
classes in the resolver for a given type. | |
@method canCatalogEntriesByType | |
@param {string} type The type. e.g. "model", "controller", "route" | |
@return {boolean} whether a list is available for this type. | |
*/ | |
canCatalogEntriesByType: function(type) { | |
if (type === 'model' || type === 'template') return false; | |
return true; | |
}, | |
/** | |
Returns the available classes a given type. | |
@method catalogEntriesByType | |
@param {string} type The type. e.g. "model", "controller", "route" | |
@return {Array} An array of strings. | |
*/ | |
catalogEntriesByType: function(type) { | |
var namespaces = Ember.A(Namespace.NAMESPACES), types = Ember.A(), self = this; | |
var typeSuffixRegex = new RegExp(classify(type) + "$"); | |
namespaces.forEach(function(namespace) { | |
if (namespace !== Ember) { | |
for (var key in namespace) { | |
if (!namespace.hasOwnProperty(key)) { continue; } | |
if (typeSuffixRegex.test(key)) { | |
var klass = namespace[key]; | |
if (typeOf(klass) === 'class') { | |
types.push(dasherize(key.replace(typeSuffixRegex, ''))); | |
} | |
} | |
} | |
} | |
}); | |
return types; | |
} | |
}); | |
__exports__["default"] = ContainerDebugAdapter; | |
}); | |
define("ember-extension-support/data_adapter", | |
["ember-metal/core","ember-metal/property_get","ember-metal/run_loop","ember-runtime/system/string","ember-runtime/system/namespace","ember-runtime/system/object","ember-runtime/system/native_array","ember-application/system/application","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __dependency6__, __dependency7__, __dependency8__, __exports__) { | |
"use strict"; | |
var Ember = __dependency1__["default"]; | |
var get = __dependency2__.get; | |
var run = __dependency3__["default"]; | |
var dasherize = __dependency4__.dasherize; | |
var Namespace = __dependency5__["default"]; | |
var EmberObject = __dependency6__["default"]; | |
var emberA = __dependency7__.A; | |
var Application = __dependency8__["default"]; | |
/** | |
@module ember | |
@submodule ember-extension-support | |
*/ | |
/** | |
The `DataAdapter` helps a data persistence library | |
interface with tools that debug Ember such | |
as the [Ember Extension](https://github.com/tildeio/ember-extension) | |
for Chrome and Firefox. | |
This class will be extended by a persistence library | |
which will override some of the methods with | |
library-specific code. | |
The methods likely to be overridden are: | |
* `getFilters` | |
* `detect` | |
* `columnsForType` | |
* `getRecords` | |
* `getRecordColumnValues` | |
* `getRecordKeywords` | |
* `getRecordFilterValues` | |
* `getRecordColor` | |
* `observeRecord` | |
The adapter will need to be registered | |
in the application's container as `dataAdapter:main` | |
Example: | |
```javascript | |
Application.initializer({ | |
name: "data-adapter", | |
initialize: function(container, application) { | |
application.register('data-adapter:main', DS.DataAdapter); | |
} | |
}); | |
``` | |
@class DataAdapter | |
@namespace Ember | |
@extends EmberObject | |
*/ | |
__exports__["default"] = EmberObject.extend({ | |
init: function() { | |
this._super(); | |
this.releaseMethods = emberA(); | |
}, | |
/** | |
The container of the application being debugged. | |
This property will be injected | |
on creation. | |
@property container | |
@default null | |
@since 1.3.0 | |
*/ | |
container: null, | |
/** | |
The container-debug-adapter which is used | |
to list all models. | |
@property containerDebugAdapter | |
@default undefined | |
@since 1.5.0 | |
**/ | |
containerDebugAdapter: undefined, | |
/** | |
Number of attributes to send | |
as columns. (Enough to make the record | |
identifiable). | |
@private | |
@property attributeLimit | |
@default 3 | |
@since 1.3.0 | |
*/ | |
attributeLimit: 3, | |
/** | |
Stores all methods that clear observers. | |
These methods will be called on destruction. | |
@private | |
@property releaseMethods | |
@since 1.3.0 | |
*/ | |
releaseMethods: emberA(), | |
/** | |
Specifies how records can be filtered. | |
Records returned will need to have a `filterValues` | |
property with a key for every name in the returned array. | |
@public | |
@method getFilters | |
@return {Array} List of objects defining filters. | |
The object should have a `name` and `desc` property. | |
*/ | |
getFilters: function() { | |
return emberA(); | |
}, | |
/** | |
Fetch the model types and observe them for changes. | |
@public | |
@method watchModelTypes | |
@param {Function} typesAdded Callback to call to add types. | |
Takes an array of objects containing wrapped types (returned from `wrapModelType`). | |
@param {Function} typesUpdated Callback to call when a type has changed. | |
Takes an array of objects containing wrapped types. | |
@return {Function} Method to call to remove all observers | |
*/ | |
watchModelTypes: function(typesAdded, typesUpdated) { | |
var modelTypes = this.getModelTypes(), | |
self = this, typesToSend, releaseMethods = emberA(); | |
typesToSend = modelTypes.map(function(type) { | |
var klass = type.klass; | |
var wrapped = self.wrapModelType(klass, type.name); | |
releaseMethods.push(self.observeModelType(klass, typesUpdated)); | |
return wrapped; | |
}); | |
typesAdded(typesToSend); | |
var release = function() { | |
releaseMethods.forEach(function(fn) { fn(); }); | |
self.releaseMethods.removeObject(release); | |
}; | |
this.releaseMethods.pushObject(release); | |
return release; | |
}, | |
_nameToClass: function(type) { | |
if (typeof type === 'string') { | |
type = this.container.lookupFactory('model:' + type); | |
} | |
return type; | |
}, | |
/** | |
Fetch the records of a given type and observe them for changes. | |
@public | |
@method watchRecords | |
@param {Function} recordsAdded Callback to call to add records. | |
Takes an array of objects containing wrapped records. | |
The object should have the following properties: | |
columnValues: {Object} key and value of a table cell | |
object: {Object} the actual record object | |
@param {Function} recordsUpdated Callback to call when a record has changed. | |
Takes an array of objects containing wrapped records. | |
@param {Function} recordsRemoved Callback to call when a record has removed. | |
Takes the following parameters: | |
index: the array index where the records were removed | |
count: the number of records removed | |
@return {Function} Method to call to remove all observers | |
*/ | |
watchRecords: function(type, recordsAdded, recordsUpdated, recordsRemoved) { | |
var self = this, releaseMethods = emberA(), records = this.getRecords(type), release; | |
var recordUpdated = function(updatedRecord) { | |
recordsUpdated([updatedRecord]); | |
}; | |
var recordsToSend = records.map(function(record) { | |
releaseMethods.push(self.observeRecord(record, recordUpdated)); | |
return self.wrapRecord(record); | |
}); | |
var contentDidChange = function(array, idx, removedCount, addedCount) { | |
for (var i = idx; i < idx + addedCount; i++) { | |
var record = array.objectAt(i); | |
var wrapped = self.wrapRecord(record); | |
releaseMethods.push(self.observeRecord(record, recordUpdated)); | |
recordsAdded([wrapped]); | |
} | |
if (removedCount) { | |
recordsRemoved(idx, removedCount); | |
} | |
}; | |
var observer = { didChange: contentDidChange, willChange: Ember.K }; | |
records.addArrayObserver(self, observer); | |
release = function() { | |
releaseMethods.forEach(function(fn) { fn(); }); | |
records.removeArrayObserver(self, observer); | |
self.releaseMethods.removeObject(release); | |
}; | |
recordsAdded(recordsToSend); | |
this.releaseMethods.pushObject(release); | |
return release; | |
}, | |
/** | |
Clear all observers before destruction | |
@private | |
@method willDestroy | |
*/ | |
willDestroy: function() { | |
this._super(); | |
this.releaseMethods.forEach(function(fn) { | |
fn(); | |
}); | |
}, | |
/** | |
Detect whether a class is a model. | |
Test that against the model class | |
of your persistence library | |
@private | |
@method detect | |
@param {Class} klass The class to test | |
@return boolean Whether the class is a model class or not | |
*/ | |
detect: function(klass) { | |
return false; | |
}, | |
/** | |
Get the columns for a given model type. | |
@private | |
@method columnsForType | |
@param {Class} type The model type | |
@return {Array} An array of columns of the following format: | |
name: {String} name of the column | |
desc: {String} Humanized description (what would show in a table column name) | |
*/ | |
columnsForType: function(type) { | |
return emberA(); | |
}, | |
/** | |
Adds observers to a model type class. | |
@private | |
@method observeModelType | |
@param {Class} type The model type class | |
@param {Function} typesUpdated Called when a type is modified. | |
@return {Function} The function to call to remove observers | |
*/ | |
observeModelType: function(type, typesUpdated) { | |
var self = this, records = this.getRecords(type); | |
var onChange = function() { | |
typesUpdated([self.wrapModelType(type)]); | |
}; | |
var observer = { | |
didChange: function() { | |
run.scheduleOnce('actions', this, onChange); | |
}, | |
willChange: Ember.K | |
}; | |
records.addArrayObserver(this, observer); | |
var release = function() { | |
records.removeArrayObserver(self, observer); | |
}; | |
return release; | |
}, | |
/** | |
Wraps a given model type and observes changes to it. | |
@private | |
@method wrapModelType | |
@param {Class} type A model class | |
@param {String} Optional name of the class | |
@return {Object} contains the wrapped type and the function to remove observers | |
Format: | |
type: {Object} the wrapped type | |
The wrapped type has the following format: | |
name: {String} name of the type | |
count: {Integer} number of records available | |
columns: {Columns} array of columns to describe the record | |
object: {Class} the actual Model type class | |
release: {Function} The function to remove observers | |
*/ | |
wrapModelType: function(type, name) { | |
var release, records = this.getRecords(type), | |
typeToSend, self = this; | |
typeToSend = { | |
name: name || type.toString(), | |
count: get(records, 'length'), | |
columns: this.columnsForType(type), | |
object: type | |
}; | |
return typeToSend; | |
}, | |
/** | |
Fetches all models defined in the application. | |
@private | |
@method getModelTypes | |
@return {Array} Array of model types | |
*/ | |
getModelTypes: function() { | |
var types, self = this, | |
containerDebugAdapter = this.get('containerDebugAdapter'); | |
if (containerDebugAdapter.canCatalogEntriesByType('model')) { | |
types = containerDebugAdapter.catalogEntriesByType('model'); | |
} else { | |
types = this._getObjectsOnNamespaces(); | |
} | |
// New adapters return strings instead of classes | |
return types.map(function(name) { | |
return { | |
klass: self._nameToClass(name), | |
name: name | |
}; | |
}).filter(function(type) { | |
return self.detect(type.klass); | |
}); | |
}, | |
/** | |
Loops over all namespaces and all objects | |
attached to them | |
@private | |
@method _getObjectsOnNamespaces | |
@return {Array} Array of model type strings | |
*/ | |
_getObjectsOnNamespaces: function() { | |
var namespaces = emberA(Namespace.NAMESPACES), types = emberA(); | |
namespaces.forEach(function(namespace) { | |
for (var key in namespace) { | |
if (!namespace.hasOwnProperty(key)) { continue; } | |
var name = dasherize(key); | |
if (!(namespace instanceof Application) && namespace.toString()) { | |
name = namespace + '/' + name; | |
} | |
types.push(name); | |
} | |
}); | |
return types; | |
}, | |
/** | |
Fetches all loaded records for a given type. | |
@private | |
@method getRecords | |
@return {Array} An array of records. | |
This array will be observed for changes, | |
so it should update when new records are added/removed. | |
*/ | |
getRecords: function(type) { | |
return emberA(); | |
}, | |
/** | |
Wraps a record and observers changes to it. | |
@private | |
@method wrapRecord | |
@param {Object} record The record instance. | |
@return {Object} The wrapped record. Format: | |
columnValues: {Array} | |
searchKeywords: {Array} | |
*/ | |
wrapRecord: function(record) { | |
var recordToSend = { object: record }, columnValues = {}, self = this; | |
recordToSend.columnValues = this.getRecordColumnValues(record); | |
recordToSend.searchKeywords = this.getRecordKeywords(record); | |
recordToSend.filterValues = this.getRecordFilterValues(record); | |
recordToSend.color = this.getRecordColor(record); | |
return recordToSend; | |
}, | |
/** | |
Gets the values for each column. | |
@private | |
@method getRecordColumnValues | |
@return {Object} Keys should match column names defined | |
by the model type. | |
*/ | |
getRecordColumnValues: function(record) { | |
return {}; | |
}, | |
/** | |
Returns keywords to match when searching records. | |
@private | |
@method getRecordKeywords | |
@return {Array} Relevant keywords for search. | |
*/ | |
getRecordKeywords: function(record) { | |
return emberA(); | |
}, | |
/** | |
Returns the values of filters defined by `getFilters`. | |
@private | |
@method getRecordFilterValues | |
@param {Object} record The record instance | |
@return {Object} The filter values | |
*/ | |
getRecordFilterValues: function(record) { | |
return {}; | |
}, | |
/** | |
Each record can have a color that represents its state. | |
@private | |
@method getRecordColor | |
@param {Object} record The record instance | |
@return {String} The record's color | |
Possible options: black, red, blue, green | |
*/ | |
getRecordColor: function(record) { | |
return null; | |
}, | |
/** | |
Observes all relevant properties and re-sends the wrapped record | |
when a change occurs. | |
@private | |
@method observerRecord | |
@param {Object} record The record instance | |
@param {Function} recordUpdated The callback to call when a record is updated. | |
@return {Function} The function to call to remove all observers. | |
*/ | |
observeRecord: function(record, recordUpdated) { | |
return function(){}; | |
} | |
}); | |
}); | |
define("ember-extension-support/initializers", | |
[], | |
function() { | |
"use strict"; | |
}); | |
define("ember-handlebars-compiler", | |
["ember-metal/core","exports"], | |
function(__dependency1__, __exports__) { | |
"use strict"; | |
/* global Handlebars:true */ | |
/** | |
@module ember | |
@submodule ember-handlebars-compiler | |
*/ | |
var Ember = __dependency1__["default"]; | |
// ES6Todo: you'll need to import debugger once debugger is es6'd. | |
if (typeof Ember.assert === 'undefined') { Ember.assert = function(){}; } | |
if (typeof Ember.FEATURES === 'undefined') { Ember.FEATURES = { isEnabled: function(){} }; } | |
var objectCreate = Object.create || function(parent) { | |
function F() {} | |
F.prototype = parent; | |
return new F(); | |
}; | |
// set up for circular references later | |
var View, Component; | |
// ES6Todo: when ember-debug is es6'ed import this. | |
// var emberAssert = Ember.assert; | |
var Handlebars = (Ember.imports && Ember.imports.Handlebars) || (this && this.Handlebars); | |
if (!Handlebars && typeof require === 'function') { | |
Handlebars = require('handlebars'); | |
} | |
Ember.assert("Ember Handlebars requires Handlebars version 1.0 or 1.1. Include " + | |
"a SCRIPT tag in the HTML HEAD linking to the Handlebars file " + | |
"before you link to Ember.", Handlebars); | |
Ember.assert("Ember Handlebars requires Handlebars version 1.0 or 1.1, " + | |
"COMPILER_REVISION expected: 4, got: " + Handlebars.COMPILER_REVISION + | |
" - Please note: Builds of master may have other COMPILER_REVISION values.", | |
Handlebars.COMPILER_REVISION === 4); | |
/** | |
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. | |
@class Handlebars | |
@namespace Ember | |
*/ | |
var EmberHandlebars = Ember.Handlebars = objectCreate(Handlebars); | |
/** | |
Register a bound helper or custom view helper. | |
## Simple bound helper example | |
```javascript | |
Ember.Handlebars.helper('capitalize', function(value) { | |
return value.toUpperCase(); | |
}); | |
``` | |
The above bound helper can be used inside of templates as follows: | |
```handlebars | |
{{capitalize name}} | |
``` | |
In this case, when the `name` property of the template's context changes, | |
the rendered value of the helper will update to reflect this change. | |
For more examples of bound helpers, see documentation for | |
`Ember.Handlebars.registerBoundHelper`. | |
## Custom view helper example | |
Assuming a view subclass named `App.CalendarView` were defined, a helper | |
for rendering instances of this view could be registered as follows: | |
```javascript | |
Ember.Handlebars.helper('calendar', App.CalendarView): | |
``` | |
The above bound helper can be used inside of templates as follows: | |
```handlebars | |
{{calendar}} | |
``` | |
Which is functionally equivalent to: | |
```handlebars | |
{{view App.CalendarView}} | |
``` | |
Options in the helper will be passed to the view in exactly the same | |
manner as with the `view` helper. | |
@method helper | |
@for Ember.Handlebars | |
@param {String} name | |
@param {Function|Ember.View} function or view class constructor | |
@param {String} dependentKeys* | |
*/ | |
EmberHandlebars.helper = function(name, value) { | |
if (!View) { View = requireModule('ember-views/views/view')['View']; } // ES6TODO: stupid circular dep | |
if (!Component) { Component = requireModule('ember-views/views/component')['default']; } // ES6TODO: stupid circular dep | |
Ember.assert("You tried to register a component named '" + name + "', but component names must include a '-'", !Component.detect(value) || name.match(/-/)); | |
if (View.detect(value)) { | |
EmberHandlebars.registerHelper(name, EmberHandlebars.makeViewHelper(value)); | |
} else { | |
EmberHandlebars.registerBoundHelper.apply(null, arguments); | |
} | |
}; | |
/** | |
Returns a helper function that renders the provided ViewClass. | |
Used internally by Ember.Handlebars.helper and other methods | |
involving helper/component registration. | |
@private | |
@method makeViewHelper | |
@for Ember.Handlebars | |
@param {Function} ViewClass view class constructor | |
@since 1.2.0 | |
*/ | |
EmberHandlebars.makeViewHelper = function(ViewClass) { | |
return function(options) { | |
Ember.assert("You can only pass attributes (such as name=value) not bare values to a helper for a View found in '" + ViewClass.toString() + "'", arguments.length < 2); | |
return EmberHandlebars.helpers.view.call(this, ViewClass, options); | |
}; | |
}; | |
/** | |
@class helpers | |
@namespace Ember.Handlebars | |
*/ | |
EmberHandlebars.helpers = objectCreate(Handlebars.helpers); | |
/** | |
Override the the opcode compiler and JavaScript compiler for Handlebars. | |
@class Compiler | |
@namespace Ember.Handlebars | |
@private | |
@constructor | |
*/ | |
EmberHandlebars.Compiler = function() {}; | |
// Handlebars.Compiler doesn't exist in runtime-only | |
if (Handlebars.Compiler) { | |
EmberHandlebars.Compiler.prototype = objectCreate(Handlebars.Compiler.prototype); | |
} | |
EmberHandlebars.Compiler.prototype.compiler = EmberHandlebars.Compiler; | |
/** | |
@class JavaScriptCompiler | |
@namespace Ember.Handlebars | |
@private | |
@constructor | |
*/ | |
EmberHandlebars.JavaScriptCompiler = function() {}; | |
// Handlebars.JavaScriptCompiler doesn't exist in runtime-only | |
if (Handlebars.JavaScriptCompiler) { | |
EmberHandlebars.JavaScriptCompiler.prototype = objectCreate(Handlebars.JavaScriptCompiler.prototype); | |
EmberHandlebars.JavaScriptCompiler.prototype.compiler = EmberHandlebars.JavaScriptCompiler; | |
} | |
EmberHandlebars.JavaScriptCompiler.prototype.namespace = "Ember.Handlebars"; | |
EmberHandlebars.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 | |
@method appendToBuffer | |
@param string {String} | |
*/ | |
EmberHandlebars.JavaScriptCompiler.prototype.appendToBuffer = function(string) { | |
return "data.buffer.push("+string+");"; | |
}; | |
// Hacks ahead: | |
// Handlebars presently has a bug where the `blockHelperMissing` hook | |
// doesn't get passed the name of the missing helper name, but rather | |
// gets passed the value of that missing helper evaluated on the current | |
// context, which is most likely `undefined` and totally useless. | |
// | |
// So we alter the compiled template function to pass the name of the helper | |
// instead, as expected. | |
// | |
// This can go away once the following is closed: | |
// https://github.com/wycats/handlebars.js/issues/634 | |
var DOT_LOOKUP_REGEX = /helpers\.(.*?)\)/, | |
BRACKET_STRING_LOOKUP_REGEX = /helpers\['(.*?)'/, | |
INVOCATION_SPLITTING_REGEX = /(.*blockHelperMissing\.call\(.*)(stack[0-9]+)(,.*)/; | |
EmberHandlebars.JavaScriptCompiler.stringifyLastBlockHelperMissingInvocation = function(source) { | |
var helperInvocation = source[source.length - 1], | |
helperName = (DOT_LOOKUP_REGEX.exec(helperInvocation) || BRACKET_STRING_LOOKUP_REGEX.exec(helperInvocation))[1], | |
matches = INVOCATION_SPLITTING_REGEX.exec(helperInvocation); | |
source[source.length - 1] = matches[1] + "'" + helperName + "'" + matches[3]; | |
}; | |
var stringifyBlockHelperMissing = EmberHandlebars.JavaScriptCompiler.stringifyLastBlockHelperMissingInvocation; | |
var originalBlockValue = EmberHandlebars.JavaScriptCompiler.prototype.blockValue; | |
EmberHandlebars.JavaScriptCompiler.prototype.blockValue = function() { | |
originalBlockValue.apply(this, arguments); | |
stringifyBlockHelperMissing(this.source); | |
}; | |
var originalAmbiguousBlockValue = EmberHandlebars.JavaScriptCompiler.prototype.ambiguousBlockValue; | |
EmberHandlebars.JavaScriptCompiler.prototype.ambiguousBlockValue = function() { | |
originalAmbiguousBlockValue.apply(this, arguments); | |
stringifyBlockHelperMissing(this.source); | |
}; | |
/** | |
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 | |
@method mustache | |
@for Ember.Handlebars.Compiler | |
@param mustache | |
*/ | |
EmberHandlebars.Compiler.prototype.mustache = function(mustache) { | |
if (!(mustache.params.length || mustache.hash)) { | |
var id = new Handlebars.AST.IdNode([{ part: '_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. | |
@method precompile | |
@for Ember.Handlebars | |
@static | |
@param {String} string The template to precompile | |
@param {Boolean} asObject optional parameter, defaulting to true, of whether or not the | |
compiled template should be returned as an Object or a String | |
*/ | |
EmberHandlebars.precompile = function(string, asObject) { | |
var ast = Handlebars.parse(string); | |
var options = { | |
knownHelpers: { | |
action: true, | |
unbound: true, | |
'bind-attr': true, | |
template: true, | |
view: true, | |
_triageMustache: true | |
}, | |
data: true, | |
stringParams: true | |
}; | |
asObject = asObject === undefined ? true : asObject; | |
var environment = new EmberHandlebars.Compiler().compile(ast, options); | |
return new EmberHandlebars.JavaScriptCompiler().compile(environment, options, undefined, asObject); | |
}; | |
// We don't support this for Handlebars runtime-only | |
if (Handlebars.compile) { | |
/** | |
The entry point for Ember Handlebars. This replaces the default | |
`Handlebars.compile` and turns on template-local data and String | |
parameters. | |
@method compile | |
@for Ember.Handlebars | |
@static | |
@param {String} string The template to compile | |
@return {Function} | |
*/ | |
EmberHandlebars.compile = function(string) { | |
var ast = Handlebars.parse(string); | |
var options = { data: true, stringParams: true }; | |
var environment = new EmberHandlebars.Compiler().compile(ast, options); | |
var templateSpec = new EmberHandlebars.JavaScriptCompiler().compile(environment, options, undefined, true); | |
var template = EmberHandlebars.template(templateSpec); | |
template.isMethod = false; //Make sure we don't wrap templates with ._super | |
return template; | |
}; | |
} | |
__exports__["default"] = EmberHandlebars; | |
}); | |
define("ember-handlebars", | |
["ember-handlebars-compiler","ember-metal/core","ember-runtime/system/lazy_load","ember-handlebars/loader","ember-handlebars/ext","ember-handlebars/string","ember-handlebars/helpers/shared","ember-handlebars/helpers/binding","ember-handlebars/helpers/collection","ember-handlebars/helpers/view","ember-handlebars/helpers/unbound","ember-handlebars/helpers/debug","ember-handlebars/helpers/each","ember-handlebars/helpers/template","ember-handlebars/helpers/partial","ember-handlebars/helpers/yield","ember-handlebars/helpers/loc","ember-handlebars/controls/checkbox","ember-handlebars/controls/select","ember-handlebars/controls/text_area","ember-handlebars/controls/text_field","ember-handlebars/controls/text_support","ember-handlebars/controls","ember-handlebars/component_lookup","ember-handlebars/views/handlebars_bound_view","ember-handlebars/views/metamorph_view","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __dependency6__, __dependency7__, __dependency8__, __dependency9__, __dependency10__, __dependency11__, __dependency12__, __dependency13__, __dependency14__, __dependency15__, __dependency16__, __dependency17__, __dependency18__, __dependency19__, __dependency20__, __dependency21__, __dependency22__, __dependency23__, __dependency24__, __dependency25__, __dependency26__, __exports__) { | |
"use strict"; | |
var EmberHandlebars = __dependency1__["default"]; | |
var Ember = __dependency2__["default"]; | |
// to add to globals | |
var runLoadHooks = __dependency3__.runLoadHooks; | |
var bootstrap = __dependency4__["default"]; | |
var normalizePath = __dependency5__.normalizePath; | |
var template = __dependency5__.template; | |
var makeBoundHelper = __dependency5__.makeBoundHelper; | |
var registerBoundHelper = __dependency5__.registerBoundHelper; | |
var resolveHash = __dependency5__.resolveHash; | |
var resolveParams = __dependency5__.resolveParams; | |
var getEscaped = __dependency5__.getEscaped; | |
var handlebarsGet = __dependency5__.handlebarsGet; | |
var evaluateUnboundHelper = __dependency5__.evaluateUnboundHelper; | |
var helperMissingHelper = __dependency5__.helperMissingHelper; | |
var blockHelperMissingHelper = __dependency5__.blockHelperMissingHelper; | |
// side effect of extending StringUtils of htmlSafe | |
var resolvePaths = __dependency7__["default"]; | |
var bind = __dependency8__.bind; | |
var _triageMustacheHelper = __dependency8__._triageMustacheHelper; | |
var resolveHelper = __dependency8__.resolveHelper; | |
var bindHelper = __dependency8__.bindHelper; | |
var boundIfHelper = __dependency8__.boundIfHelper; | |
var unboundIfHelper = __dependency8__.unboundIfHelper; | |
var withHelper = __dependency8__.withHelper; | |
var ifHelper = __dependency8__.ifHelper; | |
var unlessHelper = __dependency8__.unlessHelper; | |
var bindAttrHelper = __dependency8__.bindAttrHelper; | |
var bindAttrHelperDeprecated = __dependency8__.bindAttrHelperDeprecated; | |
var bindClasses = __dependency8__.bindClasses; | |
var collectionHelper = __dependency9__["default"]; | |
var ViewHelper = __dependency10__.ViewHelper; | |
var viewHelper = __dependency10__.viewHelper; | |
var unboundHelper = __dependency11__["default"]; | |
var logHelper = __dependency12__.logHelper; | |
var debuggerHelper = __dependency12__.debuggerHelper; | |
var EachView = __dependency13__.EachView; | |
var GroupedEach = __dependency13__.GroupedEach; | |
var eachHelper = __dependency13__.eachHelper; | |
var templateHelper = __dependency14__["default"]; | |
var partialHelper = __dependency15__["default"]; | |
var yieldHelper = __dependency16__["default"]; | |
var locHelper = __dependency17__["default"]; | |
var Checkbox = __dependency18__["default"]; | |
var Select = __dependency19__.Select; | |
var SelectOption = __dependency19__.SelectOption; | |
var SelectOptgroup = __dependency19__.SelectOptgroup; | |
var TextArea = __dependency20__["default"]; | |
var TextField = __dependency21__["default"]; | |
var TextSupport = __dependency22__["default"]; | |
var inputHelper = __dependency23__.inputHelper; | |
var textareaHelper = __dependency23__.textareaHelper; | |
var ComponentLookup = __dependency24__["default"]; | |
var _HandlebarsBoundView = __dependency25__._HandlebarsBoundView; | |
var SimpleHandlebarsView = __dependency25__.SimpleHandlebarsView; | |
var _SimpleMetamorphView = __dependency26__._SimpleMetamorphView; | |
var _MetamorphView = __dependency26__._MetamorphView; | |
var _Metamorph = __dependency26__._Metamorph; | |
/** | |
Ember Handlebars | |
@module ember | |
@submodule ember-handlebars | |
@requires ember-views | |
*/ | |
// Ember.Handlebars.Globals | |
EmberHandlebars.bootstrap = bootstrap; | |
EmberHandlebars.template = template; | |
EmberHandlebars.makeBoundHelper = makeBoundHelper; | |
EmberHandlebars.registerBoundHelper = registerBoundHelper; | |
EmberHandlebars.resolveHash = resolveHash; | |
EmberHandlebars.resolveParams = resolveParams; | |
EmberHandlebars.resolveHelper = resolveHelper; | |
EmberHandlebars.get = handlebarsGet; | |
EmberHandlebars.getEscaped = getEscaped; | |
EmberHandlebars.evaluateUnboundHelper = evaluateUnboundHelper; | |
EmberHandlebars.bind = bind; | |
EmberHandlebars.bindClasses = bindClasses; | |
EmberHandlebars.EachView = EachView; | |
EmberHandlebars.GroupedEach = GroupedEach; | |
EmberHandlebars.resolvePaths = resolvePaths; | |
EmberHandlebars.ViewHelper = ViewHelper; | |
EmberHandlebars.normalizePath = normalizePath; | |
// Ember Globals | |
Ember.Handlebars = EmberHandlebars; | |
Ember.ComponentLookup = ComponentLookup; | |
Ember._SimpleHandlebarsView = SimpleHandlebarsView; | |
Ember._HandlebarsBoundView = _HandlebarsBoundView; | |
Ember._SimpleMetamorphView = _SimpleMetamorphView; | |
Ember._MetamorphView = _MetamorphView; | |
Ember._Metamorph = _Metamorph; | |
Ember.TextSupport = TextSupport; | |
Ember.Checkbox = Checkbox; | |
Ember.Select = Select; | |
Ember.SelectOption = SelectOption; | |
Ember.SelectOptgroup = SelectOptgroup; | |
Ember.TextArea = TextArea; | |
Ember.TextField = TextField; | |
Ember.TextSupport = TextSupport; | |
// register helpers | |
EmberHandlebars.registerHelper('helperMissing', helperMissingHelper); | |
EmberHandlebars.registerHelper('blockHelperMissing', blockHelperMissingHelper); | |
EmberHandlebars.registerHelper('bind', bindHelper); | |
EmberHandlebars.registerHelper('boundIf', boundIfHelper); | |
EmberHandlebars.registerHelper('_triageMustache', _triageMustacheHelper); | |
EmberHandlebars.registerHelper('unboundIf', unboundIfHelper); | |
EmberHandlebars.registerHelper('with', withHelper); | |
EmberHandlebars.registerHelper('if', ifHelper); | |
EmberHandlebars.registerHelper('unless', unlessHelper); | |
EmberHandlebars.registerHelper('bind-attr', bindAttrHelper); | |
EmberHandlebars.registerHelper('bindAttr', bindAttrHelperDeprecated); | |
EmberHandlebars.registerHelper('collection', collectionHelper); | |
EmberHandlebars.registerHelper("log", logHelper); | |
EmberHandlebars.registerHelper("debugger", debuggerHelper); | |
EmberHandlebars.registerHelper("each", eachHelper); | |
EmberHandlebars.registerHelper("loc", locHelper); | |
EmberHandlebars.registerHelper("partial", partialHelper); | |
EmberHandlebars.registerHelper("template", templateHelper); | |
EmberHandlebars.registerHelper("yield", yieldHelper); | |
EmberHandlebars.registerHelper("view", viewHelper); | |
EmberHandlebars.registerHelper("unbound", unboundHelper); | |
EmberHandlebars.registerHelper("input", inputHelper); | |
EmberHandlebars.registerHelper("textarea", textareaHelper); | |
// run load hooks | |
runLoadHooks('Ember.Handlebars', EmberHandlebars); | |
__exports__["default"] = EmberHandlebars; | |
}); | |
define("ember-handlebars/component_lookup", | |
["ember-runtime/system/object","exports"], | |
function(__dependency1__, __exports__) { | |
"use strict"; | |
var EmberObject = __dependency1__["default"]; | |
var ComponentLookup = EmberObject.extend({ | |
lookupFactory: function(name, container) { | |
container = container || this.container; | |
var fullName = 'component:' + name, | |
templateFullName = 'template:components/' + name, | |
templateRegistered = container && container.has(templateFullName); | |
if (templateRegistered) { | |
container.injection(fullName, 'layout', templateFullName); | |
} | |
var Component = container.lookupFactory(fullName); | |
// Only treat as a component if either the component | |
// or a template has been registered. | |
if (templateRegistered || Component) { | |
if (!Component) { | |
container.register(fullName, Ember.Component); | |
Component = container.lookupFactory(fullName); | |
} | |
return Component; | |
} | |
} | |
}); | |
__exports__["default"] = ComponentLookup; | |
}); | |
define("ember-handlebars/controls", | |
["ember-handlebars/controls/checkbox","ember-handlebars/controls/text_field","ember-handlebars/controls/text_area","ember-metal/core","ember-handlebars-compiler","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __exports__) { | |
"use strict"; | |
var Checkbox = __dependency1__["default"]; | |
var TextField = __dependency2__["default"]; | |
var TextArea = __dependency3__["default"]; | |
var Ember = __dependency4__["default"]; | |
// Ember.assert | |
// var emberAssert = Ember.assert; | |
var EmberHandlebars = __dependency5__["default"]; | |
var helpers = EmberHandlebars.helpers; | |
/** | |
@module ember | |
@submodule ember-handlebars-compiler | |
*/ | |
/** | |
The `{{input}}` helper inserts an HTML `<input>` tag into the template, | |
with a `type` value of either `text` or `checkbox`. If no `type` is provided, | |
`text` will be the default value applied. The attributes of `{{input}}` | |
match those of the native HTML tag as closely as possible for these two types. | |
## Use as text field | |
An `{{input}}` with no `type` or a `type` of `text` will render an HTML text input. | |
The following HTML attributes can be set via the helper: | |
<table> | |
<tr><td>`readonly`</td><td>`required`</td><td>`autofocus`</td></tr> | |
<tr><td>`value`</td><td>`placeholder`</td><td>`disabled`</td></tr> | |
<tr><td>`size`</td><td>`tabindex`</td><td>`maxlength`</td></tr> | |
<tr><td>`name`</td><td>`min`</td><td>`max`</td></tr> | |
<tr><td>`pattern`</td><td>`accept`</td><td>`autocomplete`</td></tr> | |
<tr><td>`autosave`</td><td>`formaction`</td><td>`formenctype`</td></tr> | |
<tr><td>`formmethod`</td><td>`formnovalidate`</td><td>`formtarget`</td></tr> | |
<tr><td>`height`</td><td>`inputmode`</td><td>`multiple`</td></tr> | |
<tr><td>`step`</td><td>`width`</td><td>`form`</td></tr> | |
<tr><td>`selectionDirection`</td><td>`spellcheck`</td><td> </td></tr> | |
</table> | |
When set to a quoted string, these values will be directly applied to the HTML | |
element. When left unquoted, these values will be bound to a property on the | |
template's current rendering context (most typically a controller instance). | |
## Unbound: | |
```handlebars | |
{{input value="http://www.facebook.com"}} | |
``` | |
```html | |
<input type="text" value="http://www.facebook.com"/> | |
``` | |
## Bound: | |
```javascript | |
App.ApplicationController = Ember.Controller.extend({ | |
firstName: "Stanley", | |
entryNotAllowed: true | |
}); | |
``` | |
```handlebars | |
{{input type="text" value=firstName disabled=entryNotAllowed size="50"}} | |
``` | |
```html | |
<input type="text" value="Stanley" disabled="disabled" size="50"/> | |
``` | |
## Extension | |
Internally, `{{input type="text"}}` creates an instance of `Ember.TextField`, passing | |
arguments from the helper to `Ember.TextField`'s `create` method. You can extend the | |
capabilities of text inputs in your applications by reopening this class. For example, | |
if you are building a Bootstrap project where `data-*` attributes are used, you | |
can add one to the `TextField`'s `attributeBindings` property: | |
```javascript | |
Ember.TextField.reopen({ | |
attributeBindings: ['data-error'] | |
}); | |
``` | |
Keep in mind when writing `Ember.TextField` subclasses that `Ember.TextField` | |
itself extends `Ember.Component`, meaning that it does NOT inherit | |
the `controller` of the parent view. | |
See more about [Ember components](api/classes/Ember.Component.html) | |
## Use as checkbox | |
An `{{input}}` with a `type` of `checkbox` will render an HTML checkbox input. | |
The following HTML attributes can be set via the helper: | |
* `checked` | |
* `disabled` | |
* `tabindex` | |
* `indeterminate` | |
* `name` | |
* `autofocus` | |
* `form` | |
When set to a quoted string, these values will be directly applied to the HTML | |
element. When left unquoted, these values will be bound to a property on the | |
template's current rendering context (most typically a controller instance). | |
## Unbound: | |
```handlebars | |
{{input type="checkbox" name="isAdmin"}} | |
``` | |
```html | |
<input type="checkbox" name="isAdmin" /> | |
``` | |
## Bound: | |
```javascript | |
App.ApplicationController = Ember.Controller.extend({ | |
isAdmin: true | |
}); | |
``` | |
```handlebars | |
{{input type="checkbox" checked=isAdmin }} | |
``` | |
```html | |
<input type="checkbox" checked="checked" /> | |
``` | |
## Extension | |
Internally, `{{input type="checkbox"}}` creates an instance of `Ember.Checkbox`, passing | |
arguments from the helper to `Ember.Checkbox`'s `create` method. You can extend the | |
capablilties of checkbox inputs in your applications by reopening this class. For example, | |
if you wanted to add a css class to all checkboxes in your application: | |
```javascript | |
Ember.Checkbox.reopen({ | |
classNames: ['my-app-checkbox'] | |
}); | |
``` | |
@method input | |
@for Ember.Handlebars.helpers | |
@param {Hash} options | |
*/ | |
function inputHelper(options) { | |
Ember.assert('You can only pass attributes to the `input` helper, not arguments', arguments.length < 2); | |
var hash = options.hash, | |
types = options.hashTypes, | |
inputType = hash.type, | |
onEvent = hash.on; | |
delete hash.type; | |
delete hash.on; | |
if (inputType === 'checkbox') { | |
Ember.assert("{{input type='checkbox'}} does not support setting `value=someBooleanValue`; you must use `checked=someBooleanValue` instead.", options.hashTypes.value !== 'ID'); | |
return helpers.view.call(this, Checkbox, options); | |
} else { | |
if (inputType) { hash.type = inputType; } | |
hash.onEvent = onEvent || 'enter'; | |
return helpers.view.call(this, TextField, options); | |
} | |
} | |
__exports__.inputHelper = inputHelper;/** | |
`{{textarea}}` inserts a new instance of `<textarea>` tag into the template. | |
The attributes of `{{textarea}}` match those of the native HTML tags as | |
closely as possible. | |
The following HTML attributes can be set: | |
* `value` | |
* `name` | |
* `rows` | |
* `cols` | |
* `placeholder` | |
* `disabled` | |
* `maxlength` | |
* `tabindex` | |
* `selectionEnd` | |
* `selectionStart` | |
* `selectionDirection` | |
* `wrap` | |
* `readonly` | |
* `autofocus` | |
* `form` | |
* `spellcheck` | |
* `required` | |
When set to a quoted string, these value will be directly applied to the HTML | |
element. When left unquoted, these values will be bound to a property on the | |
template's current rendering context (most typically a controller instance). | |
Unbound: | |
```handlebars | |
{{textarea value="Lots of static text that ISN'T bound"}} | |
``` | |
Would result in the following HTML: | |
```html | |
<textarea class="ember-text-area"> | |
Lots of static text that ISN'T bound | |
</textarea> | |
``` | |
Bound: | |
In the following example, the `writtenWords` property on `App.ApplicationController` | |
will be updated live as the user types 'Lots of text that IS bound' into | |
the text area of their browser's window. | |
```javascript | |
App.ApplicationController = Ember.Controller.extend({ | |
writtenWords: "Lots of text that IS bound" | |
}); | |
``` | |
```handlebars | |
{{textarea value=writtenWords}} | |
``` | |
Would result in the following HTML: | |
```html | |
<textarea class="ember-text-area"> | |
Lots of text that IS bound | |
</textarea> | |
``` | |
If you wanted a one way binding between the text area and a div tag | |
somewhere else on your screen, you could use `Ember.computed.oneWay`: | |
```javascript | |
App.ApplicationController = Ember.Controller.extend({ | |
writtenWords: "Lots of text that IS bound", | |
outputWrittenWords: Ember.computed.oneWay("writtenWords") | |
}); | |
``` | |
```handlebars | |
{{textarea value=writtenWords}} | |
<div> | |
{{outputWrittenWords}} | |
</div> | |
``` | |
Would result in the following HTML: | |
```html | |
<textarea class="ember-text-area"> | |
Lots of text that IS bound | |
</textarea> | |
<-- the following div will be updated in real time as you type --> | |
<div> | |
Lots of text that IS bound | |
</div> | |
``` | |
Finally, this example really shows the power and ease of Ember when two | |
properties are bound to eachother via `Ember.computed.alias`. Type into | |
either text area box and they'll both stay in sync. Note that | |
`Ember.computed.alias` costs more in terms of performance, so only use it when | |
your really binding in both directions: | |
```javascript | |
App.ApplicationController = Ember.Controller.extend({ | |
writtenWords: "Lots of text that IS bound", | |
twoWayWrittenWords: Ember.computed.alias("writtenWords") | |
}); | |
``` | |
```handlebars | |
{{textarea value=writtenWords}} | |
{{textarea value=twoWayWrittenWords}} | |
``` | |
```html | |
<textarea id="ember1" class="ember-text-area"> | |
Lots of text that IS bound | |
</textarea> | |
<-- both updated in real time --> | |
<textarea id="ember2" class="ember-text-area"> | |
Lots of text that IS bound | |
</textarea> | |
``` | |
## Extension | |
Internally, `{{textarea}}` creates an instance of `Ember.TextArea`, passing | |
arguments from the helper to `Ember.TextArea`'s `create` method. You can | |
extend the capabilities of text areas in your application by reopening this | |
class. For example, if you are building a Bootstrap project where `data-*` | |
attributes are used, you can globally add support for a `data-*` attribute | |
on all `{{textarea}}`s' in your app by reopening `Ember.TextArea` or | |
`Ember.TextSupport` and adding it to the `attributeBindings` concatenated | |
property: | |
```javascript | |
Ember.TextArea.reopen({ | |
attributeBindings: ['data-error'] | |
}); | |
``` | |
Keep in mind when writing `Ember.TextArea` subclasses that `Ember.TextArea` | |
itself extends `Ember.Component`, meaning that it does NOT inherit | |
the `controller` of the parent view. | |
See more about [Ember components](api/classes/Ember.Component.html) | |
@method textarea | |
@for Ember.Handlebars.helpers | |
@param {Hash} options | |
*/ | |
function textareaHelper(options) { | |
Ember.assert('You can only pass attributes to the `textarea` helper, not arguments', arguments.length < 2); | |
var hash = options.hash, | |
types = options.hashTypes; | |
return helpers.view.call(this, TextArea, options); | |
} | |
__exports__.textareaHelper = textareaHelper; | |
}); | |
define("ember-handlebars/controls/checkbox", | |
["ember-metal/property_get","ember-metal/property_set","ember-views/views/view","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __exports__) { | |
"use strict"; | |
var get = __dependency1__.get; | |
var set = __dependency2__.set; | |
var View = __dependency3__.View; | |
/** | |
@module ember | |
@submodule ember-handlebars | |
*/ | |
/** | |
The internal class used to create text inputs when the `{{input}}` | |
helper is used with `type` of `checkbox`. | |
See [handlebars.helpers.input](/api/classes/Ember.Handlebars.helpers.html#method_input) for usage details. | |
## Direct manipulation of `checked` | |
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](/api/classes/Ember.View.html)'s | |
layout section for more information. | |
@class Checkbox | |
@namespace Ember | |
@extends Ember.View | |
*/ | |
var Checkbox = View.extend({ | |
instrumentDisplay: '{{input type="checkbox"}}', | |
classNames: ['ember-checkbox'], | |
tagName: 'input', | |
attributeBindings: ['type', 'checked', 'indeterminate', 'disabled', 'tabindex', 'name', | |
'autofocus', 'required', 'form'], | |
type: "checkbox", | |
checked: false, | |
disabled: false, | |
indeterminate: false, | |
init: function() { | |
this._super(); | |
this.on("change", this, this._updateElementValue); | |
}, | |
didInsertElement: function() { | |
this._super(); | |
get(this, 'element').indeterminate = !!get(this, 'indeterminate'); | |
}, | |
_updateElementValue: function() { | |
set(this, 'checked', this.$().prop('checked')); | |
} | |
}); | |
__exports__["default"] = Checkbox; | |
}); | |
define("ember-handlebars/controls/select", | |
["ember-handlebars-compiler","ember-metal/enumerable_utils","ember-metal/property_get","ember-metal/property_set","ember-views/views/view","ember-views/views/collection_view","ember-metal/utils","ember-metal/is_none","ember-metal/computed","ember-runtime/system/native_array","ember-metal/mixin","ember-metal/properties","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __dependency6__, __dependency7__, __dependency8__, __dependency9__, __dependency10__, __dependency11__, __dependency12__, __exports__) { | |
"use strict"; | |
/** | |
@module ember | |
@submodule ember-handlebars | |
*/ | |
var EmberHandlebars = __dependency1__["default"]; | |
var EnumerableUtils = __dependency2__["default"]; | |
var get = __dependency3__.get; | |
var set = __dependency4__.set; | |
var View = __dependency5__.View; | |
var CollectionView = __dependency6__["default"]; | |
var isArray = __dependency7__.isArray; | |
var isNone = __dependency8__["default"]; | |
var computed = __dependency9__.computed; | |
var emberA = __dependency10__.A; | |
var observer = __dependency11__.observer; | |
var defineProperty = __dependency12__.defineProperty; | |
var indexOf = EnumerableUtils.indexOf, | |
indexesOf = EnumerableUtils.indexesOf, | |
forEach = EnumerableUtils.forEach, | |
replace = EnumerableUtils.replace, | |
precompileTemplate = EmberHandlebars.compile; | |
var SelectOption = View.extend({ | |
instrumentDisplay: 'Ember.SelectOption', | |
tagName: 'option', | |
attributeBindings: ['value', 'selected'], | |
defaultTemplate: function(context, options) { | |
options = { data: options.data, hash: {} }; | |
EmberHandlebars.helpers.bind.call(context, "view.label", options); | |
}, | |
init: function() { | |
this.labelPathDidChange(); | |
this.valuePathDidChange(); | |
this._super(); | |
}, | |
selected: computed(function() { | |
var content = get(this, 'content'), | |
selection = get(this, 'parentView.selection'); | |
if (get(this, 'parentView.multiple')) { | |
return selection && indexOf(selection, content.valueOf()) > -1; | |
} else { | |
// Primitives get passed through bindings as objects... since | |
// `new Number(4) !== 4`, we use `==` below | |
return content == selection; // jshint ignore:line | |
} | |
}).property('content', 'parentView.selection'), | |
labelPathDidChange: observer('parentView.optionLabelPath', function() { | |
var labelPath = get(this, 'parentView.optionLabelPath'); | |
if (!labelPath) { return; } | |
defineProperty(this, 'label', computed(function() { | |
return get(this, labelPath); | |
}).property(labelPath)); | |
}), | |
valuePathDidChange: observer('parentView.optionValuePath', function() { | |
var valuePath = get(this, 'parentView.optionValuePath'); | |
if (!valuePath) { return; } | |
defineProperty(this, 'value', computed(function() { | |
return get(this, valuePath); | |
}).property(valuePath)); | |
}) | |
}); | |
var SelectOptgroup = CollectionView.extend({ | |
instrumentDisplay: 'Ember.SelectOptgroup', | |
tagName: 'optgroup', | |
attributeBindings: ['label'], | |
selectionBinding: 'parentView.selection', | |
multipleBinding: 'parentView.multiple', | |
optionLabelPathBinding: 'parentView.optionLabelPath', | |
optionValuePathBinding: 'parentView.optionValuePath', | |
itemViewClassBinding: 'parentView.optionView' | |
}); | |
/** | |
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 text and `value` property of each `<option>` element within the | |
`<select>` element are populated from the objects in the `Element.Select`'s | |
`content` property. The underlying data object of the selected `<option>` is | |
stored in the `Element.Select`'s `value` property. | |
## The Content Property (array of strings) | |
The simplest version of an `Ember.Select` takes an array of strings as its | |
`content` property. The string will be used as both the `value` property and | |
the inner text of each `<option>` element inside the rendered `<select>`. | |
Example: | |
```javascript | |
App.ApplicationController = Ember.ObjectController.extend({ | |
names: ["Yehuda", "Tom"] | |
}); | |
``` | |
```handlebars | |
{{view Ember.Select content=names}} | |
``` | |
Would result in the following HTML: | |
```html | |
<select class="ember-select"> | |
<option value="Yehuda">Yehuda</option> | |
<option value="Tom">Tom</option> | |
</select> | |
``` | |
You can control which `<option>` is selected through the `Ember.Select`'s | |
`value` property: | |
```javascript | |
App.ApplicationController = Ember.ObjectController.extend({ | |
selectedName: 'Tom', | |
names: ["Yehuda", "Tom"] | |
}); | |
``` | |
```handlebars | |
{{view Ember.Select | |
content=names | |
value=selectedName | |
}} | |
``` | |
Would result in the following HTML with the `<option>` for 'Tom' selected: | |
```html | |
<select class="ember-select"> | |
<option value="Yehuda">Yehuda</option> | |
<option value="Tom" selected="selected">Tom</option> | |
</select> | |
``` | |
A user interacting with the rendered `<select>` to choose "Yehuda" would | |
update the value of `selectedName` to "Yehuda". | |
## The Content Property (array of Objects) | |
An `Ember.Select` can also take an array of JavaScript or Ember objects as | |
its `content` property. | |
When using objects you need to tell the `Ember.Select` which property should | |
be accessed on each object to supply the `value` attribute of the `<option>` | |
and which property should be used to supply the element text. | |
The `optionValuePath` option is used to specify the path on each object to | |
the desired property for the `value` attribute. The `optionLabelPath` | |
specifies the path on each object to the desired property for the | |
element's text. Both paths must reference each object itself as `content`: | |
```javascript | |
App.ApplicationController = Ember.ObjectController.extend({ | |
programmers: [ | |
{firstName: "Yehuda", id: 1}, | |
{firstName: "Tom", id: 2} | |
] | |
}); | |
``` | |
```handlebars | |
{{view Ember.Select | |
content=programmers | |
optionValuePath="content.id" | |
optionLabelPath="content.firstName"}} | |
``` | |
Would result in the following HTML: | |
```html | |
<select class="ember-select"> | |
<option value="1">Yehuda</option> | |
<option value="2">Tom</option> | |
</select> | |
``` | |
The `value` attribute of the selected `<option>` within an `Ember.Select` | |
can be bound to a property on another object: | |
```javascript | |
App.ApplicationController = Ember.ObjectController.extend({ | |
programmers: [ | |
{firstName: "Yehuda", id: 1}, | |
{firstName: "Tom", id: 2} | |
], | |
currentProgrammer: { | |
id: 2 | |
} | |
}); | |
``` | |
```handlebars | |
{{view Ember.Select | |
content=programmers | |
optionValuePath="content.id" | |
optionLabelPath="content.firstName" | |
value=currentProgrammer.id}} | |
``` | |
Would result in the following HTML with a selected option: | |
```html | |
<select class="ember-select"> | |
<option value="1">Yehuda</option> | |
<option value="2" selected="selected">Tom</option> | |
</select> | |
``` | |
Interacting with the rendered element by selecting the first option | |
('Yehuda') will update the `id` of `currentProgrammer` | |
to match the `value` property of the newly selected `<option>`. | |
Alternatively, you can control selection through the underlying objects | |
used to render each object by binding the `selection` option. When the selected | |
`<option>` is changed, the property path provided to `selection` | |
will be updated to match the content object of the rendered `<option>` | |
element: | |
```javascript | |
var yehuda = {firstName: "Yehuda", id: 1, bff4eva: 'tom'} | |
var tom = {firstName: "Tom", id: 2, bff4eva: 'yehuda'}; | |
App.ApplicationController = Ember.ObjectController.extend({ | |
selectedPerson: tom, | |
programmers: [ | |
yehuda, | |
tom | |
] | |
}); | |
``` | |
```handlebars | |
{{view Ember.Select | |
content=programmers | |
optionValuePath="content.id" | |
optionLabelPath="content.firstName" | |
selection=selectedPerson}} | |
``` | |
Would result in the following HTML with a selected option: | |
```html | |
<select class="ember-select"> | |
<option value="1">Yehuda</option> | |
<option value="2" selected="selected">Tom</option> | |
</select> | |
``` | |
Interacting with the rendered element by selecting the first option | |
('Yehuda') will update the `selectedPerson` to match the object of | |
the newly selected `<option>`. In this case it is the first object | |
in the `programmers` | |
## Supplying a Prompt | |
A `null` value for the `Ember.Select`'s `value` or `selection` property | |
results in there being no `<option>` with a `selected` attribute: | |
```javascript | |
App.ApplicationController = Ember.ObjectController.extend({ | |
selectedProgrammer: null, | |
programmers: [ | |
"Yehuda", | |
"Tom" | |
] | |
}); | |
``` | |
``` handlebars | |
{{view Ember.Select | |
content=programmers | |
value=selectedProgrammer | |
}} | |
``` | |
Would result in the following HTML: | |
```html | |
<select class="ember-select"> | |
<option value="Yehuda">Yehuda</option> | |
<option value="Tom">Tom</option> | |
</select> | |
``` | |
Although `selectedProgrammer` is `null` and no `<option>` | |
has a `selected` attribute the rendered HTML will display the | |
first item as though it were selected. You can supply a string | |
value for the `Ember.Select` to display when there is no selection | |
with the `prompt` option: | |
```javascript | |
App.ApplicationController = Ember.ObjectController.extend({ | |
selectedProgrammer: null, | |
programmers: [ | |
"Yehuda", | |
"Tom" | |
] | |
}); | |
``` | |
```handlebars | |
{{view Ember.Select | |
content=programmers | |
value=selectedProgrammer | |
prompt="Please select a name" | |
}} | |
``` | |
Would result in the following HTML: | |
```html | |
<select class="ember-select"> | |
<option>Please select a name</option> | |
<option value="Yehuda">Yehuda</option> | |
<option value="Tom">Tom</option> | |
</select> | |
``` | |
@class Select | |
@namespace Ember | |
@extends Ember.View | |
*/ | |
var Select = View.extend({ | |
instrumentDisplay: 'Ember.Select', | |
tagName: 'select', | |
classNames: ['ember-select'], | |
defaultTemplate: Ember.Handlebars.template(function anonymous(Handlebars,depth0,helpers,partials,data) { | |
this.compilerInfo = [4,'>= 1.0.0']; | |
helpers = this.merge(helpers, Ember.Handlebars.helpers); data = data || {}; | |
var buffer = '', stack1, escapeExpression=this.escapeExpression, self=this; | |
function program1(depth0,data) { | |
var buffer = '', stack1; | |
data.buffer.push("<option value=\"\">"); | |
stack1 = helpers._triageMustache.call(depth0, "view.prompt", {hash:{},hashTypes:{},hashContexts:{},contexts:[depth0],types:["ID"],data:data}); | |
if(stack1 || stack1 === 0) { data.buffer.push(stack1); } | |
data.buffer.push("</option>"); | |
return buffer; | |
} | |
function program3(depth0,data) { | |
var stack1; | |
stack1 = helpers.each.call(depth0, "view.groupedContent", {hash:{},hashTypes:{},hashContexts:{},inverse:self.noop,fn:self.program(4, program4, data),contexts:[depth0],types:["ID"],data:data}); | |
if(stack1 || stack1 === 0) { data.buffer.push(stack1); } | |
else { data.buffer.push(''); } | |
} | |
function program4(depth0,data) { | |
data.buffer.push(escapeExpression(helpers.view.call(depth0, "view.groupView", {hash:{ | |
'content': ("content"), | |
'label': ("label") | |
},hashTypes:{'content': "ID",'label': "ID"},hashContexts:{'content': depth0,'label': depth0},contexts:[depth0],types:["ID"],data:data}))); | |
} | |
function program6(depth0,data) { | |
var stack1; | |
stack1 = helpers.each.call(depth0, "view.content", {hash:{},hashTypes:{},hashContexts:{},inverse:self.noop,fn:self.program(7, program7, data),contexts:[depth0],types:["ID"],data:data}); | |
if(stack1 || stack1 === 0) { data.buffer.push(stack1); } | |
else { data.buffer.push(''); } | |
} | |
function program7(depth0,data) { | |
data.buffer.push(escapeExpression(helpers.view.call(depth0, "view.optionView", {hash:{ | |
'content': ("") | |
},hashTypes:{'content': "ID"},hashContexts:{'content': depth0},contexts:[depth0],types:["ID"],data:data}))); | |
} | |
stack1 = helpers['if'].call(depth0, "view.prompt", {hash:{},hashTypes:{},hashContexts:{},inverse:self.noop,fn:self.program(1, program1, data),contexts:[depth0],types:["ID"],data:data}); | |
if(stack1 || stack1 === 0) { data.buffer.push(stack1); } | |
stack1 = helpers['if'].call(depth0, "view.optionGroupPath", {hash:{},hashTypes:{},hashContexts:{},inverse:self.program(6, program6, data),fn:self.program(3, program3, data),contexts:[depth0],types:["ID"],data:data}); | |
if(stack1 || stack1 === 0) { data.buffer.push(stack1); } | |
return buffer; | |
}), | |
attributeBindings: ['multiple', 'disabled', 'tabindex', 'name', 'required', 'autofocus', | |
'form', 'size'], | |
/** | |
The `multiple` attribute of the select element. Indicates whether multiple | |
options can be selected. | |
@property multiple | |
@type Boolean | |
@default false | |
*/ | |
multiple: false, | |
/** | |
The `disabled` attribute of the select element. Indicates whether | |
the element is disabled from interactions. | |
@property disabled | |
@type Boolean | |
@default false | |
*/ | |
disabled: false, | |
/** | |
The `required` attribute of the select element. Indicates whether | |
a selected option is required for form validation. | |
@property required | |
@type Boolean | |
@default false | |
@since 1.5.0 | |
*/ | |
required: 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: | |
```javascript | |
Ember.Select.create({ | |
content: Ember.A([ | |
{ id: 1, firstName: 'Yehuda' }, | |
{ id: 2, firstName: 'Tom' } | |
]), | |
optionLabelPath: 'content.firstName', | |
optionValuePath: 'content.id' | |
}); | |
``` | |
@property content | |
@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. | |
@property selection | |
@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. | |
@property value | |
@type String | |
@default null | |
*/ | |
value: 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'), | |
/** | |
If given, a top-most dummy option will be rendered to serve as a user | |
prompt. | |
@property prompt | |
@type String | |
@default null | |
*/ | |
prompt: null, | |
/** | |
The path of the option labels. See [content](/api/classes/Ember.Select.html#property_content). | |
@property optionLabelPath | |
@type String | |
@default 'content' | |
*/ | |
optionLabelPath: 'content', | |
/** | |
The path of the option values. See [content](/api/classes/Ember.Select.html#property_content). | |
@property optionValuePath | |
@type String | |
@default 'content' | |
*/ | |
optionValuePath: 'content', | |
/** | |
The path of the option group. | |
When this property is used, `content` should be sorted by `optionGroupPath`. | |
@property optionGroupPath | |
@type String | |
@default null | |
*/ | |
optionGroupPath: null, | |
/** | |
The view class for optgroup. | |
@property groupView | |
@type Ember.View | |
@default Ember.SelectOptgroup | |
*/ | |
groupView: SelectOptgroup, | |
groupedContent: computed(function() { | |
var groupPath = get(this, 'optionGroupPath'); | |
var groupedContent = emberA(); | |
var content = get(this, 'content') || []; | |
forEach(content, function(item) { | |
var label = get(item, groupPath); | |
if (get(groupedContent, 'lastObject.label') !== label) { | |
groupedContent.pushObject({ | |
label: label, | |
content: emberA() | |
}); | |
} | |
get(groupedContent, 'lastObject.content').push(item); | |
}); | |
return groupedContent; | |
}).property('optionGroupPath', 'content.@each'), | |
/** | |
The view class for option. | |
@property optionView | |
@type Ember.View | |
@default Ember.SelectOption | |
*/ | |
optionView: SelectOption, | |
_change: function() { | |
if (get(this, 'multiple')) { | |
this._changeMultiple(); | |
} else { | |
this._changeSingle(); | |
} | |
}, | |
selectionDidChange: observer('selection.@each', function() { | |
var selection = get(this, 'selection'); | |
if (get(this, 'multiple')) { | |
if (!isArray(selection)) { | |
set(this, 'selection', emberA([selection])); | |
return; | |
} | |
this._selectionDidChangeMultiple(); | |
} else { | |
this._selectionDidChangeSingle(); | |
} | |
}), | |
valueDidChange: observer('value', 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 ? content.find(function(obj) { | |
return value === (valuePath ? get(obj, valuePath) : obj); | |
}) : null; | |
this.set('selection', selection); | |
} | |
}), | |
_triggerChange: function() { | |
var selection = get(this, 'selection'); | |
var value = get(this, 'value'); | |
if (!isNone(selection)) { this.selectionDidChange(); } | |
if (!isNone(value)) { this.valueDidChange(); } | |
this._change(); | |
}, | |
_changeSingle: function() { | |
var selectedIndex = this.$()[0].selectedIndex, | |
content = get(this, 'content'), | |
prompt = get(this, 'prompt'); | |
if (!content || !get(content, 'length')) { 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'), | |
selection = get(this, 'selection'); | |
if (!content) { return; } | |
if (options) { | |
var selectedIndexes = options.map(function() { | |
return this.index - offset; | |
}).toArray(); | |
var newSelection = content.objectsAt(selectedIndexes); | |
if (isArray(selection)) { | |
replace(selection, 0, get(selection, 'length'), newSelection); | |
} else { | |
set(this, 'selection', newSelection); | |
} | |
} | |
}, | |
_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); | |
} | |
}); | |
__exports__["default"] = Select; | |
__exports__.Select = Select; | |
__exports__.SelectOption = SelectOption; | |
__exports__.SelectOptgroup = SelectOptgroup; | |
}); | |
define("ember-handlebars/controls/text_area", | |
["ember-metal/property_get","ember-views/views/component","ember-handlebars/controls/text_support","ember-metal/mixin","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __exports__) { | |
"use strict"; | |
/** | |
@module ember | |
@submodule ember-handlebars | |
*/ | |
var get = __dependency1__.get; | |
var Component = __dependency2__["default"]; | |
var TextSupport = __dependency3__["default"]; | |
var observer = __dependency4__.observer; | |
/** | |
The internal class used to create textarea element when the `{{textarea}}` | |
helper is used. | |
See [handlebars.helpers.textarea](/api/classes/Ember.Handlebars.helpers.html#method_textarea) for usage details. | |
## 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](/api/classes/Ember.View.html)'s | |
layout section for more information. | |
@class TextArea | |
@namespace Ember | |
@extends Ember.Component | |
@uses Ember.TextSupport | |
*/ | |
__exports__["default"] = Component.extend(TextSupport, { | |
instrumentDisplay: '{{textarea}}', | |
classNames: ['ember-text-area'], | |
tagName: "textarea", | |
attributeBindings: ['rows', 'cols', 'name', 'selectionEnd', 'selectionStart', 'wrap'], | |
rows: null, | |
cols: null, | |
_updateElementValue: observer('value', 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); | |
} | |
}), | |
init: function() { | |
this._super(); | |
this.on("didInsertElement", this, this._updateElementValue); | |
} | |
}); | |
}); | |
define("ember-handlebars/controls/text_field", | |
["ember-metal/property_get","ember-metal/property_set","ember-views/views/component","ember-handlebars/controls/text_support","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __exports__) { | |
"use strict"; | |
/** | |
@module ember | |
@submodule ember-handlebars | |
*/ | |
var get = __dependency1__.get; | |
var set = __dependency2__.set; | |
var Component = __dependency3__["default"]; | |
var TextSupport = __dependency4__["default"]; | |
/** | |
The internal class used to create text inputs when the `{{input}}` | |
helper is used with `type` of `text`. | |
See [Handlebars.helpers.input](/api/classes/Ember.Handlebars.helpers.html#method_input) for usage details. | |
## Layout and LayoutName properties | |
Because HTML `input` elements are self closing `layout` and `layoutName` | |
properties will not be applied. See [Ember.View](/api/classes/Ember.View.html)'s | |
layout section for more information. | |
@class TextField | |
@namespace Ember | |
@extends Ember.Component | |
@uses Ember.TextSupport | |
*/ | |
__exports__["default"] = Component.extend(TextSupport, { | |
instrumentDisplay: '{{input type="text"}}', | |
classNames: ['ember-text-field'], | |
tagName: "input", | |
attributeBindings: ['type', 'value', 'size', 'pattern', 'name', 'min', 'max', | |
'accept', 'autocomplete', 'autosave', 'formaction', | |
'formenctype', 'formmethod', 'formnovalidate', 'formtarget', | |
'height', 'inputmode', 'list', 'multiple', 'step', | |
'width'], | |
/** | |
The `value` attribute of the input element. As the user inputs text, this | |
property is updated live. | |
@property value | |
@type String | |
@default "" | |
*/ | |
value: "", | |
/** | |
The `type` attribute of the input element. | |
@property type | |
@type String | |
@default "text" | |
*/ | |
type: "text", | |
/** | |
The `size` of the text field in characters. | |
@property size | |
@type String | |
@default null | |
*/ | |
size: null, | |
/** | |
The `pattern` attribute of input element. | |
@property pattern | |
@type String | |
@default null | |
*/ | |
pattern: null, | |
/** | |
The `min` attribute of input element used with `type="number"` or `type="range"`. | |
@property min | |
@type String | |
@default null | |
@since 1.4.0 | |
*/ | |
min: null, | |
/** | |
The `max` attribute of input element used with `type="number"` or `type="range"`. | |
@property max | |
@type String | |
@default null | |
@since 1.4.0 | |
*/ | |
max: null | |
}); | |
}); | |
define("ember-handlebars/controls/text_support", | |
["ember-metal/property_get","ember-metal/property_set","ember-metal/mixin","ember-runtime/mixins/target_action_support","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __exports__) { | |
"use strict"; | |
/** | |
@module ember | |
@submodule ember-handlebars | |
*/ | |
var get = __dependency1__.get; | |
var set = __dependency2__.set; | |
var Mixin = __dependency3__.Mixin; | |
var TargetActionSupport = __dependency4__["default"]; | |
/** | |
Shared mixin used by `Ember.TextField` and `Ember.TextArea`. | |
@class TextSupport | |
@namespace Ember | |
@uses Ember.TargetActionSupport | |
@extends Ember.Mixin | |
@private | |
*/ | |
var TextSupport = Mixin.create(TargetActionSupport, { | |
value: "", | |
attributeBindings: ['placeholder', 'disabled', 'maxlength', 'tabindex', 'readonly', | |
'autofocus', 'form', 'selectionDirection', 'spellcheck', 'required', | |
'title', 'autocapitalize', 'autocorrect'], | |
placeholder: null, | |
disabled: false, | |
maxlength: null, | |
init: function() { | |
this._super(); | |
this.on("focusOut", this, this._elementValueDidChange); | |
this.on("change", this, this._elementValueDidChange); | |
this.on("paste", this, this._elementValueDidChange); | |
this.on("cut", this, this._elementValueDidChange); | |
this.on("input", this, this._elementValueDidChange); | |
this.on("keyUp", this, this.interpretKeyEvents); | |
}, | |
/** | |
The action to be sent when the user presses the return key. | |
This is similar to the `{{action}}` helper, but is fired when | |
the user presses the return key when editing a text field, and sends | |
the value of the field as the context. | |
@property action | |
@type String | |
@default null | |
*/ | |
action: null, | |
/** | |
The event that should send the action. | |
Options are: | |
* `enter`: the user pressed enter | |
* `keyPress`: the user pressed a key | |
@property onEvent | |
@type String | |
@default enter | |
*/ | |
onEvent: 'enter', | |
/** | |
Whether they `keyUp` event that triggers an `action` to be sent continues | |
propagating to other views. | |
By default, when the user presses the return key on their keyboard and | |
the text field has an `action` set, the action will be sent to the view's | |
controller and the key event will stop propagating. | |
If you would like parent views to receive the `keyUp` event even after an | |
action has been dispatched, set `bubbles` to true. | |
@property bubbles | |
@type Boolean | |
@default false | |
*/ | |
bubbles: false, | |
interpretKeyEvents: function(event) { | |
var map = TextSupport.KEY_EVENTS; | |
var method = map[event.keyCode]; | |
this._elementValueDidChange(); | |
if (method) { return this[method](event); } | |
}, | |
_elementValueDidChange: function() { | |
set(this, 'value', this.$().val()); | |
}, | |
/** | |
The action to be sent when the user inserts a new line. | |
Called by the `Ember.TextSupport` mixin on keyUp if keycode matches 13. | |
Uses sendAction to send the `enter` action to the controller. | |
@method insertNewline | |
@param {Event} event | |
*/ | |
insertNewline: function(event) { | |
sendAction('enter', this, event); | |
sendAction('insert-newline', this, event); | |
}, | |
/** | |
Called when the user hits escape. | |
Called by the `Ember.TextSupport` mixin on keyUp if keycode matches 27. | |
Uses sendAction to send the `escape-press` action to the controller. | |
@method cancel | |
@param {Event} event | |
*/ | |
cancel: function(event) { | |
sendAction('escape-press', this, event); | |
}, | |
/** | |
Called when the text area is focused. | |
@method focusIn | |
@param {Event} event | |
*/ | |
focusIn: function(event) { | |
sendAction('focus-in', this, event); | |
}, | |
/** | |
Called when the text area is blurred. | |
@method focusOut | |
@param {Event} event | |
*/ | |
focusOut: function(event) { | |
sendAction('focus-out', this, event); | |
}, | |
/** | |
The action to be sent when the user presses a key. Enabled by setting | |
the `onEvent` property to `keyPress`. | |
Uses sendAction to send the `keyPress` action to the controller. | |
@method keyPress | |
@param {Event} event | |
*/ | |
keyPress: function(event) { | |
sendAction('key-press', this, event); | |
} | |
}); | |
TextSupport.KEY_EVENTS = { | |
13: 'insertNewline', | |
27: 'cancel' | |
}; | |
// In principle, this shouldn't be necessary, but the legacy | |
// sendAction semantics for TextField are different from | |
// the component semantics so this method normalizes them. | |
function sendAction(eventName, view, event) { | |
var action = get(view, eventName), | |
on = get(view, 'onEvent'), | |
value = get(view, 'value'); | |
// back-compat support for keyPress as an event name even though | |
// it's also a method name that consumes the event (and therefore | |
// incompatible with sendAction semantics). | |
if (on === eventName || (on === 'keyPress' && eventName === 'key-press')) { | |
view.sendAction('action', value); | |
} | |
view.sendAction(eventName, value); | |
if (action || on === eventName) { | |
if(!get(view, 'bubbles')) { | |
event.stopPropagation(); | |
} | |
} | |
} | |
__exports__["default"] = TextSupport; | |
}); | |
define("ember-handlebars/ext", | |
["ember-metal/core","ember-runtime/system/string","ember-handlebars-compiler","ember-metal/property_get","ember-metal/binding","ember-metal/error","ember-metal/mixin","ember-metal/is_empty","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __dependency6__, __dependency7__, __dependency8__, __exports__) { | |
"use strict"; | |
var Ember = __dependency1__["default"]; | |
// Ember.FEATURES, Ember.assert, Ember.Handlebars, Ember.lookup | |
// var emberAssert = Ember.assert; | |
var fmt = __dependency2__.fmt; | |
var EmberHandlebars = __dependency3__["default"]; | |
var helpers = EmberHandlebars.helpers; | |
var get = __dependency4__.get; | |
var isGlobalPath = __dependency5__.isGlobalPath; | |
var EmberError = __dependency6__["default"]; | |
var IS_BINDING = __dependency7__.IS_BINDING; | |
// late bound via requireModule because of circular dependencies. | |
var resolveHelper, | |
SimpleHandlebarsView; | |
var isEmpty = __dependency8__["default"]; | |
var slice = [].slice, originalTemplate = EmberHandlebars.template; | |
/** | |
If a path starts with a reserved keyword, returns the root | |
that should be used. | |
@private | |
@method normalizePath | |
@for Ember | |
@param root {Object} | |
@param path {String} | |
@param data {Hash} | |
*/ | |
function normalizePath(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. | |
@method get | |
@for Ember.Handlebars | |
@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 | |
*/ | |
function handlebarsGet(root, path, options) { | |
var data = options && options.data, | |
normalizedPath = normalizePath(root, path, data), | |
value; | |
if (Ember.FEATURES.isEnabled("ember-handlebars-caps-lookup")) { | |
// If the path starts with a capital letter, look it up on Ember.lookup, | |
// which defaults to the `window` object in browsers. | |
if (isGlobalPath(path)) { | |
value = get(Ember.lookup, path); | |
} else { | |
// 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. | |
value = get(normalizedPath.root, normalizedPath.path); | |
} | |
} else { | |
root = normalizedPath.root; | |
path = normalizedPath.path; | |
value = get(root, path); | |
if (value === undefined && root !== Ember.lookup && isGlobalPath(path)) { | |
value = get(Ember.lookup, path); | |
} | |
} | |
return value; | |
} | |
/** | |
This method uses `Ember.Handlebars.get` to lookup a value, then ensures | |
that the value is escaped properly. | |
If `unescaped` is a truthy value then the escaping will not be performed. | |
@method getEscaped | |
@for Ember.Handlebars | |
@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 | |
@since 1.4.0 | |
*/ | |
function getEscaped(root, path, options) { | |
var result = handlebarsGet(root, path, options); | |
if (result === null || result === undefined) { | |
result = ""; | |
} else if (!(result instanceof Handlebars.SafeString)) { | |
result = String(result); | |
} | |
if (!options.hash.unescaped){ | |
result = Handlebars.Utils.escapeExpression(result); | |
} | |
return result; | |
} | |
__exports__.getEscaped = getEscaped;function resolveParams(context, params, options) { | |
var resolvedParams = [], types = options.types, param, type; | |
for (var i=0, l=params.length; i<l; i++) { | |
param = params[i]; | |
type = types[i]; | |
if (type === 'ID') { | |
resolvedParams.push(handlebarsGet(context, param, options)); | |
} else { | |
resolvedParams.push(param); | |
} | |
} | |
return resolvedParams; | |
} | |
__exports__.resolveParams = resolveParams;function resolveHash(context, hash, options) { | |
var resolvedHash = {}, types = options.hashTypes, type; | |
for (var key in hash) { | |
if (!hash.hasOwnProperty(key)) { continue; } | |
type = types[key]; | |
if (type === 'ID') { | |
resolvedHash[key] = handlebarsGet(context, hash[key], options); | |
} else { | |
resolvedHash[key] = hash[key]; | |
} | |
} | |
return resolvedHash; | |
} | |
__exports__.resolveHash = resolveHash;/** | |
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. | |
@private | |
@method helperMissing | |
@for Ember.Handlebars.helpers | |
@param {String} path | |
@param {Hash} options | |
*/ | |
function helperMissingHelper(path) { | |
if (!resolveHelper) { resolveHelper = requireModule('ember-handlebars/helpers/binding')['resolveHelper']; } // ES6TODO: stupid circular dep | |
var error, view = ""; | |
var options = arguments[arguments.length - 1]; | |
var helper = resolveHelper(options.data.view.container, path); | |
if (helper) { | |
return helper.apply(this, slice.call(arguments, 1)); | |
} | |
error = "%@ Handlebars error: Could not find property '%@' on object %@."; | |
if (options.data) { | |
view = options.data.view; | |
} | |
throw new EmberError(fmt(error, [view, path, this])); | |
} | |
__exports__.helperMissingHelper = helperMissingHelper;/** | |
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. | |
@private | |
@method helperMissing | |
@for Ember.Handlebars.helpers | |
@param {String} path | |
@param {Hash} options | |
*/ | |
function blockHelperMissingHelper(path) { | |
if (!resolveHelper) { resolveHelper = requireModule('ember-handlebars/helpers/binding')['resolveHelper']; } // ES6TODO: stupid circular dep | |
var options = arguments[arguments.length - 1]; | |
Ember.assert("`blockHelperMissing` was invoked without a helper name, which " + | |
"is most likely due to a mismatch between the version of " + | |
"Ember.js you're running now and the one used to precompile your " + | |
"templates. Please make sure the version of " + | |
"`ember-handlebars-compiler` you're using is up to date.", path); | |
var helper = resolveHelper(options.data.view.container, path); | |
if (helper) { | |
return helper.apply(this, slice.call(arguments, 1)); | |
} else { | |
return helpers.helperMissing.call(this, path); | |
} | |
} | |
__exports__.blockHelperMissingHelper = blockHelperMissingHelper;/** | |
Register a bound handlebars helper. Bound helpers behave similarly to regular | |
handlebars helpers, with the added ability to re-render when the underlying data | |
changes. | |
## Simple example | |
```javascript | |
Ember.Handlebars.registerBoundHelper('capitalize', function(value) { | |
return Ember.String.capitalize(value); | |
}); | |
``` | |
The above bound helper can be used inside of templates as follows: | |
```handlebars | |
{{capitalize name}} | |
``` | |
In this case, when the `name` property of the template's context changes, | |
the rendered value of the helper will update to reflect this change. | |
## Example with options | |
Like normal handlebars helpers, bound helpers have access to the options | |
passed into the helper call. | |
```javascript | |
Ember.Handlebars.registerBoundHelper('repeat', function(value, options) { | |
var count = options.hash.count; | |
var a = []; | |
while(a.length < count) { | |
a.push(value); | |
} | |
return a.join(''); | |
}); | |
``` | |
This helper could be used in a template as follows: | |
```handlebars | |
{{repeat text count=3}} | |
``` | |
## Example with bound options | |
Bound hash options are also supported. Example: | |
```handlebars | |
{{repeat text count=numRepeats}} | |
``` | |
In this example, count will be bound to the value of | |
the `numRepeats` property on the context. If that property | |
changes, the helper will be re-rendered. | |
## Example with extra dependencies | |
The `Ember.Handlebars.registerBoundHelper` method takes a variable length | |
third parameter which indicates extra dependencies on the passed in value. | |
This allows the handlebars helper to update when these dependencies change. | |
```javascript | |
Ember.Handlebars.registerBoundHelper('capitalizeName', function(value) { | |
return value.get('name').toUpperCase(); | |
}, 'name'); | |
``` | |
## Example with multiple bound properties | |
`Ember.Handlebars.registerBoundHelper` supports binding to | |
multiple properties, e.g.: | |
```javascript | |
Ember.Handlebars.registerBoundHelper('concatenate', function() { | |
var values = Array.prototype.slice.call(arguments, 0, -1); | |
return values.join('||'); | |
}); | |
``` | |
Which allows for template syntax such as `{{concatenate prop1 prop2}}` or | |
`{{concatenate prop1 prop2 prop3}}`. If any of the properties change, | |
the helper will re-render. Note that dependency keys cannot be | |
using in conjunction with multi-property helpers, since it is ambiguous | |
which property the dependent keys would belong to. | |
## Use with unbound helper | |
The `{{unbound}}` helper can be used with bound helper invocations | |
to render them in their unbound form, e.g. | |
```handlebars | |
{{unbound capitalize name}} | |
``` | |
In this example, if the name property changes, the helper | |
will not re-render. | |
## Use with blocks not supported | |
Bound helpers do not support use with Handlebars blocks or | |
the addition of child views of any kind. | |
@method registerBoundHelper | |
@for Ember.Handlebars | |
@param {String} name | |
@param {Function} function | |
@param {String} dependentKeys* | |
*/ | |
function registerBoundHelper(name, fn) { | |
var boundHelperArgs = slice.call(arguments, 1), | |
boundFn = makeBoundHelper.apply(this, boundHelperArgs); | |
EmberHandlebars.registerHelper(name, boundFn); | |
} | |
__exports__.registerBoundHelper = registerBoundHelper;/** | |
A helper function used by `registerBoundHelper`. Takes the | |
provided Handlebars helper function fn and returns it in wrapped | |
bound helper form. | |
The main use case for using this outside of `registerBoundHelper` | |
is for registering helpers on the container: | |
```js | |
var boundHelperFn = Ember.Handlebars.makeBoundHelper(function(word) { | |
return word.toUpperCase(); | |
}); | |
container.register('helper:my-bound-helper', boundHelperFn); | |
``` | |
In the above example, if the helper function hadn't been wrapped in | |
`makeBoundHelper`, the registered helper would be unbound. | |
@method makeBoundHelper | |
@for Ember.Handlebars | |
@param {Function} function | |
@param {String} dependentKeys* | |
@since 1.2.0 | |
*/ | |
function makeBoundHelper(fn) { | |
if (!SimpleHandlebarsView) { SimpleHandlebarsView = requireModule('ember-handlebars/views/handlebars_bound_view')['SimpleHandlebarsView']; } // ES6TODO: stupid circular dep | |
var dependentKeys = slice.call(arguments, 1); | |
function helper() { | |
var properties = slice.call(arguments, 0, -1), | |
numProperties = properties.length, | |
options = arguments[arguments.length - 1], | |
normalizedProperties = [], | |
data = options.data, | |
types = data.isUnbound ? slice.call(options.types, 1) : options.types, | |
hash = options.hash, | |
view = data.view, | |
contexts = options.contexts, | |
currentContext = (contexts && contexts.length) ? contexts[0] : this, | |
prefixPathForDependentKeys = '', | |
loc, len, hashOption, | |
boundOption, property, | |
normalizedValue = SimpleHandlebarsView.prototype.normalizedValue; | |
Ember.assert("registerBoundHelper-generated helpers do not support use with Handlebars blocks.", !options.fn); | |
// Detect bound options (e.g. countBinding="otherCount") | |
var boundOptions = hash.boundOptions = {}; | |
for (hashOption in hash) { | |
if (IS_BINDING.test(hashOption)) { | |
// Lop off 'Binding' suffix. | |
boundOptions[hashOption.slice(0, -7)] = hash[hashOption]; | |
} | |
} | |
// Expose property names on data.properties object. | |
var watchedProperties = []; | |
data.properties = []; | |
for (loc = 0; loc < numProperties; ++loc) { | |
data.properties.push(properties[loc]); | |
if (types[loc] === 'ID') { | |
var normalizedProp = normalizePath(currentContext, properties[loc], data); | |
normalizedProperties.push(normalizedProp); | |
watchedProperties.push(normalizedProp); | |
} else { | |
if(data.isUnbound) { | |
normalizedProperties.push({path: properties[loc]}); | |
}else { | |
normalizedProperties.push(null); | |
} | |
} | |
} | |
// Handle case when helper invocation is preceded by `unbound`, e.g. | |
// {{unbound myHelper foo}} | |
if (data.isUnbound) { | |
return evaluateUnboundHelper(this, fn, normalizedProperties, options); | |
} | |
var bindView = new SimpleHandlebarsView(null, null, !options.hash.unescaped, options.data); | |
// Override SimpleHandlebarsView's method for generating the view's content. | |
bindView.normalizedValue = function() { | |
var args = [], boundOption; | |
// Copy over bound hash options. | |
for (boundOption in boundOptions) { | |
if (!boundOptions.hasOwnProperty(boundOption)) { continue; } | |
property = normalizePath(currentContext, boundOptions[boundOption], data); | |
bindView.path = property.path; | |
bindView.pathRoot = property.root; | |
hash[boundOption] = normalizedValue.call(bindView); | |
} | |
for (loc = 0; loc < numProperties; ++loc) { | |
property = normalizedProperties[loc]; | |
if (property) { | |
bindView.path = property.path; | |
bindView.pathRoot = property.root; | |
args.push(normalizedValue.call(bindView)); | |
} else { | |
args.push(properties[loc]); | |
} | |
} | |
args.push(options); | |
// Run the supplied helper function. | |
return fn.apply(currentContext, args); | |
}; | |
view.appendChild(bindView); | |
// Assemble list of watched properties that'll re-render this helper. | |
for (boundOption in boundOptions) { | |
if (boundOptions.hasOwnProperty(boundOption)) { | |
watchedProperties.push(normalizePath(currentContext, boundOptions[boundOption], data)); | |
} | |
} | |
// Observe each property. | |
for (loc = 0, len = watchedProperties.length; loc < len; ++loc) { | |
property = watchedProperties[loc]; | |
view.registerObserver(property.root, property.path, bindView, bindView.rerender); | |
} | |
if (types[0] !== 'ID' || normalizedProperties.length === 0) { | |
return; | |
} | |
// Add dependent key observers to the first param | |
var normalized = normalizedProperties[0], | |
pathRoot = normalized.root, | |
path = normalized.path; | |
if(!isEmpty(path)) { | |
prefixPathForDependentKeys = path + '.'; | |
} | |
for (var i=0, l=dependentKeys.length; i<l; i++) { | |
view.registerObserver(pathRoot, prefixPathForDependentKeys + dependentKeys[i], bindView, bindView.rerender); | |
} | |
} | |
helper._rawFunction = fn; | |
return helper; | |
} | |
/** | |
Renders the unbound form of an otherwise bound helper function. | |
@private | |
@method evaluateUnboundHelper | |
@param {Function} fn | |
@param {Object} context | |
@param {Array} normalizedProperties | |
@param {String} options | |
*/ | |
function evaluateUnboundHelper(context, fn, normalizedProperties, options) { | |
var args = [], | |
hash = options.hash, | |
boundOptions = hash.boundOptions, | |
types = slice.call(options.types, 1), | |
loc, | |
len, | |
property, | |
propertyType, | |
boundOption; | |
for (boundOption in boundOptions) { | |
if (!boundOptions.hasOwnProperty(boundOption)) { continue; } | |
hash[boundOption] = handlebarsGet(context, boundOptions[boundOption], options); | |
} | |
for(loc = 0, len = normalizedProperties.length; loc < len; ++loc) { | |
property = normalizedProperties[loc]; | |
propertyType = types[loc]; | |
if(propertyType === "ID") { | |
args.push(handlebarsGet(property.root, property.path, options)); | |
} else { | |
args.push(property.path); | |
} | |
} | |
args.push(options); | |
return fn.apply(context, args); | |
} | |
/** | |
Overrides Handlebars.template so that we can distinguish | |
user-created, top-level templates from inner contexts. | |
@private | |
@method template | |
@for Ember.Handlebars | |
@param {String} spec | |
*/ | |
function template(spec) { | |
var t = originalTemplate(spec); | |
t.isTop = true; | |
return t; | |
} | |
__exports__.template = template;__exports__.normalizePath = normalizePath; | |
__exports__.makeBoundHelper = makeBoundHelper; | |
__exports__.handlebarsGet = handlebarsGet; | |
__exports__.evaluateUnboundHelper = evaluateUnboundHelper; | |
}); | |
define("ember-handlebars/helpers/binding", | |
["ember-metal/core","ember-handlebars-compiler","ember-metal/property_get","ember-metal/property_set","ember-metal/utils","ember-runtime/system/string","ember-metal/platform","ember-metal/is_none","ember-metal/enumerable_utils","ember-metal/array","ember-views/views/view","ember-metal/run_loop","ember-metal/observer","ember-metal/binding","ember-views/system/jquery","ember-handlebars/ext","ember-runtime/keys","ember-handlebars/views/handlebars_bound_view","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __dependency6__, __dependency7__, __dependency8__, __dependency9__, __dependency10__, __dependency11__, __dependency12__, __dependency13__, __dependency14__, __dependency15__, __dependency16__, __dependency17__, __dependency18__, __exports__) { | |
"use strict"; | |
/** | |
@module ember | |
@submodule ember-handlebars | |
*/ | |
var Ember = __dependency1__["default"]; | |
// Ember.assert, Ember.warn, uuid | |
// var emberAssert = Ember.assert, Ember.warn = Ember.warn; | |
var EmberHandlebars = __dependency2__["default"]; | |
var get = __dependency3__.get; | |
var set = __dependency4__.set; | |
var apply = __dependency5__.apply; | |
var fmt = __dependency6__.fmt; | |
var o_create = __dependency7__.create; | |
var isNone = __dependency8__["default"]; | |
var EnumerableUtils = __dependency9__["default"]; | |
var forEach = __dependency10__.forEach; | |
var View = __dependency11__.View; | |
var run = __dependency12__["default"]; | |
var removeObserver = __dependency13__.removeObserver; | |
var isGlobalPath = __dependency14__.isGlobalPath; | |
var emberBind = __dependency14__.bind; | |
var jQuery = __dependency15__["default"]; | |
var isArray = __dependency5__.isArray; | |
var handlebarsGetEscaped = __dependency16__.getEscaped; | |
var keys = __dependency17__["default"]; | |
var _HandlebarsBoundView = __dependency18__._HandlebarsBoundView; | |
var SimpleHandlebarsView = __dependency18__.SimpleHandlebarsView; | |
var normalizePath = __dependency16__.normalizePath; | |
var handlebarsGet = __dependency16__.handlebarsGet; | |
var getEscaped = __dependency16__.getEscaped; | |
var guidFor = __dependency5__.guidFor; | |
var typeOf = __dependency5__.typeOf; | |
var helpers = EmberHandlebars.helpers; | |
var SafeString = EmberHandlebars.SafeString; | |
function exists(value) { | |
return !isNone(value); | |
} | |
var WithView = _HandlebarsBoundView.extend({ | |
init: function() { | |
var controller; | |
apply(this, this._super, arguments); | |
var keywords = this.templateData.keywords; | |
var keywordName = this.templateHash.keywordName; | |
var keywordPath = this.templateHash.keywordPath; | |
var controllerName = this.templateHash.controller; | |
var preserveContext = this.preserveContext; | |
if (controllerName) { | |
var previousContext = this.previousContext; | |
controller = this.container.lookupFactory('controller:'+controllerName).create({ | |
parentController: previousContext, | |
target: previousContext | |
}); | |
this._generatedController = controller; | |
if (!preserveContext) { | |
this.set('controller', controller); | |
this.valueNormalizerFunc = function(result) { | |
controller.set('model', result); | |
return controller; | |
}; | |
} else { | |
var controllerPath = jQuery.expando + guidFor(controller); | |
keywords[controllerPath] = controller; | |
emberBind(keywords, controllerPath + '.model', keywordPath); | |
keywordPath = controllerPath; | |
} | |
} | |
if (preserveContext) { | |
emberBind(keywords, keywordName, keywordPath); | |
} | |
}, | |
willDestroy: function() { | |
this._super(); | |
if (this._generatedController) { | |
this._generatedController.destroy(); | |
} | |
} | |
}); | |
// 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. | |
function bind(property, options, preserveContext, shouldDisplay, valueNormalizer, childProperties) { | |
var data = options.data, | |
fn = options.fn, | |
inverse = options.inverse, | |
view = data.view, | |
normalized, observer, i; | |
// we relied on the behavior of calling without | |
// context to mean this === window, but when running | |
// "use strict", it's possible for this to === undefined; | |
var currentContext = this || window; | |
normalized = normalizePath(currentContext, property, data); | |
// Set up observers for observable objects | |
if ('object' === typeof this) { | |
if (data.insideGroup) { | |
observer = function() { | |
run.once(view, 'rerender'); | |
}; | |
var template, context, result = handlebarsGet(currentContext, property, options); | |
result = valueNormalizer ? valueNormalizer(result) : result; | |
context = preserveContext ? currentContext : result; | |
if (shouldDisplay(result)) { | |
template = fn; | |
} else if (inverse) { | |
template = inverse; | |
} | |
template(context, { data: options.data }); | |
} else { | |
var viewClass = _HandlebarsBoundView; | |
var viewOptions = { | |
preserveContext: preserveContext, | |
shouldDisplayFunc: shouldDisplay, | |
valueNormalizerFunc: valueNormalizer, | |
displayTemplate: fn, | |
inverseTemplate: inverse, | |
path: property, | |
pathRoot: currentContext, | |
previousContext: currentContext, | |
isEscaped: !options.hash.unescaped, | |
templateData: options.data, | |
templateHash: options.hash, | |
helperName: options.helperName | |
}; | |
if (options.isWithHelper) { | |
viewClass = WithView; | |
} | |
// 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(viewClass, viewOptions); | |
view.appendChild(bindView); | |
observer = function() { | |
run.scheduleOnce('render', 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 (normalized.path !== '') { | |
view.registerObserver(normalized.root, normalized.path, observer); | |
if (childProperties) { | |
for (i=0; i<childProperties.length; i++) { | |
view.registerObserver(normalized.root, normalized.path+'.'+childProperties[i], observer); | |
} | |
} | |
} | |
} else { | |
// The object is not observable, so just render it out and | |
// be done with it. | |
data.buffer.push(handlebarsGetEscaped(currentContext, property, options)); | |
} | |
} | |
function simpleBind(currentContext, property, options) { | |
var data = options.data, | |
view = data.view, | |
normalized, observer, pathRoot, output; | |
normalized = normalizePath(currentContext, property, data); | |
pathRoot = normalized.root; | |
// Set up observers for observable objects | |
if (pathRoot && ('object' === typeof pathRoot)) { | |
if (data.insideGroup) { | |
observer = function() { | |
run.once(view, 'rerender'); | |
}; | |
output = handlebarsGetEscaped(currentContext, property, options); | |
data.buffer.push(output); | |
} else { | |
var bindView = new SimpleHandlebarsView( | |
property, currentContext, !options.hash.unescaped, options.data | |
); | |
bindView._parentView = view; | |
view.appendChild(bindView); | |
observer = function() { | |
run.scheduleOnce('render', bindView, 'rerender'); | |
}; | |
} | |
// 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 (normalized.path !== '') { | |
view.registerObserver(normalized.root, normalized.path, observer); | |
} | |
} else { | |
// The object is not observable, so just render it out and | |
// be done with it. | |
output = handlebarsGetEscaped(currentContext, property, options); | |
data.buffer.push(output); | |
} | |
} | |
function shouldDisplayIfHelperContent(result) { | |
var truthy = result && get(result, 'isTruthy'); | |
if (typeof truthy === 'boolean') { return truthy; } | |
if (isArray(result)) { | |
return get(result, 'length') !== 0; | |
} else { | |
return !!result; | |
} | |
} | |
/** | |
'_triageMustache' is used internally select between a binding, helper, or component 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 | |
@method _triageMustache | |
@for Ember.Handlebars.helpers | |
@param {String} property Property/helperID to triage | |
@param {Object} options hash of template/rendering options | |
@return {String} HTML string | |
*/ | |
function _triageMustacheHelper(property, options) { | |
Ember.assert("You cannot pass more than one argument to the _triageMustache helper", arguments.length <= 2); | |
var helper = EmberHandlebars.resolveHelper(options.data.view.container, property); | |
if (helper) { | |
return helper.call(this, options); | |
} | |
return helpers.bind.call(this, property, options); | |
} | |
/** | |
Used to lookup/resolve handlebars helpers. The lookup order is: | |
* Look for a registered helper | |
* If a dash exists in the name: | |
* Look for a helper registed in the container | |
* Use Ember.ComponentLookup to find an Ember.Component that resolves | |
to the given name | |
@private | |
@method resolveHelper | |
@param {Container} container | |
@param {String} name the name of the helper to lookup | |
@return {Handlebars Helper} | |
*/ | |
function resolveHelper(container, name) { | |
if (helpers[name]) { | |
return helpers[name]; | |
} | |
if (!container || name.indexOf('-') === -1) { | |
return; | |
} | |
var helper = container.lookup('helper:' + name); | |
if (!helper) { | |
var componentLookup = container.lookup('component-lookup:main'); | |
Ember.assert("Could not find 'component-lookup:main' on the provided container, which is necessary for performing component lookups", componentLookup); | |
var Component = componentLookup.lookupFactory(name, container); | |
if (Component) { | |
helper = EmberHandlebars.makeViewHelper(Component); | |
container.register('helper:' + name, helper); | |
} | |
} | |
return helper; | |
} | |
/** | |
`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`: | |
```handlebars | |
{{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 | |
@method bind | |
@for Ember.Handlebars.helpers | |
@param {String} property Property to bind | |
@param {Function} fn Context to provide for rendering | |
@return {String} HTML string | |
*/ | |
function bindHelper(property, options) { | |
Ember.assert("You cannot pass more than one argument to the bind helper", arguments.length <= 2); | |
var context = (options.contexts && options.contexts.length) ? options.contexts[0] : this; | |
if (!options.fn) { | |
return simpleBind(context, property, options); | |
} | |
options.helperName = 'bind'; | |
return bind.call(context, property, options, false, exists); | |
} | |
/** | |
Use the `boundIf` helper to create a conditional that re-evaluates | |
whenever the truthiness of the bound value changes. | |
```handlebars | |
{{#boundIf "content.shouldDisplayTitle"}} | |
{{content.title}} | |
{{/boundIf}} | |
``` | |
@private | |
@method boundIf | |
@for Ember.Handlebars.helpers | |
@param {String} property Property to bind | |
@param {Function} fn Context to provide for rendering | |
@return {String} HTML string | |
*/ | |
function boundIfHelper(property, fn) { | |
var context = (fn.contexts && fn.contexts.length) ? fn.contexts[0] : this; | |
fn.helperName = fn.helperName || 'boundIf'; | |
return bind.call(context, property, fn, true, shouldDisplayIfHelperContent, shouldDisplayIfHelperContent, ['isTruthy', 'length']); | |
} | |
/** | |
@private | |
Use the `unboundIf` helper to create a conditional that evaluates once. | |
```handlebars | |
{{#unboundIf "content.shouldDisplayTitle"}} | |
{{content.title}} | |
{{/unboundIf}} | |
``` | |
@method unboundIf | |
@for Ember.Handlebars.helpers | |
@param {String} property Property to bind | |
@param {Function} fn Context to provide for rendering | |
@return {String} HTML string | |
@since 1.4.0 | |
*/ | |
function unboundIfHelper(property, fn) { | |
var context = (fn.contexts && fn.contexts.length) ? fn.contexts[0] : this, | |
data = fn.data, | |
template = fn.fn, | |
inverse = fn.inverse, | |
normalized, propertyValue, result; | |
normalized = normalizePath(context, property, data); | |
propertyValue = handlebarsGet(context, property, fn); | |
if (!shouldDisplayIfHelperContent(propertyValue)) { | |
template = inverse; | |
} | |
template(context, { data: data }); | |
} | |
/** | |
Use the `{{with}}` helper when you want to scope context. Take the following code as an example: | |
```handlebars | |
<h5>{{user.name}}</h5> | |
<div class="role"> | |
<h6>{{user.role.label}}</h6> | |
<span class="role-id">{{user.role.id}}</span> | |
<p class="role-desc">{{user.role.description}}</p> | |
</div> | |
``` | |
`{{with}}` can be our best friend in these cases, | |
instead of writing `user.role.*` over and over, we use `{{#with user.role}}`. | |
Now the context within the `{{#with}} .. {{/with}}` block is `user.role` so you can do the following: | |
```handlebars | |
<h5>{{user.name}}</h5> | |
<div class="role"> | |
{{#with user.role}} | |
<h6>{{label}}</h6> | |
<span class="role-id">{{id}}</span> | |
<p class="role-desc">{{description}}</p> | |
{{/with}} | |
</div> | |
``` | |
### `as` operator | |
This operator aliases the scope to a new name. It's helpful for semantic clarity and to retain | |
default scope or to reference from another `{{with}}` block. | |
```handlebars | |
// posts might not be | |
{{#with user.posts as blogPosts}} | |
<div class="notice"> | |
There are {{blogPosts.length}} blog posts written by {{user.name}}. | |
</div> | |
{{#each post in blogPosts}} | |
<li>{{post.title}}</li> | |
{{/each}} | |
{{/with}} | |
``` | |
Without the `as` operator, it would be impossible to reference `user.name` in the example above. | |
NOTE: The alias should not reuse a name from the bound property path. | |
For example: `{{#with foo.bar as foo}}` is not supported because it attempts to alias using | |
the first part of the property path, `foo`. Instead, use `{{#with foo.bar as baz}}`. | |
### `controller` option | |
Adding `controller='something'` instructs the `{{with}}` helper to create and use an instance of | |
the specified controller with the new context as its content. | |
This is very similar to using an `itemController` option with the `{{each}}` helper. | |
```handlebars | |
{{#with users.posts controller='userBlogPosts'}} | |
{{!- The current context is wrapped in our controller instance }} | |
{{/with}} | |
``` | |
In the above example, the template provided to the `{{with}}` block is now wrapped in the | |
`userBlogPost` controller, which provides a very elegant way to decorate the context with custom | |
functions/properties. | |
@method with | |
@for Ember.Handlebars.helpers | |
@param {Function} context | |
@param {Hash} options | |
@return {String} HTML string | |
*/ | |
function withHelper(context, options) { | |
var bindContext, preserveContext, controller, helperName = 'with'; | |
if (arguments.length === 4) { | |
var keywordName, path, rootPath, normalized, contextPath; | |
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]; | |
if (path) { | |
helperName += ' ' + path + ' as ' + keywordName; | |
} | |
Ember.assert("You must pass a block to the with helper", options.fn && options.fn !== Handlebars.VM.noop); | |
var localizedOptions = o_create(options); | |
localizedOptions.data = o_create(options.data); | |
localizedOptions.data.keywords = o_create(options.data.keywords || {}); | |
if (isGlobalPath(path)) { | |
contextPath = 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 = jQuery.expando + guidFor(rootPath); | |
localizedOptions.data.keywords[contextKey] = rootPath; | |
// if the path is '' ("this"), just bind directly to the current context | |
contextPath = path ? contextKey + '.' + path : contextKey; | |
} | |
localizedOptions.hash.keywordName = keywordName; | |
localizedOptions.hash.keywordPath = contextPath; | |
bindContext = this; | |
context = path; | |
options = localizedOptions; | |
preserveContext = true; | |
} 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); | |
helperName += ' ' + context; | |
bindContext = options.contexts[0]; | |
preserveContext = false; | |
} | |
options.helperName = helperName; | |
options.isWithHelper = true; | |
return bind.call(bindContext, context, options, preserveContext, exists); | |
} | |
/** | |
See [boundIf](/api/classes/Ember.Handlebars.helpers.html#method_boundIf) | |
and [unboundIf](/api/classes/Ember.Handlebars.helpers.html#method_unboundIf) | |
@method if | |
@for Ember.Handlebars.helpers | |
@param {Function} context | |
@param {Hash} options | |
@return {String} HTML string | |
*/ | |
function ifHelper(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); | |
options.helperName = options.helperName || ('if ' + context); | |
if (options.data.isUnbound) { | |
return helpers.unboundIf.call(options.contexts[0], context, options); | |
} else { | |
return helpers.boundIf.call(options.contexts[0], context, options); | |
} | |
} | |
/** | |
@method unless | |
@for Ember.Handlebars.helpers | |
@param {Function} context | |
@param {Hash} options | |
@return {String} HTML string | |
*/ | |
function unlessHelper(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, helperName = 'unless'; | |
if (context) { | |
helperName += ' ' + context; | |
} | |
options.fn = inverse; | |
options.inverse = fn; | |
options.helperName = options.helperName || helperName; | |
if (options.data.isUnbound) { | |
return helpers.unboundIf.call(options.contexts[0], context, options); | |
} else { | |
return helpers.boundIf.call(options.contexts[0], context, options); | |
} | |
} | |
/** | |
`bind-attr` allows you to create a binding between DOM element attributes and | |
Ember objects. For example: | |
```handlebars | |
<img {{bind-attr src="imageUrl" alt="imageTitle"}}> | |
``` | |
The above handlebars template will fill the `<img>`'s `src` attribute will | |
the value of the property referenced with `"imageUrl"` and its `alt` | |
attribute with the value of the property referenced with `"imageTitle"`. | |
If the rendering context of this template is the following object: | |
```javascript | |
{ | |
imageUrl: 'http://lolcats.info/haz-a-funny', | |
imageTitle: 'A humorous image of a cat' | |
} | |
``` | |
The resulting HTML output will be: | |
```html | |
<img src="http://lolcats.info/haz-a-funny" alt="A humorous image of a cat"> | |
``` | |
`bind-attr` cannot redeclare existing DOM element attributes. The use of `src` | |
in the following `bind-attr` example will be ignored and the hard coded value | |
of `src="/failwhale.gif"` will take precedence: | |
```handlebars | |
<img src="/failwhale.gif" {{bind-attr src="imageUrl" alt="imageTitle"}}> | |
``` | |
### `bind-attr` and the `class` attribute | |
`bind-attr` supports a special syntax for handling a number of cases unique | |
to the `class` DOM element attribute. The `class` attribute combines | |
multiple discrete values into a single attribute as a space-delimited | |
list of strings. Each string can be: | |
* a string return value of an object's property. | |
* a boolean return value of an object's property | |
* a hard-coded value | |
A string return value works identically to other uses of `bind-attr`. The | |
return value of the property will become the value of the attribute. For | |
example, the following view and template: | |
```javascript | |
AView = View.extend({ | |
someProperty: function() { | |
return "aValue"; | |
}.property() | |
}) | |
``` | |
```handlebars | |
<img {{bind-attr class="view.someProperty}}> | |
``` | |
Result in the following rendered output: | |
```html | |
<img class="aValue"> | |
``` | |
A boolean return value will insert a specified class name if the property | |
returns `true` and remove the class name if the property returns `false`. | |
A class name is provided via the syntax | |
`somePropertyName:class-name-if-true`. | |
```javascript | |
AView = View.extend({ | |
someBool: true | |
}) | |
``` | |
```handlebars | |
<img {{bind-attr class="view.someBool:class-name-if-true"}}> | |
``` | |
Result in the following rendered output: | |
```html | |
<img class="class-name-if-true"> | |
``` | |
An additional section of the binding can be provided if you want to | |
replace the existing class instead of removing it when the boolean | |
value changes: | |
```handlebars | |
<img {{bind-attr class="view.someBool:class-name-if-true:class-name-if-false"}}> | |
``` | |
A hard-coded value can be used by prepending `:` to the desired | |
class name: `:class-name-to-always-apply`. | |
```handlebars | |
<img {{bind-attr class=":class-name-to-always-apply"}}> | |
``` | |
Results in the following rendered output: | |
```html | |
<img class="class-name-to-always-apply"> | |
``` | |
All three strategies - string return value, boolean return value, and | |
hard-coded value – can be combined in a single declaration: | |
```handlebars | |
<img {{bind-attr class=":class-name-to-always-apply view.someBool:class-name-if-true view.someProperty"}}> | |
``` | |
@method bind-attr | |
@for Ember.Handlebars.helpers | |
@param {Hash} options | |
@return {String} HTML string | |
*/ | |
function bindAttrHelper(options) { | |
var attrs = options.hash; | |
Ember.assert("You must specify at least one hash argument to bind-attr", !!keys(attrs).length); | |
var view = options.data.view; | |
var ret = []; | |
// we relied on the behavior of calling without | |
// context to mean this === window, but when running | |
// "use strict", it's possible for this to === undefined; | |
var ctx = this || window; | |
// 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) { | |
var classResults = bindClasses(ctx, classBindings, view, dataId, options); | |
ret.push('class="' + Handlebars.Utils.escapeExpression(classResults.join(' ')) + '"'); | |
delete attrs['class']; | |
} | |
var attrKeys = 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], | |
normalized; | |
Ember.assert(fmt("You must provide an expression as the value of bound attribute. You specified: %@=%@", [attr, path]), typeof path === 'string'); | |
normalized = normalizePath(ctx, path, options.data); | |
var value = (path === 'this') ? normalized.root : handlebarsGet(ctx, path, options), | |
type = 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; | |
observer = function observer() { | |
var result = handlebarsGet(ctx, 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) { | |
removeObserver(normalized.root, normalized.path, observer); | |
return; | |
} | |
View.applyAttributeBindings(elem, attr, result); | |
}; | |
// 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. | |
// Note: don't add observer when path is 'this' or path | |
// is whole keyword e.g. {{#each x in list}} ... {{bind-attr attr="x"}} | |
if (path !== 'this' && !(normalized.isKeyword && normalized.path === '' )) { | |
view.registerObserver(normalized.root, normalized.path, observer); | |
} | |
// 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 SafeString(ret.join(' ')); | |
} | |
/** | |
See `bind-attr` | |
@method bindAttr | |
@for Ember.Handlebars.helpers | |
@deprecated | |
@param {Function} context | |
@param {Hash} options | |
@return {String} HTML string | |
*/ | |
function bindAttrHelperDeprecated() { | |
Ember.warn("The 'bindAttr' view helper is deprecated in favor of 'bind-attr'"); | |
return helpers['bind-attr'].apply(this, arguments); | |
} | |
/** | |
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. | |
@private | |
@method bindClasses | |
@for Ember.Handlebars | |
@param {Ember.Object} context The context from which to lookup properties | |
@param {String} classBindings A string, space-separated, of class bindings | |
to use | |
@param {View} view The view in which observers should look for the | |
element to update | |
@param {Srting} bindAttrId Optional bindAttr id used to lookup elements | |
@return {Array} An array of class names to add | |
*/ | |
function bindClasses(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 = handlebarsGet(root, path, options); | |
} | |
return 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; | |
var parsedPath = 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. | |
observer = function() { | |
// Get the current value of the property | |
newClass = classStringForPath(context, 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) { | |
removeObserver(pathRoot, path, observer); | |
} 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; | |
} | |
} | |
}; | |
if (path !== '' && path !== 'this') { | |
view.registerObserver(pathRoot, path, observer); | |
} | |
// 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(context, 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; | |
} | |
__exports__.bind = bind; | |
__exports__._triageMustacheHelper = _triageMustacheHelper; | |
__exports__.resolveHelper = resolveHelper; | |
__exports__.bindHelper = bindHelper; | |
__exports__.boundIfHelper = boundIfHelper; | |
__exports__.unboundIfHelper = unboundIfHelper; | |
__exports__.withHelper = withHelper; | |
__exports__.ifHelper = ifHelper; | |
__exports__.unlessHelper = unlessHelper; | |
__exports__.bindAttrHelper = bindAttrHelper; | |
__exports__.bindAttrHelperDeprecated = bindAttrHelperDeprecated; | |
__exports__.bindClasses = bindClasses; | |
}); | |
define("ember-handlebars/helpers/collection", | |
["ember-metal/core","ember-metal/utils","ember-handlebars-compiler","ember-runtime/system/string","ember-metal/property_get","ember-handlebars/ext","ember-handlebars/helpers/view","ember-metal/computed","ember-views/views/collection_view","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __dependency6__, __dependency7__, __dependency8__, __dependency9__, __exports__) { | |
"use strict"; | |
/** | |
@module ember | |
@submodule ember-handlebars | |
*/ | |
var Ember = __dependency1__["default"]; | |
// Ember.assert, Ember.deprecate | |
var inspect = __dependency2__.inspect; | |
// var emberAssert = Ember.assert; | |
// emberDeprecate = Ember.deprecate; | |
var EmberHandlebars = __dependency3__["default"]; | |
var helpers = EmberHandlebars.helpers; | |
var fmt = __dependency4__.fmt; | |
var get = __dependency5__.get; | |
var handlebarsGet = __dependency6__.handlebarsGet; | |
var ViewHelper = __dependency7__.ViewHelper; | |
var computed = __dependency8__.computed; | |
var CollectionView = __dependency9__["default"]; | |
var alias = computed.alias; | |
/** | |
`{{collection}}` is a `Ember.Handlebars` helper for adding instances of | |
`Ember.CollectionView` to a template. See [Ember.CollectionView](/api/classes/Ember.CollectionView.html) | |
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: | |
```handlebars | |
{{#collection contentBinding="App.items"}} | |
Hi {{view.content.name}} | |
{{/collection}} | |
``` | |
And the following application code | |
```javascript | |
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 | |
```html | |
<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 in a collection | |
If you provide an `itemViewClass` option that has its own `template` you can | |
omit the block. | |
The following template: | |
```handlebars | |
{{collection contentBinding="App.items" itemViewClass="App.AnItemView"}} | |
``` | |
And application code | |
```javascript | |
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 {{view.content.name}}") | |
}); | |
``` | |
Will result in the HTML structure below | |
```html | |
<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: | |
```handlebars | |
{{#collection App.MyCustomCollectionClass contentBinding="App.items"}} | |
Hi {{view.content.name}} | |
{{/collection}} | |
``` | |
### 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): | |
```handlebars | |
{{#collection contentBinding="App.items" | |
itemTagName="p" | |
itemClassNames="greeting"}} | |
Howdy {{view.content.name}} | |
{{/collection}} | |
``` | |
Will result in the following HTML structure: | |
```html | |
<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> | |
``` | |
@method collection | |
@for Ember.Handlebars.helpers | |
@param {String} path | |
@param {Hash} options | |
@return {String} HTML string | |
@deprecated Use `{{each}}` helper instead. | |
*/ | |
function collectionHelper(path, options) { | |
Ember.deprecate("Using the {{collection}} helper without specifying a class has been deprecated as the {{each}} helper now supports the same functionality.", path !== 'collection'); | |
// 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; | |
var view = options.data.view; | |
var controller, container; | |
// If passed a path string, convert that into an object. | |
// Otherwise, just default to the standard class. | |
var collectionClass; | |
if (path) { | |
controller = data.keywords.controller; | |
container = controller && controller.container; | |
collectionClass = handlebarsGet(this, path, options) || container.lookupFactory('view:' + path); | |
Ember.assert(fmt("%@ #collection: Could not find collection class %@", [data.view, path]), !!collectionClass); | |
} | |
else { | |
collectionClass = CollectionView; | |
} | |
var hash = options.hash, itemHash = {}, match; | |
// Extract item view class if provided else default to the standard class | |
var collectionPrototype = collectionClass.proto(), itemViewClass; | |
if (hash.itemView) { | |
controller = data.keywords.controller; | |
Ember.assert('You specified an itemView, but the current context has no ' + | |
'container to look the itemView up in. This probably means ' + | |
'that you created a view manually, instead of through the ' + | |
'container. Instead, use container.lookup("view:viewName"), ' + | |
'which will properly instantiate your view.', | |
controller && controller.container); | |
container = controller.container; | |
itemViewClass = container.lookupFactory('view:' + hash.itemView); | |
Ember.assert('You specified the itemView ' + hash.itemView + ", but it was " + | |
"not found at " + container.describe("view:" + hash.itemView) + | |
" (and it was not registered in the container)", !!itemViewClass); | |
} else if (hash.itemViewClass) { | |
itemViewClass = handlebarsGet(collectionPrototype, hash.itemViewClass, options); | |
} else { | |
itemViewClass = collectionPrototype.itemViewClass; | |
} | |
Ember.assert(fmt("%@ #collection: Could not find itemViewClass %@", [data.view, itemViewClass]), !!itemViewClass); | |
delete hash.itemViewClass; | |
delete hash.itemView; | |
// 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 && prop !== 'itemController') { | |
// 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]; | |
} | |
} | |
} | |
if (fn) { | |
itemHash.template = fn; | |
delete options.fn; | |
} | |
var emptyViewClass; | |
if (inverse && inverse !== EmberHandlebars.VM.noop) { | |
emptyViewClass = get(collectionPrototype, 'emptyViewClass'); | |
emptyViewClass = emptyViewClass.extend({ | |
template: inverse, | |
tagName: itemHash.tagName | |
}); | |
} else if (hash.emptyViewClass) { | |
emptyViewClass = handlebarsGet(this, hash.emptyViewClass, options); | |
} | |
if (emptyViewClass) { hash.emptyView = emptyViewClass; } | |
if (hash.keyword) { | |
itemHash._context = this; | |
} else { | |
itemHash._context = alias('content'); | |
} | |
var viewOptions = ViewHelper.propertiesFromHTMLOptions({ data: data, hash: itemHash }, this); | |
hash.itemViewClass = itemViewClass.extend(viewOptions); | |
options.helperName = options.helperName || 'collection'; | |
return helpers.view.call(this, collectionClass, options); | |
} | |
__exports__["default"] = collectionHelper; | |
}); | |
define("ember-handlebars/helpers/debug", | |
["ember-metal/core","ember-metal/utils","ember-metal/logger","ember-metal/property_get","ember-handlebars/ext","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __exports__) { | |
"use strict"; | |
/*jshint debug:true*/ | |
/** | |
@module ember | |
@submodule ember-handlebars | |
*/ | |
var Ember = __dependency1__["default"]; | |
// Ember.FEATURES, | |
var inspect = __dependency2__.inspect; | |
var Logger = __dependency3__["default"]; | |
var get = __dependency4__.get; | |
var normalizePath = __dependency5__.normalizePath; | |
var handlebarsGet = __dependency5__.handlebarsGet; | |
var a_slice = [].slice; | |
/** | |
`log` allows you to output the value of variables in the current rendering | |
context. `log` also accepts primitive types such as strings or numbers. | |
```handlebars | |
{{log "myVariable:" myVariable }} | |
``` | |
@method log | |
@for Ember.Handlebars.helpers | |
@param {String} property | |
*/ | |
function logHelper() { | |
var params = a_slice.call(arguments, 0, -1), | |
options = arguments[arguments.length - 1], | |
logger = Logger.log, | |
values = [], | |
allowPrimitives = true; | |
for (var i = 0; i < params.length; i++) { | |
var type = options.types[i]; | |
if (type === 'ID' || !allowPrimitives) { | |
var context = (options.contexts && options.contexts[i]) || this, | |
normalized = normalizePath(context, params[i], options.data); | |
if (normalized.path === 'this') { | |
values.push(normalized.root); | |
} else { | |
values.push(handlebarsGet(normalized.root, normalized.path, options)); | |
} | |
} else { | |
values.push(params[i]); | |
} | |
} | |
logger.apply(logger, values); | |
} | |
/** | |
Execute the `debugger` statement in the current context. | |
```handlebars | |
{{debugger}} | |
``` | |
Before invoking the `debugger` statement, there | |
are a few helpful variables defined in the | |
body of this helper that you can inspect while | |
debugging that describe how and where this | |
helper was invoked: | |
- templateContext: this is most likely a controller | |
from which this template looks up / displays properties | |
- typeOfTemplateContext: a string description of | |
what the templateContext is | |
For example, if you're wondering why a value `{{foo}}` | |
isn't rendering as expected within a template, you | |
could place a `{{debugger}}` statement, and when | |
the `debugger;` breakpoint is hit, you can inspect | |
`templateContext`, determine if it's the object you | |
expect, and/or evaluate expressions in the console | |
to perform property lookups on the `templateContext`: | |
``` | |
> templateContext.get('foo') // -> "<value of {{foo}}>" | |
``` | |
@method debugger | |
@for Ember.Handlebars.helpers | |
@param {String} property | |
*/ | |
function debuggerHelper(options) { | |
// These are helpful values you can inspect while debugging. | |
var templateContext = this; | |
var typeOfTemplateContext = inspect(templateContext); | |
debugger; | |
} | |
__exports__.logHelper = logHelper; | |
__exports__.debuggerHelper = debuggerHelper; | |
}); | |
define("ember-handlebars/helpers/each", | |
["ember-metal/core","ember-handlebars-compiler","ember-runtime/system/string","ember-metal/property_get","ember-metal/property_set","ember-views/views/collection_view","ember-metal/binding","ember-runtime/controllers/controller","ember-runtime/controllers/array_controller","ember-runtime/mixins/array","ember-runtime/copy","ember-metal/run_loop","ember-metal/events","ember-handlebars/ext","ember-metal/computed","ember-metal/observer","ember-handlebars/views/metamorph_view","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __dependency6__, __dependency7__, __dependency8__, __dependency9__, __dependency10__, __dependency11__, __dependency12__, __dependency13__, __dependency14__, __dependency15__, __dependency16__, __dependency17__, __exports__) { | |
"use strict"; | |
/** | |
@module ember | |
@submodule ember-handlebars | |
*/ | |
var Ember = __dependency1__["default"]; | |
// Ember.assert;, Ember.K | |
// var emberAssert = Ember.assert, | |
var K = Ember.K; | |
var EmberHandlebars = __dependency2__["default"]; | |
var helpers = EmberHandlebars.helpers; | |
var fmt = __dependency3__.fmt; | |
var get = __dependency4__.get; | |
var set = __dependency5__.set; | |
var CollectionView = __dependency6__["default"]; | |
var Binding = __dependency7__.Binding; | |
var ControllerMixin = __dependency8__.ControllerMixin; | |
var ArrayController = __dependency9__["default"]; | |
var EmberArray = __dependency10__["default"]; | |
var copy = __dependency11__["default"]; | |
var run = __dependency12__["default"]; | |
var on = __dependency13__.on; | |
var handlebarsGet = __dependency14__.handlebarsGet; | |
var computed = __dependency15__.computed; | |
var addObserver = __dependency16__.addObserver; | |
var removeObserver = __dependency16__.removeObserver; | |
var addBeforeObserver = __dependency16__.addBeforeObserver; | |
var removeBeforeObserver = __dependency16__.removeBeforeObserver; | |
var _Metamorph = __dependency17__._Metamorph; | |
var _MetamorphView = __dependency17__._MetamorphView; | |
var EachView = CollectionView.extend(_Metamorph, { | |
init: function() { | |
var itemController = get(this, 'itemController'); | |
var binding; | |
if (itemController) { | |
var controller = get(this, 'controller.container').lookupFactory('controller:array').create({ | |
_isVirtual: true, | |
parentController: get(this, 'controller'), | |
itemController: itemController, | |
target: get(this, 'controller'), | |
_eachView: this | |
}); | |
this.disableContentObservers(function() { | |
set(this, 'content', controller); | |
binding = new Binding('content', '_eachView.dataSource').oneWay(); | |
binding.connect(controller); | |
}); | |
set(this, '_arrayController', controller); | |
} else { | |
this.disableContentObservers(function() { | |
binding = new Binding('content', 'dataSource').oneWay(); | |
binding.connect(this); | |
}); | |
} | |
return this._super(); | |
}, | |
_assertArrayLike: function(content) { | |
Ember.assert(fmt("The value that #each loops over must be an Array. You " + | |
"passed %@, but it should have been an ArrayController", | |
[content.constructor]), | |
!ControllerMixin.detect(content) || | |
(content && content.isGenerated) || | |
content instanceof ArrayController); | |
Ember.assert(fmt("The value that #each loops over must be an Array. You passed %@", [(ControllerMixin.detect(content) && content.get('model') !== undefined) ? fmt("'%@' (wrapped in %@)", [content.get('model'), content]) : content]), EmberArray.detect(content)); | |
}, | |
disableContentObservers: function(callback) { | |
removeBeforeObserver(this, 'content', null, '_contentWillChange'); | |
removeObserver(this, 'content', null, '_contentDidChange'); | |
callback.call(this); | |
addBeforeObserver(this, 'content', null, '_contentWillChange'); | |
addObserver(this, 'content', null, '_contentDidChange'); | |
}, | |
itemViewClass: _MetamorphView, | |
emptyViewClass: _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'); | |
var content = get(view, 'content'); | |
if (keyword) { | |
var data = get(view, 'templateData'); | |
data = copy(data); | |
data.keywords = view.cloneKeywords(); | |
set(view, 'templateData', data); | |
// In this case, we do not bind, because the `content` of | |
// a #each item cannot change. | |
data.keywords[keyword] = content; | |
} | |
// If {{#each}} is looping over an array of controllers, | |
// point each child view at their respective controller. | |
if (content && content.isController) { | |
set(view, 'controller', content); | |
} | |
return view; | |
}, | |
destroy: function() { | |
if (!this._super()) { return; } | |
var arrayController = get(this, '_arrayController'); | |
if (arrayController) { | |
arrayController.destroy(); | |
} | |
return this; | |
} | |
}); | |
// Defeatureify doesn't seem to like nested functions that need to be removed | |
function _addMetamorphCheck() { | |
EachView.reopen({ | |
_checkMetamorph: on('didInsertElement', function() { | |
Ember.assert("The metamorph tags, " + | |
this.morph.start + " and " + this.morph.end + | |
", have different parents.\nThe browser has fixed your template to output valid HTML (for example, check that you have properly closed all tags and have used a TBODY tag when creating a table with '{{#each}}')", | |
document.getElementById( this.morph.start ).parentNode === | |
document.getElementById( this.morph.end ).parentNode | |
); | |
}) | |
}); | |
} | |
// until ember-debug is es6ed | |
var runInDebug = function(f){ f(); }; | |
runInDebug( function() { | |
_addMetamorphCheck(); | |
}); | |
var GroupedEach = EmberHandlebars.GroupedEach = function(context, path, options) { | |
var self = this, | |
normalized = EmberHandlebars.normalizePath(context, path, options.data); | |
this.context = context; | |
this.path = path; | |
this.options = options; | |
this.template = options.fn; | |
this.containingView = options.data.view; | |
this.normalizedRoot = normalized.root; | |
this.normalizedPath = normalized.path; | |
this.content = this.lookupContent(); | |
this.addContentObservers(); | |
this.addArrayObservers(); | |
this.containingView.on('willClearRender', function() { | |
self.destroy(); | |
}); | |
}; | |
GroupedEach.prototype = { | |
contentWillChange: function() { | |
this.removeArrayObservers(); | |
}, | |
contentDidChange: function() { | |
this.content = this.lookupContent(); | |
this.addArrayObservers(); | |
this.rerenderContainingView(); | |
}, | |
contentArrayWillChange: K, | |
contentArrayDidChange: function() { | |
this.rerenderContainingView(); | |
}, | |
lookupContent: function() { | |
return handlebarsGet(this.normalizedRoot, this.normalizedPath, this.options); | |
}, | |
addArrayObservers: function() { | |
if (!this.content) { return; } | |
this.content.addArrayObserver(this, { | |
willChange: 'contentArrayWillChange', | |
didChange: 'contentArrayDidChange' | |
}); | |
}, | |
removeArrayObservers: function() { | |
if (!this.content) { return; } | |
this.content.removeArrayObserver(this, { | |
willChange: 'contentArrayWillChange', | |
didChange: 'contentArrayDidChange' | |
}); | |
}, | |
addContentObservers: function() { | |
addBeforeObserver(this.normalizedRoot, this.normalizedPath, this, this.contentWillChange); | |
addObserver(this.normalizedRoot, this.normalizedPath, this, this.contentDidChange); | |
}, | |
removeContentObservers: function() { | |
removeBeforeObserver(this.normalizedRoot, this.normalizedPath, this.contentWillChange); | |
removeObserver(this.normalizedRoot, this.normalizedPath, this.contentDidChange); | |
}, | |
render: function() { | |
if (!this.content) { return; } | |
var content = this.content, | |
contentLength = get(content, 'length'), | |
options = this.options, | |
data = options.data, | |
template = this.template; | |
data.insideEach = true; | |
for (var i = 0; i < contentLength; i++) { | |
var context = content.objectAt(i); | |
options.data.keywords[options.hash.keyword] = context; | |
template(context, { data: data }); | |
} | |
}, | |
rerenderContainingView: function() { | |
var self = this; | |
run.scheduleOnce('render', this, function() { | |
// It's possible it's been destroyed after we enqueued a re-render call. | |
if (!self.destroyed) { | |
self.containingView.rerender(); | |
} | |
}); | |
}, | |
destroy: function() { | |
this.removeContentObservers(); | |
if (this.content) { | |
this.removeArrayObservers(); | |
} | |
this.destroyed = true; | |
} | |
}; | |
/** | |
The `{{#each}}` helper loops over elements in a collection, rendering its | |
block once for each item. It is an extension of the base Handlebars `{{#each}}` | |
helper: | |
```javascript | |
Developers = [{name: 'Yehuda'},{name: 'Tom'}, {name: 'Paul'}]; | |
``` | |
```handlebars | |
{{#each Developers}} | |
{{name}} | |
{{/each}} | |
``` | |
`{{each}}` supports an alternative syntax with element naming: | |
```handlebars | |
{{#each person in Developers}} | |
{{person.name}} | |
{{/each}} | |
``` | |
When looping over objects that do not have properties, `{{this}}` can be used | |
to render the object: | |
```javascript | |
DeveloperNames = ['Yehuda', 'Tom', 'Paul'] | |
``` | |
```handlebars | |
{{#each DeveloperNames}} | |
{{this}} | |
{{/each}} | |
``` | |
### {{else}} condition | |
`{{#each}}` can have a matching `{{else}}`. The contents of this block will render | |
if the collection is empty. | |
``` | |
{{#each person in Developers}} | |
{{person.name}} | |
{{else}} | |
<p>Sorry, nobody is available for this task.</p> | |
{{/each}} | |
``` | |
### Specifying a View class for items | |
If you provide an `itemViewClass` option that references a view class | |
with its own `template` you can omit the block. | |
The following template: | |
```handlebars | |
{{#view App.MyView }} | |
{{each view.items itemViewClass="App.AnItemView"}} | |
{{/view}} | |
``` | |
And application code | |
```javascript | |
App = Ember.Application.create({ | |
MyView: Ember.View.extend({ | |
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 {{name}}") | |
}); | |
``` | |
Will result in the HTML structure below | |
```html | |
<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> | |
``` | |
If an `itemViewClass` is defined on the helper, and therefore the helper is not | |
being used as a block, an `emptyViewClass` can also be provided optionally. | |
The `emptyViewClass` will match the behavior of the `{{else}}` condition | |
described above. That is, the `emptyViewClass` will render if the collection | |
is empty. | |
### Representing each item with a Controller. | |
By default the controller lookup within an `{{#each}}` block will be | |
the controller of the template where the `{{#each}}` was used. If each | |
item needs to be presented by a custom controller you can provide a | |
`itemController` option which references a controller by lookup name. | |
Each item in the loop will be wrapped in an instance of this controller | |
and the item itself will be set to the `model` property of that controller. | |
This is useful in cases where properties of model objects need transformation | |
or synthesis for display: | |
```javascript | |
App.DeveloperController = Ember.ObjectController.extend({ | |
isAvailableForHire: function() { | |
return !this.get('model.isEmployed') && this.get('model.isSeekingWork'); | |
}.property('isEmployed', 'isSeekingWork') | |
}) | |
``` | |
```handlebars | |
{{#each person in developers itemController="developer"}} | |
{{person.name}} {{#if person.isAvailableForHire}}Hire me!{{/if}} | |
{{/each}} | |
``` | |
Each itemController will receive a reference to the current controller as | |
a `parentController` property. | |
### (Experimental) Grouped Each | |
When used in conjunction with the experimental [group helper](https://github.com/emberjs/group-helper), | |
you can inform Handlebars to re-render an entire group of items instead of | |
re-rendering them one at a time (in the event that they are changed en masse | |
or an item is added/removed). | |
```handlebars | |
{{#group}} | |
{{#each people}} | |
{{firstName}} {{lastName}} | |
{{/each}} | |
{{/group}} | |
``` | |
This can be faster than the normal way that Handlebars re-renders items | |
in some cases. | |
If for some reason you have a group with more than one `#each`, you can make | |
one of the collections be updated in normal (non-grouped) fashion by setting | |
the option `groupedRows=true` (counter-intuitive, I know). | |
For example, | |
```handlebars | |
{{dealershipName}} | |
{{#group}} | |
{{#each dealers}} | |
{{firstName}} {{lastName}} | |
{{/each}} | |
{{#each car in cars groupedRows=true}} | |
{{car.make}} {{car.model}} {{car.color}} | |
{{/each}} | |
{{/group}} | |
``` | |
Any change to `dealershipName` or the `dealers` collection will cause the | |
entire group to be re-rendered. However, changes to the `cars` collection | |
will be re-rendered individually (as normal). | |
Note that `group` behavior is also disabled by specifying an `itemViewClass`. | |
@method each | |
@for Ember.Handlebars.helpers | |
@param [name] {String} name for item (used with `in`) | |
@param [path] {String} path | |
@param [options] {Object} Handlebars key/value pairs of options | |
@param [options.itemViewClass] {String} a path to a view class used for each item | |
@param [options.itemController] {String} name of a controller to be created for each item | |
@param [options.groupedRows] {boolean} enable normal item-by-item rendering when inside a `#group` helper | |
*/ | |
function eachHelper(path, options) { | |
var ctx, helperName = 'each'; | |
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]; | |
helperName += ' ' + keywordName + ' in ' + path; | |
if (path === '') { path = "this"; } | |
options.hash.keyword = keywordName; | |
} else if (arguments.length === 1) { | |
options = path; | |
path = 'this'; | |
} else { | |
helperName += ' ' + path; | |
} | |
options.hash.dataSourceBinding = path; | |
// Set up emptyView as a metamorph with no tag | |
//options.hash.emptyViewClass = Ember._MetamorphView; | |
// can't rely on this default behavior when use strict | |
ctx = this || window; | |
options.helperName = options.helperName || helperName; | |
if (options.data.insideGroup && !options.hash.groupedRows && !options.hash.itemViewClass) { | |
new GroupedEach(ctx, path, options).render(); | |
} else { | |
// ES6TODO: figure out how to do this without global lookup. | |
return helpers.collection.call(ctx, 'Ember.Handlebars.EachView', options); | |
} | |
} | |
__exports__.EachView = EachView; | |
__exports__.GroupedEach = GroupedEach; | |
__exports__.eachHelper = eachHelper; | |
}); | |
define("ember-handlebars/helpers/loc", | |
["ember-runtime/system/string","exports"], | |
function(__dependency1__, __exports__) { | |
"use strict"; | |
var loc = __dependency1__.loc; | |
/** | |
@module ember | |
@submodule ember-handlebars | |
*/ | |
// ES6TODO: | |
// Pretty sure this can be expressed as | |
// var locHelper EmberStringUtils.loc ? | |
/** | |
Calls [Ember.String.loc](/api/classes/Ember.String.html#method_loc) with the | |
provided string. | |
This is a convenient way to localize text. For example: | |
```html | |
<script type="text/x-handlebars" data-template-name="home"> | |
{{loc "welcome"}} | |
</script> | |
``` | |
Take note that `"welcome"` is a string and not an object | |
reference. | |
See [Ember.String.loc](/api/classes/Ember.String.html#method_loc) for how to | |
set up localized string references. | |
@method loc | |
@for Ember.Handlebars.helpers | |
@param {String} str The string to format | |
@see {Ember.String#loc} | |
*/ | |
__exports__["default"] = function locHelper(str) { | |
return loc(str); | |
} | |
}); | |
define("ember-handlebars/helpers/partial", | |
["ember-metal/core","ember-metal/is_none","ember-handlebars/ext","ember-handlebars/helpers/binding","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __exports__) { | |
"use strict"; | |
var Ember = __dependency1__["default"]; | |
// Ember.assert | |
// var emberAssert = Ember.assert; | |
var isNone = __dependency2__.isNone; | |
var handlebarsGet = __dependency3__.handlebarsGet; | |
var bind = __dependency4__.bind; | |
/** | |
@module ember | |
@submodule ember-handlebars | |
*/ | |
/** | |
The `partial` helper renders another template without | |
changing the template context: | |
```handlebars | |
{{foo}} | |
{{partial "nav"}} | |
``` | |
The above example template will render a template named | |
"_nav", which has the same context as the parent template | |
it's rendered into, so if the "_nav" template also referenced | |
`{{foo}}`, it would print the same thing as the `{{foo}}` | |
in the above example. | |
If a "_nav" template isn't found, the `partial` helper will | |
fall back to a template named "nav". | |
## Bound template names | |
The parameter supplied to `partial` can also be a path | |
to a property containing a template name, e.g.: | |
```handlebars | |
{{partial someTemplateName}} | |
``` | |
The above example will look up the value of `someTemplateName` | |
on the template context (e.g. a controller) and use that | |
value as the name of the template to render. If the resolved | |
value is falsy, nothing will be rendered. If `someTemplateName` | |
changes, the partial will be re-rendered using the new template | |
name. | |
## Setting the partial's context with `with` | |
The `partial` helper can be used in conjunction with the `with` | |
helper to set a context that will be used by the partial: | |
```handlebars | |
{{#with currentUser}} | |
{{partial "user_info"}} | |
{{/with}} | |
``` | |
@method partial | |
@for Ember.Handlebars.helpers | |
@param {String} partialName the name of the template to render minus the leading underscore | |
*/ | |
__exports__["default"] = function partialHelper(name, options) { | |
var context = (options.contexts && options.contexts.length) ? options.contexts[0] : this; | |
options.helperName = options.helperName || 'partial'; | |
if (options.types[0] === "ID") { | |
// Helper was passed a property path; we need to | |
// create a binding that will re-render whenever | |
// this property changes. | |
options.fn = function(context, fnOptions) { | |
var partialName = handlebarsGet(context, name, fnOptions); | |
renderPartial(context, partialName, fnOptions); | |
}; | |
return bind.call(context, name, options, true, exists); | |
} else { | |
// Render the partial right into parent template. | |
renderPartial(context, name, options); | |
} | |
} | |
function exists(value) { | |
return !isNone(value); | |
} | |
function renderPartial(context, name, options) { | |
var nameParts = name.split("/"), | |
lastPart = nameParts[nameParts.length - 1]; | |
nameParts[nameParts.length - 1] = "_" + lastPart; | |
var view = options.data.view, | |
underscoredName = nameParts.join("/"), | |
template = view.templateForName(underscoredName), | |
deprecatedTemplate = !template && view.templateForName(name); | |
Ember.assert("Unable to find partial with name '"+name+"'.", template || deprecatedTemplate); | |
template = template || deprecatedTemplate; | |
template(context, { data: options.data }); | |
} | |
}); | |
define("ember-handlebars/helpers/shared", | |
["ember-handlebars/ext","exports"], | |
function(__dependency1__, __exports__) { | |
"use strict"; | |
var handlebarsGet = __dependency1__.handlebarsGet; | |
__exports__["default"] = function resolvePaths(options) { | |
var ret = [], | |
contexts = options.contexts, | |
roots = options.roots, | |
data = options.data; | |
for (var i=0, l=contexts.length; i<l; i++) { | |
ret.push(handlebarsGet(roots[i], contexts[i], { data: data })); | |
} | |
return ret; | |
} | |
}); | |
define("ember-handlebars/helpers/template", | |
["ember-metal/core","ember-handlebars-compiler","exports"], | |
function(__dependency1__, __dependency2__, __exports__) { | |
"use strict"; | |
var Ember = __dependency1__["default"]; | |
// var emberDeprecate = Ember.deprecate; | |
var EmberHandlebars = __dependency2__["default"]; | |
var helpers = EmberHandlebars.helpers; | |
/** | |
@module ember | |
@submodule ember-handlebars | |
*/ | |
/** | |
`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: | |
```html | |
<script type="text/x-handlebars" data-template-name="logged_in_user"> | |
{{#with loggedInUser}} | |
Last Login: {{lastLogin}} | |
User Info: {{template "user_info"}} | |
{{/with}} | |
</script> | |
``` | |
```html | |
<script type="text/x-handlebars" data-template-name="user_info"> | |
Name: <em>{{name}}</em> | |
Karma: <em>{{karma}}</em> | |
</script> | |
``` | |
```handlebars | |
{{#if isUser}} | |
{{template "user_info"}} | |
{{else}} | |
{{template "unlogged_user_info"}} | |
{{/if}} | |
``` | |
This helper looks for templates in the global `Ember.TEMPLATES` hash. If you | |
add `<script>` 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: | |
```javascript | |
Ember.TEMPLATES["my_cool_template"] = Ember.Handlebars.compile('<b>{{user}}</b>'); | |
``` | |
@deprecated | |
@method template | |
@for Ember.Handlebars.helpers | |
@param {String} templateName the template to render | |
*/ | |
__exports__["default"] = function templateHelper(name, options) { | |
Ember.deprecate("The `template` helper has been deprecated in favor of the `partial` helper. Please use `partial` instead, which will work the same way."); | |
options.helperName = options.helperName || 'template'; | |
return helpers.partial.apply(this, arguments); | |
} | |
}); | |
define("ember-handlebars/helpers/unbound", | |
["ember-handlebars-compiler","ember-handlebars/helpers/binding","ember-handlebars/ext","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __exports__) { | |
"use strict"; | |
/*globals Handlebars */ | |
/** | |
@module ember | |
@submodule ember-handlebars | |
*/ | |
var EmberHandlebars = __dependency1__["default"]; | |
var helpers = EmberHandlebars.helpers; | |
var resolveHelper = __dependency2__.resolveHelper; | |
var handlebarsGet = __dependency3__.handlebarsGet; | |
var slice = [].slice; | |
/** | |
`unbound` allows you to output a property without binding. *Important:* The | |
output will not be updated if the property changes. Use with caution. | |
```handlebars | |
<div>{{unbound somePropertyThatDoesntChange}}</div> | |
``` | |
`unbound` can also be used in conjunction with a bound helper to | |
render it in its unbound form: | |
```handlebars | |
<div>{{unbound helperName somePropertyThatDoesntChange}}</div> | |
``` | |
@method unbound | |
@for Ember.Handlebars.helpers | |
@param {String} property | |
@return {String} HTML string | |
*/ | |
__exports__["default"] = function unboundHelper(property, fn) { | |
var options = arguments[arguments.length - 1], | |
container = options.data.view.container, | |
helper, context, out, ctx; | |
ctx = this; | |
if (arguments.length > 2) { | |
// Unbound helper call. | |
options.data.isUnbound = true; | |
helper = resolveHelper(container, property) || helpers.helperMissing; | |
out = helper.apply(ctx, slice.call(arguments, 1)); | |
delete options.data.isUnbound; | |
return out; | |
} | |
context = (fn.contexts && fn.contexts.length) ? fn.contexts[0] : ctx; | |
return handlebarsGet(context, property, fn); | |
} | |
}); | |
define("ember-handlebars/helpers/view", | |
["ember-metal/core","ember-runtime/system/object","ember-metal/property_get","ember-metal/property_set","ember-metal/mixin","ember-views/system/jquery","ember-views/views/view","ember-metal/binding","ember-handlebars/ext","ember-runtime/system/string","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __dependency6__, __dependency7__, __dependency8__, __dependency9__, __dependency10__, __exports__) { | |
"use strict"; | |
/*globals Handlebars */ | |
/** | |
@module ember | |
@submodule ember-handlebars | |
*/ | |
var Ember = __dependency1__["default"]; | |
// Ember.warn, Ember.assert | |
// var emberWarn = Ember.warn, emberAssert = Ember.assert; | |
var EmberObject = __dependency2__["default"]; | |
var get = __dependency3__.get; | |
var set = __dependency4__.set; | |
var IS_BINDING = __dependency5__.IS_BINDING; | |
var jQuery = __dependency6__["default"]; | |
var View = __dependency7__.View; | |
var isGlobalPath = __dependency8__.isGlobalPath; | |
var normalizePath = __dependency9__.normalizePath; | |
var handlebarsGet = __dependency9__.handlebarsGet; | |
var EmberString = __dependency10__["default"]; | |
var LOWERCASE_A_Z = /^[a-z]/, | |
VIEW_PREFIX = /^view\./; | |
function makeBindings(thisContext, options) { | |
var hash = options.hash, | |
hashType = options.hashTypes; | |
for (var prop in hash) { | |
if (hashType[prop] === 'ID') { | |
var value = hash[prop]; | |
if (IS_BINDING.test(prop)) { | |
Ember.warn("You're attempting to render a view by passing " + prop + "=" + value + " to a view helper, but this syntax is ambiguous. You should either surround " + value + " in quotes or remove `Binding` from " + prop + "."); | |
} else { | |
hash[prop + 'Binding'] = value; | |
hashType[prop + 'Binding'] = 'STRING'; | |
delete hash[prop]; | |
delete hashType[prop]; | |
} | |
} | |
} | |
if (hash.hasOwnProperty('idBinding')) { | |
// id can't be bound, so just perform one-time lookup. | |
hash.id = handlebarsGet(thisContext, hash.idBinding, options); | |
hashType.id = 'STRING'; | |
delete hash.idBinding; | |
delete hashType.idBinding; | |
} | |
} | |
var ViewHelper = EmberObject.create({ | |
propertiesFromHTMLOptions: function(options) { | |
var hash = options.hash, data = options.data; | |
var extensions = {}, | |
classes = hash['class'], | |
dup = false; | |
if (hash.id) { | |
extensions.elementId = hash.id; | |
dup = true; | |
} | |
if (hash.tag) { | |
extensions.tagName = hash.tag; | |
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 = jQuery.extend({}, hash); | |
delete hash.id; | |
delete hash.tag; | |
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 (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="_parentView.context.isGreen:green" | |
var parsedPath = View._parsePropertyPath(full); | |
path = this.contextualizeBindingPath(parsedPath.path, data); | |
if (path) { extensions.classNameBindings[b] = path + parsedPath.classNames; } | |
} | |
} | |
} | |
return jQuery.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 = normalizePath(null, path, data); | |
if (normalized.isKeyword) { | |
return 'templateData.keywords.' + path; | |
} else if (isGlobalPath(path)) { | |
return null; | |
} else if (path === 'this' || path === '') { | |
return '_parentView.context'; | |
} else { | |
return '_parentView.context.' + path; | |
} | |
}, | |
helper: function(thisContext, path, options) { | |
var data = options.data, | |
fn = options.fn, | |
newView; | |
makeBindings(thisContext, options); | |
if ('string' === typeof path) { | |
// TODO: this is a lame conditional, this should likely change | |
// but something along these lines will likely need to be added | |
// as deprecation warnings | |
// | |
if (options.types[0] === 'STRING' && LOWERCASE_A_Z.test(path) && !VIEW_PREFIX.test(path)) { | |
Ember.assert("View requires a container", !!data.view.container); | |
newView = data.view.container.lookupFactory('view:' + path); | |
} else { | |
newView = handlebarsGet(thisContext, path, options); | |
} | |
Ember.assert("Unable to find view at path '" + path + "'", !!newView); | |
} else { | |
newView = path; | |
} | |
Ember.assert(EmberString.fmt('You must pass a view to the #view helper, not %@ (%@)', [path, newView]), View.detect(newView) || View.detectInstance(newView)); | |
var viewOptions = this.propertiesFromHTMLOptions(options, thisContext); | |
var currentView = data.view; | |
viewOptions.templateData = data; | |
var newViewProto = newView.proto ? newView.proto() : newView; | |
if (fn) { | |
Ember.assert("You cannot provide a template block if you also specified a templateName", !get(viewOptions, 'templateName') && !get(newViewProto, '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 (!newViewProto.controller && !newViewProto.controllerBinding && !viewOptions.controller && !viewOptions.controllerBinding) { | |
viewOptions._context = thisContext; | |
} | |
// for instrumentation | |
if (options.helperName) { | |
viewOptions.helperName = options.helperName; | |
} | |
currentView.appendChild(newView, viewOptions); | |
} | |
}); | |
__exports__.ViewHelper = ViewHelper; | |
/** | |
`{{view}}` inserts a new instance of an `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: | |
```handlebars | |
A span: | |
{{#view tagName="span"}} | |
hello. | |
{{/view}} | |
``` | |
Will result in HTML structure: | |
```html | |
<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. | |
```javascript | |
aView = Ember.View.create({ | |
template: Ember.Handlebars.compile("{{#view}} my parent: {{parentView.elementId}} {{/view}}") | |
}); | |
aView.appendTo('body'); | |
``` | |
Will result in HTML structure: | |
```html | |
<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`. | |
```handlebars | |
{{#view tagName="span" id="a-custom-id"}} | |
hello. | |
{{/view}} | |
``` | |
Results in the following HTML structure: | |
```html | |
<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: | |
```handlebars | |
{{#view tagName="span" class="a-custom-class"}} | |
hello. | |
{{/view}} | |
``` | |
Results in the following HTML structure: | |
```html | |
<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. | |
```handlebars | |
{{#view "MyApp.CustomView"}} | |
hello. | |
{{/view}} | |
``` | |
The first argument can also be a relative path accessible from the current | |
context. | |
```javascript | |
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 "view.innerViewClass"}} hi {{/view}}') | |
}); | |
MyApp.OuterView.create().appendTo('body'); | |
``` | |
Will result in the following HTML: | |
```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. | |
```handlebars | |
{{view "MyApp.ViewWithATemplateDefined"}} | |
``` | |
### `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. | |
```javascript | |
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 | |
``` | |
@method view | |
@for Ember.Handlebars.helpers | |
@param {String} path | |
@param {Hash} options | |
@return {String} HTML string | |
*/ | |
function viewHelper(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 | |
// and get an instance of the registered `view:default` | |
if (path && path.data && path.data.isRenderData) { | |
options = path; | |
Ember.assert('{{view}} helper requires parent view to have a container but none was found. This usually happens when you are manually-managing views.', !!options.data.view.container); | |
path = options.data.view.container.lookupFactory('view:default'); | |
} | |
options.helperName = options.helperName || 'view'; | |
return ViewHelper.helper(this, path, options); | |
} | |
__exports__.viewHelper = viewHelper; | |
}); | |
define("ember-handlebars/helpers/yield", | |
["ember-metal/core","ember-metal/property_get","exports"], | |
function(__dependency1__, __dependency2__, __exports__) { | |
"use strict"; | |
/** | |
@module ember | |
@submodule ember-handlebars | |
*/ | |
var Ember = __dependency1__["default"]; | |
// var emberAssert = Ember.assert; | |
var get = __dependency2__.get; | |
/** | |
`{{yield}}` denotes an area of a template that will be rendered inside | |
of another template. It has two main uses: | |
### Use with `layout` | |
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: | |
```javascript | |
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: | |
```html | |
<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. | |
```javascript | |
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 | |
``` | |
### Use with Ember.Component | |
When designing components `{{yield}}` is used to denote where, inside the component's | |
template, an optional block passed to the component should render: | |
```handlebars | |
<!-- application.hbs --> | |
{{#labeled-textfield value=someProperty}} | |
First name: | |
{{/labeled-textfield}} | |
``` | |
```handlebars | |
<!-- components/labeled-textfield.hbs --> | |
<label> | |
{{yield}} {{input value=value}} | |
</label> | |
``` | |
Result: | |
```html | |
<label> | |
First name: <input type="text" /> | |
</label> | |
``` | |
@method yield | |
@for Ember.Handlebars.helpers | |
@param {Hash} options | |
@return {String} HTML string | |
*/ | |
__exports__["default"] = function yieldHelper(options) { | |
var view = options.data.view; | |
while (view && !get(view, 'layout')) { | |
if (view._contextView) { | |
view = view._contextView; | |
} else { | |
view = get(view, '_parentView'); | |
} | |
} | |
Ember.assert("You called yield in a template that was not a layout", !!view); | |
view._yield(this, options); | |
} | |
}); | |
define("ember-handlebars/loader", | |
["ember-handlebars/component_lookup","ember-views/system/jquery","ember-metal/error","ember-runtime/system/lazy_load","ember-handlebars-compiler","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __exports__) { | |
"use strict"; | |
/*globals Handlebars */ | |
var ComponentLookup = __dependency1__["default"]; | |
var jQuery = __dependency2__["default"]; | |
var EmberError = __dependency3__["default"]; | |
var onLoad = __dependency4__.onLoad; | |
var EmberHandlebars = __dependency5__["default"]; | |
/** | |
@module ember | |
@submodule ember-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. | |
@private | |
@method bootstrap | |
@for Ember.Handlebars | |
@static | |
@param ctx | |
*/ | |
function bootstrap(ctx) { | |
var selectors = 'script[type="text/x-handlebars"], script[type="text/x-raw-handlebars"]'; | |
jQuery(selectors, ctx) | |
.each(function() { | |
// Get a reference to the script tag | |
var script = jQuery(this); | |
var compile = (script.attr('type') === 'text/x-raw-handlebars') ? | |
jQuery.proxy(Handlebars.compile, Handlebars) : | |
jQuery.proxy(EmberHandlebars.compile, EmberHandlebars), | |
// 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') || 'application', | |
template = compile(script.html()); | |
// Check if template of same name already exists | |
if (Ember.TEMPLATES[templateName] !== undefined) { | |
throw new EmberError('Template named "' + templateName + '" already exists.'); | |
} | |
// 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(); | |
}); | |
} | |
function _bootstrap() { | |
bootstrap( jQuery(document) ); | |
} | |
function registerComponentLookup(container) { | |
container.register('component-lookup:main', ComponentLookup); | |
} | |
/* | |
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. | |
*/ | |
onLoad('Ember.Application', function(Application) { | |
Application.initializer({ | |
name: 'domTemplates', | |
initialize: _bootstrap | |
}); | |
Application.initializer({ | |
name: 'registerComponentLookup', | |
after: 'domTemplates', | |
initialize: registerComponentLookup | |
}); | |
}); | |
__exports__["default"] = bootstrap; | |
}); | |
define("ember-handlebars/string", | |
["ember-runtime/system/string","exports"], | |
function(__dependency1__, __exports__) { | |
"use strict"; | |
// required so we can extend this object. | |
var EmberStringUtils = __dependency1__["default"]; | |
/** | |
Mark a string as safe for unescaped output with Handlebars. If you | |
return HTML from a Handlebars helper, use this function to | |
ensure Handlebars does not escape the HTML. | |
```javascript | |
Ember.String.htmlSafe('<div>someString</div>') | |
``` | |
@method htmlSafe | |
@for Ember.String | |
@static | |
@return {Handlebars.SafeString} a string that will not be html escaped by Handlebars | |
*/ | |
function htmlSafe(str) { | |
return new Handlebars.SafeString(str); | |
} | |
EmberStringUtils.htmlSafe = htmlSafe; | |
if (Ember.EXTEND_PROTOTYPES === true || Ember.EXTEND_PROTOTYPES.String) { | |
/** | |
Mark a string as being safe for unescaped output with Handlebars. | |
```javascript | |
'<div>someString</div>'.htmlSafe() | |
``` | |
See [Ember.String.htmlSafe](/api/classes/Ember.String.html#method_htmlSafe). | |
@method htmlSafe | |
@for String | |
@return {Handlebars.SafeString} a string that will not be html escaped by Handlebars | |
*/ | |
String.prototype.htmlSafe = function() { | |
return htmlSafe(this); | |
}; | |
} | |
__exports__["default"] = htmlSafe; | |
}); | |
define("ember-handlebars/views/handlebars_bound_view", | |
["ember-handlebars-compiler","ember-metal/core","ember-metal/error","ember-metal/property_get","ember-metal/property_set","ember-metal/merge","ember-metal/run_loop","ember-metal/computed","ember-views/views/view","ember-views/views/states","ember-handlebars/views/metamorph_view","ember-handlebars/ext","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __dependency6__, __dependency7__, __dependency8__, __dependency9__, __dependency10__, __dependency11__, __dependency12__, __exports__) { | |
"use strict"; | |
/*globals Handlebars, Metamorph:true */ | |
/*jshint newcap:false*/ | |
/** | |
@module ember | |
@submodule ember-handlebars | |
*/ | |
var EmberHandlebars = __dependency1__["default"]; | |
// EmberHandlebars.SafeString; | |
var SafeString = EmberHandlebars.SafeString; | |
var Ember = __dependency2__["default"]; | |
// Ember.K | |
var K = Ember.K; | |
var Metamorph = requireModule('metamorph'); | |
var EmberError = __dependency3__["default"]; | |
var get = __dependency4__.get; | |
var set = __dependency5__.set; | |
var merge = __dependency6__["default"]; | |
var run = __dependency7__["default"]; | |
var computed = __dependency8__.computed; | |
var View = __dependency9__.View; | |
var cloneStates = __dependency10__.cloneStates; | |
var states = __dependency10__.states; | |
var viewStates = states; | |
var _MetamorphView = __dependency11__._MetamorphView; | |
var handlebarsGet = __dependency12__.handlebarsGet; | |
function SimpleHandlebarsView(path, pathRoot, isEscaped, templateData) { | |
this.path = path; | |
this.pathRoot = pathRoot; | |
this.isEscaped = isEscaped; | |
this.templateData = templateData; | |
this.morph = Metamorph(); | |
this.state = 'preRender'; | |
this.updateId = null; | |
this._parentView = null; | |
this.buffer = null; | |
} | |
SimpleHandlebarsView.prototype = { | |
isVirtual: true, | |
isView: true, | |
destroy: function () { | |
if (this.updateId) { | |
run.cancel(this.updateId); | |
this.updateId = null; | |
} | |
if (this._parentView) { | |
this._parentView.removeChild(this); | |
} | |
this.morph = null; | |
this.state = 'destroyed'; | |
}, | |
propertyWillChange: K, | |
propertyDidChange: K, | |
normalizedValue: function() { | |
var path = this.path, | |
pathRoot = this.pathRoot, | |
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 = this.templateData; | |
result = handlebarsGet(pathRoot, path, { data: templateData }); | |
} | |
return result; | |
}, | |
renderToBuffer: function(buffer) { | |
var string = ''; | |
string += this.morph.startTag(); | |
string += this.render(); | |
string += this.morph.endTag(); | |
buffer.push(string); | |
}, | |
render: function() { | |
// If not invoked via a triple-mustache ({{{foo}}}), escape | |
// the content of the template. | |
var escape = this.isEscaped; | |
var result = this.normalizedValue(); | |
if (result === null || result === undefined) { | |
result = ""; | |
} else if (!(result instanceof SafeString)) { | |
result = String(result); | |
} | |
if (escape) { result = Handlebars.Utils.escapeExpression(result); } | |
return result; | |
}, | |
rerender: function() { | |
switch(this.state) { | |
case 'preRender': | |
case 'destroyed': | |
break; | |
case 'inBuffer': | |
throw new EmberError("Something you did tried to replace an {{expression}} before it was inserted into the DOM."); | |
case 'hasElement': | |
case 'inDOM': | |
this.updateId = run.scheduleOnce('render', this, 'update'); | |
break; | |
} | |
return this; | |
}, | |
update: function () { | |
this.updateId = null; | |
this.morph.html(this.render()); | |
}, | |
transitionTo: function(state) { | |
this.state = state; | |
} | |
}; | |
states = cloneStates(viewStates); | |
merge(states._default, { | |
rerenderIfNeeded: K | |
}); | |
merge(states.inDOM, { | |
rerenderIfNeeded: function(view) { | |
if (view.normalizedValue() !== view._lastNormalizedValue) { | |
view.rerender(); | |
} | |
} | |
}); | |
/** | |
`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. | |
@class _HandlebarsBoundView | |
@namespace Ember | |
@extends Ember._MetamorphView | |
@private | |
*/ | |
var _HandlebarsBoundView = _MetamorphView.extend({ | |
instrumentName: 'boundHandlebars', | |
_states: states, | |
/** | |
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. | |
@property shouldDisplayFunc | |
@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`. | |
@property preserveContext | |
@type Boolean | |
@default false | |
*/ | |
preserveContext: false, | |
/** | |
If `preserveContext` is true, this is the object that will be used | |
to render the template. | |
@property previousContext | |
@type Object | |
*/ | |
previousContext: null, | |
/** | |
The template to render when `shouldDisplayFunc` evaluates to `true`. | |
@property displayTemplate | |
@type Function | |
@default null | |
*/ | |
displayTemplate: null, | |
/** | |
The template to render when `shouldDisplayFunc` evaluates to `false`. | |
@property inverseTemplate | |
@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. | |
@property path | |
@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. | |
@property pathRoot | |
@type Object | |
*/ | |
pathRoot: null, | |
normalizedValue: 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 = handlebarsGet(pathRoot, path, { data: templateData }); | |
} | |
return valueNormalizer ? valueNormalizer(result) : result; | |
}, | |
rerenderIfNeeded: function() { | |
this.currentState.rerenderIfNeeded(this); | |
}, | |
/** | |
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`. | |
@method render | |
@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 = 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 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); | |
} | |
}); | |
__exports__._HandlebarsBoundView = _HandlebarsBoundView; | |
__exports__.SimpleHandlebarsView = SimpleHandlebarsView; | |
}); | |
define("ember-handlebars/views/metamorph_view", | |
["ember-metal/core","ember-metal/property_get","ember-metal/property_set","ember-views/views/view","ember-metal/mixin","ember-metal/run_loop","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __dependency6__, __exports__) { | |
"use strict"; | |
/* global Metamorph:true */ | |
/*jshint newcap:false*/ | |
var Ember = __dependency1__["default"]; | |
// Ember.deprecate | |
// var emberDeprecate = Ember.deprecate; | |
var get = __dependency2__.get; | |
var set = __dependency3__["default"]; | |
var CoreView = __dependency4__.CoreView; | |
var View = __dependency4__.View; | |
var Mixin = __dependency5__.Mixin; | |
var run = __dependency6__["default"]; | |
/** | |
@module ember | |
@submodule ember-handlebars | |
*/ | |
var Metamorph = requireModule('metamorph'); | |
function notifyMutationListeners() { | |
run.once(View, 'notifyMutationListeners'); | |
} | |
// DOMManager should just abstract dom manipulation between jquery and metamorph | |
var DOMManager = { | |
remove: function(view) { | |
view.morph.remove(); | |
notifyMutationListeners(); | |
}, | |
prepend: function(view, html) { | |
view.morph.prepend(html); | |
notifyMutationListeners(); | |
}, | |
after: function(view, html) { | |
view.morph.after(html); | |
notifyMutationListeners(); | |
}, | |
html: function(view, html) { | |
view.morph.html(html); | |
notifyMutationListeners(); | |
}, | |
// This is messed up. | |
replace: function(view) { | |
var morph = view.morph; | |
view.transitionTo('preRender'); | |
run.schedule('render', this, function renderMetamorphView() { | |
if (view.isDestroying) { return; } | |
view.clearRenderedChildren(); | |
var buffer = view.renderToBuffer(); | |
view.invokeRecursively(function(view) { | |
view.propertyWillChange('element'); | |
}); | |
view.triggerRecursively('willInsertElement'); | |
morph.replaceWith(buffer.string()); | |
view.transitionTo('inDOM'); | |
view.invokeRecursively(function(view) { | |
view.propertyDidChange('element'); | |
}); | |
view.triggerRecursively('didInsertElement'); | |
notifyMutationListeners(); | |
}); | |
}, | |
empty: function(view) { | |
view.morph.html(""); | |
notifyMutationListeners(); | |
} | |
}; | |
// The `morph` and `outerHTML` properties are internal only | |
// and not observable. | |
/** | |
@class _Metamorph | |
@namespace Ember | |
@private | |
*/ | |
var _Metamorph = Mixin.create({ | |
isVirtual: true, | |
tagName: '', | |
instrumentName: 'metamorph', | |
init: function() { | |
this._super(); | |
this.morph = Metamorph(); | |
Ember.deprecate('Supplying a tagName to Metamorph views is unreliable and is deprecated. You may be setting the tagName on a Handlebars helper that creates a Metamorph.', !this.tagName); | |
}, | |
beforeRender: function(buffer) { | |
buffer.push(this.morph.startTag()); | |
buffer.pushOpeningTag(); | |
}, | |
afterRender: function(buffer) { | |
buffer.pushClosingTag(); | |
buffer.push(this.morph.endTag()); | |
}, | |
createElement: function() { | |
var buffer = this.renderToBuffer(); | |
this.outerHTML = buffer.string(); | |
this.clearBuffer(); | |
}, | |
domManager: DOMManager | |
}); | |
__exports__._Metamorph = _Metamorph; | |
/** | |
@class _MetamorphView | |
@namespace Ember | |
@extends Ember.View | |
@uses Ember._Metamorph | |
@private | |
*/ | |
var _MetamorphView = View.extend(_Metamorph); | |
__exports__._MetamorphView = _MetamorphView; | |
/** | |
@class _SimpleMetamorphView | |
@namespace Ember | |
@extends Ember.CoreView | |
@uses Ember._Metamorph | |
@private | |
*/ | |
var _SimpleMetamorphView = CoreView.extend(_Metamorph); | |
__exports__._SimpleMetamorphView = _SimpleMetamorphView; | |
}); | |
define("ember-metal", | |
["ember-metal/core","ember-metal/merge","ember-metal/instrumentation","ember-metal/utils","ember-metal/error","ember-metal/enumerable_utils","ember-metal/platform","ember-metal/array","ember-metal/logger","ember-metal/property_get","ember-metal/events","ember-metal/observer_set","ember-metal/property_events","ember-metal/properties","ember-metal/property_set","ember-metal/map","ember-metal/get_properties","ember-metal/set_properties","ember-metal/watch_key","ember-metal/chains","ember-metal/watch_path","ember-metal/watching","ember-metal/expand_properties","ember-metal/computed","ember-metal/observer","ember-metal/mixin","ember-metal/binding","ember-metal/run_loop","ember-metal/libraries","ember-metal/is_none","ember-metal/is_empty","ember-metal/is_blank","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __dependency6__, __dependency7__, __dependency8__, __dependency9__, __dependency10__, __dependency11__, __dependency12__, __dependency13__, __dependency14__, __dependency15__, __dependency16__, __dependency17__, __dependency18__, __dependency19__, __dependency20__, __dependency21__, __dependency22__, __dependency23__, __dependency24__, __dependency25__, __dependency26__, __dependency27__, __dependency28__, __dependency29__, __dependency30__, __dependency31__, __dependency32__, __exports__) { | |
"use strict"; | |
/** | |
Ember Metal | |
@module ember | |
@submodule ember-metal | |
*/ | |
// BEGIN IMPORTS | |
var Ember = __dependency1__["default"]; | |
var merge = __dependency2__["default"]; | |
var instrument = __dependency3__.instrument; | |
var subscribe = __dependency3__.subscribe; | |
var unsubscribe = __dependency3__.unsubscribe; | |
var reset = __dependency3__.reset; | |
var generateGuid = __dependency4__.generateGuid; | |
var GUID_KEY = __dependency4__.GUID_KEY; | |
var GUID_PREFIX = __dependency4__.GUID_PREFIX; | |
var guidFor = __dependency4__.guidFor; | |
var META_DESC = __dependency4__.META_DESC; | |
var EMPTY_META = __dependency4__.EMPTY_META; | |
var meta = __dependency4__.meta; | |
var getMeta = __dependency4__.getMeta; | |
var setMeta = __dependency4__.setMeta; | |
var metaPath = __dependency4__.metaPath; | |
var inspect = __dependency4__.inspect; | |
var typeOf = __dependency4__.typeOf; | |
var tryCatchFinally = __dependency4__.tryCatchFinally; | |
var isArray = __dependency4__.isArray; | |
var makeArray = __dependency4__.makeArray; | |
var canInvoke = __dependency4__.canInvoke; | |
var tryInvoke = __dependency4__.tryInvoke; | |
var tryFinally = __dependency4__.tryFinally; | |
var wrap = __dependency4__.wrap; | |
var apply = __dependency4__.apply; | |
var applyStr = __dependency4__.applyStr; | |
var EmberError = __dependency5__["default"]; | |
var EnumerableUtils = __dependency6__["default"]; | |
var create = __dependency7__.create; | |
var platform = __dependency7__.platform; | |
var map = __dependency8__.map; | |
var forEach = __dependency8__.forEach; | |
var filter = __dependency8__.filter; | |
var indexOf = __dependency8__.indexOf; | |
var Logger = __dependency9__["default"]; | |
var get = __dependency10__.get; | |
var getWithDefault = __dependency10__.getWithDefault; | |
var normalizeTuple = __dependency10__.normalizeTuple; | |
var _getPath = __dependency10__._getPath; | |
var on = __dependency11__.on; | |
var addListener = __dependency11__.addListener; | |
var removeListener = __dependency11__.removeListener; | |
var suspendListener = __dependency11__.suspendListener; | |
var suspendListeners = __dependency11__.suspendListeners; | |
var sendEvent = __dependency11__.sendEvent; | |
var hasListeners = __dependency11__.hasListeners; | |
var watchedEvents = __dependency11__.watchedEvents; | |
var listenersFor = __dependency11__.listenersFor; | |
var listenersDiff = __dependency11__.listenersDiff; | |
var listenersUnion = __dependency11__.listenersUnion; | |
var ObserverSet = __dependency12__["default"]; | |
var propertyWillChange = __dependency13__.propertyWillChange; | |
var propertyDidChange = __dependency13__.propertyDidChange; | |
var overrideChains = __dependency13__.overrideChains; | |
var beginPropertyChanges = __dependency13__.beginPropertyChanges; | |
var endPropertyChanges = __dependency13__.endPropertyChanges; | |
var changeProperties = __dependency13__.changeProperties; | |
var Descriptor = __dependency14__.Descriptor; | |
var defineProperty = __dependency14__.defineProperty; | |
var set = __dependency15__.set; | |
var trySet = __dependency15__.trySet; | |
var OrderedSet = __dependency16__.OrderedSet; | |
var Map = __dependency16__.Map; | |
var MapWithDefault = __dependency16__.MapWithDefault; | |
var getProperties = __dependency17__["default"]; | |
var setProperties = __dependency18__["default"]; | |
var watchKey = __dependency19__.watchKey; | |
var unwatchKey = __dependency19__.unwatchKey; | |
var flushPendingChains = __dependency20__.flushPendingChains; | |
var removeChainWatcher = __dependency20__.removeChainWatcher; | |
var ChainNode = __dependency20__.ChainNode; | |
var finishChains = __dependency20__.finishChains; | |
var watchPath = __dependency21__.watchPath; | |
var unwatchPath = __dependency21__.unwatchPath; | |
var watch = __dependency22__.watch; | |
var isWatching = __dependency22__.isWatching; | |
var unwatch = __dependency22__.unwatch; | |
var rewatch = __dependency22__.rewatch; | |
var destroy = __dependency22__.destroy; | |
var expandProperties = __dependency23__["default"]; | |
var ComputedProperty = __dependency24__.ComputedProperty; | |
var computed = __dependency24__.computed; | |
var cacheFor = __dependency24__.cacheFor; | |
var addObserver = __dependency25__.addObserver; | |
var observersFor = __dependency25__.observersFor; | |
var removeObserver = __dependency25__.removeObserver; | |
var addBeforeObserver = __dependency25__.addBeforeObserver; | |
var _suspendBeforeObserver = __dependency25__._suspendBeforeObserver; | |
var _suspendObserver = __dependency25__._suspendObserver; | |
var _suspendBeforeObservers = __dependency25__._suspendBeforeObservers; | |
var _suspendObservers = __dependency25__._suspendObservers; | |
var beforeObserversFor = __dependency25__.beforeObserversFor; | |
var removeBeforeObserver = __dependency25__.removeBeforeObserver; | |
var IS_BINDING = __dependency26__.IS_BINDING; | |
var mixin = __dependency26__.mixin; | |
var Mixin = __dependency26__.Mixin; | |
var required = __dependency26__.required; | |
var aliasMethod = __dependency26__.aliasMethod; | |
var observer = __dependency26__.observer; | |
var immediateObserver = __dependency26__.immediateObserver; | |
var beforeObserver = __dependency26__.beforeObserver; | |
var Binding = __dependency27__.Binding; | |
var isGlobalPath = __dependency27__.isGlobalPath; | |
var bind = __dependency27__.bind; | |
var oneWay = __dependency27__.oneWay; | |
var run = __dependency28__["default"]; | |
var libraries = __dependency29__["default"]; | |
var isNone = __dependency30__.isNone; | |
var none = __dependency30__.none; | |
var isEmpty = __dependency31__.isEmpty; | |
var empty = __dependency31__.empty; | |
var isBlank = __dependency32__["default"]; | |
// END IMPORTS | |
// BEGIN EXPORTS | |
var EmberInstrumentation = Ember.Instrumentation = {}; | |
EmberInstrumentation.instrument = instrument; | |
EmberInstrumentation.subscribe = subscribe; | |
EmberInstrumentation.unsubscribe = unsubscribe; | |
EmberInstrumentation.reset = reset; | |
Ember.instrument = instrument; | |
Ember.subscribe = subscribe; | |
Ember.generateGuid = generateGuid; | |
Ember.GUID_KEY = GUID_KEY; | |
Ember.GUID_PREFIX = GUID_PREFIX; | |
Ember.create = create; | |
Ember.platform = platform; | |
var EmberArrayPolyfills = Ember.ArrayPolyfills = {}; | |
EmberArrayPolyfills.map = map; | |
EmberArrayPolyfills.forEach = forEach; | |
EmberArrayPolyfills.filter = filter; | |
EmberArrayPolyfills.indexOf = indexOf; | |
Ember.Error = EmberError; | |
Ember.guidFor = guidFor; | |
Ember.META_DESC = META_DESC; | |
Ember.EMPTY_META = EMPTY_META; | |
Ember.meta = meta; | |
Ember.getMeta = getMeta; | |
Ember.setMeta = setMeta; | |
Ember.metaPath = metaPath; | |
Ember.inspect = inspect; | |
Ember.typeOf = typeOf; | |
Ember.tryCatchFinally = tryCatchFinally; | |
Ember.isArray = isArray; | |
Ember.makeArray = makeArray; | |
Ember.canInvoke = canInvoke; | |
Ember.tryInvoke = tryInvoke; | |
Ember.tryFinally = tryFinally; | |
Ember.wrap = wrap; | |
Ember.apply = apply; | |
Ember.applyStr = applyStr; | |
Ember.Logger = Logger; | |
Ember.get = get; | |
Ember.getWithDefault = getWithDefault; | |
Ember.normalizeTuple = normalizeTuple; | |
Ember._getPath = _getPath; | |
Ember.EnumerableUtils = EnumerableUtils; | |
Ember.on = on; | |
Ember.addListener = addListener; | |
Ember.removeListener = removeListener; | |
Ember._suspendListener = suspendListener; | |
Ember._suspendListeners = suspendListeners; | |
Ember.sendEvent = sendEvent; | |
Ember.hasListeners = hasListeners; | |
Ember.watchedEvents = watchedEvents; | |
Ember.listenersFor = listenersFor; | |
Ember.listenersDiff = listenersDiff; | |
Ember.listenersUnion = listenersUnion; | |
Ember._ObserverSet = ObserverSet; | |
Ember.propertyWillChange = propertyWillChange; | |
Ember.propertyDidChange = propertyDidChange; | |
Ember.overrideChains = overrideChains; | |
Ember.beginPropertyChanges = beginPropertyChanges; | |
Ember.endPropertyChanges = endPropertyChanges; | |
Ember.changeProperties = changeProperties; | |
Ember.Descriptor = Descriptor; | |
Ember.defineProperty = defineProperty; | |
Ember.set = set; | |
Ember.trySet = trySet; | |
Ember.OrderedSet = OrderedSet; | |
Ember.Map = Map; | |
Ember.MapWithDefault = MapWithDefault; | |
Ember.getProperties = getProperties; | |
Ember.setProperties = setProperties; | |
Ember.watchKey = watchKey; | |
Ember.unwatchKey = unwatchKey; | |
Ember.flushPendingChains = flushPendingChains; | |
Ember.removeChainWatcher = removeChainWatcher; | |
Ember._ChainNode = ChainNode; | |
Ember.finishChains = finishChains; | |
Ember.watchPath = watchPath; | |
Ember.unwatchPath = unwatchPath; | |
Ember.watch = watch; | |
Ember.isWatching = isWatching; | |
Ember.unwatch = unwatch; | |
Ember.rewatch = rewatch; | |
Ember.destroy = destroy; | |
Ember.expandProperties = expandProperties; | |
Ember.ComputedProperty = ComputedProperty; | |
Ember.computed = computed; | |
Ember.cacheFor = cacheFor; | |
Ember.addObserver = addObserver; | |
Ember.observersFor = observersFor; | |
Ember.removeObserver = removeObserver; | |
Ember.addBeforeObserver = addBeforeObserver; | |
Ember._suspendBeforeObserver = _suspendBeforeObserver; | |
Ember._suspendBeforeObservers = _suspendBeforeObservers; | |
Ember._suspendObserver = _suspendObserver; | |
Ember._suspendObservers = _suspendObservers; | |
Ember.beforeObserversFor = beforeObserversFor; | |
Ember.removeBeforeObserver = removeBeforeObserver; | |
Ember.IS_BINDING = IS_BINDING; | |
Ember.required = required; | |
Ember.aliasMethod = aliasMethod; | |
Ember.observer = observer; | |
Ember.immediateObserver = immediateObserver; | |
Ember.beforeObserver = beforeObserver; | |
Ember.mixin = mixin; | |
Ember.Mixin = Mixin; | |
Ember.oneWay = oneWay; | |
Ember.bind = bind; | |
Ember.Binding = Binding; | |
Ember.isGlobalPath = isGlobalPath; | |
Ember.run = run; | |
Ember.libraries = libraries; | |
Ember.libraries.registerCoreLibrary('Ember', Ember.VERSION); | |
Ember.isNone = isNone; | |
Ember.none = none; | |
Ember.isEmpty = isEmpty; | |
Ember.empty = empty; | |
Ember.isBlank = isBlank; | |
Ember.merge = merge; | |
/** | |
A function may be assigned to `Ember.onerror` to be called when Ember | |
internals encounter an error. This is useful for specialized error handling | |
and reporting code. | |
```javascript | |
Ember.onerror = function(error) { | |
Em.$.ajax('/report-error', 'POST', { | |
stack: error.stack, | |
otherInformation: 'whatever app state you want to provide' | |
}); | |
}; | |
``` | |
Internally, `Ember.onerror` is used as Backburner's error handler. | |
@event onerror | |
@for Ember | |
@param {Exception} error the error object | |
*/ | |
Ember.onerror = null; | |
// END EXPORTS | |
// do this for side-effects of updating Ember.assert, warn, etc when | |
// ember-debug is present | |
if (Ember.__loader.registry['ember-debug']) { | |
requireModule('ember-debug'); | |
} | |
__exports__["default"] = Ember; | |
}); | |
define("ember-metal/array", | |
["exports"], | |
function(__exports__) { | |
"use strict"; | |
/*jshint newcap:false*/ | |
/** | |
@module ember-metal | |
*/ | |
var ArrayPrototype = Array.prototype; | |
// NOTE: There is a bug in jshint that doesn't recognize `Object()` without `new` | |
// as being ok unless both `newcap:false` and not `use strict`. | |
// https://github.com/jshint/jshint/issues/392 | |
// Testing this is not ideal, but we want to use native functions | |
// if available, but not to use versions created by libraries like Prototype | |
var isNativeFunc = function(func) { | |
// This should probably work in all browsers likely to have ES5 array methods | |
return func && Function.prototype.toString.call(func).indexOf('[native code]') > -1; | |
}; | |
// From: https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/array/map | |
var map = isNativeFunc(ArrayPrototype.map) ? ArrayPrototype.map : function(fun /*, thisp */) { | |
//"use strict"; | |
if (this === void 0 || this === null) { | |
throw new TypeError(); | |
} | |
var t = Object(this); | |
var len = t.length >>> 0; | |
if (typeof fun !== "function") { | |
throw new TypeError(); | |
} | |
var res = new Array(len); | |
var thisp = arguments[1]; | |
for (var i = 0; i < len; i++) { | |
if (i in t) { | |
res[i] = fun.call(thisp, t[i], i, t); | |
} | |
} | |
return res; | |
}; | |
// From: https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/array/foreach | |
var forEach = isNativeFunc(ArrayPrototype.forEach) ? ArrayPrototype.forEach : function(fun /*, thisp */) { | |
//"use strict"; | |
if (this === void 0 || this === null) { | |
throw new TypeError(); | |
} | |
var t = Object(this); | |
var len = t.length >>> 0; | |
if (typeof fun !== "function") { | |
throw new TypeError(); | |
} | |
var thisp = arguments[1]; | |
for (var i = 0; i < len; i++) { | |
if (i in t) { | |
fun.call(thisp, t[i], i, t); | |
} | |
} | |
}; | |
var indexOf = isNativeFunc(ArrayPrototype.indexOf) ? ArrayPrototype.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; | |
}; | |
var filter = isNativeFunc(ArrayPrototype.filter) ? ArrayPrototype.filter : function (fn, context) { | |
var i, | |
value, | |
result = [], | |
length = this.length; | |
for (i = 0; i < length; i++) { | |
if (this.hasOwnProperty(i)) { | |
value = this[i]; | |
if (fn.call(context, value, i, this)) { | |
result.push(value); | |
} | |
} | |
} | |
return result; | |
}; | |
if (Ember.SHIM_ES5) { | |
if (!ArrayPrototype.map) { | |
ArrayPrototype.map = map; | |
} | |
if (!ArrayPrototype.forEach) { | |
ArrayPrototype.forEach = forEach; | |
} | |
if (!ArrayPrototype.filter) { | |
ArrayPrototype.filter = filter; | |
} | |
if (!ArrayPrototype.indexOf) { | |
ArrayPrototype.indexOf = indexOf; | |
} | |
} | |
/** | |
Array polyfills to support ES5 features in older browsers. | |
@namespace Ember | |
@property ArrayPolyfills | |
*/ | |
__exports__.map = map; | |
__exports__.forEach = forEach; | |
__exports__.filter = filter; | |
__exports__.indexOf = indexOf; | |
}); | |
define("ember-metal/binding", | |
["ember-metal/core","ember-metal/property_get","ember-metal/property_set","ember-metal/utils","ember-metal/map","ember-metal/observer","ember-metal/run_loop","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __dependency6__, __dependency7__, __exports__) { | |
"use strict"; | |
var Ember = __dependency1__["default"]; | |
// Ember.Logger, Ember.LOG_BINDINGS, assert | |
var get = __dependency2__.get; | |
var set = __dependency3__.set; | |
var trySet = __dependency3__.trySet; | |
var guidFor = __dependency4__.guidFor; | |
var Map = __dependency5__.Map; | |
var addObserver = __dependency6__.addObserver; | |
var removeObserver = __dependency6__.removeObserver; | |
var _suspendObserver = __dependency6__._suspendObserver; | |
var run = __dependency7__["default"]; | |
// ES6TODO: where is Ember.lookup defined? | |
/** | |
@module ember-metal | |
*/ | |
// .......................................................... | |
// CONSTANTS | |
// | |
/** | |
Debug parameter you can turn on. This will log all bindings that fire to | |
the console. This should be disabled in production code. Note that you | |
can also enable this from the console or temporarily. | |
@property LOG_BINDINGS | |
@for Ember | |
@type Boolean | |
@default false | |
*/ | |
Ember.LOG_BINDINGS = false || !!Ember.ENV.LOG_BINDINGS; | |
var IS_GLOBAL = /^([A-Z$]|([0-9][A-Z$]))/; | |
/** | |
Returns true if the provided path is global (e.g., `MyApp.fooController.bar`) | |
instead of local (`foo.bar.baz`). | |
@method isGlobalPath | |
@for Ember | |
@private | |
@param {String} path | |
@return Boolean | |
*/ | |
function isGlobalPath(path) { | |
return IS_GLOBAL.test(path); | |
} | |
function getWithGlobals(obj, path) { | |
return get(isGlobalPath(path) ? Ember.lookup : obj, path); | |
} | |
// .......................................................... | |
// BINDING | |
// | |
var Binding = function(toPath, fromPath) { | |
this._direction = 'fwd'; | |
this._from = fromPath; | |
this._to = toPath; | |
this._directionMap = Map.create(); | |
}; | |
/** | |
@class Binding | |
@namespace Ember | |
*/ | |
Binding.prototype = { | |
/** | |
This copies the Binding so it can be connected to another object. | |
@method copy | |
@return {Ember.Binding} `this` | |
*/ | |
copy: function () { | |
var copy = new Binding(this._to, this._from); | |
if (this._oneWay) { copy._oneWay = true; } | |
return copy; | |
}, | |
// .......................................................... | |
// CONFIG | |
// | |
/** | |
This will set `from` property path to the specified value. It will not | |
attempt to resolve this property path to an actual object until you | |
connect the binding. | |
The binding will search for the property path starting at the root object | |
you pass when you `connect()` the binding. It follows the same rules as | |
`get()` - see that method for more information. | |
@method from | |
@param {String} path the property path to connect to | |
@return {Ember.Binding} `this` | |
*/ | |
from: function(path) { | |
this._from = path; | |
return this; | |
}, | |
/** | |
This will set the `to` property path to the specified value. It will not | |
attempt to resolve this property path to an actual object until you | |
connect the binding. | |
The binding will search for the property path starting at the root object | |
you pass when you `connect()` the binding. It follows the same rules as | |
`get()` - see that method for more information. | |
@method to | |
@param {String|Tuple} path A property path or tuple | |
@return {Ember.Binding} `this` | |
*/ | |
to: function(path) { | |
this._to = path; | |
return this; | |
}, | |
/** | |
Configures the binding as one way. A one-way binding will relay changes | |
on the `from` side to the `to` side, but not the other way around. This | |
means that if you change the `to` side directly, the `from` side may have | |
a different value. | |
@method oneWay | |
@return {Ember.Binding} `this` | |
*/ | |
oneWay: function() { | |
this._oneWay = true; | |
return this; | |
}, | |
/** | |
@method toString | |
@return {String} string representation of binding | |
*/ | |
toString: function() { | |
var oneWay = this._oneWay ? '[oneWay]' : ''; | |
return "Ember.Binding<" + guidFor(this) + ">(" + this._from + " -> " + this._to + ")" + oneWay; | |
}, | |
// .......................................................... | |
// CONNECT AND SYNC | |
// | |
/** | |
Attempts to connect this binding instance so that it can receive and relay | |
changes. This method will raise an exception if you have not set the | |
from/to properties yet. | |
@method connect | |
@param {Object} obj The root object for this binding. | |
@return {Ember.Binding} `this` | |
*/ | |
connect: function(obj) { | |
Ember.assert('Must pass a valid object to Ember.Binding.connect()', !!obj); | |
var fromPath = this._from, toPath = this._to; | |
trySet(obj, toPath, getWithGlobals(obj, fromPath)); | |
// add an observer on the object to be notified when the binding should be updated | |
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) { addObserver(obj, toPath, this, this.toDidChange); } | |
this._readyToSync = true; | |
return this; | |
}, | |
/** | |
Disconnects the binding instance. Changes will no longer be relayed. You | |
will not usually need to call this method. | |
@method disconnect | |
@param {Object} obj The root object you passed when connecting the binding. | |
@return {Ember.Binding} `this` | |
*/ | |
disconnect: function(obj) { | |
Ember.assert('Must pass a valid object to Ember.Binding.disconnect()', !!obj); | |
var twoWay = !this._oneWay; | |
// remove an observer on the object so we're no longer notified of | |
// changes that should update bindings. | |
removeObserver(obj, this._from, this, this.fromDidChange); | |
// if the binding is two-way, remove the observer from the target as well | |
if (twoWay) { removeObserver(obj, this._to, this, this.toDidChange); } | |
this._readyToSync = false; // disable scheduled syncs... | |
return this; | |
}, | |
// .......................................................... | |
// PRIVATE | |
// | |
/* called when the from side changes */ | |
fromDidChange: function(target) { | |
this._scheduleSync(target, 'fwd'); | |
}, | |
/* called when the to side changes */ | |
toDidChange: function(target) { | |
this._scheduleSync(target, 'back'); | |
}, | |
_scheduleSync: function(obj, dir) { | |
var directionMap = this._directionMap; | |
var existingDir = directionMap.get(obj); | |
// if we haven't scheduled the binding yet, schedule it | |
if (!existingDir) { | |
run.schedule('sync', this, this._sync, obj); | |
directionMap.set(obj, dir); | |
} | |
// If both a 'back' and 'fwd' sync have been scheduled on the same object, | |
// default to a 'fwd' sync so that it remains deterministic. | |
if (existingDir === 'back' && dir === 'fwd') { | |
directionMap.set(obj, 'fwd'); | |
} | |
}, | |
_sync: function(obj) { | |
var log = Ember.LOG_BINDINGS; | |
// don't synchronize destroyed objects or disconnected bindings | |
if (obj.isDestroyed || !this._readyToSync) { return; } | |
// get the direction of the binding for the object we are | |
// synchronizing from | |
var directionMap = this._directionMap; | |
var direction = directionMap.get(obj); | |
var fromPath = this._from, toPath = this._to; | |
directionMap.remove(obj); | |
// if we're synchronizing from the remote object... | |
if (direction === 'fwd') { | |
var fromValue = getWithGlobals(obj, this._from); | |
if (log) { | |
Ember.Logger.log(' ', this.toString(), '->', fromValue, obj); | |
} | |
if (this._oneWay) { | |
trySet(obj, toPath, fromValue); | |
} else { | |
_suspendObserver(obj, toPath, this, this.toDidChange, function () { | |
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); | |
} | |
_suspendObserver(obj, fromPath, this, this.fromDidChange, function () { | |
trySet(isGlobalPath(fromPath) ? Ember.lookup : obj, fromPath, toValue); | |
}); | |
} | |
} | |
}; | |
function mixinProperties(to, from) { | |
for (var key in from) { | |
if (from.hasOwnProperty(key)) { | |
to[key] = from[key]; | |
} | |
} | |
} | |
mixinProperties(Binding, { | |
/* | |
See `Ember.Binding.from`. | |
@method from | |
@static | |
*/ | |
from: function() { | |
var C = this, binding = new C(); | |
return binding.from.apply(binding, arguments); | |
}, | |
/* | |
See `Ember.Binding.to`. | |
@method to | |
@static | |
*/ | |
to: function() { | |
var C = this, binding = new C(); | |
return binding.to.apply(binding, arguments); | |
}, | |
/** | |
Creates a new Binding instance and makes it apply in a single direction. | |
A one-way binding will relay changes on the `from` side object (supplied | |
as the `from` argument) the `to` side, but not the other way around. | |
This means that if you change the "to" side directly, the "from" side may have | |
a different value. | |
See `Binding.oneWay`. | |
@method oneWay | |
@param {String} from from path. | |
@param {Boolean} [flag] (Optional) passing nothing here will make the | |
binding `oneWay`. You can instead pass `false` to disable `oneWay`, making the | |
binding two way again. | |
@return {Ember.Binding} `this` | |
*/ | |
oneWay: function(from, flag) { | |
var C = this, binding = new C(null, from); | |
return binding.oneWay(flag); | |
} | |
}); | |
/** | |
An `Ember.Binding` connects the properties of two objects so that whenever | |
the value of one property changes, the other property will be changed also. | |
## Automatic Creation of Bindings with `/^*Binding/`-named Properties | |
You do not usually create Binding objects directly but instead describe | |
bindings in your class or object definition using automatic binding | |
detection. | |
Properties ending in a `Binding` suffix will be converted to `Ember.Binding` | |
instances. The value of this property should be a string representing a path | |
to another object or a custom binding instanced created using Binding helpers | |
(see "One Way Bindings"): | |
``` | |
valueBinding: "MyApp.someController.title" | |
``` | |
This will create a binding from `MyApp.someController.title` to the `value` | |
property of your object instance automatically. Now the two values will be | |
kept in sync. | |
## One Way Bindings | |
One especially useful binding customization you can use is the `oneWay()` | |
helper. This helper tells Ember that you are only interested in | |
receiving changes on the object you are binding from. For example, if you | |
are binding to a preference and you want to be notified if the preference | |
has changed, but your object will not be changing the preference itself, you | |
could do: | |
``` | |
bigTitlesBinding: Ember.Binding.oneWay("MyApp.preferencesController.bigTitles") | |
``` | |
This way if the value of `MyApp.preferencesController.bigTitles` changes the | |
`bigTitles` property of your object will change also. However, if you | |
change the value of your `bigTitles` property, it will not update the | |
`preferencesController`. | |
One way bindings are almost twice as fast to setup and twice as fast to | |
execute because the binding only has to worry about changes to one side. | |
You should consider using one way bindings anytime you have an object that | |
may be created frequently and you do not intend to change a property; only | |
to monitor it for changes (such as in the example above). | |
## Adding Bindings Manually | |
All of the examples above show you how to configure a custom binding, but the | |
result of these customizations will be a binding template, not a fully active | |
Binding instance. The binding will actually become active only when you | |
instantiate the object the binding belongs to. It is useful however, to | |
understand what actually happens when the binding is activated. | |
For a binding to function it must have at least a `from` property and a `to` | |
property. The `from` property path points to the object/key that you want to | |
bind from while the `to` path points to the object/key you want to bind to. | |
When you define a custom binding, you are usually describing the property | |
you want to bind from (such as `MyApp.someController.value` in the examples | |
above). When your object is created, it will automatically assign the value | |
you want to bind `to` based on the name of your binding key. In the | |
examples above, during init, Ember objects will effectively call | |
something like this on your binding: | |
```javascript | |
binding = Ember.Binding.from(this.valueBinding).to("value"); | |
``` | |
This creates a new binding instance based on the template you provide, and | |
sets the to path to the `value` property of the new object. Now that the | |
binding is fully configured with a `from` and a `to`, it simply needs to be | |
connected to become active. This is done through the `connect()` method: | |
```javascript | |
binding.connect(this); | |
``` | |
Note that when you connect a binding you pass the object you want it to be | |
connected to. This object will be used as the root for both the from and | |
to side of the binding when inspecting relative paths. This allows the | |
binding to be automatically inherited by subclassed objects as well. | |
Now that the binding is connected, it will observe both the from and to side | |
and relay changes. | |
If you ever needed to do so (you almost never will, but it is useful to | |
understand this anyway), you could manually create an active binding by | |
using the `Ember.bind()` helper method. (This is the same method used by | |
to setup your bindings on objects): | |
```javascript | |
Ember.bind(MyApp.anotherObject, "value", "MyApp.someController.value"); | |
``` | |
Both of these code fragments have the same effect as doing the most friendly | |
form of binding creation like so: | |
```javascript | |
MyApp.anotherObject = Ember.Object.create({ | |
valueBinding: "MyApp.someController.value", | |
// OTHER CODE FOR THIS OBJECT... | |
}); | |
``` | |
Ember's built in binding creation method makes it easy to automatically | |
create bindings for you. You should always use the highest-level APIs | |
available, even if you understand how it works underneath. | |
@class Binding | |
@namespace Ember | |
@since Ember 0.9 | |
*/ | |
// Ember.Binding = Binding; ES6TODO: where to put this? | |
/** | |
Global helper method to create a new binding. Just pass the root object | |
along with a `to` and `from` path to create and connect the binding. | |
@method bind | |
@for Ember | |
@param {Object} obj The root object of the transform. | |
@param {String} to The path to the 'to' side of the binding. | |
Must be relative to obj. | |
@param {String} from The path to the 'from' side of the binding. | |
Must be relative to obj or a global path. | |
@return {Ember.Binding} binding instance | |
*/ | |
function bind(obj, to, from) { | |
return new Binding(to, from).connect(obj); | |
} | |
__exports__.bind = bind;/** | |
@method oneWay | |
@for Ember | |
@param {Object} obj The root object of the transform. | |
@param {String} to The path to the 'to' side of the binding. | |
Must be relative to obj. | |
@param {String} from The path to the 'from' side of the binding. | |
Must be relative to obj or a global path. | |
@return {Ember.Binding} binding instance | |
*/ | |
function oneWay(obj, to, from) { | |
return new Binding(to, from).oneWay().connect(obj); | |
} | |
__exports__.oneWay = oneWay;__exports__.Binding = Binding; | |
__exports__.isGlobalPath = isGlobalPath; | |
}); | |
define("ember-metal/chains", | |
["ember-metal/core","ember-metal/property_get","ember-metal/utils","ember-metal/array","ember-metal/watch_key","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __exports__) { | |
"use strict"; | |
var Ember = __dependency1__["default"]; | |
// warn, assert, etc; | |
var get = __dependency2__.get; | |
var normalizeTuple = __dependency2__.normalizeTuple; | |
var meta = __dependency3__.meta; | |
var META_KEY = __dependency3__.META_KEY; | |
var forEach = __dependency4__.forEach; | |
var watchKey = __dependency5__.watchKey; | |
var unwatchKey = __dependency5__.unwatchKey; | |
var metaFor = meta, | |
warn = Ember.warn, | |
FIRST_KEY = /^([^\.]+)/; | |
function firstKey(path) { | |
return path.match(FIRST_KEY)[0]; | |
} | |
var pendingQueue = []; | |
// attempts to add the pendingQueue chains again. If some of them end up | |
// back in the queue and reschedule is true, schedules a timeout to try | |
// again. | |
function flushPendingChains() { | |
if (pendingQueue.length === 0) { return; } // nothing to do | |
var queue = pendingQueue; | |
pendingQueue = []; | |
forEach.call(queue, function(q) { q[0].add(q[1]); }); | |
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); | |
} | |
__exports__.flushPendingChains = flushPendingChains;function addChainWatcher(obj, keyName, node) { | |
if (!obj || ('object' !== typeof obj)) { return; } // nothing to do | |
var m = metaFor(obj), nodes = m.chainWatchers; | |
if (!m.hasOwnProperty('chainWatchers')) { | |
nodes = m.chainWatchers = {}; | |
} | |
if (!nodes[keyName]) { nodes[keyName] = []; } | |
nodes[keyName].push(node); | |
watchKey(obj, keyName, m); | |
} | |
function removeChainWatcher(obj, keyName, node) { | |
if (!obj || 'object' !== typeof obj) { return; } // nothing to do | |
var m = obj[META_KEY]; | |
if (m && !m.hasOwnProperty('chainWatchers')) { return; } // nothing to do | |
var nodes = m && m.chainWatchers; | |
if (nodes && nodes[keyName]) { | |
nodes = nodes[keyName]; | |
for (var i = 0, l = nodes.length; i < l; i++) { | |
if (nodes[i] === node) { nodes.splice(i, 1); } | |
} | |
} | |
unwatchKey(obj, keyName, m); | |
} | |
// 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. | |
function ChainNode(parent, key, value) { | |
this._parent = parent; | |
this._key = key; | |
// _watching is true when calling get(this._parent, this._key) will | |
// return the value of this node. | |
// | |
// It is false for the root of a chain (because we have no parent) | |
// and for global paths (because the parent node is the object with | |
// the observer on it) | |
this._watching = value===undefined; | |
this._value = value; | |
this._paths = {}; | |
if (this._watching) { | |
this._object = parent.value(); | |
if (this._object) { addChainWatcher(this._object, this._key, this); } | |
} | |
// Special-case: the EachProxy relies on immediate evaluation to | |
// establish its observers. | |
// | |
// TODO: Replace this with an efficient callback that the EachProxy | |
// can implement. | |
if (this._parent && this._parent._key === '@each') { | |
this.value(); | |
} | |
} | |
var ChainNodePrototype = ChainNode.prototype; | |
function lazyGet(obj, key) { | |
if (!obj) return undefined; | |
var meta = obj[META_KEY]; | |
// check if object meant only to be a prototype | |
if (meta && meta.proto === obj) return undefined; | |
if (key === "@each") return get(obj, key); | |
// if a CP only return cached value | |
var desc = meta && meta.descs[key]; | |
if (desc && desc._cacheable) { | |
if (key in meta.cache) { | |
return meta.cache[key]; | |
} else { | |
return undefined; | |
} | |
} | |
return get(obj, key); | |
} | |
ChainNodePrototype.value = function() { | |
if (this._value === undefined && this._watching) { | |
var obj = this._parent.value(); | |
this._value = lazyGet(obj, this._key); | |
} | |
return this._value; | |
}; | |
ChainNodePrototype.destroy = function() { | |
if (this._watching) { | |
var obj = this._object; | |
if (obj) { removeChainWatcher(obj, this._key, this); } | |
this._watching = false; // so future calls do nothing | |
} | |
}; | |
// copies a top level object only | |
ChainNodePrototype.copy = function(obj) { | |
var ret = new ChainNode(null, null, obj), | |
paths = this._paths, path; | |
for (path in paths) { | |
if (paths[path] <= 0) { continue; } // this check will also catch non-number vals. | |
ret.add(path); | |
} | |
return ret; | |
}; | |
// called on the root node of a chain to setup watchers on the specified | |
// path. | |
ChainNodePrototype.add = function(path) { | |
var obj, tuple, key, src, paths; | |
paths = this._paths; | |
paths[path] = (paths[path] || 0) + 1; | |
obj = this.value(); | |
tuple = normalizeTuple(obj, path); | |
// the path was a local path | |
if (tuple[0] && tuple[0] === obj) { | |
path = tuple[1]; | |
key = firstKey(path); | |
path = path.slice(key.length+1); | |
// global path, but object does not exist yet. | |
// put into a queue and try to connect later. | |
} else if (!tuple[0]) { | |
pendingQueue.push([this, path]); | |
tuple.length = 0; | |
return; | |
// global path, and object already exists | |
} else { | |
src = tuple[0]; | |
key = path.slice(0, 0-(tuple[1].length+1)); | |
path = tuple[1]; | |
} | |
tuple.length = 0; | |
this.chain(key, path, src); | |
}; | |
// called on the root node of a chain to teardown watcher on the specified | |
// path | |
ChainNodePrototype.remove = function(path) { | |
var obj, tuple, key, src, paths; | |
paths = this._paths; | |
if (paths[path] > 0) { paths[path]--; } | |
obj = this.value(); | |
tuple = normalizeTuple(obj, path); | |
if (tuple[0] === obj) { | |
path = tuple[1]; | |
key = firstKey(path); | |
path = path.slice(key.length+1); | |
} else { | |
src = tuple[0]; | |
key = path.slice(0, 0-(tuple[1].length+1)); | |
path = tuple[1]; | |
} | |
tuple.length = 0; | |
this.unchain(key, path); | |
}; | |
ChainNodePrototype.count = 0; | |
ChainNodePrototype.chain = function(key, path, src) { | |
var chains = this._chains, node; | |
if (!chains) { chains = this._chains = {}; } | |
node = chains[key]; | |
if (!node) { node = chains[key] = new ChainNode(this, key, src); } | |
node.count++; // count chains... | |
// chain rest of path if there is one | |
if (path && path.length>0) { | |
key = firstKey(path); | |
path = path.slice(key.length+1); | |
node.chain(key, path); // NOTE: no src means it will observe changes... | |
} | |
}; | |
ChainNodePrototype.unchain = function(key, path) { | |
var chains = this._chains, node = chains[key]; | |
// unchain rest of path first... | |
if (path && path.length>1) { | |
key = firstKey(path); | |
path = path.slice(key.length+1); | |
node.unchain(key, path); | |
} | |
// delete node if needed. | |
node.count--; | |
if (node.count<=0) { | |
delete chains[node._key]; | |
node.destroy(); | |
} | |
}; | |
ChainNodePrototype.willChange = function(events) { | |
var chains = this._chains; | |
if (chains) { | |
for(var key in chains) { | |
if (!chains.hasOwnProperty(key)) { continue; } | |
chains[key].willChange(events); | |
} | |
} | |
if (this._parent) { this._parent.chainWillChange(this, this._key, 1, events); } | |
}; | |
ChainNodePrototype.chainWillChange = function(chain, path, depth, events) { | |
if (this._key) { path = this._key + '.' + path; } | |
if (this._parent) { | |
this._parent.chainWillChange(this, path, depth+1, events); | |
} else { | |
if (depth > 1) { | |
events.push(this.value(), path); | |
} | |
path = 'this.' + path; | |
if (this._paths[path] > 0) { | |
events.push(this.value(), path); | |
} | |
} | |
}; | |
ChainNodePrototype.chainDidChange = function(chain, path, depth, events) { | |
if (this._key) { path = this._key + '.' + path; } | |
if (this._parent) { | |
this._parent.chainDidChange(this, path, depth+1, events); | |
} else { | |
if (depth > 1) { | |
events.push(this.value(), path); | |
} | |
path = 'this.' + path; | |
if (this._paths[path] > 0) { | |
events.push(this.value(), path); | |
} | |
} | |
}; | |
ChainNodePrototype.didChange = function(events) { | |
// 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(events); | |
} | |
} | |
// if no events are passed in then we only care about the above wiring update | |
if (events === null) { return; } | |
// and finally tell parent about my path changing... | |
if (this._parent) { this._parent.chainDidChange(this, this._key, 1, events); } | |
}; | |
function finishChains(obj) { | |
// We only create meta if we really have to | |
var m = obj[META_KEY], chains = m && m.chains; | |
if (chains) { | |
if (chains.value() !== obj) { | |
metaFor(obj).chains = chains = chains.copy(obj); | |
} else { | |
chains.didChange(null); | |
} | |
} | |
} | |
__exports__.finishChains = finishChains;__exports__.removeChainWatcher = removeChainWatcher; | |
__exports__.ChainNode = ChainNode; | |
}); | |
define("ember-metal/computed", | |
["ember-metal/core","ember-metal/property_get","ember-metal/property_set","ember-metal/utils","ember-metal/enumerable_utils","ember-metal/platform","ember-metal/watching","ember-metal/expand_properties","ember-metal/error","ember-metal/properties","ember-metal/property_events","ember-metal/is_empty","ember-metal/is_none","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __dependency6__, __dependency7__, __dependency8__, __dependency9__, __dependency10__, __dependency11__, __dependency12__, __dependency13__, __exports__) { | |
"use strict"; | |
var Ember = __dependency1__["default"]; | |
var get = __dependency2__.get; | |
var set = __dependency3__.set; | |
var meta = __dependency4__.meta; | |
var META_KEY = __dependency4__.META_KEY; | |
var guidFor = __dependency4__.guidFor; | |
var typeOf = __dependency4__.typeOf; | |
var inspect = __dependency4__.inspect; | |
var EnumerableUtils = __dependency5__["default"]; | |
var create = __dependency6__.create; | |
var watch = __dependency7__.watch; | |
var unwatch = __dependency7__.unwatch; | |
var expandProperties = __dependency8__["default"]; | |
var EmberError = __dependency9__["default"]; | |
var Descriptor = __dependency10__.Descriptor; | |
var defineProperty = __dependency10__.defineProperty; | |
var propertyWillChange = __dependency11__.propertyWillChange; | |
var propertyDidChange = __dependency11__.propertyDidChange; | |
var isEmpty = __dependency12__["default"]; | |
var isNone = __dependency13__.isNone; | |
/** | |
@module ember-metal | |
*/ | |
Ember.warn("The CP_DEFAULT_CACHEABLE flag has been removed and computed properties are always cached by default. Use `volatile` if you don't want caching.", Ember.ENV.CP_DEFAULT_CACHEABLE !== false); | |
var metaFor = meta, | |
a_slice = [].slice, | |
o_create = create; | |
function UNDEFINED() { } | |
var lengthPattern = /\.(length|\[\])$/; | |
// .......................................................... | |
// DEPENDENT KEYS | |
// | |
// data structure: | |
// meta.deps = { | |
// 'depKey': { | |
// 'keyName': count, | |
// } | |
// } | |
/* | |
This function returns a map of unique dependencies for a | |
given object and key. | |
*/ | |
function keysForDep(depsMeta, depKey) { | |
var keys = depsMeta[depKey]; | |
if (!keys) { | |
// if there are no dependencies yet for a the given key | |
// create a new empty list of dependencies for the key | |
keys = depsMeta[depKey] = {}; | |
} else if (!depsMeta.hasOwnProperty(depKey)) { | |
// otherwise if the dependency list is inherited from | |
// a superclass, clone the hash | |
keys = depsMeta[depKey] = o_create(keys); | |
} | |
return keys; | |
} | |
function metaForDeps(meta) { | |
return keysForDep(meta, 'deps'); | |
} | |
function addDependentKeys(desc, obj, keyName, meta) { | |
// the descriptor has a list of dependent keys, so | |
// add all of its dependent keys. | |
var depKeys = desc._dependentKeys, depsMeta, idx, len, depKey, keys; | |
if (!depKeys) return; | |
depsMeta = metaForDeps(meta); | |
for(idx = 0, len = depKeys.length; idx < len; idx++) { | |
depKey = depKeys[idx]; | |
// Lookup keys meta for depKey | |
keys = keysForDep(depsMeta, depKey); | |
// Increment the number of times depKey depends on keyName. | |
keys[keyName] = (keys[keyName] || 0) + 1; | |
// Watch the depKey | |
watch(obj, depKey, meta); | |
} | |
} | |
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(meta); | |
for(idx = 0, len = depKeys.length; idx < len; idx++) { | |
depKey = depKeys[idx]; | |
// Lookup keys meta for depKey | |
keys = keysForDep(depsMeta, depKey); | |
// Increment the number of times depKey depends on keyName. | |
keys[keyName] = (keys[keyName] || 0) - 1; | |
// Watch the depKey | |
unwatch(obj, depKey, meta); | |
} | |
} | |
// .......................................................... | |
// COMPUTED PROPERTY | |
// | |
/** | |
A computed property transforms an objects function into a property. | |
By default the function backing the computed property will only be called | |
once and the result will be cached. You can specify various properties | |
that your computed property is dependent on. This will force the cached | |
result to be recomputed if the dependencies are modified. | |
In the following example we declare a computed property (by calling | |
`.property()` on the fullName function) and setup the properties | |
dependencies (depending on firstName and lastName). The fullName function | |
will be called once (regardless of how many times it is accessed) as long | |
as it's dependencies have not been changed. Once firstName or lastName are updated | |
any future calls (or anything bound) to fullName will incorporate the new | |
values. | |
```javascript | |
Person = Ember.Object.extend({ | |
// these will be supplied by `create` | |
firstName: null, | |
lastName: null, | |
fullName: function() { | |
var firstName = this.get('firstName'); | |
var lastName = this.get('lastName'); | |
return firstName + ' ' + lastName; | |
}.property('firstName', 'lastName') | |
}); | |
var tom = Person.create({ | |
firstName: 'Tom', | |
lastName: 'Dale' | |
}); | |
tom.get('fullName') // 'Tom Dale' | |
``` | |
You can also define what Ember should do when setting a computed property. | |
If you try to set a computed property, it will be invoked with the key and | |
value you want to set it to. You can also accept the previous value as the | |
third parameter. | |
```javascript | |
Person = Ember.Object.extend({ | |
// these will be supplied by `create` | |
firstName: null, | |
lastName: null, | |
fullName: function(key, value, oldValue) { | |
// getter | |
if (arguments.length === 1) { | |
var firstName = this.get('firstName'); | |
var lastName = this.get('lastName'); | |
return firstName + ' ' + lastName; | |
// setter | |
} else { | |
var name = value.split(" "); | |
this.set('firstName', name[0]); | |
this.set('lastName', name[1]); | |
return value; | |
} | |
}.property('firstName', 'lastName') | |
}); | |
var person = Person.create(); | |
person.set('fullName', 'Peter Wagenet'); | |
person.get('firstName') // 'Peter' | |
person.get('lastName') // 'Wagenet' | |
``` | |
@class ComputedProperty | |
@namespace Ember | |
@extends Ember.Descriptor | |
@constructor | |
*/ | |
function ComputedProperty(func, opts) { | |
func.__ember_arity__ = func.length; | |
this.func = func; | |
this._cacheable = (opts && opts.cacheable !== undefined) ? opts.cacheable : true; | |
this._dependentKeys = opts && opts.dependentKeys; | |
this._readOnly = opts && (opts.readOnly !== undefined || !!opts.readOnly) || false; | |
} | |
ComputedProperty.prototype = new Descriptor(); | |
var ComputedPropertyPrototype = ComputedProperty.prototype; | |
ComputedPropertyPrototype._dependentKeys = undefined; | |
ComputedPropertyPrototype._suspended = undefined; | |
ComputedPropertyPrototype._meta = undefined; | |
/** | |
Properties are cacheable by default. Computed property will automatically | |
cache the return value of your function until one of the dependent keys changes. | |
Call `volatile()` to set it into non-cached mode. When in this mode | |
the computed property will not automatically cache the return value. | |
However, if a property is properly observable, there is no reason to disable | |
caching. | |
@method cacheable | |
@param {Boolean} aFlag optional set to `false` to disable caching | |
@return {Ember.ComputedProperty} this | |
@chainable | |
*/ | |
ComputedPropertyPrototype.cacheable = function(aFlag) { | |
this._cacheable = aFlag !== false; | |
return this; | |
}; | |
/** | |
Call on a computed property to set it into non-cached mode. When in this | |
mode the computed property will not automatically cache the return value. | |
```javascript | |
MyApp.outsideService = Ember.Object.extend({ | |
value: function() { | |
return OutsideService.getValue(); | |
}.property().volatile() | |
}).create(); | |
``` | |
@method volatile | |
@return {Ember.ComputedProperty} this | |
@chainable | |
*/ | |
ComputedPropertyPrototype.volatile = function() { | |
return this.cacheable(false); | |
}; | |
/** | |
Call on a computed property to set it into read-only mode. When in this | |
mode the computed property will throw an error when set. | |
```javascript | |
MyApp.Person = Ember.Object.extend({ | |
guid: function() { | |
return 'guid-guid-guid'; | |
}.property().readOnly() | |
}); | |
MyApp.person = MyApp.Person.create(); | |
MyApp.person.set('guid', 'new-guid'); // will throw an exception | |
``` | |
@method readOnly | |
@return {Ember.ComputedProperty} this | |
@chainable | |
*/ | |
ComputedPropertyPrototype.readOnly = function(readOnly) { | |
this._readOnly = readOnly === undefined || !!readOnly; | |
return this; | |
}; | |
/** | |
Sets the dependent keys on this computed property. Pass any number of | |
arguments containing key paths that this computed property depends on. | |
```javascript | |
MyApp.President = Ember.Object.extend({ | |
fullName: computed(function() { | |
return this.get('firstName') + ' ' + this.get('lastName'); | |
// Tell Ember that this computed property depends on firstName | |
// and lastName | |
}).property('firstName', 'lastName') | |
}); | |
MyApp.president = MyApp.President.create({ | |
firstName: 'Barack', | |
lastName: 'Obama', | |
}); | |
MyApp.president.get('fullName'); // 'Barack Obama' | |
``` | |
@method property | |
@param {String} path* zero or more property paths | |
@return {Ember.ComputedProperty} this | |
@chainable | |
*/ | |
ComputedPropertyPrototype.property = function() { | |
var args; | |
var addArg = function (property) { | |
args.push(property); | |
}; | |
args = []; | |
for (var i = 0, l = arguments.length; i < l; i++) { | |
expandProperties(arguments[i], addArg); | |
} | |
this._dependentKeys = args; | |
return this; | |
}; | |
/** | |
In some cases, you may want to annotate computed properties with additional | |
metadata about how they function or what values they operate on. For example, | |
computed property functions may close over variables that are then no longer | |
available for introspection. | |
You can pass a hash of these values to a computed property like this: | |
``` | |
person: function() { | |
var personId = this.get('personId'); | |
return App.Person.create({ id: personId }); | |
}.property().meta({ type: App.Person }) | |
``` | |
The hash that you pass to the `meta()` function will be saved on the | |
computed property descriptor under the `_meta` key. Ember runtime | |
exposes a public API for retrieving these values from classes, | |
via the `metaForProperty()` function. | |
@method meta | |
@param {Hash} meta | |
@chainable | |
*/ | |
ComputedPropertyPrototype.meta = function(meta) { | |
if (arguments.length === 0) { | |
return this._meta || {}; | |
} else { | |
this._meta = meta; | |
return this; | |
} | |
}; | |
/* impl descriptor API */ | |
ComputedPropertyPrototype.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 (meta.cache[keyName] !== undefined) { | |
meta.cache[keyName] = undefined; | |
removeDependentKeys(this, obj, keyName, meta); | |
} | |
} | |
}; | |
function finishChains(chainNodes) | |
{ | |
for (var i=0, l=chainNodes.length; i<l; i++) { | |
chainNodes[i].didChange(null); | |
} | |
} | |
/** | |
Access the value of the function backing the computed property. | |
If this property has already been cached, return the cached result. | |
Otherwise, call the function passing the property name as an argument. | |
```javascript | |
Person = Ember.Object.extend({ | |
fullName: function(keyName) { | |
// the keyName parameter is 'fullName' in this case. | |
return this.get('firstName') + ' ' + this.get('lastName'); | |
}.property('firstName', 'lastName') | |
}); | |
var tom = Person.create({ | |
firstName: 'Tom', | |
lastName: 'Dale' | |
}); | |
tom.get('fullName') // 'Tom Dale' | |
``` | |
@method get | |
@param {String} keyName The key being accessed. | |
@return {Object} The return value of the function backing the CP. | |
*/ | |
ComputedPropertyPrototype.get = function(obj, keyName) { | |
var ret, cache, meta, chainNodes; | |
if (this._cacheable) { | |
meta = metaFor(obj); | |
cache = meta.cache; | |
var result = cache[keyName]; | |
if (result === UNDEFINED) { | |
return undefined; | |
} else if (result !== undefined) { | |
return result; | |
} | |
ret = this.func.call(obj, keyName); | |
if (ret === undefined) { | |
cache[keyName] = UNDEFINED; | |
} else { | |
cache[keyName] = ret; | |
} | |
chainNodes = meta.chainWatchers && meta.chainWatchers[keyName]; | |
if (chainNodes) { finishChains(chainNodes); } | |
addDependentKeys(this, obj, keyName, meta); | |
} else { | |
ret = this.func.call(obj, keyName); | |
} | |
return ret; | |
}; | |
/** | |
Set the value of a computed property. If the function that backs your | |
computed property does not accept arguments then the default action for | |
setting would be to define the property on the current object, and set | |
the value of the property to the value being set. | |
Generally speaking if you intend for your computed property to be set | |
your backing function should accept either two or three arguments. | |
@method set | |
@param {String} keyName The key being accessed. | |
@param {Object} newValue The new value being assigned. | |
@param {String} oldValue The old value being replaced. | |
@return {Object} The return value of the function backing the CP. | |
*/ | |
ComputedPropertyPrototype.set = function(obj, keyName, value) { | |
var cacheable = this._cacheable, | |
func = this.func, | |
meta = metaFor(obj, cacheable), | |
oldSuspended = this._suspended, | |
hadCachedValue = false, | |
cache = meta.cache, | |
funcArgLength, cachedValue, ret; | |
if (this._readOnly) { | |
throw new EmberError('Cannot set read-only property "' + keyName + '" on object: ' + inspect(obj)); | |
} | |
this._suspended = obj; | |
try { | |
if (cacheable && cache[keyName] !== undefined) { | |
cachedValue = cache[keyName]; | |
hadCachedValue = true; | |
} | |
// Check if the CP has been wrapped. If it has, use the | |
// length from the wrapped function. | |
funcArgLength = func.wrappedFunction ? func.wrappedFunction.__ember_arity__ : func.__ember_arity__; | |
// For backwards-compatibility with computed properties | |
// that check for arguments.length === 2 to determine if | |
// they are being get or set, only pass the old cached | |
// value if the computed property opts into a third | |
// argument. | |
if (funcArgLength === 3) { | |
ret = func.call(obj, keyName, value, cachedValue); | |
} else if (funcArgLength === 2) { | |
ret = func.call(obj, keyName, value); | |
} else { | |
defineProperty(obj, keyName, null, cachedValue); | |
set(obj, keyName, value); | |
return; | |
} | |
if (hadCachedValue && cachedValue === ret) { return; } | |
var watched = meta.watching[keyName]; | |
if (watched) { propertyWillChange(obj, keyName); } | |
if (hadCachedValue) { | |
cache[keyName] = undefined; | |
} | |
if (cacheable) { | |
if (!hadCachedValue) { | |
addDependentKeys(this, obj, keyName, meta); | |
} | |
if (ret === undefined) { | |
cache[keyName] = UNDEFINED; | |
} else { | |
cache[keyName] = ret; | |
} | |
} | |
if (watched) { propertyDidChange(obj, keyName); } | |
} finally { | |
this._suspended = oldSuspended; | |
} | |
return ret; | |
}; | |
/* called before property is overridden */ | |
ComputedPropertyPrototype.teardown = function(obj, keyName) { | |
var meta = metaFor(obj); | |
if (keyName in meta.cache) { | |
removeDependentKeys(this, obj, keyName, meta); | |
} | |
if (this._cacheable) { delete meta.cache[keyName]; } | |
return null; // no value to restore | |
}; | |
/** | |
This helper returns a new property descriptor that wraps the passed | |
computed property function. You can use this helper to define properties | |
with mixins or via `Ember.defineProperty()`. | |
The function you pass will be used to both get and set property values. | |
The function should accept two parameters, key and value. If value is not | |
undefined you should set the value first. In either case return the | |
current value of the property. | |
@method computed | |
@for Ember | |
@param {Function} func The computed property function. | |
@return {Ember.ComputedProperty} property descriptor instance | |
*/ | |
function computed(func) { | |
var args; | |
if (arguments.length > 1) { | |
args = a_slice.call(arguments); | |
func = args.pop(); | |
} | |
if (typeof func !== "function") { | |
throw new EmberError("Computed Property declared without a property function"); | |
} | |
var cp = new ComputedProperty(func); | |
if (args) { | |
cp.property.apply(cp, args); | |
} | |
return cp; | |
} | |
/** | |
Returns the cached value for a property, if one exists. | |
This can be useful for peeking at the value of a computed | |
property that is generated lazily, without accidentally causing | |
it to be created. | |
@method cacheFor | |
@for Ember | |
@param {Object} obj the object whose property you want to check | |
@param {String} key the name of the property whose cached value you want | |
to return | |
@return {Object} the cached value | |
*/ | |
function cacheFor(obj, key) { | |
var meta = obj[META_KEY], | |
cache = meta && meta.cache, | |
ret = cache && cache[key]; | |
if (ret === UNDEFINED) { return undefined; } | |
return ret; | |
} | |
cacheFor.set = function(cache, key, value) { | |
if (value === undefined) { | |
cache[key] = UNDEFINED; | |
} else { | |
cache[key] = value; | |
} | |
}; | |
cacheFor.get = function(cache, key) { | |
var ret = cache[key]; | |
if (ret === UNDEFINED) { return undefined; } | |
return ret; | |
}; | |
cacheFor.remove = function(cache, key) { | |
cache[key] = undefined; | |
}; | |
function getProperties(self, propertyNames) { | |
var ret = {}; | |
for(var i = 0; i < propertyNames.length; i++) { | |
ret[propertyNames[i]] = get(self, propertyNames[i]); | |
} | |
return ret; | |
} | |
function registerComputed(name, macro) { | |
computed[name] = function(dependentKey) { | |
var args = a_slice.call(arguments); | |
return computed(dependentKey, function() { | |
return macro.apply(this, args); | |
}); | |
}; | |
} | |
function registerComputedWithProperties(name, macro) { | |
computed[name] = function() { | |
var properties = a_slice.call(arguments); | |
var computedFunc = computed(function() { | |
return macro.apply(this, [getProperties(this, properties)]); | |
}); | |
return computedFunc.property.apply(computedFunc, properties); | |
}; | |
} | |
/** | |
A computed property that returns true if the value of the dependent | |
property is null, an empty string, empty array, or empty function. | |
Example | |
```javascript | |
var ToDoList = Ember.Object.extend({ | |
done: Ember.computed.empty('todos') | |
}); | |
var todoList = ToDoList.create({todos: ['Unit Test', 'Documentation', 'Release']}); | |
todoList.get('done'); // false | |
todoList.get('todos').clear(); | |
todoList.get('done'); // true | |
``` | |
@since 1.6.0 | |
@method computed.empty | |
@for Ember | |
@param {String} dependentKey | |
@return {Ember.ComputedProperty} computed property which negate | |
the original value for property | |
*/ | |
computed.empty = function (dependentKey) { | |
return computed(dependentKey + '.length', function () { | |
return isEmpty(get(this, dependentKey)); | |
}); | |
}; | |
/** | |
A computed property that returns true if the value of the dependent | |
property is NOT null, an empty string, empty array, or empty function. | |
Note: When using `computed.notEmpty` to watch an array make sure to | |
use the `array.[]` syntax so the computed can subscribe to transitions | |
from empty to non-empty states. | |
Example | |
```javascript | |
var Hamster = Ember.Object.extend({ | |
hasStuff: Ember.computed.notEmpty('backpack.[]') | |
}); | |
var hamster = Hamster.create({backpack: ['Food', 'Sleeping Bag', 'Tent']}); | |
hamster.get('hasStuff'); // true | |
hamster.get('backpack').clear(); // [] | |
hamster.get('hasStuff'); // false | |
``` | |
@method computed.notEmpty | |
@for Ember | |
@param {String} dependentKey | |
@return {Ember.ComputedProperty} computed property which returns true if | |
original value for property is not empty. | |
*/ | |
registerComputed('notEmpty', function(dependentKey) { | |
return !isEmpty(get(this, dependentKey)); | |
}); | |
/** | |
A computed property that returns true if the value of the dependent | |
property is null or undefined. This avoids errors from JSLint complaining | |
about use of ==, which can be technically confusing. | |
Example | |
```javascript | |
var Hamster = Ember.Object.extend({ | |
isHungry: Ember.computed.none('food') | |
}); | |
var hamster = Hamster.create(); | |
hamster.get('isHungry'); // true | |
hamster.set('food', 'Banana'); | |
hamster.get('isHungry'); // false | |
hamster.set('food', null); | |
hamster.get('isHungry'); // true | |
``` | |
@method computed.none | |
@for Ember | |
@param {String} dependentKey | |
@return {Ember.ComputedProperty} computed property which | |
returns true if original value for property is null or undefined. | |
*/ | |
registerComputed('none', function(dependentKey) { | |
return isNone(get(this, dependentKey)); | |
}); | |
/** | |
A computed property that returns the inverse boolean value | |
of the original value for the dependent property. | |
Example | |
```javascript | |
var User = Ember.Object.extend({ | |
isAnonymous: Ember.computed.not('loggedIn') | |
}); | |
var user = User.create({loggedIn: false}); | |
user.get('isAnonymous'); // true | |
user.set('loggedIn', true); | |
user.get('isAnonymous'); // false | |
``` | |
@method computed.not | |
@for Ember | |
@param {String} dependentKey | |
@return {Ember.ComputedProperty} computed property which returns | |
inverse of the original value for property | |
*/ | |
registerComputed('not', function(dependentKey) { | |
return !get(this, dependentKey); | |
}); | |
/** | |
A computed property that converts the provided dependent property | |
into a boolean value. | |
```javascript | |
var Hamster = Ember.Object.extend({ | |
hasBananas: Ember.computed.bool('numBananas') | |
}); | |
var hamster = Hamster.create(); | |
hamster.get('hasBananas'); // false | |
hamster.set('numBananas', 0); | |
hamster.get('hasBananas'); // false | |
hamster.set('numBananas', 1); | |
hamster.get('hasBananas'); // true | |
hamster.set('numBananas', null); | |
hamster.get('hasBananas'); // false | |
``` | |
@method computed.bool | |
@for Ember | |
@param {String} dependentKey | |
@return {Ember.ComputedProperty} computed property which converts | |
to boolean the original value for property | |
*/ | |
registerComputed('bool', function(dependentKey) { | |
return !!get(this, dependentKey); | |
}); | |
/** | |
A computed property which matches the original value for the | |
dependent property against a given RegExp, returning `true` | |
if they values matches the RegExp and `false` if it does not. | |
Example | |
```javascript | |
var User = Ember.Object.extend({ | |
hasValidEmail: Ember.computed.match('email', /^.+@.+\..+$/) | |
}); | |
var user = User.create({loggedIn: false}); | |
user.get('hasValidEmail'); // false | |
user.set('email', ''); | |
user.get('hasValidEmail'); // false | |
user.set('email', '[email protected]'); | |
user.get('hasValidEmail'); // true | |
``` | |
@method computed.match | |
@for Ember | |
@param {String} dependentKey | |
@param {RegExp} regexp | |
@return {Ember.ComputedProperty} computed property which match | |
the original value for property against a given RegExp | |
*/ | |
registerComputed('match', function(dependentKey, regexp) { | |
var value = get(this, dependentKey); | |
return typeof value === 'string' ? regexp.test(value) : false; | |
}); | |
/** | |
A computed property that returns true if the provided dependent property | |
is equal to the given value. | |
Example | |
```javascript | |
var Hamster = Ember.Object.extend({ | |
napTime: Ember.computed.equal('state', 'sleepy') | |
}); | |
var hamster = Hamster.create(); | |
hamster.get('napTime'); // false | |
hamster.set('state', 'sleepy'); | |
hamster.get('napTime'); // true | |
hamster.set('state', 'hungry'); | |
hamster.get('napTime'); // false | |
``` | |
@method computed.equal | |
@for Ember | |
@param {String} dependentKey | |
@param {String|Number|Object} value | |
@return {Ember.ComputedProperty} computed property which returns true if | |
the original value for property is equal to the given value. | |
*/ | |
registerComputed('equal', function(dependentKey, value) { | |
return get(this, dependentKey) === value; | |
}); | |
/** | |
A computed property that returns true if the provied dependent property | |
is greater than the provided value. | |
Example | |
```javascript | |
var Hamster = Ember.Object.extend({ | |
hasTooManyBananas: Ember.computed.gt('numBananas', 10) | |
}); | |
var hamster = Hamster.create(); | |
hamster.get('hasTooManyBananas'); // false | |
hamster.set('numBananas', 3); | |
hamster.get('hasTooManyBananas'); // false | |
hamster.set('numBananas', 11); | |
hamster.get('hasTooManyBananas'); // true | |
``` | |
@method computed.gt | |
@for Ember | |
@param {String} dependentKey | |
@param {Number} value | |
@return {Ember.ComputedProperty} computed property which returns true if | |
the original value for property is greater then given value. | |
*/ | |
registerComputed('gt', function(dependentKey, value) { | |
return get(this, dependentKey) > value; | |
}); | |
/** | |
A computed property that returns true if the provided dependent property | |
is greater than or equal to the provided value. | |
Example | |
```javascript | |
var Hamster = Ember.Object.extend({ | |
hasTooManyBananas: Ember.computed.gte('numBananas', 10) | |
}); | |
var hamster = Hamster.create(); | |
hamster.get('hasTooManyBananas'); // false | |
hamster.set('numBananas', 3); | |
hamster.get('hasTooManyBananas'); // false | |
hamster.set('numBananas', 10); | |
hamster.get('hasTooManyBananas'); // true | |
``` | |
@method computed.gte | |
@for Ember | |
@param {String} dependentKey | |
@param {Number} value | |
@return {Ember.ComputedProperty} computed property which returns true if | |
the original value for property is greater or equal then given value. | |
*/ | |
registerComputed('gte', function(dependentKey, value) { | |
return get(this, dependentKey) >= value; | |
}); | |
/** | |
A computed property that returns true if the provided dependent property | |
is less than the provided value. | |
Example | |
```javascript | |
var Hamster = Ember.Object.extend({ | |
needsMoreBananas: Ember.computed.lt('numBananas', 3) | |
}); | |
var hamster = Hamster.create(); | |
hamster.get('needsMoreBananas'); // true | |
hamster.set('numBananas', 3); | |
hamster.get('needsMoreBananas'); // false | |
hamster.set('numBananas', 2); | |
hamster.get('needsMoreBananas'); // true | |
``` | |
@method computed.lt | |
@for Ember | |
@param {String} dependentKey | |
@param {Number} value | |
@return {Ember.ComputedProperty} computed property which returns true if | |
the original value for property is less then given value. | |
*/ | |
registerComputed('lt', function(dependentKey, value) { | |
return get(this, dependentKey) < value; | |
}); | |
/** | |
A computed property that returns true if the provided dependent property | |
is less than or equal to the provided value. | |
Example | |
```javascript | |
var Hamster = Ember.Object.extend({ | |
needsMoreBananas: Ember.computed.lte('numBananas', 3) | |
}); | |
var hamster = Hamster.create(); | |
hamster.get('needsMoreBananas'); // true | |
hamster.set('numBananas', 5); | |
hamster.get('needsMoreBananas'); // false | |
hamster.set('numBananas', 3); | |
hamster.get('needsMoreBananas'); // true | |
``` | |
@method computed.lte | |
@for Ember | |
@param {String} dependentKey | |
@param {Number} value | |
@return {Ember.ComputedProperty} computed property which returns true if | |
the original value for property is less or equal then given value. | |
*/ | |
registerComputed('lte', function(dependentKey, value) { | |
return get(this, dependentKey) <= value; | |
}); | |
/** | |
A computed property that performs a logical `and` on the | |
original values for the provided dependent properties. | |
Example | |
```javascript | |
var Hamster = Ember.Object.extend({ | |
readyForCamp: Ember.computed.and('hasTent', 'hasBackpack') | |
}); | |
var hamster = Hamster.create(); | |
hamster.get('readyForCamp'); // false | |
hamster.set('hasTent', true); | |
hamster.get('readyForCamp'); // false | |
hamster.set('hasBackpack', true); | |
hamster.get('readyForCamp'); // true | |
``` | |
@method computed.and | |
@for Ember | |
@param {String} dependentKey* | |
@return {Ember.ComputedProperty} computed property which performs | |
a logical `and` on the values of all the original values for properties. | |
*/ | |
registerComputedWithProperties('and', function(properties) { | |
for (var key in properties) { | |
if (properties.hasOwnProperty(key) && !properties[key]) { | |
return false; | |
} | |
} | |
return true; | |
}); | |
/** | |
A computed property which performs a logical `or` on the | |
original values for the provided dependent properties. | |
Example | |
```javascript | |
var Hamster = Ember.Object.extend({ | |
readyForRain: Ember.computed.or('hasJacket', 'hasUmbrella') | |
}); | |
var hamster = Hamster.create(); | |
hamster.get('readyForRain'); // false | |
hamster.set('hasJacket', true); | |
hamster.get('readyForRain'); // true | |
``` | |
@method computed.or | |
@for Ember | |
@param {String} dependentKey* | |
@return {Ember.ComputedProperty} computed property which performs | |
a logical `or` on the values of all the original values for properties. | |
*/ | |
registerComputedWithProperties('or', function(properties) { | |
for (var key in properties) { | |
if (properties.hasOwnProperty(key) && properties[key]) { | |
return true; | |
} | |
} | |
return false; | |
}); | |
/** | |
A computed property that returns the first truthy value | |
from a list of dependent properties. | |
Example | |
```javascript | |
var Hamster = Ember.Object.extend({ | |
hasClothes: Ember.computed.any('hat', 'shirt') | |
}); | |
var hamster = Hamster.create(); | |
hamster.get('hasClothes'); // null | |
hamster.set('shirt', 'Hawaiian Shirt'); | |
hamster.get('hasClothes'); // 'Hawaiian Shirt' | |
``` | |
@method computed.any | |
@for Ember | |
@param {String} dependentKey* | |
@return {Ember.ComputedProperty} computed property which returns | |
the first truthy value of given list of properties. | |
*/ | |
registerComputedWithProperties('any', function(properties) { | |
for (var key in properties) { | |
if (properties.hasOwnProperty(key) && properties[key]) { | |
return properties[key]; | |
} | |
} | |
return null; | |
}); | |
/** | |
A computed property that returns the array of values | |
for the provided dependent properties. | |
Example | |
```javascript | |
var Hamster = Ember.Object.extend({ | |
clothes: Ember.computed.collect('hat', 'shirt') | |
}); | |
var hamster = Hamster.create(); | |
hamster.get('clothes'); // [null, null] | |
hamster.set('hat', 'Camp Hat'); | |
hamster.set('shirt', 'Camp Shirt'); | |
hamster.get('clothes'); // ['Camp Hat', 'Camp Shirt'] | |
``` | |
@method computed.collect | |
@for Ember | |
@param {String} dependentKey* | |
@return {Ember.ComputedProperty} computed property which maps | |
values of all passed properties in to an array. | |
*/ | |
registerComputedWithProperties('collect', function(properties) { | |
var res = []; | |
for (var key in properties) { | |
if (properties.hasOwnProperty(key)) { | |
if (isNone(properties[key])) { | |
res.push(null); | |
} else { | |
res.push(properties[key]); | |
} | |
} | |
} | |
return res; | |
}); | |
/** | |
Creates a new property that is an alias for another property | |
on an object. Calls to `get` or `set` this property behave as | |
though they were called on the original property. | |
```javascript | |
Person = Ember.Object.extend({ | |
name: 'Alex Matchneer', | |
nomen: Ember.computed.alias('name') | |
}); | |
alex = Person.create(); | |
alex.get('nomen'); // 'Alex Matchneer' | |
alex.get('name'); // 'Alex Matchneer' | |
alex.set('nomen', '@machty'); | |
alex.get('name'); // '@machty' | |
``` | |
@method computed.alias | |
@for Ember | |
@param {String} dependentKey | |
@return {Ember.ComputedProperty} computed property which creates an | |
alias to the original value for property. | |
*/ | |
computed.alias = function(dependentKey) { | |
return computed(dependentKey, function(key, value) { | |
if (arguments.length > 1) { | |
set(this, dependentKey, value); | |
return get(this, dependentKey); | |
} else { | |
return get(this, dependentKey); | |
} | |
}); | |
}; | |
/** | |
Where `computed.alias` aliases `get` and `set`, and allows for bidirectional | |
data flow, `computed.oneWay` only provides an aliased `get`. The `set` will | |
not mutate the upstream property, rather causes the current property to | |
become the value set. This causes the downstream property to permanently | |
diverge from the upstream property. | |
Example | |
```javascript | |
var User = Ember.Object.extend({ | |
firstName: null, | |
lastName: null, | |
nickName: Ember.computed.oneWay('firstName') | |
}); | |
var teddy = User.create({ | |
firstName: 'Teddy', | |
lastName: 'Zeenny' | |
}); | |
teddy.get('nickName'); // 'Teddy' | |
teddy.set('nickName', 'TeddyBear'); // 'TeddyBear' | |
teddy.get('firstName'); // 'Teddy' | |
``` | |
@method computed.oneWay | |
@for Ember | |
@param {String} dependentKey | |
@return {Ember.ComputedProperty} computed property which creates a | |
one way computed property to the original value for property. | |
*/ | |
computed.oneWay = function(dependentKey) { | |
return computed(dependentKey, function() { | |
return get(this, dependentKey); | |
}); | |
}; | |
if (Ember.FEATURES.isEnabled('query-params-new')) { | |
/** | |
This is a more semantically meaningful alias of `computed.oneWay`, | |
whose name is somewhat ambiguous as to which direction the data flows. | |
@method computed.reads | |
@for Ember | |
@param {String} dependentKey | |
@return {Ember.ComputedProperty} computed property which creates a | |
one way computed property to the original value for property. | |
*/ | |
computed.reads = computed.oneWay; | |
} | |
/** | |
Where `computed.oneWay` provides oneWay bindings, `computed.readOnly` provides | |
a readOnly one way binding. Very often when using `computed.oneWay` one does | |
not also want changes to propogate back up, as they will replace the value. | |
This prevents the reverse flow, and also throws an exception when it occurs. | |
Example | |
```javascript | |
var User = Ember.Object.extend({ | |
firstName: null, | |
lastName: null, | |
nickName: Ember.computed.readOnly('firstName') | |
}); | |
var teddy = User.create({ | |
firstName: 'Teddy', | |
lastName: 'Zeenny' | |
}); | |
teddy.get('nickName'); // 'Teddy' | |
teddy.set('nickName', 'TeddyBear'); // throws Exception | |
// throw new Ember.Error('Cannot Set: nickName on: <User:ember27288>' );` | |
teddy.get('firstName'); // 'Teddy' | |
``` | |
@method computed.readOnly | |
@for Ember | |
@param {String} dependentKey | |
@return {Ember.ComputedProperty} computed property which creates a | |
one way computed property to the original value for property. | |
@since 1.5.0 | |
*/ | |
computed.readOnly = function(dependentKey) { | |
return computed(dependentKey, function() { | |
return get(this, dependentKey); | |
}).readOnly(); | |
}; | |
/** | |
A computed property that acts like a standard getter and setter, | |
but returns the value at the provided `defaultPath` if the | |
property itself has not been set to a value | |
Example | |
```javascript | |
var Hamster = Ember.Object.extend({ | |
wishList: Ember.computed.defaultTo('favoriteFood') | |
}); | |
var hamster = Hamster.create({favoriteFood: 'Banana'}); | |
hamster.get('wishList'); // 'Banana' | |
hamster.set('wishList', 'More Unit Tests'); | |
hamster.get('wishList'); // 'More Unit Tests' | |
hamster.get('favoriteFood'); // 'Banana' | |
``` | |
@method computed.defaultTo | |
@for Ember | |
@param {String} defaultPath | |
@return {Ember.ComputedProperty} computed property which acts like | |
a standard getter and setter, but defaults to the value from `defaultPath`. | |
*/ | |
// ES6TODO: computed should have its own export path so you can do import {defaultTo} from computed | |
computed.defaultTo = function(defaultPath) { | |
return computed(function(key, newValue, cachedValue) { | |
if (arguments.length === 1) { | |
return get(this, defaultPath); | |
} | |
return newValue != null ? newValue : get(this, defaultPath); | |
}); | |
}; | |
/** | |
Creates a new property that is an alias for another property | |
on an object. Calls to `get` or `set` this property behave as | |
though they were called on the original property, but also | |
print a deprecation warning. | |
@method computed.deprecatingAlias | |
@for Ember | |
@param {String} dependentKey | |
@return {Ember.ComputedProperty} computed property which creates an | |
alias with a deprecation to the original value for property. | |
*/ | |
computed.deprecatingAlias = function(dependentKey) { | |
return computed(dependentKey, function(key, value) { | |
Ember.deprecate('Usage of `' + key + '` is deprecated, use `' + dependentKey + '` instead.'); | |
if (arguments.length > 1) { | |
set(this, dependentKey, value); | |
return value; | |
} else { | |
return get(this, dependentKey); | |
} | |
}); | |
}; | |
__exports__.ComputedProperty = ComputedProperty; | |
__exports__.computed = computed; | |
__exports__.cacheFor = cacheFor; | |
}); | |
define("ember-metal/core", | |
["exports"], | |
function(__exports__) { | |
"use strict"; | |
/*globals Ember:true,Em:true,ENV,EmberENV,MetamorphENV:true */ | |
/** | |
@module ember | |
@submodule ember-metal | |
*/ | |
/** | |
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. | |
@class Ember | |
@static | |
@version 1.7.0-beta.1+canary.6555b15a | |
*/ | |
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 = {}; | |
} | |
// Default imports, exports and lookup to the global object; | |
var imports = Ember.imports = Ember.imports || this; | |
var exports = Ember.exports = Ember.exports || this; | |
var lookup = Ember.lookup = Ember.lookup || this; | |
// aliases needed to keep minifiers from removing the global context | |
exports.Em = exports.Ember = Ember; | |
// Make sure these are set whether Ember was already defined or not | |
Ember.isNamespace = true; | |
Ember.toString = function() { return "Ember"; }; | |
/** | |
@property VERSION | |
@type String | |
@default '1.7.0-beta.1+canary.6555b15a' | |
@static | |
*/ | |
Ember.VERSION = '1.7.0-beta.1+canary.6555b15a'; | |
/** | |
Standard environmental variables. You can define these in a global `EmberENV` | |
variable before loading Ember to control various configuration settings. | |
For backwards compatibility with earlier versions of Ember the global `ENV` | |
variable will be used if `EmberENV` is not defined. | |
@property ENV | |
@type Hash | |
*/ | |
if (Ember.ENV) { | |
// do nothing if Ember.ENV is already setup | |
} else if ('undefined' !== typeof EmberENV) { | |
Ember.ENV = EmberENV; | |
} else if('undefined' !== typeof ENV) { | |
Ember.ENV = ENV; | |
} else { | |
Ember.ENV = {}; | |
} | |
Ember.config = Ember.config || {}; | |
// We disable the RANGE API by default for performance reasons | |
if ('undefined' === typeof Ember.ENV.DISABLE_RANGE_API) { | |
Ember.ENV.DISABLE_RANGE_API = true; | |
} | |
if ("undefined" === typeof MetamorphENV) { | |
exports.MetamorphENV = {}; | |
} | |
MetamorphENV.DISABLE_RANGE_API = Ember.ENV.DISABLE_RANGE_API; | |
/** | |
Hash of enabled Canary features. Add to before creating your application. | |
You can also define `ENV.FEATURES` if you need to enable features flagged at runtime. | |
@class FEATURES | |
@namespace Ember | |
@static | |
@since 1.1.0 | |
*/ | |
Ember.FEATURES = Ember.ENV.FEATURES || {}; | |
/** | |
Test that a feature is enabled. Parsed by Ember's build tools to leave | |
experimental features out of beta/stable builds. | |
You can define the following configuration options: | |
* `ENV.ENABLE_ALL_FEATURES` - force all features to be enabled. | |
* `ENV.ENABLE_OPTIONAL_FEATURES` - enable any features that have not been explicitly | |
enabled/disabled. | |
@method isEnabled | |
@param {String} feature | |
@return {Boolean} | |
@for Ember.FEATURES | |
@since 1.1.0 | |
*/ | |
Ember.FEATURES.isEnabled = function(feature) { | |
var featureValue = Ember.FEATURES[feature]; | |
if (Ember.ENV.ENABLE_ALL_FEATURES) { | |
return true; | |
} else if (featureValue === true || featureValue === false || featureValue === undefined) { | |
return featureValue; | |
} else if (Ember.ENV.ENABLE_OPTIONAL_FEATURES) { | |
return true; | |
} else { | |
return false; | |
} | |
}; | |
// .......................................................... | |
// BOOTSTRAP | |
// | |
/** | |
Determines whether Ember should enhance 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 trouble 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. | |
@property EXTEND_PROTOTYPES | |
@type Boolean | |
@default true | |
@for Ember | |
*/ | |
Ember.EXTEND_PROTOTYPES = Ember.ENV.EXTEND_PROTOTYPES; | |
if (typeof Ember.EXTEND_PROTOTYPES === 'undefined') { | |
Ember.EXTEND_PROTOTYPES = true; | |
} | |
/** | |
Determines whether Ember logs a full stack trace during deprecation warnings | |
@property LOG_STACKTRACE_ON_DEPRECATION | |
@type Boolean | |
@default true | |
*/ | |
Ember.LOG_STACKTRACE_ON_DEPRECATION = (Ember.ENV.LOG_STACKTRACE_ON_DEPRECATION !== false); | |
/** | |
Determines whether Ember should add ECMAScript 5 shims to older browsers. | |
@property SHIM_ES5 | |
@type Boolean | |
@default Ember.EXTEND_PROTOTYPES | |
*/ | |
Ember.SHIM_ES5 = (Ember.ENV.SHIM_ES5 === false) ? false : Ember.EXTEND_PROTOTYPES; | |
/** | |
Determines whether Ember logs info about version of used libraries | |
@property LOG_VERSION | |
@type Boolean | |
@default true | |
*/ | |
Ember.LOG_VERSION = (Ember.ENV.LOG_VERSION === false) ? false : true; | |
/** | |
Empty function. Useful for some operations. Always returns `this`. | |
@method K | |
@private | |
@return {Object} | |
*/ | |
Ember.K = function() { return this; }; | |
// 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.debug) { Ember.debug = Ember.K; } | |
if ('undefined' === typeof Ember.runInDebug) { Ember.runInDebug = Ember.K; } | |
if ('undefined' === typeof Ember.deprecate) { Ember.deprecate = Ember.K; } | |
if ('undefined' === typeof Ember.deprecateFunc) { | |
Ember.deprecateFunc = function(_, func) { return func; }; | |
} | |
/** | |
Previously we used `Ember.$.uuid`, however `$.uuid` has been removed from | |
jQuery master. We'll just bootstrap our own uuid now. | |
@property uuid | |
@type Number | |
@private | |
*/ | |
Ember.uuid = 0; | |
__exports__["default"] = Ember; | |
}); | |
define("ember-metal/enumerable_utils", | |
["ember-metal/array","exports"], | |
function(__dependency1__, __exports__) { | |
"use strict"; | |
var map = __dependency1__.map; | |
var forEach = __dependency1__.forEach; | |
var indexOf = __dependency1__.indexOf; | |
var filter = __dependency1__.filter; | |
var splice = Array.prototype.splice; | |
/** | |
* Defines some convenience methods for working with Enumerables. | |
* `Ember.EnumerableUtils` uses `Ember.ArrayPolyfills` when necessary. | |
* | |
* @class EnumerableUtils | |
* @namespace Ember | |
* @static | |
* */ | |
var utils = { | |
/** | |
* Calls the map function on the passed object with a specified callback. This | |
* uses `Ember.ArrayPolyfill`'s-map method when necessary. | |
* | |
* @method map | |
* @param {Object} obj The object that should be mapped | |
* @param {Function} callback The callback to execute | |
* @param {Object} thisArg Value to use as this when executing *callback* | |
* | |
* @return {Array} An array of mapped values. | |
*/ | |
map: function(obj, callback, thisArg) { | |
return obj.map ? obj.map.call(obj, callback, thisArg) : map.call(obj, callback, thisArg); | |
}, | |
/** | |
* Calls the forEach function on the passed object with a specified callback. This | |
* uses `Ember.ArrayPolyfill`'s-forEach method when necessary. | |
* | |
* @method forEach | |
* @param {Object} obj The object to call forEach on | |
* @param {Function} callback The callback to execute | |
* @param {Object} thisArg Value to use as this when executing *callback* | |
* | |
*/ | |
forEach: function(obj, callback, thisArg) { | |
return obj.forEach ? obj.forEach.call(obj, callback, thisArg) : forEach.call(obj, callback, thisArg); | |
}, | |
/** | |
* Calls the filter function on the passed object with a specified callback. This | |
* uses `Ember.ArrayPolyfill`'s-filter method when necessary. | |
* | |
* @method filter | |
* @param {Object} obj The object to call filter on | |
* @param {Function} callback The callback to execute | |
* @param {Object} thisArg Value to use as this when executing *callback* | |
* | |
* @return {Array} An array containing the filtered values | |
* @since 1.4.0 | |
*/ | |
filter: function(obj, callback, thisArg) { | |
return obj.filter ? obj.filter.call(obj, callback, thisArg) : filter.call(obj, callback, thisArg); | |
}, | |
/** | |
* Calls the indexOf function on the passed object with a specified callback. This | |
* uses `Ember.ArrayPolyfill`'s-indexOf method when necessary. | |
* | |
* @method indexOf | |
* @param {Object} obj The object to call indexOn on | |
* @param {Function} callback The callback to execute | |
* @param {Object} index The index to start searching from | |
* | |
*/ | |
indexOf: function(obj, element, index) { | |
return obj.indexOf ? obj.indexOf.call(obj, element, index) : indexOf.call(obj, element, index); | |
}, | |
/** | |
* Returns an array of indexes of the first occurrences of the passed elements | |
* on the passed object. | |
* | |
* ```javascript | |
* var array = [1, 2, 3, 4, 5]; | |
* Ember.EnumerableUtils.indexesOf(array, [2, 5]); // [1, 4] | |
* | |
* var fubar = "Fubarr"; | |
* Ember.EnumerableUtils.indexesOf(fubar, ['b', 'r']); // [2, 4] | |
* ``` | |
* | |
* @method indexesOf | |
* @param {Object} obj The object to check for element indexes | |
* @param {Array} elements The elements to search for on *obj* | |
* | |
* @return {Array} An array of indexes. | |
* | |
*/ | |
indexesOf: function(obj, elements) { | |
return elements === undefined ? [] : utils.map(elements, function(item) { | |
return utils.indexOf(obj, item); | |
}); | |
}, | |
/** | |
* Adds an object to an array. If the array already includes the object this | |
* method has no effect. | |
* | |
* @method addObject | |
* @param {Array} array The array the passed item should be added to | |
* @param {Object} item The item to add to the passed array | |
* | |
* @return 'undefined' | |
*/ | |
addObject: function(array, item) { | |
var index = utils.indexOf(array, item); | |
if (index === -1) { array.push(item); } | |
}, | |
/** | |
* Removes an object from an array. If the array does not contain the passed | |
* object this method has no effect. | |
* | |
* @method removeObject | |
* @param {Array} array The array to remove the item from. | |
* @param {Object} item The item to remove from the passed array. | |
* | |
* @return 'undefined' | |
*/ | |
removeObject: function(array, item) { | |
var index = utils.indexOf(array, item); | |
if (index !== -1) { array.splice(index, 1); } | |
}, | |
_replace: function(array, idx, amt, objects) { | |
var args = [].concat(objects), chunk, ret = [], | |
// https://code.google.com/p/chromium/issues/detail?id=56588 | |
size = 60000, start = idx, ends = amt, count; | |
while (args.length) { | |
count = ends > size ? size : ends; | |
if (count <= 0) { count = 0; } | |
chunk = args.splice(0, size); | |
chunk = [start, count].concat(chunk); | |
start += size; | |
ends -= count; | |
ret = ret.concat(splice.apply(array, chunk)); | |
} | |
return ret; | |
}, | |
/** | |
* Replaces objects in an array with the passed objects. | |
* | |
* ```javascript | |
* var array = [1,2,3]; | |
* Ember.EnumerableUtils.replace(array, 1, 2, [4, 5]); // [1, 4, 5] | |
* | |
* var array = [1,2,3]; | |
* Ember.EnumerableUtils.replace(array, 1, 1, [4, 5]); // [1, 4, 5, 3] | |
* | |
* var array = [1,2,3]; | |
* Ember.EnumerableUtils.replace(array, 10, 1, [4, 5]); // [1, 2, 3, 4, 5] | |
* ``` | |
* | |
* @method replace | |
* @param {Array} array The array the objects should be inserted into. | |
* @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* | |
* | |
* @return {Array} The modified array. | |
*/ | |
replace: function(array, idx, amt, objects) { | |
if (array.replace) { | |
return array.replace(idx, amt, objects); | |
} else { | |
return utils._replace(array, idx, amt, objects); | |
} | |
}, | |
/** | |
* Calculates the intersection of two arrays. This method returns a new array | |
* filled with the records that the two passed arrays share with each other. | |
* If there is no intersection, an empty array will be returned. | |
* | |
* ```javascript | |
* var array1 = [1, 2, 3, 4, 5]; | |
* var array2 = [1, 3, 5, 6, 7]; | |
* | |
* Ember.EnumerableUtils.intersection(array1, array2); // [1, 3, 5] | |
* | |
* var array1 = [1, 2, 3]; | |
* var array2 = [4, 5, 6]; | |
* | |
* Ember.EnumerableUtils.intersection(array1, array2); // [] | |
* ``` | |
* | |
* @method intersection | |
* @param {Array} array1 The first array | |
* @param {Array} array2 The second array | |
* | |
* @return {Array} The intersection of the two passed arrays. | |
*/ | |
intersection: function(array1, array2) { | |
var intersection = []; | |
utils.forEach(array1, function(element) { | |
if (utils.indexOf(array2, element) >= 0) { | |
intersection.push(element); | |
} | |
}); | |
return intersection; | |
} | |
}; | |
__exports__["default"] = utils; | |
}); | |
define("ember-metal/error", | |
["ember-metal/platform","exports"], | |
function(__dependency1__, __exports__) { | |
"use strict"; | |
var create = __dependency1__.create; | |
var errorProps = [ | |
'description', | |
'fileName', | |
'lineNumber', | |
'message', | |
'name', | |
'number', | |
'stack' | |
]; | |
/** | |
A subclass of the JavaScript Error object for use in Ember. | |
@class Error | |
@namespace Ember | |
@extends Error | |
@constructor | |
*/ | |
function EmberError() { | |
var tmp = Error.apply(this, arguments); | |
// Adds a `stack` property to the given error object that will yield the | |
// stack trace at the time captureStackTrace was called. | |
// When collecting the stack trace all frames above the topmost call | |
// to this function, including that call, will be left out of the | |
// stack trace. | |
// This is useful because we can hide Ember implementation details | |
// that are not very helpful for the user. | |
if (Error.captureStackTrace) { | |
Error.captureStackTrace(this, Ember.Error); | |
} | |
// Unfortunately errors are not enumerable in Chrome (at least), so `for prop in tmp` doesn't work. | |
for (var idx = 0; idx < errorProps.length; idx++) { | |
this[errorProps[idx]] = tmp[errorProps[idx]]; | |
} | |
} | |
EmberError.prototype = create(Error.prototype); | |
__exports__["default"] = EmberError; | |
}); | |
define("ember-metal/events", | |
["ember-metal/core","ember-metal/utils","ember-metal/platform","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __exports__) { | |
"use strict"; | |
/** | |
@module ember-metal | |
*/ | |
var Ember = __dependency1__["default"]; | |
var meta = __dependency2__.meta; | |
var META_KEY = __dependency2__.META_KEY; | |
var tryFinally = __dependency2__.tryFinally; | |
var apply = __dependency2__.apply; | |
var applyStr = __dependency2__.applyStr; | |
var create = __dependency3__.create; | |
var a_slice = [].slice, | |
metaFor = meta, | |
/* listener flags */ | |
ONCE = 1, SUSPENDED = 2; | |
/* | |
The event system uses a series of nested hashes to store listeners on an | |
object. When a listener is registered, or when an event arrives, these | |
hashes are consulted to determine which target and action pair to invoke. | |
The hashes are stored in the object's meta hash, and look like this: | |
// Object's meta hash | |
{ | |
listeners: { // variable name: `listenerSet` | |
"foo:changed": [ // variable name: `actions` | |
target, method, flags | |
] | |
} | |
} | |
*/ | |
function indexOf(array, target, method) { | |
var index = -1; | |
// hashes are added to the end of the event array | |
// so it makes sense to start searching at the end | |
// of the array and search in reverse | |
for (var i = array.length - 3 ; i >=0; i -= 3) { | |
if (target === array[i] && method === array[i + 1]) { | |
index = i; break; | |
} | |
} | |
return index; | |
} | |
function actionsFor(obj, eventName) { | |
var meta = metaFor(obj, true), | |
actions; | |
if (!meta.listeners) { meta.listeners = {}; } | |
if (!meta.hasOwnProperty('listeners')) { | |
// setup inherited copy of the listeners object | |
meta.listeners = create(meta.listeners); | |
} | |
actions = meta.listeners[eventName]; | |
// if there are actions, but the eventName doesn't exist in our listeners, then copy them from the prototype | |
if (actions && !meta.listeners.hasOwnProperty(eventName)) { | |
actions = meta.listeners[eventName] = meta.listeners[eventName].slice(); | |
} else if (!actions) { | |
actions = meta.listeners[eventName] = []; | |
} | |
return actions; | |
} | |
function listenersUnion(obj, eventName, otherActions) { | |
var meta = obj[META_KEY], | |
actions = meta && meta.listeners && meta.listeners[eventName]; | |
if (!actions) { return; } | |
for (var i = actions.length - 3; i >= 0; i -= 3) { | |
var target = actions[i], | |
method = actions[i+1], | |
flags = actions[i+2], | |
actionIndex = indexOf(otherActions, target, method); | |
if (actionIndex === -1) { | |
otherActions.push(target, method, flags); | |
} | |
} | |
} | |
__exports__.listenersUnion = listenersUnion;function listenersDiff(obj, eventName, otherActions) { | |
var meta = obj[META_KEY], | |
actions = meta && meta.listeners && meta.listeners[eventName], | |
diffActions = []; | |
if (!actions) { return; } | |
for (var i = actions.length - 3; i >= 0; i -= 3) { | |
var target = actions[i], | |
method = actions[i+1], | |
flags = actions[i+2], | |
actionIndex = indexOf(otherActions, target, method); | |
if (actionIndex !== -1) { continue; } | |
otherActions.push(target, method, flags); | |
diffActions.push(target, method, flags); | |
} | |
return diffActions; | |
} | |
__exports__.listenersDiff = listenersDiff;/** | |
Add an event listener | |
@method addListener | |
@for Ember | |
@param obj | |
@param {String} eventName | |
@param {Object|Function} targetOrMethod A target object or a function | |
@param {Function|String} method A function or the name of a function to be called on `target` | |
@param {Boolean} once A flag whether a function should only be called once | |
*/ | |
function addListener(obj, eventName, target, method, once) { | |
Ember.assert("You must pass at least an object and event name to Ember.addListener", !!obj && !!eventName); | |
if (!method && 'function' === typeof target) { | |
method = target; | |
target = null; | |
} | |
var actions = actionsFor(obj, eventName), | |
actionIndex = indexOf(actions, target, method), | |
flags = 0; | |
if (once) flags |= ONCE; | |
if (actionIndex !== -1) { return; } | |
actions.push(target, method, flags); | |
if ('function' === typeof obj.didAddListener) { | |
obj.didAddListener(eventName, target, method); | |
} | |
} | |
__exports__.addListener = addListener;/** | |
Remove an event listener | |
Arguments should match those passed to `Ember.addListener`. | |
@method removeListener | |
@for Ember | |
@param obj | |
@param {String} eventName | |
@param {Object|Function} targetOrMethod A target object or a function | |
@param {Function|String} method A function or the name of a function to be called on `target` | |
*/ | |
function removeListener(obj, eventName, target, method) { | |
Ember.assert("You must pass at least an object and event name to Ember.removeListener", !!obj && !!eventName); | |
if (!method && 'function' === typeof target) { | |
method = target; | |
target = null; | |
} | |
function _removeListener(target, method) { | |
var actions = actionsFor(obj, eventName), | |
actionIndex = indexOf(actions, target, method); | |
// action doesn't exist, give up silently | |
if (actionIndex === -1) { return; } | |
actions.splice(actionIndex, 3); | |
if ('function' === typeof obj.didRemoveListener) { | |
obj.didRemoveListener(eventName, target, method); | |
} | |
} | |
if (method) { | |
_removeListener(target, method); | |
} else { | |
var meta = obj[META_KEY], | |
actions = meta && meta.listeners && meta.listeners[eventName]; | |
if (!actions) { return; } | |
for (var i = actions.length - 3; i >= 0; i -= 3) { | |
_removeListener(actions[i], actions[i+1]); | |
} | |
} | |
} | |
/** | |
Suspend listener during callback. | |
This should only be used by the target of the event listener | |
when it is taking an action that would cause the event, e.g. | |
an object might suspend its property change listener while it is | |
setting that property. | |
@method suspendListener | |
@for Ember | |
@private | |
@param obj | |
@param {String} eventName | |
@param {Object|Function} targetOrMethod A target object or a function | |
@param {Function|String} method A function or the name of a function to be called on `target` | |
@param {Function} callback | |
*/ | |
function suspendListener(obj, eventName, target, method, callback) { | |
if (!method && 'function' === typeof target) { | |
method = target; | |
target = null; | |
} | |
var actions = actionsFor(obj, eventName), | |
actionIndex = indexOf(actions, target, method); | |
if (actionIndex !== -1) { | |
actions[actionIndex+2] |= SUSPENDED; // mark the action as suspended | |
} | |
function tryable() { return callback.call(target); } | |
function finalizer() { if (actionIndex !== -1) { actions[actionIndex+2] &= ~SUSPENDED; } } | |
return tryFinally(tryable, finalizer); | |
} | |
__exports__.suspendListener = suspendListener;/** | |
Suspends multiple listeners during a callback. | |
@method suspendListeners | |
@for Ember | |
@private | |
@param obj | |
@param {Array} eventName Array of event names | |
@param {Object|Function} targetOrMethod A target object or a function | |
@param {Function|String} method A function or the name of a function to be called on `target` | |
@param {Function} callback | |
*/ | |
function suspendListeners(obj, eventNames, target, method, callback) { | |
if (!method && 'function' === typeof target) { | |
method = target; | |
target = null; | |
} | |
var suspendedActions = [], | |
actionsList = [], | |
eventName, actions, i, l; | |
for (i=0, l=eventNames.length; i<l; i++) { | |
eventName = eventNames[i]; | |
actions = actionsFor(obj, eventName); | |
var actionIndex = indexOf(actions, target, method); | |
if (actionIndex !== -1) { | |
actions[actionIndex+2] |= SUSPENDED; | |
suspendedActions.push(actionIndex); | |
actionsList.push(actions); | |
} | |
} | |
function tryable() { return callback.call(target); } | |
function finalizer() { | |
for (var i = 0, l = suspendedActions.length; i < l; i++) { | |
var actionIndex = suspendedActions[i]; | |
actionsList[i][actionIndex+2] &= ~SUSPENDED; | |
} | |
} | |
return tryFinally(tryable, finalizer); | |
} | |
__exports__.suspendListeners = suspendListeners;/** | |
Return a list of currently watched events | |
@private | |
@method watchedEvents | |
@for Ember | |
@param obj | |
*/ | |
function watchedEvents(obj) { | |
var listeners = obj[META_KEY].listeners, ret = []; | |
if (listeners) { | |
for(var eventName in listeners) { | |
if (listeners[eventName]) { ret.push(eventName); } | |
} | |
} | |
return ret; | |
} | |
__exports__.watchedEvents = watchedEvents;/** | |
Send an event. The execution of suspended listeners | |
is skipped, and once listeners are removed. A listener without | |
a target is executed on the passed object. If an array of actions | |
is not passed, the actions stored on the passed object are invoked. | |
@method sendEvent | |
@for Ember | |
@param obj | |
@param {String} eventName | |
@param {Array} params Optional parameters for each listener. | |
@param {Array} actions Optional array of actions (listeners). | |
@return true | |
*/ | |
function sendEvent(obj, eventName, params, actions) { | |
// first give object a chance to handle it | |
if (obj !== Ember && 'function' === typeof obj.sendEvent) { | |
obj.sendEvent(eventName, params); | |
} | |
if (!actions) { | |
var meta = obj[META_KEY]; | |
actions = meta && meta.listeners && meta.listeners[eventName]; | |
} | |
if (!actions) { return; } | |
for (var i = actions.length - 3; i >= 0; i -= 3) { // looping in reverse for once listeners | |
var target = actions[i], method = actions[i+1], flags = actions[i+2]; | |
if (!method) { continue; } | |
if (flags & SUSPENDED) { continue; } | |
if (flags & ONCE) { removeListener(obj, eventName, target, method); } | |
if (!target) { target = obj; } | |
if ('string' === typeof method) { | |
if (params) { | |
applyStr(target, method, params); | |
} else { | |
target[method](); | |
} | |
} else { | |
if (params) { | |
apply(target, method, params); | |
} else { | |
method.call(target); | |
} | |
} | |
} | |
return true; | |
} | |
__exports__.sendEvent = sendEvent;/** | |
@private | |
@method hasListeners | |
@for Ember | |
@param obj | |
@param {String} eventName | |
*/ | |
function hasListeners(obj, eventName) { | |
var meta = obj[META_KEY], | |
actions = meta && meta.listeners && meta.listeners[eventName]; | |
return !!(actions && actions.length); | |
} | |
__exports__.hasListeners = hasListeners;/** | |
@private | |
@method listenersFor | |
@for Ember | |
@param obj | |
@param {String} eventName | |
*/ | |
function listenersFor(obj, eventName) { | |
var ret = []; | |
var meta = obj[META_KEY], | |
actions = meta && meta.listeners && meta.listeners[eventName]; | |
if (!actions) { return ret; } | |
for (var i = 0, l = actions.length; i < l; i += 3) { | |
var target = actions[i], | |
method = actions[i+1]; | |
ret.push([target, method]); | |
} | |
return ret; | |
} | |
__exports__.listenersFor = listenersFor;/** | |
Define a property as a function that should be executed when | |
a specified event or events are triggered. | |
``` javascript | |
var Job = Ember.Object.extend({ | |
logCompleted: Ember.on('completed', function(){ | |
console.log('Job completed!'); | |
}) | |
}); | |
var job = Job.create(); | |
Ember.sendEvent(job, 'completed'); // Logs "Job completed!" | |
``` | |
@method on | |
@for Ember | |
@param {String} eventNames* | |
@param {Function} func | |
@return func | |
*/ | |
function on(){ | |
var func = a_slice.call(arguments, -1)[0], | |
events = a_slice.call(arguments, 0, -1); | |
func.__ember_listens__ = events; | |
return func; | |
} | |
__exports__.on = on;__exports__.removeListener = removeListener; | |
}); | |
define("ember-metal/expand_properties", | |
["ember-metal/error","ember-metal/enumerable_utils","exports"], | |
function(__dependency1__, __dependency2__, __exports__) { | |
"use strict"; | |
var EmberError = __dependency1__["default"]; | |
var EnumerableUtils = __dependency2__["default"]; | |
/** | |
@module ember-metal | |
*/ | |
var forEach = EnumerableUtils.forEach, | |
BRACE_EXPANSION = /^((?:[^\.]*\.)*)\{(.*)\}$/; | |
/** | |
Expands `pattern`, invoking `callback` for each expansion. | |
The only pattern supported is brace-expansion, anything else will be passed | |
once to `callback` directly. Brace expansion can only appear at the end of a | |
pattern, for an example see the last call below. | |
Example | |
```js | |
function echo(arg){ console.log(arg); } | |
Ember.expandProperties('foo.bar', echo); //=> 'foo.bar' | |
Ember.expandProperties('{foo,bar}', echo); //=> 'foo', 'bar' | |
Ember.expandProperties('foo.{bar,baz}', echo); //=> 'foo.bar', 'foo.baz' | |
Ember.expandProperties('{foo,bar}.baz', echo); //=> '{foo,bar}.baz' | |
``` | |
@method | |
@private | |
@param {string} pattern The property pattern to expand. | |
@param {function} callback The callback to invoke. It is invoked once per | |
expansion, and is passed the expansion. | |
*/ | |
__exports__["default"] = function expandProperties(pattern, callback) { | |
var match, prefix, list; | |
if (pattern.indexOf(' ') > -1) { | |
throw new EmberError('Brace expanded properties cannot contain spaces, ' + | |
'e.g. `user.{firstName, lastName}` should be `user.{firstName,lastName}`'); | |
} | |
if (match = BRACE_EXPANSION.exec(pattern)) { | |
prefix = match[1]; | |
list = match[2]; | |
forEach(list.split(','), function (suffix) { | |
callback(prefix + suffix); | |
}); | |
} else { | |
callback(pattern); | |
} | |
} | |
}); | |
define("ember-metal/get_properties", | |
["ember-metal/property_get","ember-metal/utils","exports"], | |
function(__dependency1__, __dependency2__, __exports__) { | |
"use strict"; | |
var get = __dependency1__.get; | |
var typeOf = __dependency2__.typeOf; | |
/** | |
To get multiple properties at once, call `Ember.getProperties` | |
with an object followed by a list of strings or an array: | |
```javascript | |
Ember.getProperties(record, 'firstName', 'lastName', 'zipCode'); | |
// { firstName: 'John', lastName: 'Doe', zipCode: '10011' } | |
``` | |
is equivalent to: | |
```javascript | |
Ember.getProperties(record, ['firstName', 'lastName', 'zipCode']); | |
// { firstName: 'John', lastName: 'Doe', zipCode: '10011' } | |
``` | |
@method getProperties | |
@param obj | |
@param {String...|Array} list of keys to get | |
@return {Hash} | |
*/ | |
__exports__["default"] = function getProperties(obj) { | |
var ret = {}, | |
propertyNames = arguments, | |
i = 1; | |
if (arguments.length === 2 && typeOf(arguments[1]) === 'array') { | |
i = 0; | |
propertyNames = arguments[1]; | |
} | |
for(var len = propertyNames.length; i < len; i++) { | |
ret[propertyNames[i]] = get(obj, propertyNames[i]); | |
} | |
return ret; | |
} | |
}); | |
define("ember-metal/instrumentation", | |
["ember-metal/core","ember-metal/utils","exports"], | |
function(__dependency1__, __dependency2__, __exports__) { | |
"use strict"; | |
var Ember = __dependency1__["default"]; | |
var tryCatchFinally = __dependency2__.tryCatchFinally; | |
/** | |
The purpose of the Ember Instrumentation module is | |
to provide efficient, general-purpose instrumentation | |
for Ember. | |
Subscribe to a listener by using `Ember.subscribe`: | |
```javascript | |
Ember.subscribe("render", { | |
before: function(name, timestamp, payload) { | |
}, | |
after: function(name, timestamp, payload) { | |
} | |
}); | |
``` | |
If you return a value from the `before` callback, that same | |
value will be passed as a fourth parameter to the `after` | |
callback. | |
Instrument a block of code by using `Ember.instrument`: | |
```javascript | |
Ember.instrument("render.handlebars", payload, function() { | |
// rendering logic | |
}, binding); | |
``` | |
Event names passed to `Ember.instrument` are namespaced | |
by periods, from more general to more specific. Subscribers | |
can listen for events by whatever level of granularity they | |
are interested in. | |
In the above example, the event is `render.handlebars`, | |
and the subscriber listened for all events beginning with | |
`render`. It would receive callbacks for events named | |
`render`, `render.handlebars`, `render.container`, or | |
even `render.handlebars.layout`. | |
@class Instrumentation | |
@namespace Ember | |
@static | |
*/ | |
var subscribers = [], cache = {}; | |
var populateListeners = function(name) { | |
var listeners = [], subscriber; | |
for (var i=0, l=subscribers.length; i<l; i++) { | |
subscriber = subscribers[i]; | |
if (subscriber.regex.test(name)) { | |
listeners.push(subscriber.object); | |
} | |
} | |
cache[name] = listeners; | |
return listeners; | |
}; | |
var time = (function() { | |
var perf = 'undefined' !== typeof window ? window.performance || {} : {}; | |
var fn = perf.now || perf.mozNow || perf.webkitNow || perf.msNow || perf.oNow; | |
// fn.bind will be available in all the browsers that support the advanced window.performance... ;-) | |
return fn ? fn.bind(perf) : function() { return +new Date(); }; | |
})(); | |
/** | |
Notifies event's subscribers, calls `before` and `after` hooks. | |
@method instrument | |
@namespace Ember.Instrumentation | |
@param {String} [name] Namespaced event name. | |
@param {Object} payload | |
@param {Function} callback Function that you're instrumenting. | |
@param {Object} binding Context that instrument function is called with. | |
*/ | |
function instrument(name, payload, callback, binding) { | |
var listeners = cache[name], timeName, ret; | |
// ES6TODO: Docs. What is this? | |
if (Ember.STRUCTURED_PROFILE) { | |
timeName = name + ": " + payload.object; | |
console.time(timeName); | |
} | |
if (!listeners) { | |
listeners = populateListeners(name); | |
} | |
if (listeners.length === 0) { | |
ret = callback.call(binding); | |
if (Ember.STRUCTURED_PROFILE) { console.timeEnd(timeName); } | |
return ret; | |
} | |
var beforeValues = [], listener, i, l; | |
function tryable() { | |
for (i=0, l=listeners.length; i<l; i++) { | |
listener = listeners[i]; | |
beforeValues[i] = listener.before(name, time(), payload); | |
} | |
return callback.call(binding); | |
} | |
function catchable(e) { | |
payload = payload || {}; | |
payload.exception = e; | |
} | |
function finalizer() { | |
for (i=0, l=listeners.length; i<l; i++) { | |
listener = listeners[i]; | |
listener.after(name, time(), payload, beforeValues[i]); | |
} | |
if (Ember.STRUCTURED_PROFILE) { | |
console.timeEnd(timeName); | |
} | |
} | |
return tryCatchFinally(tryable, catchable, finalizer); | |
} | |
__exports__.instrument = instrument;/** | |
Subscribes to a particular event or instrumented block of code. | |
@method subscribe | |
@namespace Ember.Instrumentation | |
@param {String} [pattern] Namespaced event name. | |
@param {Object} [object] Before and After hooks. | |
@return {Subscriber} | |
*/ | |
function subscribe(pattern, object) { | |
var paths = pattern.split("."), path, regex = []; | |
for (var i=0, l=paths.length; i<l; i++) { | |
path = paths[i]; | |
if (path === "*") { | |
regex.push("[^\\.]*"); | |
} else { | |
regex.push(path); | |
} | |
} | |
regex = regex.join("\\."); | |
regex = regex + "(\\..*)?"; | |
var subscriber = { | |
pattern: pattern, | |
regex: new RegExp("^" + regex + "$"), | |
object: object | |
}; | |
subscribers.push(subscriber); | |
cache = {}; | |
return subscriber; | |
} | |
__exports__.subscribe = subscribe;/** | |
Unsubscribes from a particular event or instrumented block of code. | |
@method unsubscribe | |
@namespace Ember.Instrumentation | |
@param {Object} [subscriber] | |
*/ | |
function unsubscribe(subscriber) { | |
var index; | |
for (var i=0, l=subscribers.length; i<l; i++) { | |
if (subscribers[i] === subscriber) { | |
index = i; | |
} | |
} | |
subscribers.splice(index, 1); | |
cache = {}; | |
} | |
__exports__.unsubscribe = unsubscribe;/** | |
Resets `Ember.Instrumentation` by flushing list of subscribers. | |
@method reset | |
@namespace Ember.Instrumentation | |
*/ | |
function reset() { | |
subscribers = []; | |
cache = {}; | |
} | |
__exports__.reset = reset; | |
}); | |
define("ember-metal/is_blank", | |
["ember-metal/core","ember-metal/is_empty","exports"], | |
function(__dependency1__, __dependency2__, __exports__) { | |
"use strict"; | |
var Ember = __dependency1__["default"]; | |
// deprecateFunc | |
var isEmpty = __dependency2__["default"]; | |
/** | |
A value is blank if it is empty or a whitespace string. | |
```javascript | |
Ember.isBlank(); // true | |
Ember.isBlank(null); // true | |
Ember.isBlank(undefined); // true | |
Ember.isBlank(''); // true | |
Ember.isBlank([]); // true | |
Ember.isBlank('\n\t'); // true | |
Ember.isBlank(' '); // true | |
Ember.isBlank({}); // false | |
Ember.isBlank('\n\t Hello'); // false | |
Ember.isBlank('Hello world'); // false | |
Ember.isBlank([1,2,3]); // false | |
``` | |
@method isBlank | |
@for Ember | |
@param {Object} obj Value to test | |
@return {Boolean} | |
@since 1.5.0 | |
*/ | |
__exports__["default"] = function isBlank(obj) { | |
return isEmpty(obj) || (typeof obj === 'string' && obj.match(/\S/) === null); | |
} | |
}); | |
define("ember-metal/is_empty", | |
["ember-metal/core","ember-metal/property_get","ember-metal/is_none","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __exports__) { | |
"use strict"; | |
var Ember = __dependency1__["default"]; | |
// deprecateFunc | |
var get = __dependency2__.get; | |
var isNone = __dependency3__["default"]; | |
/** | |
Verifies that a value is `null` or an empty string, empty array, | |
or empty function. | |
Constrains the rules on `Ember.isNone` by returning false for empty | |
string and empty arrays. | |
```javascript | |
Ember.isEmpty(); // true | |
Ember.isEmpty(null); // true | |
Ember.isEmpty(undefined); // true | |
Ember.isEmpty(''); // true | |
Ember.isEmpty([]); // true | |
Ember.isEmpty('Adam Hawkins'); // false | |
Ember.isEmpty([0,1,2]); // false | |
``` | |
@method isEmpty | |
@for Ember | |
@param {Object} obj Value to test | |
@return {Boolean} | |
*/ | |
function isEmpty(obj) { | |
return isNone(obj) || (obj.length === 0 && typeof obj !== 'function') || (typeof obj === 'object' && get(obj, 'length') === 0); | |
} | |
var empty = Ember.deprecateFunc("Ember.empty is deprecated. Please use Ember.isEmpty instead.", isEmpty); | |
__exports__.empty = empty; | |
__exports__["default"] = isEmpty; | |
__exports__.isEmpty = isEmpty; | |
__exports__.empty = empty; | |
}); | |
define("ember-metal/is_none", | |
["ember-metal/core","exports"], | |
function(__dependency1__, __exports__) { | |
"use strict"; | |
var Ember = __dependency1__["default"]; | |
// deprecateFunc | |
/** | |
Returns true if the passed value is null or undefined. This avoids errors | |
from JSLint complaining about use of ==, which can be technically | |
confusing. | |
```javascript | |
Ember.isNone(); // true | |
Ember.isNone(null); // true | |
Ember.isNone(undefined); // true | |
Ember.isNone(''); // false | |
Ember.isNone([]); // false | |
Ember.isNone(function() {}); // false | |
``` | |
@method isNone | |
@for Ember | |
@param {Object} obj Value to test | |
@return {Boolean} | |
*/ | |
function isNone(obj) { | |
return obj === null || obj === undefined; | |
} | |
var none = Ember.deprecateFunc("Ember.none is deprecated. Please use Ember.isNone instead.", isNone); | |
__exports__.none = none; | |
__exports__["default"] = isNone; | |
__exports__.isNone = isNone; | |
}); | |
define("ember-metal/libraries", | |
["ember-metal/enumerable_utils","exports"], | |
function(__dependency1__, __exports__) { | |
"use strict"; | |
// Provides a way to register library versions with ember. | |
var EnumerableUtils = __dependency1__["default"]; | |
var forEach = EnumerableUtils.forEach, | |
indexOf = EnumerableUtils.indexOf; | |
var libraries = function() { | |
var _libraries = []; | |
var coreLibIndex = 0; | |
var getLibrary = function(name) { | |
for (var i = 0; i < _libraries.length; i++) { | |
if (_libraries[i].name === name) { | |
return _libraries[i]; | |
} | |
} | |
}; | |
_libraries.register = function(name, version) { | |
if (!getLibrary(name)) { | |
_libraries.push({name: name, version: version}); | |
} | |
}; | |
_libraries.registerCoreLibrary = function(name, version) { | |
if (!getLibrary(name)) { | |
_libraries.splice(coreLibIndex++, 0, {name: name, version: version}); | |
} | |
}; | |
_libraries.deRegister = function(name) { | |
var lib = getLibrary(name); | |
if (lib) _libraries.splice(indexOf(_libraries, lib), 1); | |
}; | |
_libraries.each = function (callback) { | |
forEach(_libraries, function(lib) { | |
callback(lib.name, lib.version); | |
}); | |
}; | |
return _libraries; | |
}(); | |
__exports__["default"] = libraries; | |
}); | |
define("ember-metal/logger", | |
["ember-metal/core","ember-metal/error","exports"], | |
function(__dependency1__, __dependency2__, __exports__) { | |
"use strict"; | |
var Ember = __dependency1__["default"]; | |
var EmberError = __dependency2__["default"]; | |
function consoleMethod(name) { | |
var consoleObj, logToConsole; | |
if (Ember.imports.console) { | |
consoleObj = Ember.imports.console; | |
} else if (typeof console !== 'undefined') { | |
consoleObj = console; | |
} | |
var method = typeof consoleObj === 'object' ? consoleObj[name] : null; | |
if (method) { | |
// Older IE doesn't support apply, but Chrome needs it | |
if (typeof method.apply === 'function') { | |
logToConsole = function() { | |
method.apply(consoleObj, arguments); | |
}; | |
logToConsole.displayName = 'console.' + name; | |
return logToConsole; | |
} else { | |
return function() { | |
var message = Array.prototype.join.call(arguments, ', '); | |
method(message); | |
}; | |
} | |
} | |
} | |
function assertPolyfill(test, message) { | |
if (!test) { | |
try { | |
// attempt to preserve the stack | |
throw new EmberError("assertion failed: " + message); | |
} catch(error) { | |
setTimeout(function() { | |
throw error; | |
}, 0); | |
} | |
} | |
} | |
/** | |
Inside Ember-Metal, simply uses the methods from `imports.console`. | |
Override this to provide more robust logging functionality. | |
@class Logger | |
@namespace Ember | |
*/ | |
__exports__["default"] = { | |
/** | |
Logs the arguments to the console. | |
You can pass as many arguments as you want and they will be joined together with a space. | |
```javascript | |
var foo = 1; | |
Ember.Logger.log('log value of foo:', foo); | |
// "log value of foo: 1" will be printed to the console | |
``` | |
@method log | |
@for Ember.Logger | |
@param {*} arguments | |
*/ | |
log: consoleMethod('log') || Ember.K, | |
/** | |
Prints the arguments to the console with a warning icon. | |
You can pass as many arguments as you want and they will be joined together with a space. | |
```javascript | |
Ember.Logger.warn('Something happened!'); | |
// "Something happened!" will be printed to the console with a warning icon. | |
``` | |
@method warn | |
@for Ember.Logger | |
@param {*} arguments | |
*/ | |
warn: consoleMethod('warn') || Ember.K, | |
/** | |
Prints the arguments to the console with an error icon, red text and a stack trace. | |
You can pass as many arguments as you want and they will be joined together with a space. | |
```javascript | |
Ember.Logger.error('Danger! Danger!'); | |
// "Danger! Danger!" will be printed to the console in red text. | |
``` | |
@method error | |
@for Ember.Logger | |
@param {*} arguments | |
*/ | |
error: consoleMethod('error') || Ember.K, | |
/** | |
Logs the arguments to the console. | |
You can pass as many arguments as you want and they will be joined together with a space. | |
```javascript | |
var foo = 1; | |
Ember.Logger.info('log value of foo:', foo); | |
// "log value of foo: 1" will be printed to the console | |
``` | |
@method info | |
@for Ember.Logger | |
@param {*} arguments | |
*/ | |
info: consoleMethod('info') || Ember.K, | |
/** | |
Logs the arguments to the console in blue text. | |
You can pass as many arguments as you want and they will be joined together with a space. | |
```javascript | |
var foo = 1; | |
Ember.Logger.debug('log value of foo:', foo); | |
// "log value of foo: 1" will be printed to the console | |
``` | |
@method debug | |
@for Ember.Logger | |
@param {*} arguments | |
*/ | |
debug: consoleMethod('debug') || consoleMethod('info') || Ember.K, | |
/** | |
If the value passed into `Ember.Logger.assert` is not truthy it will throw an error with a stack trace. | |
```javascript | |
Ember.Logger.assert(true); // undefined | |
Ember.Logger.assert(true === false); // Throws an Assertion failed error. | |
``` | |
@method assert | |
@for Ember.Logger | |
@param {Boolean} bool Value to test | |
*/ | |
assert: consoleMethod('assert') || assertPolyfill | |
}; | |
}); | |
define("ember-metal/map", | |
["ember-metal/property_set","ember-metal/utils","ember-metal/array","ember-metal/platform","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __exports__) { | |
"use strict"; | |
/** | |
@module ember-metal | |
*/ | |
/* | |
JavaScript (before ES6) does not have a Map implementation. Objects, | |
which are often used as dictionaries, may only have Strings as keys. | |
Because Ember has a way to get a unique identifier for every object | |
via `Ember.guidFor`, we can implement a performant Map with arbitrary | |
keys. Because it is commonly used in low-level bookkeeping, Map is | |
implemented as a pure JavaScript object for performance. | |
This implementation follows the current iteration of the ES6 proposal for | |
maps (http://wiki.ecmascript.org/doku.php?id=harmony:simple_maps_and_sets), | |
with two exceptions. First, because we need our implementation to be pleasant | |
on older browsers, we do not use the `delete` name (using `remove` instead). | |
Second, as we do not have the luxury of in-VM iteration, we implement a | |
forEach method for iteration. | |
Map is mocked out to look like an Ember object, so you can do | |
`Ember.Map.create()` for symmetry with other Ember classes. | |
*/ | |
var set = __dependency1__.set; | |
var guidFor = __dependency2__.guidFor; | |
var indexOf = __dependency3__.indexOf; | |
var create = __dependency4__.create; | |
function copy(obj) { | |
var output = {}; | |
for (var prop in obj) { | |
if (obj.hasOwnProperty(prop)) { output[prop] = obj[prop]; } | |
} | |
return output; | |
} | |
function copyMap(original, newObject) { | |
var keys = original.keys.copy(), | |
values = copy(original.values); | |
newObject.keys = keys; | |
newObject.values = values; | |
newObject.length = original.length; | |
return newObject; | |
} | |
/** | |
This class is used internally by Ember and Ember Data. | |
Please do not use it at this time. We plan to clean it up | |
and add many tests soon. | |
@class OrderedSet | |
@namespace Ember | |
@constructor | |
@private | |
*/ | |
function OrderedSet() { | |
this.clear(); | |
} | |
/** | |
@method create | |
@static | |
@return {Ember.OrderedSet} | |
*/ | |
OrderedSet.create = function() { | |
return new OrderedSet(); | |
}; | |
OrderedSet.prototype = { | |
/** | |
@method clear | |
*/ | |
clear: function() { | |
this.presenceSet = {}; | |
this.list = []; | |
}, | |
/** | |
@method add | |
@param obj | |
*/ | |
add: function(obj) { | |
var guid = guidFor(obj), | |
presenceSet = this.presenceSet, | |
list = this.list; | |
if (guid in presenceSet) { return; } | |
presenceSet[guid] = true; | |
list.push(obj); | |
}, | |
/** | |
@method remove | |
@param obj | |
*/ | |
remove: function(obj) { | |
var guid = guidFor(obj), | |
presenceSet = this.presenceSet, | |
list = this.list; | |
delete presenceSet[guid]; | |
var index = indexOf.call(list, obj); | |
if (index > -1) { | |
list.splice(index, 1); | |
} | |
}, | |
/** | |
@method isEmpty | |
@return {Boolean} | |
*/ | |
isEmpty: function() { | |
return this.list.length === 0; | |
}, | |
/** | |
@method has | |
@param obj | |
@return {Boolean} | |
*/ | |
has: function(obj) { | |
var guid = guidFor(obj), | |
presenceSet = this.presenceSet; | |
return guid in presenceSet; | |
}, | |
/** | |
@method forEach | |
@param {Function} fn | |
@param self | |
*/ | |
forEach: function(fn, self) { | |
// allow mutation during iteration | |
var list = this.toArray(); | |
for (var i = 0, j = list.length; i < j; i++) { | |
fn.call(self, list[i]); | |
} | |
}, | |
/** | |
@method toArray | |
@return {Array} | |
*/ | |
toArray: function() { | |
return this.list.slice(); | |
}, | |
/** | |
@method copy | |
@return {Ember.OrderedSet} | |
*/ | |
copy: function() { | |
var set = new OrderedSet(); | |
set.presenceSet = copy(this.presenceSet); | |
set.list = this.toArray(); | |
return set; | |
} | |
}; | |
/** | |
A Map stores values indexed by keys. Unlike JavaScript's | |
default Objects, the keys of a Map can be any JavaScript | |
object. | |
Internally, a Map has two data structures: | |
1. `keys`: an OrderedSet of all of the existing keys | |
2. `values`: a JavaScript Object indexed by the `Ember.guidFor(key)` | |
When a key/value pair is added for the first time, we | |
add the key to the `keys` OrderedSet, and create or | |
replace an entry in `values`. When an entry is deleted, | |
we delete its entry in `keys` and `values`. | |
@class Map | |
@namespace Ember | |
@private | |
@constructor | |
*/ | |
function Map() { | |
this.keys = OrderedSet.create(); | |
this.values = {}; | |
} | |
Ember.Map = Map; | |
/** | |
@method create | |
@static | |
*/ | |
Map.create = function() { | |
return new Map(); | |
}; | |
Map.prototype = { | |
/** | |
This property will change as the number of objects in the map changes. | |
@property length | |
@type number | |
@default 0 | |
*/ | |
length: 0, | |
/** | |
Retrieve the value associated with a given key. | |
@method get | |
@param {*} key | |
@return {*} the value associated with the key, or `undefined` | |
*/ | |
get: function(key) { | |
var values = this.values, | |
guid = guidFor(key); | |
return values[guid]; | |
}, | |
/** | |
Adds a value to the map. If a value for the given key has already been | |
provided, the new value will replace the old value. | |
@method set | |
@param {*} key | |
@param {*} value | |
*/ | |
set: function(key, value) { | |
var keys = this.keys, | |
values = this.values, | |
guid = guidFor(key); | |
keys.add(key); | |
values[guid] = value; | |
set(this, 'length', keys.list.length); | |
}, | |
/** | |
Removes a value from the map for an associated key. | |
@method remove | |
@param {*} key | |
@return {Boolean} true if an item was removed, false otherwise | |
*/ | |
remove: function(key) { | |
// don't use ES6 "delete" because it will be annoying | |
// to use in browsers that are not ES6 friendly; | |
var keys = this.keys, | |
values = this.values, | |
guid = guidFor(key); | |
if (values.hasOwnProperty(guid)) { | |
keys.remove(key); | |
delete values[guid]; | |
set(this, 'length', keys.list.length); | |
return true; | |
} else { | |
return false; | |
} | |
}, | |
/** | |
Check whether a key is present. | |
@method has | |
@param {*} key | |
@return {Boolean} true if the item was present, false otherwise | |
*/ | |
has: function(key) { | |
var values = this.values, | |
guid = guidFor(key); | |
return values.hasOwnProperty(guid); | |
}, | |
/** | |
Iterate over all the keys and values. Calls the function once | |
for each key, passing in the key and value, in that order. | |
The keys are guaranteed to be iterated over in insertion order. | |
@method forEach | |
@param {Function} callback | |
@param {*} self if passed, the `this` value inside the | |
callback. By default, `this` is the map. | |
*/ | |
forEach: function(callback, self) { | |
var keys = this.keys, | |
values = this.values; | |
keys.forEach(function(key) { | |
var guid = guidFor(key); | |
callback.call(self, key, values[guid]); | |
}); | |
}, | |
/** | |
@method copy | |
@return {Ember.Map} | |
*/ | |
copy: function() { | |
return copyMap(this, new Map()); | |
} | |
}; | |
/** | |
@class MapWithDefault | |
@namespace Ember | |
@extends Ember.Map | |
@private | |
@constructor | |
@param [options] | |
@param {*} [options.defaultValue] | |
*/ | |
function MapWithDefault(options) { | |
Map.call(this); | |
this.defaultValue = options.defaultValue; | |
} | |
/** | |
@method create | |
@static | |
@param [options] | |
@param {*} [options.defaultValue] | |
@return {Ember.MapWithDefault|Ember.Map} If options are passed, returns | |
`Ember.MapWithDefault` otherwise returns `Ember.Map` | |
*/ | |
MapWithDefault.create = function(options) { | |
if (options) { | |
return new MapWithDefault(options); | |
} else { | |
return new Map(); | |
} | |
}; | |
MapWithDefault.prototype = create(Map.prototype); | |
/** | |
Retrieve the value associated with a given key. | |
@method get | |
@param {*} key | |
@return {*} the value associated with the key, or the default value | |
*/ | |
MapWithDefault.prototype.get = function(key) { | |
var hasValue = this.has(key); | |
if (hasValue) { | |
return Map.prototype.get.call(this, key); | |
} else { | |
var defaultValue = this.defaultValue(key); | |
this.set(key, defaultValue); | |
return defaultValue; | |
} | |
}; | |
/** | |
@method copy | |
@return {Ember.MapWithDefault} | |
*/ | |
MapWithDefault.prototype.copy = function() { | |
return copyMap(this, new MapWithDefault({ | |
defaultValue: this.defaultValue | |
})); | |
}; | |
__exports__.OrderedSet = OrderedSet; | |
__exports__.Map = Map; | |
__exports__.MapWithDefault = MapWithDefault; | |
}); | |
define("ember-metal/merge", | |
["exports"], | |
function(__exports__) { | |
"use strict"; | |
/** | |
Merge the contents of two objects together into the first object. | |
```javascript | |
Ember.merge({first: 'Tom'}, {last: 'Dale'}); // {first: 'Tom', last: 'Dale'} | |
var a = {first: 'Yehuda'}, b = {last: 'Katz'}; | |
Ember.merge(a, b); // a == {first: 'Yehuda', last: 'Katz'}, b == {last: 'Katz'} | |
``` | |
@method merge | |
@for Ember | |
@param {Object} original The object to merge into | |
@param {Object} updates The object to copy properties from | |
@return {Object} | |
*/ | |
__exports__["default"] = function merge(original, updates) { | |
for (var prop in updates) { | |
if (!updates.hasOwnProperty(prop)) { continue; } | |
original[prop] = updates[prop]; | |
} | |
return original; | |
} | |
}); | |
define("ember-metal/mixin", | |
["ember-metal/core","ember-metal/merge","ember-metal/array","ember-metal/platform","ember-metal/utils","ember-metal/expand_properties","ember-metal/properties","ember-metal/computed","ember-metal/binding","ember-metal/observer","ember-metal/events","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __dependency6__, __dependency7__, __dependency8__, __dependency9__, __dependency10__, __dependency11__, __exports__) { | |
"use strict"; | |
/** | |
@module ember | |
@submodule ember-metal | |
*/ | |
var Ember = __dependency1__["default"]; | |
// warn, assert, wrap, et; | |
var merge = __dependency2__["default"]; | |
var map = __dependency3__.map; | |
var indexOf = __dependency3__.indexOf; | |
var forEach = __dependency3__.forEach; | |
var create = __dependency4__.create; | |
var guidFor = __dependency5__.guidFor; | |
var meta = __dependency5__.meta; | |
var META_KEY = __dependency5__.META_KEY; | |
var wrap = __dependency5__.wrap; | |
var makeArray = __dependency5__.makeArray; | |
var apply = __dependency5__.apply; | |
var expandProperties = __dependency6__["default"]; | |
var Descriptor = __dependency7__.Descriptor; | |
var defineProperty = __dependency7__.defineProperty; | |
var ComputedProperty = __dependency8__.ComputedProperty; | |
var Binding = __dependency9__.Binding; | |
var addObserver = __dependency10__.addObserver; | |
var removeObserver = __dependency10__.removeObserver; | |
var addBeforeObserver = __dependency10__.addBeforeObserver; | |
var removeBeforeObserver = __dependency10__.removeBeforeObserver; | |
var addListener = __dependency11__.addListener; | |
var removeListener = __dependency11__.removeListener; | |
var REQUIRED, | |
a_map = map, | |
a_indexOf = indexOf, | |
a_forEach = forEach, | |
a_slice = [].slice, | |
o_create = create, | |
metaFor = meta; | |
function superFunction(){ | |
var ret, func = this.__nextSuper; | |
if (func) { | |
this.__nextSuper = null; | |
ret = apply(this, func, arguments); | |
this.__nextSuper = func; | |
} | |
return ret; | |
} | |
function mixinsMeta(obj) { | |
var m = metaFor(obj, true), ret = m.mixins; | |
if (!ret) { | |
ret = m.mixins = {}; | |
} else if (!m.hasOwnProperty('mixins')) { | |
ret = m.mixins = o_create(ret); | |
} | |
return ret; | |
} | |
function initMixin(mixin, args) { | |
if (args && args.length > 0) { | |
mixin.mixins = a_map.call(args, function(x) { | |
if (x instanceof Mixin) { return x; } | |
// Note: Manually setup a primitive mixin here. This is the only | |
// way to actually get a primitive mixin. This way normal creation | |
// of mixins will give you combined mixins... | |
var mixin = new Mixin(); | |
mixin.properties = x; | |
return mixin; | |
}); | |
} | |
return mixin; | |
} | |
function isMethod(obj) { | |
return 'function' === typeof obj && | |
obj.isMethod !== false && | |
obj !== Boolean && obj !== Object && obj !== Number && obj !== Array && obj !== Date && obj !== String; | |
} | |
var CONTINUE = {}; | |
function mixinProperties(mixinsMeta, mixin) { | |
var guid; | |
if (mixin instanceof Mixin) { | |
guid = guidFor(mixin); | |
if (mixinsMeta[guid]) { return CONTINUE; } | |
mixinsMeta[guid] = mixin; | |
return mixin.properties; | |
} else { | |
return mixin; // apply anonymous mixin properties | |
} | |
} | |
function concatenatedMixinProperties(concatProp, props, values, base) { | |
var concats; | |
// reset before adding each new mixin to pickup concats from previous | |
concats = values[concatProp] || base[concatProp]; | |
if (props[concatProp]) { | |
concats = concats ? concats.concat(props[concatProp]) : props[concatProp]; | |
} | |
return concats; | |
} | |
function giveDescriptorSuper(meta, key, property, values, descs) { | |
var superProperty; | |
// Computed properties override methods, and do not call super to them | |
if (values[key] === undefined) { | |
// Find the original descriptor in a parent mixin | |
superProperty = descs[key]; | |
} | |
// If we didn't find the original descriptor in a parent mixin, find | |
// it on the original object. | |
superProperty = superProperty || meta.descs[key]; | |
if (!superProperty || !(superProperty instanceof ComputedProperty)) { | |
return property; | |
} | |
// Since multiple mixins may inherit from the same parent, we need | |
// to clone the computed property so that other mixins do not receive | |
// the wrapped version. | |
property = o_create(property); | |
property.func = wrap(property.func, superProperty.func); | |
return property; | |
} | |
function giveMethodSuper(obj, key, method, values, descs) { | |
var superMethod; | |
// Methods overwrite computed properties, and do not call super to them. | |
if (descs[key] === undefined) { | |
// Find the original method in a parent mixin | |
superMethod = values[key]; | |
} | |
// If we didn't find the original value in a parent mixin, find it in | |
// the original object | |
superMethod = superMethod || obj[key]; | |
// Only wrap the new method if the original method was a function | |
if ('function' !== typeof superMethod) { | |
return method; | |
} | |
return wrap(method, superMethod); | |
} | |
function applyConcatenatedProperties(obj, key, value, values) { | |
var baseValue = values[key] || obj[key]; | |
if (baseValue) { | |
if ('function' === typeof baseValue.concat) { | |
return baseValue.concat(value); | |
} else { | |
return makeArray(baseValue).concat(value); | |
} | |
} else { | |
return makeArray(value); | |
} | |
} | |
function applyMergedProperties(obj, key, value, values) { | |
var baseValue = values[key] || obj[key]; | |
if (!baseValue) { return value; } | |
var newBase = merge({}, baseValue), | |
hasFunction = false; | |
for (var prop in value) { | |
if (!value.hasOwnProperty(prop)) { continue; } | |
var propValue = value[prop]; | |
if (isMethod(propValue)) { | |
// TODO: support for Computed Properties, etc? | |
hasFunction = true; | |
newBase[prop] = giveMethodSuper(obj, prop, propValue, baseValue, {}); | |
} else { | |
newBase[prop] = propValue; | |
} | |
} | |
if (hasFunction) { | |
newBase._super = superFunction; | |
} | |
return newBase; | |
} | |
function addNormalizedProperty(base, key, value, meta, descs, values, concats, mergings) { | |
if (value instanceof Descriptor) { | |
if (value === REQUIRED && descs[key]) { return CONTINUE; } | |
// Wrap descriptor function to implement | |
// __nextSuper() if needed | |
if (value.func) { | |
value = giveDescriptorSuper(meta, key, value, values, descs); | |
} | |
descs[key] = value; | |
values[key] = undefined; | |
} else { | |
if ((concats && a_indexOf.call(concats, key) >= 0) || | |
key === 'concatenatedProperties' || | |
key === 'mergedProperties') { | |
value = applyConcatenatedProperties(base, key, value, values); | |
} else if ((mergings && a_indexOf.call(mergings, key) >= 0)) { | |
value = applyMergedProperties(base, key, value, values); | |
} else if (isMethod(value)) { | |
value = giveMethodSuper(base, key, value, values, descs); | |
} | |
descs[key] = undefined; | |
values[key] = value; | |
} | |
} | |
function mergeMixins(mixins, m, descs, values, base, keys) { | |
var mixin, props, key, concats, mergings, meta; | |
function removeKeys(keyName) { | |
delete descs[keyName]; | |
delete values[keyName]; | |
} | |
for(var i=0, l=mixins.length; i<l; i++) { | |
mixin = mixins[i]; | |
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]'); | |
props = mixinProperties(m, mixin); | |
if (props === CONTINUE) { continue; } | |
if (props) { | |
meta = metaFor(base); | |
if (base.willMergeMixin) { base.willMergeMixin(props); } | |
concats = concatenatedMixinProperties('concatenatedProperties', props, values, base); | |
mergings = concatenatedMixinProperties('mergedProperties', props, values, base); | |
for (key in props) { | |
if (!props.hasOwnProperty(key)) { continue; } | |
keys.push(key); | |
addNormalizedProperty(base, key, props[key], meta, descs, values, concats, mergings); | |
} | |
// 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, keys); | |
if (mixin._without) { a_forEach.call(mixin._without, removeKeys); } | |
} | |
} | |
} | |
var IS_BINDING = /^.+Binding$/; | |
function detectBinding(obj, key, value, m) { | |
if (IS_BINDING.test(key)) { | |
var bindings = m.bindings; | |
if (!bindings) { | |
bindings = m.bindings = {}; | |
} else if (!m.hasOwnProperty('bindings')) { | |
bindings = m.bindings = o_create(m.bindings); | |
} | |
bindings[key] = value; | |
} | |
} | |
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 = bindings[key]; | |
if (binding) { | |
to = key.slice(0, -7); // strip Binding off end | |
if (binding instanceof Binding) { | |
binding = binding.copy(); // copy prototypes' instance | |
binding.to(to); | |
} else { // binding is string path | |
binding = new Binding(to, binding); | |
} | |
binding.connect(obj); | |
obj[key] = binding; | |
} | |
} | |
// mark as applied | |
m.bindings = {}; | |
} | |
} | |
function finishPartial(obj, m) { | |
connectBindings(obj, m || metaFor(obj)); | |
return obj; | |
} | |
function followAlias(obj, desc, m, descs, values) { | |
var altKey = desc.methodName, value; | |
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]; | |
} | |
return { desc: desc, value: value }; | |
} | |
function updateObserversAndListeners(obj, key, observerOrListener, pathsKey, updateMethod) { | |
var paths = observerOrListener[pathsKey]; | |
if (paths) { | |
for (var i=0, l=paths.length; i<l; i++) { | |
updateMethod(obj, paths[i], null, key); | |
} | |
} | |
} | |
function replaceObserversAndListeners(obj, key, observerOrListener) { | |
var prev = obj[key]; | |
if ('function' === typeof prev) { | |
updateObserversAndListeners(obj, key, prev, '__ember_observesBefore__', removeBeforeObserver); | |
updateObserversAndListeners(obj, key, prev, '__ember_observes__', removeObserver); | |
updateObserversAndListeners(obj, key, prev, '__ember_listens__', removeListener); | |
} | |
if ('function' === typeof observerOrListener) { | |
updateObserversAndListeners(obj, key, observerOrListener, '__ember_observesBefore__', addBeforeObserver); | |
updateObserversAndListeners(obj, key, observerOrListener, '__ember_observes__', addObserver); | |
updateObserversAndListeners(obj, key, observerOrListener, '__ember_listens__', addListener); | |
} | |
} | |
function applyMixin(obj, mixins, partial) { | |
var descs = {}, values = {}, m = metaFor(obj), | |
key, value, desc, keys = []; | |
obj._super = superFunction; | |
// Go through all mixins and hashes passed in, and: | |
// | |
// * Handle concatenated properties | |
// * Handle merged properties | |
// * Set up _super wrapping if necessary | |
// * Set up computed property descriptors | |
// * Copying `toString` in broken browsers | |
mergeMixins(mixins, mixinsMeta(obj), descs, values, obj, keys); | |
for(var i = 0, l = keys.length; i < l; i++) { | |
key = keys[i]; | |
if (key === 'constructor' || !values.hasOwnProperty(key)) { continue; } | |
desc = descs[key]; | |
value = values[key]; | |
if (desc === REQUIRED) { continue; } | |
while (desc && desc instanceof Alias) { | |
var followed = followAlias(obj, desc, m, descs, values); | |
desc = followed.desc; | |
value = followed.value; | |
} | |
if (desc === undefined && value === undefined) { continue; } | |
replaceObserversAndListeners(obj, key, value); | |
detectBinding(obj, key, value, m); | |
defineProperty(obj, key, desc, value, m); | |
} | |
if (!partial) { // don't apply to prototype | |
finishPartial(obj, m); | |
} | |
return obj; | |
} | |
/** | |
@method mixin | |
@for Ember | |
@param obj | |
@param mixins* | |
@return obj | |
*/ | |
function mixin(obj) { | |
var args = a_slice.call(arguments, 1); | |
applyMixin(obj, args, false); | |
return obj; | |
} | |
__exports__.mixin = mixin;/** | |
The `Ember.Mixin` class allows you to create mixins, whose properties can be | |
added to other classes. For instance, | |
```javascript | |
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. | |
App.CommentView = Ember.View.extend(App.Editable, { | |
template: Ember.Handlebars.compile('{{#if view.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`. | |
Note that mixins extend a constructor's prototype so arrays and object literals | |
defined as properties will be shared amongst objects that implement the mixin. | |
If you want to define a property in a mixin that is not shared, you can define | |
it either as a computed property or have it be created on initialization of the object. | |
```javascript | |
//filters array will be shared amongst any object implementing mixin | |
App.Filterable = Ember.Mixin.create({ | |
filters: Ember.A() | |
}); | |
//filters will be a separate array for every object implementing the mixin | |
App.Filterable = Ember.Mixin.create({ | |
filters: Ember.computed(function(){return Ember.A();}) | |
}); | |
//filters will be created as a separate array during the object's initialization | |
App.Filterable = Ember.Mixin.create({ | |
init: function() { | |
this._super(); | |
this.set("filters", Ember.A()); | |
} | |
}); | |
``` | |
@class Mixin | |
@namespace Ember | |
*/ | |
__exports__["default"] = Mixin; | |
function Mixin() { return initMixin(this, arguments); } | |
Mixin.prototype = { | |
properties: null, | |
mixins: null, | |
ownerConstructor: null | |
}; | |
Mixin._apply = applyMixin; | |
Mixin.applyPartial = function(obj) { | |
var args = a_slice.call(arguments, 1); | |
return applyMixin(obj, args, true); | |
}; | |
Mixin.finishPartial = finishPartial; | |
// ES6TODO: this relies on a global state? | |
Ember.anyUnprocessedMixins = false; | |
/** | |
@method create | |
@static | |
@param arguments* | |
*/ | |
Mixin.create = function() { | |
// ES6TODO: this relies on a global state? | |
Ember.anyUnprocessedMixins = true; | |
var M = this; | |
return initMixin(new M(), arguments); | |
}; | |
var MixinPrototype = Mixin.prototype; | |
/** | |
@method reopen | |
@param arguments* | |
*/ | |
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; | |
}; | |
/** | |
@method apply | |
@param obj | |
@return applied object | |
*/ | |
MixinPrototype.apply = function(obj) { | |
return applyMixin(obj, [this], false); | |
}; | |
MixinPrototype.applyPartial = function(obj) { | |
return applyMixin(obj, [this], true); | |
}; | |
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; | |
} | |
/** | |
@method detect | |
@param obj | |
@return {Boolean} | |
*/ | |
MixinPrototype.detect = function(obj) { | |
if (!obj) { return false; } | |
if (obj instanceof Mixin) { return _detect(obj, this, {}); } | |
var m = obj[META_KEY], | |
mixins = m && m.mixins; | |
if (mixins) { | |
return !!mixins[guidFor(this)]; | |
} | |
return false; | |
}; | |
MixinPrototype.without = function() { | |
var ret = new Mixin(this); | |
ret._without = a_slice.call(arguments); | |
return ret; | |
}; | |
function _keys(ret, mixin, seen) { | |
if (seen[guidFor(mixin)]) { return; } | |
seen[guidFor(mixin)] = true; | |
if (mixin.properties) { | |
var props = mixin.properties; | |
for (var key in props) { | |
if (props.hasOwnProperty(key)) { ret[key] = true; } | |
} | |
} else if (mixin.mixins) { | |
a_forEach.call(mixin.mixins, function(x) { _keys(ret, x, seen); }); | |
} | |
} | |
MixinPrototype.keys = function() { | |
var keys = {}, seen = {}, ret = []; | |
_keys(keys, this, seen); | |
for(var key in keys) { | |
if (keys.hasOwnProperty(key)) { ret.push(key); } | |
} | |
return ret; | |
}; | |
// returns the mixins currently applied to the specified object | |
// TODO: Make Ember.mixin | |
Mixin.mixins = function(obj) { | |
var m = obj[META_KEY], | |
mixins = m && m.mixins, ret = []; | |
if (!mixins) { return ret; } | |
for (var key in mixins) { | |
var mixin = mixins[key]; | |
// skip primitive mixins since these are always anonymous | |
if (!mixin.properties) { ret.push(mixin); } | |
} | |
return ret; | |
}; | |
REQUIRED = new Descriptor(); | |
REQUIRED.toString = function() { return '(Required Property)'; }; | |
/** | |
Denotes a required property for a mixin | |
@method required | |
@for Ember | |
*/ | |
function required() { | |
return REQUIRED; | |
} | |
__exports__.required = required;function Alias(methodName) { | |
this.methodName = methodName; | |
} | |
Alias.prototype = new Descriptor(); | |
/** | |
Makes a method available via an additional name. | |
```javascript | |
App.Person = Ember.Object.extend({ | |
name: function() { | |
return 'Tomhuda Katzdale'; | |
}, | |
moniker: Ember.aliasMethod('name') | |
}); | |
var goodGuy = App.Person.create() | |
``` | |
@method aliasMethod | |
@for Ember | |
@param {String} methodName name of the method to alias | |
@return {Ember.Descriptor} | |
*/ | |
function aliasMethod(methodName) { | |
return new Alias(methodName); | |
} | |
__exports__.aliasMethod = aliasMethod;// .......................................................... | |
// OBSERVER HELPER | |
// | |
/** | |
Specify a method that observes property changes. | |
```javascript | |
Ember.Object.extend({ | |
valueObserver: Ember.observer('value', function() { | |
// Executes whenever the "value" property changes | |
}) | |
}); | |
``` | |
In the future this method may become asynchronous. If you want to ensure | |
synchronous behavior, use `immediateObserver`. | |
Also available as `Function.prototype.observes` if prototype extensions are | |
enabled. | |
@method observer | |
@for Ember | |
@param {String} propertyNames* | |
@param {Function} func | |
@return func | |
*/ | |
function observer() { | |
var func = a_slice.call(arguments, -1)[0]; | |
var paths; | |
var addWatchedProperty = function (path) { paths.push(path); }; | |
var _paths = a_slice.call(arguments, 0, -1); | |
if (typeof func !== "function") { | |
// revert to old, soft-deprecated argument ordering | |
func = arguments[0]; | |
_paths = a_slice.call(arguments, 1); | |
} | |
paths = []; | |
for (var i=0; i<_paths.length; ++i) { | |
expandProperties(_paths[i], addWatchedProperty); | |
} | |
if (typeof func !== "function") { | |
throw new Ember.Error("Ember.observer called without a function"); | |
} | |
func.__ember_observes__ = paths; | |
return func; | |
} | |
__exports__.observer = observer;/** | |
Specify a method that observes property changes. | |
```javascript | |
Ember.Object.extend({ | |
valueObserver: Ember.immediateObserver('value', function() { | |
// Executes whenever the "value" property changes | |
}) | |
}); | |
``` | |
In the future, `Ember.observer` may become asynchronous. In this event, | |
`Ember.immediateObserver` will maintain the synchronous behavior. | |
Also available as `Function.prototype.observesImmediately` if prototype extensions are | |
enabled. | |
@method immediateObserver | |
@for Ember | |
@param {String} propertyNames* | |
@param {Function} func | |
@return func | |
*/ | |
function immediateObserver() { | |
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 observer.apply(this, arguments); | |
} | |
__exports__.immediateObserver = immediateObserver;/** | |
When observers fire, they are called with the arguments `obj`, `keyName`. | |
Note, `@each.property` observer is called per each add or replace of an element | |
and it's not called with a specific enumeration item. | |
A `beforeObserver` fires before a property changes. | |
A `beforeObserver` is an alternative form of `.observesBefore()`. | |
```javascript | |
App.PersonView = Ember.View.extend({ | |
friends: [{ name: 'Tom' }, { name: 'Stefan' }, { name: 'Kris' }], | |
valueWillChange: Ember.beforeObserver('content.value', function(obj, keyName) { | |
this.changingFrom = obj.get(keyName); | |
}), | |
valueDidChange: Ember.observer('content.value', function(obj, keyName) { | |
// only run if updating a value already in the DOM | |
if (this.get('state') === 'inDOM') { | |
var color = obj.get(keyName) > this.changingFrom ? 'green' : 'red'; | |
// logic | |
} | |
}), | |
friendsDidChange: Ember.observer('[email protected]', function(obj, keyName) { | |
// some logic | |
// obj.get(keyName) returns friends array | |
}) | |
}); | |
``` | |
Also available as `Function.prototype.observesBefore` if prototype extensions are | |
enabled. | |
@method beforeObserver | |
@for Ember | |
@param {String} propertyNames* | |
@param {Function} func | |
@return func | |
*/ | |
function beforeObserver() { | |
var func = a_slice.call(arguments, -1)[0]; | |
var paths; | |
var addWatchedProperty = function(path) { paths.push(path); }; | |
var _paths = a_slice.call(arguments, 0, -1); | |
if (typeof func !== "function") { | |
// revert to old, soft-deprecated argument ordering | |
func = arguments[0]; | |
_paths = a_slice.call(arguments, 1); | |
} | |
paths = []; | |
for (var i=0; i<_paths.length; ++i) { | |
expandProperties(_paths[i], addWatchedProperty); | |
} | |
if (typeof func !== "function") { | |
throw new Ember.Error("Ember.beforeObserver called without a function"); | |
} | |
func.__ember_observesBefore__ = paths; | |
return func; | |
} | |
__exports__.beforeObserver = beforeObserver;__exports__.IS_BINDING = IS_BINDING; | |
__exports__.Mixin = Mixin; | |
}); | |
define("ember-metal/observer", | |
["ember-metal/watching","ember-metal/array","ember-metal/events","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __exports__) { | |
"use strict"; | |
var watch = __dependency1__.watch; | |
var unwatch = __dependency1__.unwatch; | |
var map = __dependency2__.map; | |
var listenersFor = __dependency3__.listenersFor; | |
var addListener = __dependency3__.addListener; | |
var removeListener = __dependency3__.removeListener; | |
var suspendListeners = __dependency3__.suspendListeners; | |
var suspendListener = __dependency3__.suspendListener; | |
/** | |
@module ember-metal | |
*/ | |
var AFTER_OBSERVERS = ':change'; | |
var BEFORE_OBSERVERS = ':before'; | |
function changeEvent(keyName) { | |
return keyName + AFTER_OBSERVERS; | |
} | |
function beforeEvent(keyName) { | |
return keyName + BEFORE_OBSERVERS; | |
} | |
/** | |
@method addObserver | |
@for Ember | |
@param obj | |
@param {String} path | |
@param {Object|Function} targetOrMethod | |
@param {Function|String} [method] | |
*/ | |
function addObserver(obj, _path, target, method) { | |
addListener(obj, changeEvent(_path), target, method); | |
watch(obj, _path); | |
return this; | |
} | |
__exports__.addObserver = addObserver;function observersFor(obj, path) { | |
return listenersFor(obj, changeEvent(path)); | |
} | |
__exports__.observersFor = observersFor;/** | |
@method removeObserver | |
@for Ember | |
@param obj | |
@param {String} path | |
@param {Object|Function} targetOrMethod | |
@param {Function|String} [method] | |
*/ | |
function removeObserver(obj, _path, target, method) { | |
unwatch(obj, _path); | |
removeListener(obj, changeEvent(_path), target, method); | |
return this; | |
} | |
__exports__.removeObserver = removeObserver;/** | |
@method addBeforeObserver | |
@for Ember | |
@param obj | |
@param {String} path | |
@param {Object|Function} targetOrMethod | |
@param {Function|String} [method] | |
*/ | |
function addBeforeObserver(obj, _path, target, method) { | |
addListener(obj, beforeEvent(_path), target, method); | |
watch(obj, _path); | |
return this; | |
} | |
__exports__.addBeforeObserver = addBeforeObserver;// Suspend observer during callback. | |
// | |
// This should only be used by the target of the observer | |
// while it is setting the observed path. | |
function _suspendBeforeObserver(obj, path, target, method, callback) { | |
return suspendListener(obj, beforeEvent(path), target, method, callback); | |
} | |
__exports__._suspendBeforeObserver = _suspendBeforeObserver;function _suspendObserver(obj, path, target, method, callback) { | |
return suspendListener(obj, changeEvent(path), target, method, callback); | |
} | |
__exports__._suspendObserver = _suspendObserver;function _suspendBeforeObservers(obj, paths, target, method, callback) { | |
var events = map.call(paths, beforeEvent); | |
return suspendListeners(obj, events, target, method, callback); | |
} | |
__exports__._suspendBeforeObservers = _suspendBeforeObservers;function _suspendObservers(obj, paths, target, method, callback) { | |
var events = map.call(paths, changeEvent); | |
return suspendListeners(obj, events, target, method, callback); | |
} | |
__exports__._suspendObservers = _suspendObservers;function beforeObserversFor(obj, path) { | |
return listenersFor(obj, beforeEvent(path)); | |
} | |
__exports__.beforeObserversFor = beforeObserversFor;/** | |
@method removeBeforeObserver | |
@for Ember | |
@param obj | |
@param {String} path | |
@param {Object|Function} targetOrMethod | |
@param {Function|String} [method] | |
*/ | |
function removeBeforeObserver(obj, _path, target, method) { | |
unwatch(obj, _path); | |
removeListener(obj, beforeEvent(_path), target, method); | |
return this; | |
} | |
__exports__.removeBeforeObserver = removeBeforeObserver; | |
}); | |
define("ember-metal/observer_set", | |
["ember-metal/utils","ember-metal/events","exports"], | |
function(__dependency1__, __dependency2__, __exports__) { | |
"use strict"; | |
var guidFor = __dependency1__.guidFor; | |
var sendEvent = __dependency2__.sendEvent; | |
/* | |
this.observerSet = { | |
[senderGuid]: { // variable name: `keySet` | |
[keyName]: listIndex | |
} | |
}, | |
this.observers = [ | |
{ | |
sender: obj, | |
keyName: keyName, | |
eventName: eventName, | |
listeners: [ | |
[target, method, flags] | |
] | |
}, | |
... | |
] | |
*/ | |
__exports__["default"] = ObserverSet; | |
function ObserverSet() { | |
this.clear(); | |
} | |
ObserverSet.prototype.add = function(sender, keyName, eventName) { | |
var observerSet = this.observerSet, | |
observers = this.observers, | |
senderGuid = guidFor(sender), | |
keySet = observerSet[senderGuid], | |
index; | |
if (!keySet) { | |
observerSet[senderGuid] = keySet = {}; | |
} | |
index = keySet[keyName]; | |
if (index === undefined) { | |
index = observers.push({ | |
sender: sender, | |
keyName: keyName, | |
eventName: eventName, | |
listeners: [] | |
}) - 1; | |
keySet[keyName] = index; | |
} | |
return observers[index].listeners; | |
}; | |
ObserverSet.prototype.flush = function() { | |
var observers = this.observers, i, len, observer, sender; | |
this.clear(); | |
for (i=0, len=observers.length; i < len; ++i) { | |
observer = observers[i]; | |
sender = observer.sender; | |
if (sender.isDestroying || sender.isDestroyed) { continue; } | |
sendEvent(sender, observer.eventName, [sender, observer.keyName], observer.listeners); | |
} | |
}; | |
ObserverSet.prototype.clear = function() { | |
this.observerSet = {}; | |
this.observers = []; | |
}; | |
}); | |
define("ember-metal/platform", | |
["ember-metal/core","exports"], | |
function(__dependency1__, __exports__) { | |
"use strict"; | |
/*globals Node */ | |
var Ember = __dependency1__["default"]; | |
/** | |
@module ember-metal | |
*/ | |
/** | |
Platform specific methods and feature detectors needed by the framework. | |
@class platform | |
@namespace Ember | |
@static | |
*/ | |
// TODO remove this | |
var platform = {}; | |
/** | |
Identical to `Object.create()`. Implements if not available natively. | |
@method create | |
@for Ember | |
*/ | |
var create = Object.create; | |
// IE8 has Object.create but it couldn't treat property descriptors. | |
if (create) { | |
if (create({a: 1}, {a: {value: 2}}).a !== 2) { | |
create = null; | |
} | |
} | |
// STUB_OBJECT_CREATE allows us to override other libraries that stub | |
// Object.create different than we would prefer | |
if (!create || Ember.ENV.STUB_OBJECT_CREATE) { | |
var K = function() {}; | |
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; | |
}; | |
create.isSimulated = true; | |
} | |
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) { | |
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. | |
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. | |
canDefinePropertyOnDOM = (function() { | |
try { | |
defineProperty(document.createElement('div'), 'definePropertyOnDOM', {}); | |
return true; | |
} catch(e) { } | |
return false; | |
})(); | |
if (!canRedefineProperties) { | |
defineProperty = null; | |
} else if (!canDefinePropertyOnDOM) { | |
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); | |
} | |
}; | |
} | |
} | |
/** | |
@class platform | |
@namespace Ember | |
*/ | |
/** | |
Identical to `Object.defineProperty()`. Implements as much functionality | |
as possible if not available natively. | |
@method defineProperty | |
@param {Object} obj The object to modify | |
@param {String} keyName property name to modify | |
@param {Object} desc descriptor hash | |
@return {void} | |
*/ | |
platform.defineProperty = defineProperty; | |
/** | |
Set to true if the platform supports native getters and setters. | |
@property hasPropertyAccessors | |
@final | |
*/ | |
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; | |
} | |
__exports__.create = create; | |
__exports__.platform = platform; | |
}); | |
define("ember-metal/properties", | |
["ember-metal/core","ember-metal/utils","ember-metal/platform","ember-metal/property_events","ember-metal/property_get","ember-metal/property_set","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __dependency6__, __exports__) { | |
"use strict"; | |
/** | |
@module ember-metal | |
*/ | |
var Ember = __dependency1__["default"]; | |
var META_KEY = __dependency2__.META_KEY; | |
var meta = __dependency2__.meta; | |
var platform = __dependency3__.platform; | |
var overrideChains = __dependency4__.overrideChains; | |
var get = __dependency5__.get; | |
var set = __dependency6__.set; | |
var metaFor = meta, | |
objectDefineProperty = platform.defineProperty; | |
var MANDATORY_SETTER = Ember.ENV.MANDATORY_SETTER; | |
// .......................................................... | |
// DESCRIPTOR | |
// | |
/** | |
Objects of this type can implement an interface to respond to requests to | |
get and set. The default implementation handles simple properties. | |
You generally won't need to create or subclass this directly. | |
@class Descriptor | |
@namespace Ember | |
@private | |
@constructor | |
*/ | |
function Descriptor() {} | |
__exports__.Descriptor = Descriptor;// .......................................................... | |
// DEFINING PROPERTIES API | |
// | |
var MANDATORY_SETTER_FUNCTION = Ember.MANDATORY_SETTER_FUNCTION = function(value) { | |
Ember.assert("You must use Ember.set() to access this property (of " + this + ")", false); | |
}; | |
var DEFAULT_GETTER_FUNCTION = Ember.DEFAULT_GETTER_FUNCTION = function DEFAULT_GETTER_FUNCTION(name) { | |
return function() { | |
var meta = this[META_KEY]; | |
return meta && meta.values[name]; | |
}; | |
}; | |
/** | |
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 | |
```javascript | |
// 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')); | |
``` | |
@private | |
@method defineProperty | |
@for Ember | |
@param {Object} obj the object to define this property on. This may be a prototype. | |
@param {String} keyName the name of the property | |
@param {Ember.Descriptor} [desc] an instance of `Ember.Descriptor` (typically a | |
computed property) or an ES5 descriptor. | |
You must provide this or `data` but not both. | |
@param {*} [data] something other than a descriptor, that will | |
become the explicit value of this property. | |
*/ | |
function defineProperty(obj, keyName, desc, data, meta) { | |
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 Descriptor) { | |
existingDesc.teardown(obj, keyName); | |
} | |
if (desc instanceof 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 | |
} | |
} else { | |
descs[keyName] = undefined; // shadow descriptor in proto | |
if (desc == null) { | |
value = data; | |
if (MANDATORY_SETTER && watching) { | |
meta.values[keyName] = data; | |
objectDefineProperty(obj, keyName, { | |
configurable: true, | |
enumerable: true, | |
set: MANDATORY_SETTER_FUNCTION, | |
get: DEFAULT_GETTER_FUNCTION(keyName) | |
}); | |
} else { | |
obj[keyName] = data; | |
} | |
} else { | |
value = desc; | |
// compatibility with ES5 | |
objectDefineProperty(obj, keyName, desc); | |
} | |
} | |
// if key is being watched, override chains that | |
// were initialized with the prototype | |
if (watching) { 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; | |
} | |
__exports__.defineProperty = defineProperty;/** | |
Used internally to allow changing properties in a backwards compatible way, and print a helpful | |
deprecation warning. | |
@method deprecateProperty | |
@param {Object} object The object to add the deprecated property to. | |
@param {String} deprecatedKey The property to add (and print deprecation warnings upon accessing). | |
@param {String} newKey The property that will be aliased. | |
@private | |
*/ | |
function deprecateProperty(object, deprecatedKey, newKey) { | |
function deprecate() { | |
Ember.deprecate('Usage of `' + deprecatedKey + '` is deprecated, use `' + newKey + '` instead.'); | |
} | |
if (platform.hasPropertyAccessors) { | |
defineProperty(object, deprecatedKey, { | |
configurable: true, | |
enumerable: false, | |
set: function(value) { deprecate(); set(object, newKey, value); }, | |
get: function() { deprecate(); return get(object, newKey); } | |
}); | |
} | |
} | |
__exports__.deprecateProperty = deprecateProperty; | |
}); | |
define("ember-metal/property_events", | |
["ember-metal/utils","ember-metal/events","ember-metal/observer_set","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __exports__) { | |
"use strict"; | |
var META_KEY = __dependency1__.META_KEY; | |
var guidFor = __dependency1__.guidFor; | |
var tryFinally = __dependency1__.tryFinally; | |
var sendEvent = __dependency2__.sendEvent; | |
var listenersUnion = __dependency2__.listenersUnion; | |
var listenersDiff = __dependency2__.listenersDiff; | |
var ObserverSet = __dependency3__["default"]; | |
var beforeObserverSet = new ObserverSet(); | |
var observerSet = new ObserverSet(); | |
var deferred = 0; | |
// .......................................................... | |
// PROPERTY CHANGES | |
// | |
/** | |
This function is called just before an object property is about to change. | |
It will notify any before observers and prepare caches among other things. | |
Normally you will not need to call this method directly but if for some | |
reason you can't directly watch a property you can invoke this method | |
manually along with `Ember.propertyDidChange()` which you should call just | |
after the property value changes. | |
@method propertyWillChange | |
@for Ember | |
@param {Object} obj The object with the property that will change | |
@param {String} keyName The property key (or path) that will change. | |
@return {void} | |
*/ | |
function propertyWillChange(obj, keyName) { | |
var m = obj[META_KEY], | |
watching = (m && m.watching[keyName] > 0) || keyName === 'length', | |
proto = m && m.proto, | |
desc = m && 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); | |
notifyBeforeObservers(obj, keyName); | |
} | |
/** | |
This function is called just after an object property has changed. | |
It will notify any observers and clear caches among other things. | |
Normally you will not need to call this method directly but if for some | |
reason you can't directly watch a property you can invoke this method | |
manually along with `Ember.propertyWillChange()` which you should call just | |
before the property value changes. | |
@method propertyDidChange | |
@for Ember | |
@param {Object} obj The object with the property that will change | |
@param {String} keyName The property key (or path) that will change. | |
@return {void} | |
*/ | |
function propertyDidChange(obj, keyName) { | |
var m = obj[META_KEY], | |
watching = (m && m.watching[keyName] > 0) || keyName === 'length', | |
proto = m && m.proto, | |
desc = m && 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, false); | |
notifyObservers(obj, keyName); | |
} | |
var WILL_SEEN, DID_SEEN; | |
// called whenever a property is about to change to clear the cache of any dependent keys (and notify those properties of changes, etc...) | |
function dependentKeysWillChange(obj, depKey, meta) { | |
if (obj.isDestroying) { return; } | |
var seen = WILL_SEEN, top = !seen; | |
if (top) { seen = WILL_SEEN = {}; } | |
iterDeps(propertyWillChange, obj, depKey, seen, meta); | |
if (top) { WILL_SEEN = null; } | |
} | |
// called whenever a property has just changed to update dependent keys | |
function dependentKeysDidChange(obj, depKey, meta) { | |
if (obj.isDestroying) { return; } | |
var seen = DID_SEEN, top = !seen; | |
if (top) { seen = DID_SEEN = {}; } | |
iterDeps(propertyDidChange, obj, depKey, seen, meta); | |
if (top) { DID_SEEN = null; } | |
} | |
function iterDeps(method, obj, depKey, seen, meta) { | |
var guid = guidFor(obj); | |
if (!seen[guid]) seen[guid] = {}; | |
if (seen[guid][depKey]) return; | |
seen[guid][depKey] = true; | |
var deps = meta.deps; | |
deps = deps && deps[depKey]; | |
if (deps) { | |
for(var key in deps) { | |
var desc = meta.descs[key]; | |
if (desc && desc._suspended === obj) continue; | |
method(obj, key); | |
} | |
} | |
} | |
function chainsWillChange(obj, keyName, m) { | |
if (!(m.hasOwnProperty('chainWatchers') && | |
m.chainWatchers[keyName])) { | |
return; | |
} | |
var nodes = m.chainWatchers[keyName], | |
events = [], | |
i, l; | |
for(i = 0, l = nodes.length; i < l; i++) { | |
nodes[i].willChange(events); | |
} | |
for (i = 0, l = events.length; i < l; i += 2) { | |
propertyWillChange(events[i], events[i+1]); | |
} | |
} | |
function chainsDidChange(obj, keyName, m, suppressEvents) { | |
if (!(m && m.hasOwnProperty('chainWatchers') && | |
m.chainWatchers[keyName])) { | |
return; | |
} | |
var nodes = m.chainWatchers[keyName], | |
events = suppressEvents ? null : [], | |
i, l; | |
for(i = 0, l = nodes.length; i < l; i++) { | |
nodes[i].didChange(events); | |
} | |
if (suppressEvents) { | |
return; | |
} | |
for (i = 0, l = events.length; i < l; i += 2) { | |
propertyDidChange(events[i], events[i+1]); | |
} | |
} | |
function overrideChains(obj, keyName, m) { | |
chainsDidChange(obj, keyName, m, true); | |
} | |
/** | |
@method beginPropertyChanges | |
@chainable | |
@private | |
*/ | |
function beginPropertyChanges() { | |
deferred++; | |
} | |
/** | |
@method endPropertyChanges | |
@private | |
*/ | |
function endPropertyChanges() { | |
deferred--; | |
if (deferred<=0) { | |
beforeObserverSet.clear(); | |
observerSet.flush(); | |
} | |
} | |
/** | |
Make a series of property changes together in an | |
exception-safe way. | |
```javascript | |
Ember.changeProperties(function() { | |
obj1.set('foo', mayBlowUpWhenSet); | |
obj2.set('bar', baz); | |
}); | |
``` | |
@method changeProperties | |
@param {Function} callback | |
@param [binding] | |
*/ | |
function changeProperties(cb, binding) { | |
beginPropertyChanges(); | |
tryFinally(cb, endPropertyChanges, binding); | |
} | |
function notifyBeforeObservers(obj, keyName) { | |
if (obj.isDestroying) { return; } | |
var eventName = keyName + ':before', listeners, diff; | |
if (deferred) { | |
listeners = beforeObserverSet.add(obj, keyName, eventName); | |
diff = listenersDiff(obj, eventName, listeners); | |
sendEvent(obj, eventName, [obj, keyName], diff); | |
} else { | |
sendEvent(obj, eventName, [obj, keyName]); | |
} | |
} | |
function notifyObservers(obj, keyName) { | |
if (obj.isDestroying) { return; } | |
var eventName = keyName + ':change', listeners; | |
if (deferred) { | |
listeners = observerSet.add(obj, keyName, eventName); | |
listenersUnion(obj, eventName, listeners); | |
} else { | |
sendEvent(obj, eventName, [obj, keyName]); | |
} | |
} | |
__exports__.propertyWillChange = propertyWillChange; | |
__exports__.propertyDidChange = propertyDidChange; | |
__exports__.overrideChains = overrideChains; | |
__exports__.beginPropertyChanges = beginPropertyChanges; | |
__exports__.endPropertyChanges = endPropertyChanges; | |
__exports__.changeProperties = changeProperties; | |
}); | |
define("ember-metal/property_get", | |
["ember-metal/core","ember-metal/utils","ember-metal/error","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __exports__) { | |
"use strict"; | |
/** | |
@module ember-metal | |
*/ | |
var Ember = __dependency1__["default"]; | |
var META_KEY = __dependency2__.META_KEY; | |
var EmberError = __dependency3__["default"]; | |
var get; | |
var MANDATORY_SETTER = Ember.ENV.MANDATORY_SETTER; | |
var IS_GLOBAL_PATH = /^([A-Z$]|([0-9][A-Z$])).*[\.]/; | |
var HAS_THIS = 'this.'; | |
var FIRST_KEY = /^([^\.]+)/; | |
// .......................................................... | |
// GET AND SET | |
// | |
// If we are on a platform that supports accessors we can use those. | |
// Otherwise simulate accessors by looking up the property directly on the | |
// object. | |
/** | |
Gets the value of a property on an object. If the property is computed, | |
the function will be invoked. If the property is not defined but the | |
object implements the `unknownProperty` method then that will be invoked. | |
If you plan to run on IE8 and older browsers then you should use this | |
method anytime you want to retrieve a property on an object that you don't | |
know for sure is private. (Properties beginning with an underscore '_' | |
are considered private.) | |
On all newer browsers, you only need to use this method to retrieve | |
properties if the property might not be defined on the object and you want | |
to respect the `unknownProperty` handler. Otherwise you can ignore this | |
method. | |
Note that if the object itself is `undefined`, this method will throw | |
an error. | |
@method get | |
@for Ember | |
@param {Object} obj The object to retrieve from. | |
@param {String} keyName The property key to retrieve | |
@return {Object} the property value or `null`. | |
*/ | |
var 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; | |
} | |
Ember.assert("Cannot call get with "+ keyName +" key.", !!keyName); | |
Ember.assert("Cannot call get with '"+ keyName +"' on an undefined object.", obj !== undefined); | |
if (obj === null) { return _getPath(obj, keyName); } | |
var meta = obj[META_KEY], desc = meta && meta.descs[keyName], ret; | |
if (desc === undefined && keyName.indexOf('.') !== -1) { | |
return _getPath(obj, keyName); | |
} | |
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; | |
} | |
}; | |
// Currently used only by Ember Data tests | |
if (Ember.config.overrideAccessors) { | |
Ember.get = get; | |
Ember.config.overrideAccessors(); | |
get = Ember.get; | |
} | |
/** | |
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). | |
@private | |
@method normalizeTuple | |
@for Ember | |
@param {Object} target The current target. May be `null`. | |
@param {String} path A path on the target or a global property path. | |
@return {Array} a temporary array with the normalized target/path pair. | |
*/ | |
function normalizeTuple(target, path) { | |
var hasThis = path.indexOf(HAS_THIS) === 0, | |
isGlobal = !hasThis && IS_GLOBAL_PATH.test(path), | |
key; | |
if (!target || isGlobal) target = Ember.lookup; | |
if (hasThis) path = path.slice(5); | |
if (target === Ember.lookup) { | |
key = path.match(FIRST_KEY)[0]; | |
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 EmberError('Path cannot be empty'); | |
return [ target, path ]; | |
} | |
function _getPath(root, path) { | |
var hasThis, parts, tuple, idx, len; | |
// If there is no root and path is a key name, return that | |
// property from the global object. | |
// E.g. get('Ember') -> Ember | |
if (root === null && path.indexOf('.') === -1) { return get(Ember.lookup, path); } | |
// detect complicated paths and normalize them | |
hasThis = path.indexOf(HAS_THIS) === 0; | |
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 != null && idx < len; idx++) { | |
root = get(root, parts[idx], true); | |
if (root && root.isDestroyed) { return undefined; } | |
} | |
return root; | |
} | |
function getWithDefault(root, key, defaultValue) { | |
var value = get(root, key); | |
if (value === undefined) { return defaultValue; } | |
return value; | |
} | |
__exports__.getWithDefault = getWithDefault;__exports__["default"] = get; | |
__exports__.get = get; | |
__exports__.normalizeTuple = normalizeTuple; | |
__exports__._getPath = _getPath; | |
}); | |
define("ember-metal/property_set", | |
["ember-metal/core","ember-metal/property_get","ember-metal/utils","ember-metal/property_events","ember-metal/properties","ember-metal/error","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __dependency6__, __exports__) { | |
"use strict"; | |
var Ember = __dependency1__["default"]; | |
var getPath = __dependency2__._getPath; | |
var META_KEY = __dependency3__.META_KEY; | |
var propertyWillChange = __dependency4__.propertyWillChange; | |
var propertyDidChange = __dependency4__.propertyDidChange; | |
var defineProperty = __dependency5__.defineProperty; | |
var EmberError = __dependency6__["default"]; | |
var MANDATORY_SETTER = Ember.ENV.MANDATORY_SETTER; | |
var IS_GLOBAL = /^([A-Z$]|([0-9][A-Z$]))/; | |
/** | |
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 `setUnknownProperty` | |
method then that will be invoked as well. | |
@method set | |
@for Ember | |
@param {Object} obj The object to modify. | |
@param {String} keyName The property key to set | |
@param {Object} value The value to set | |
@return {Object} the passed value. | |
*/ | |
var 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; | |
} | |
Ember.assert("Cannot call set with "+ keyName +" key.", !!keyName); | |
if (!obj) { | |
return setPath(obj, keyName, value, tolerant); | |
} | |
var meta = obj[META_KEY], desc = meta && meta.descs[keyName], | |
isUnknown, currentValue; | |
if (desc === undefined && 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); | |
if (desc !== undefined) { | |
desc.set(obj, keyName, value); | |
} else { | |
if (typeof obj === 'object' && obj !== null && value !== undefined && obj[keyName] === value) { | |
return value; | |
} | |
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) { | |
propertyWillChange(obj, keyName); | |
if (MANDATORY_SETTER) { | |
if ((currentValue === undefined && !(keyName in obj)) || !obj.propertyIsEnumerable(keyName)) { | |
defineProperty(obj, keyName, null, value); // setup mandatory setter | |
} else { | |
meta.values[keyName] = value; | |
} | |
} else { | |
obj[keyName] = value; | |
} | |
propertyDidChange(obj, keyName); | |
} | |
} else { | |
obj[keyName] = value; | |
} | |
} | |
return value; | |
}; | |
// Currently used only by Ember Data tests | |
// ES6TODO: Verify still true | |
if (Ember.config.overrideAccessors) { | |
Ember.set = set; | |
Ember.config.overrideAccessors(); | |
set = Ember.set; | |
} | |
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 === keyName) ? keyName : 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 EmberError('Property set failed: You passed an empty path'); | |
} | |
if (!root) { | |
if (tolerant) { return; } | |
else { throw new EmberError('Property set failed: object in path "'+path+'" could not be found or was destroyed.'); } | |
} | |
return set(root, keyName, value); | |
} | |
/** | |
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. | |
@method trySet | |
@for Ember | |
@param {Object} obj The object to modify. | |
@param {String} path The property path to set | |
@param {Object} value The value to set | |
*/ | |
function trySet(root, path, value) { | |
return set(root, path, value, true); | |
} | |
__exports__.trySet = trySet;__exports__.set = set; | |
}); | |
define("ember-metal/run_loop", | |
["ember-metal/core","ember-metal/utils","ember-metal/array","ember-metal/property_events","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __exports__) { | |
"use strict"; | |
var Ember = __dependency1__["default"]; | |
var apply = __dependency2__.apply; | |
var indexOf = __dependency3__.indexOf; | |
var beginPropertyChanges = __dependency4__.beginPropertyChanges; | |
var endPropertyChanges = __dependency4__.endPropertyChanges; | |
function onBegin(current) { | |
run.currentRunLoop = current; | |
} | |
function onEnd(current, next) { | |
run.currentRunLoop = next; | |
} | |
// ES6TODO: should Backburner become es6? | |
var Backburner = requireModule('backburner').Backburner; | |
var backburner = new Backburner(['sync', 'actions', 'destroy'], { | |
sync: { | |
before: beginPropertyChanges, | |
after: endPropertyChanges | |
}, | |
defaultQueue: 'actions', | |
onBegin: onBegin, | |
onEnd: onEnd, | |
onErrorTarget: Ember, | |
onErrorMethod: 'onerror' | |
}); | |
var slice = [].slice; | |
var concat = [].concat; | |
// .......................................................... | |
// run - this is ideally the only public API the dev sees | |
// | |
/** | |
Runs the passed target and method inside of a RunLoop, ensuring any | |
deferred actions including bindings and views updates are flushed at the | |
end. | |
Normally you should not need to invoke this method yourself. However if | |
you are implementing raw event handlers when interfacing with other | |
libraries or plugins, you should probably wrap all of your code inside this | |
call. | |
```javascript | |
run(function() { | |
// code to be execute within a RunLoop | |
}); | |
``` | |
@class run | |
@namespace Ember | |
@static | |
@constructor | |
@param {Object} [target] target of method to call | |
@param {Function|String} method Method to invoke. | |
May be a function or a string. If you pass a string | |
then it will be looked up on the passed target. | |
@param {Object} [args*] Any additional arguments you wish to pass to the method. | |
@return {Object} return value from invoking the passed function. | |
*/ | |
__exports__["default"] = run; | |
function run() { | |
return apply(backburner, backburner.run, arguments); | |
} | |
/** | |
If no run-loop is present, it creates a new one. If a run loop is | |
present it will queue itself to run on the existing run-loops action | |
queue. | |
Please note: This is not for normal usage, and should be used sparingly. | |
If invoked when not within a run loop: | |
```javascript | |
run.join(function() { | |
// creates a new run-loop | |
}); | |
``` | |
Alternatively, if called within an existing run loop: | |
```javascript | |
run(function() { | |
// creates a new run-loop | |
run.join(function() { | |
// joins with the existing run-loop, and queues for invocation on | |
// the existing run-loops action queue. | |
}); | |
}); | |
``` | |
@method join | |
@namespace Ember | |
@param {Object} [target] target of method to call | |
@param {Function|String} method Method to invoke. | |
May be a function or a string. If you pass a string | |
then it will be looked up on the passed target. | |
@param {Object} [args*] Any additional arguments you wish to pass to the method. | |
@return {Object} Return value from invoking the passed function. Please note, | |
when called within an existing loop, no return value is possible. | |
*/ | |
run.join = function(target, method /* args */) { | |
if (!run.currentRunLoop) { | |
return apply(Ember, run, arguments); | |
} | |
var args = slice.call(arguments); | |
args.unshift('actions'); | |
apply(run, run.schedule, args); | |
}; | |
/** | |
Provides a useful utility for when integrating with non-Ember libraries | |
that provide asynchronous callbacks. | |
Ember utilizes a run-loop to batch and coalesce changes. This works by | |
marking the start and end of Ember-related Javascript execution. | |
When using events such as a View's click handler, Ember wraps the event | |
handler in a run-loop, but when integrating with non-Ember libraries this | |
can be tedious. | |
For example, the following is rather verbose but is the correct way to combine | |
third-party events and Ember code. | |
```javascript | |
var that = this; | |
jQuery(window).on('resize', function(){ | |
run(function(){ | |
that.handleResize(); | |
}); | |
}); | |
``` | |
To reduce the boilerplate, the following can be used to construct a | |
run-loop-wrapped callback handler. | |
```javascript | |
jQuery(window).on('resize', run.bind(this, this.handleResize)); | |
``` | |
@method bind | |
@namespace run | |
@param {Object} [target] target of method to call | |
@param {Function|String} method Method to invoke. | |
May be a function or a string. If you pass a string | |
then it will be looked up on the passed target. | |
@param {Object} [args*] Any additional arguments you wish to pass to the method. | |
@return {Object} return value from invoking the passed function. Please note, | |
when called within an existing loop, no return value is possible. | |
@since 1.4.0 | |
*/ | |
run.bind = function(target, method /* args*/) { | |
var args = slice.call(arguments); | |
return function() { | |
return apply(run, run.join, args.concat(slice.call(arguments))); | |
}; | |
}; | |
run.backburner = backburner; | |
run.currentRunLoop = null; | |
run.queues = backburner.queueNames; | |
/** | |
Begins a new RunLoop. Any deferred actions invoked after the begin will | |
be buffered until you invoke a matching call to `run.end()`. This is | |
a lower-level way to use a RunLoop instead of using `run()`. | |
```javascript | |
run.begin(); | |
// code to be execute within a RunLoop | |
run.end(); | |
``` | |
@method begin | |
@return {void} | |
*/ | |
run.begin = function() { | |
backburner.begin(); | |
}; | |
/** | |
Ends a RunLoop. This must be called sometime after you call | |
`run.begin()` to flush any deferred actions. This is a lower-level way | |
to use a RunLoop instead of using `run()`. | |
```javascript | |
run.begin(); | |
// code to be execute within a RunLoop | |
run.end(); | |
``` | |
@method end | |
@return {void} | |
*/ | |
run.end = function() { | |
backburner.end(); | |
}; | |
/** | |
Array of named queues. This array determines the order in which queues | |
are flushed at the end of the RunLoop. You can define your own queues by | |
simply adding the queue name to this array. Normally you should not need | |
to inspect or modify this property. | |
@property queues | |
@type Array | |
@default ['sync', 'actions', 'destroy'] | |
*/ | |
/** | |
Adds the passed target/method and any optional arguments to the named | |
queue to be executed at the end of the RunLoop. If you have not already | |
started a RunLoop when calling this method one will be started for you | |
automatically. | |
At the end of a RunLoop, any methods scheduled in this way will be invoked. | |
Methods will be invoked in an order matching the named queues defined in | |
the `run.queues` property. | |
```javascript | |
run.schedule('sync', this, function() { | |
// this will be executed in the first RunLoop queue, when bindings are synced | |
console.log("scheduled on sync queue"); | |
}); | |
run.schedule('actions', this, function() { | |
// this will be executed in the 'actions' queue, after bindings have synced. | |
console.log("scheduled on actions queue"); | |
}); | |
// Note the functions will be run in order based on the run queues order. | |
// Output would be: | |
// scheduled on sync queue | |
// scheduled on actions queue | |
``` | |
@method schedule | |
@param {String} queue The name of the queue to schedule against. | |
Default queues are 'sync' and 'actions' | |
@param {Object} [target] target object to use as the context when invoking a method. | |
@param {String|Function} method The method to invoke. If you pass a string it | |
will be resolved on the target object at the time the scheduled item is | |
invoked allowing you to change the target function. | |
@param {Object} [arguments*] Optional arguments to be passed to the queued method. | |
@return {void} | |
*/ | |
run.schedule = function(queue, target, method) { | |
checkAutoRun(); | |
apply(backburner, backburner.schedule, arguments); | |
}; | |
// Used by global test teardown | |
run.hasScheduledTimers = function() { | |
return backburner.hasTimers(); | |
}; | |
// Used by global test teardown | |
run.cancelTimers = function () { | |
backburner.cancelTimers(); | |
}; | |
/** | |
Immediately flushes any events scheduled in the 'sync' queue. Bindings | |
use this queue so this method is a useful way to immediately force all | |
bindings in the application to sync. | |
You should call this method anytime you need any changed state to propagate | |
throughout the app immediately without repainting the UI (which happens | |
in the later 'render' queue added by the `ember-views` package). | |
```javascript | |
run.sync(); | |
``` | |
@method sync | |
@return {void} | |
*/ | |
run.sync = function() { | |
if (backburner.currentInstance) { | |
backburner.currentInstance.queues.sync.flush(); | |
} | |
}; | |
/** | |
Invokes the passed target/method and optional arguments after a specified | |
period if time. The last parameter of this method must always be a number | |
of milliseconds. | |
You should use this method whenever you need to run some action after a | |
period of time instead of using `setTimeout()`. This method will ensure that | |
items that expire during the same script execution cycle all execute | |
together, which is often more efficient than using a real setTimeout. | |
```javascript | |
run.later(myContext, function() { | |
// code here will execute within a RunLoop in about 500ms with this == myContext | |
}, 500); | |
``` | |
@method later | |
@param {Object} [target] target of method to invoke | |
@param {Function|String} method The method to invoke. | |
If you pass a string it will be resolved on the | |
target at the time the method is invoked. | |
@param {Object} [args*] Optional arguments to pass to the timeout. | |
@param {Number} wait Number of milliseconds to wait. | |
@return {String} a string you can use to cancel the timer in | |
`run.cancel` later. | |
*/ | |
run.later = function(target, method) { | |
return apply(backburner, backburner.later, arguments); | |
}; | |
/** | |
Schedule a function to run one time during the current RunLoop. This is equivalent | |
to calling `scheduleOnce` with the "actions" queue. | |
@method once | |
@param {Object} [target] The target of the method to invoke. | |
@param {Function|String} method The method to invoke. | |
If you pass a string it will be resolved on the | |
target at the time the method is invoked. | |
@param {Object} [args*] Optional arguments to pass to the timeout. | |
@return {Object} Timer information for use in cancelling, see `run.cancel`. | |
*/ | |
run.once = function(target, method) { | |
checkAutoRun(); | |
var args = slice.call(arguments); | |
args.unshift('actions'); | |
return apply(backburner, backburner.scheduleOnce, args); | |
}; | |
/** | |
Schedules a function to run one time in a given queue of the current RunLoop. | |
Calling this method with the same queue/target/method combination will have | |
no effect (past the initial call). | |
Note that although you can pass optional arguments these will not be | |
considered when looking for duplicates. New arguments will replace previous | |
calls. | |
```javascript | |
run(function() { | |
var sayHi = function() { console.log('hi'); } | |
run.scheduleOnce('afterRender', myContext, sayHi); | |
run.scheduleOnce('afterRender', myContext, sayHi); | |
// sayHi will only be executed once, in the afterRender queue of the RunLoop | |
}); | |
``` | |
Also note that passing an anonymous function to `run.scheduleOnce` will | |
not prevent additional calls with an identical anonymous function from | |
scheduling the items multiple times, e.g.: | |
```javascript | |
function scheduleIt() { | |
run.scheduleOnce('actions', myContext, function() { console.log("Closure"); }); | |
} | |
scheduleIt(); | |
scheduleIt(); | |
// "Closure" will print twice, even though we're using `run.scheduleOnce`, | |
// because the function we pass to it is anonymous and won't match the | |
// previously scheduled operation. | |
``` | |
Available queues, and their order, can be found at `run.queues` | |
@method scheduleOnce | |
@param {String} [queue] The name of the queue to schedule against. Default queues are 'sync' and 'actions'. | |
@param {Object} [target] The target of the method to invoke. | |
@param {Function|String} method The method to invoke. | |
If you pass a string it will be resolved on the | |
target at the time the method is invoked. | |
@param {Object} [args*] Optional arguments to pass to the timeout. | |
@return {Object} Timer information for use in cancelling, see `run.cancel`. | |
*/ | |
run.scheduleOnce = function(queue, target, method) { | |
checkAutoRun(); | |
return apply(backburner, backburner.scheduleOnce, arguments); | |
}; | |
/** | |
Schedules an item to run from within a separate run loop, after | |
control has been returned to the system. This is equivalent to calling | |
`run.later` with a wait time of 1ms. | |
```javascript | |
run.next(myContext, function() { | |
// code to be executed in the next run loop, | |
// which will be scheduled after the current one | |
}); | |
``` | |
Multiple operations scheduled with `run.next` will coalesce | |
into the same later run loop, along with any other operations | |
scheduled by `run.later` that expire right around the same | |
time that `run.next` operations will fire. | |
Note that there are often alternatives to using `run.next`. | |
For instance, if you'd like to schedule an operation to happen | |
after all DOM element operations have completed within the current | |
run loop, you can make use of the `afterRender` run loop queue (added | |
by the `ember-views` package, along with the preceding `render` queue | |
where all the DOM element operations happen). Example: | |
```javascript | |
App.MyCollectionView = Ember.CollectionView.extend({ | |
didInsertElement: function() { | |
run.scheduleOnce('afterRender', this, 'processChildElements'); | |
}, | |
processChildElements: function() { | |
// ... do something with collectionView's child view | |
// elements after they've finished rendering, which | |
// can't be done within the CollectionView's | |
// `didInsertElement` hook because that gets run | |
// before the child elements have been added to the DOM. | |
} | |
}); | |
``` | |
One benefit of the above approach compared to using `run.next` is | |
that you will be able to perform DOM/CSS operations before unprocessed | |
elements are rendered to the screen, which may prevent flickering or | |
other artifacts caused by delaying processing until after rendering. | |
The other major benefit to the above approach is that `run.next` | |
introduces an element of non-determinism, which can make things much | |
harder to test, due to its reliance on `setTimeout`; it's much harder | |
to guarantee the order of scheduled operations when they are scheduled | |
outside of the current run loop, i.e. with `run.next`. | |
@method next | |
@param {Object} [target] target of method to invoke | |
@param {Function|String} method The method to invoke. | |
If you pass a string it will be resolved on the | |
target at the time the method is invoked. | |
@param {Object} [args*] Optional arguments to pass to the timeout. | |
@return {Object} Timer information for use in cancelling, see `run.cancel`. | |
*/ | |
run.next = function() { | |
var args = slice.call(arguments); | |
args.push(1); | |
return apply(backburner, backburner.later, args); | |
}; | |
/** | |
Cancels a scheduled item. Must be a value returned by `run.later()`, | |
`run.once()`, `run.next()`, `run.debounce()`, or | |
`run.throttle()`. | |
```javascript | |
var runNext = run.next(myContext, function() { | |
// will not be executed | |
}); | |
run.cancel(runNext); | |
var runLater = run.later(myContext, function() { | |
// will not be executed | |
}, 500); | |
run.cancel(runLater); | |
var runOnce = run.once(myContext, function() { | |
// will not be executed | |
}); | |
run.cancel(runOnce); | |
var throttle = run.throttle(myContext, function() { | |
// will not be executed | |
}, 1, false); | |
run.cancel(throttle); | |
var debounce = run.debounce(myContext, function() { | |
// will not be executed | |
}, 1); | |
run.cancel(debounce); | |
var debounceImmediate = run.debounce(myContext, function() { | |
// will be executed since we passed in true (immediate) | |
}, 100, true); | |
// the 100ms delay until this method can be called again will be cancelled | |
run.cancel(debounceImmediate); | |
``` | |
@method cancel | |
@param {Object} timer Timer object to cancel | |
@return {Boolean} true if cancelled or false/undefined if it wasn't found | |
*/ | |
run.cancel = function(timer) { | |
return backburner.cancel(timer); | |
}; | |
/** | |
Delay calling the target method until the debounce period has elapsed | |
with no additional debounce calls. If `debounce` is called again before | |
the specified time has elapsed, the timer is reset and the entire period | |
must pass again before the target method is called. | |
This method should be used when an event may be called multiple times | |
but the action should only be called once when the event is done firing. | |
A common example is for scroll events where you only want updates to | |
happen once scrolling has ceased. | |
```javascript | |
var myFunc = function() { console.log(this.name + ' ran.'); }; | |
var myContext = {name: 'debounce'}; | |
run.debounce(myContext, myFunc, 150); | |
// less than 150ms passes | |
run.debounce(myContext, myFunc, 150); | |
// 150ms passes | |
// myFunc is invoked with context myContext | |
// console logs 'debounce ran.' one time. | |
``` | |
Immediate allows you to run the function immediately, but debounce | |
other calls for this function until the wait time has elapsed. If | |
`debounce` is called again before the specified time has elapsed, | |
the timer is reset and the entire period must pass again before | |
the method can be called again. | |
```javascript | |
var myFunc = function() { console.log(this.name + ' ran.'); }; | |
var myContext = {name: 'debounce'}; | |
run.debounce(myContext, myFunc, 150, true); | |
// console logs 'debounce ran.' one time immediately. | |
// 100ms passes | |
run.debounce(myContext, myFunc, 150, true); | |
// 150ms passes and nothing else is logged to the console and | |
// the debouncee is no longer being watched | |
run.debounce(myContext, myFunc, 150, true); | |
// console logs 'debounce ran.' one time immediately. | |
// 150ms passes and nothing else is logged tot he console and | |
// the debouncee is no longer being watched | |
``` | |
@method debounce | |
@param {Object} [target] target of method to invoke | |
@param {Function|String} method The 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*] Optional arguments to pass to the timeout. | |
@param {Number} wait Number of milliseconds to wait. | |
@param {Boolean} immediate Trigger the function on the leading instead | |
of the trailing edge of the wait interval. Defaults to false. | |
@return {Array} Timer information for use in cancelling, see `run.cancel`. | |
*/ | |
run.debounce = function() { | |
return apply(backburner, backburner.debounce, arguments); | |
}; | |
/** | |
Ensure that the target method is never called more frequently than | |
the specified spacing period. The target method is called immediately. | |
```javascript | |
var myFunc = function() { console.log(this.name + ' ran.'); }; | |
var myContext = {name: 'throttle'}; | |
run.throttle(myContext, myFunc, 150); | |
// myFunc is invoked with context myContext | |
// console logs 'throttle ran.' | |
// 50ms passes | |
run.throttle(myContext, myFunc, 150); | |
// 50ms passes | |
run.throttle(myContext, myFunc, 150); | |
// 150ms passes | |
run.throttle(myContext, myFunc, 150); | |
// myFunc is invoked with context myContext | |
// console logs 'throttle ran.' | |
``` | |
@method throttle | |
@param {Object} [target] target of method to invoke | |
@param {Function|String} method The 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*] Optional arguments to pass to the timeout. | |
@param {Number} spacing Number of milliseconds to space out requests. | |
@param {Boolean} immediate Trigger the function on the leading instead | |
of the trailing edge of the wait interval. Defaults to true. | |
@return {Array} Timer information for use in cancelling, see `run.cancel`. | |
*/ | |
run.throttle = function() { | |
return apply(backburner, backburner.throttle, arguments); | |
}; | |
// Make sure it's not an autorun during testing | |
function checkAutoRun() { | |
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 run", !Ember.testing); | |
} | |
} | |
/** | |
Add a new named queue after the specified queue. | |
The queue to add will only be added once. | |
@method _addQueue | |
@param {String} name the name of the queue to add. | |
@param {String} after the name of the queue to add after. | |
@private | |
*/ | |
run._addQueue = function(name, after) { | |
if (indexOf.call(run.queues, name) === -1) { | |
run.queues.splice(indexOf.call(run.queues, after)+1, 0, name); | |
} | |
}; | |
}); | |
define("ember-metal/set_properties", | |
["ember-metal/property_events","ember-metal/property_set","exports"], | |
function(__dependency1__, __dependency2__, __exports__) { | |
"use strict"; | |
var changeProperties = __dependency1__.changeProperties; | |
var set = __dependency2__.set; | |
/** | |
Set a list of properties on an object. These properties are set inside | |
a single `beginPropertyChanges` and `endPropertyChanges` batch, so | |
observers will be buffered. | |
```javascript | |
anObject.setProperties({ | |
firstName: "Stanley", | |
lastName: "Stuart", | |
age: "21" | |
}) | |
``` | |
@method setProperties | |
@param self | |
@param {Object} hash | |
@return self | |
*/ | |
__exports__["default"] = function setProperties(self, hash) { | |
changeProperties(function() { | |
for(var prop in hash) { | |
if (hash.hasOwnProperty(prop)) { set(self, prop, hash[prop]); } | |
} | |
}); | |
return self; | |
} | |
}); | |
define("ember-metal/utils", | |
["ember-metal/core","ember-metal/platform","ember-metal/array","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __exports__) { | |
"use strict"; | |
var Ember = __dependency1__["default"]; | |
var platform = __dependency2__.platform; | |
var create = __dependency2__.create; | |
var forEach = __dependency3__.forEach; | |
/** | |
@module ember-metal | |
*/ | |
/** | |
Prefix used for guids through out Ember. | |
@private | |
@property GUID_PREFIX | |
@for Ember | |
@type String | |
@final | |
*/ | |
var GUID_PREFIX = 'ember'; | |
var o_defineProperty = platform.defineProperty; | |
var o_create = create; | |
// Used for guid generation... | |
var numberCache = []; | |
var stringCache = {}; | |
var uuid = 0; | |
var MANDATORY_SETTER = Ember.ENV.MANDATORY_SETTER; | |
/** | |
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. | |
@private | |
@property GUID_KEY | |
@for Ember | |
@type String | |
@final | |
*/ | |
var GUID_KEY = '__ember' + (+ new Date()); | |
var GUID_DESC = { | |
writable: false, | |
configurable: false, | |
enumerable: false, | |
value: null | |
}; | |
/** | |
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. | |
@private | |
@method generateGuid | |
@for Ember | |
@param {Object} [obj] 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] Prefix to place in front of the guid. Useful when you want to | |
separate the guid into separate namespaces. | |
@return {String} the guid | |
*/ | |
function generateGuid(obj, prefix) { | |
if (!prefix) prefix = GUID_PREFIX; | |
var ret = (prefix + (uuid++)); | |
if (obj) { | |
if (obj[GUID_KEY] === null) { | |
obj[GUID_KEY] = ret; | |
} else { | |
GUID_DESC.value = ret; | |
o_defineProperty(obj, GUID_KEY, GUID_DESC); | |
} | |
} | |
return ret; | |
} | |
__exports__.generateGuid = generateGuid;/** | |
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. | |
@private | |
@method guidFor | |
@for Ember | |
@param {Object} obj any object, string, number, Element, or primitive | |
@return {String} the unique guid for this instance. | |
*/ | |
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 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++); | |
if (obj[GUID_KEY] === null) { | |
obj[GUID_KEY] = ret; | |
} else { | |
GUID_DESC.value = ret; | |
o_defineProperty(obj, GUID_KEY, GUID_DESC); | |
} | |
return ret; | |
} | |
} | |
__exports__.guidFor = guidFor;// .......................................................... | |
// META | |
// | |
var META_DESC = { | |
writable: true, | |
configurable: false, | |
enumerable: false, | |
value: null | |
}; | |
/** | |
The key used to store meta information on object for property observing. | |
@property META_KEY | |
@for Ember | |
@private | |
@final | |
@type String | |
*/ | |
var META_KEY = '__ember_meta__'; | |
var isDefinePropertySimulated = platform.defineProperty.isSimulated; | |
function Meta(obj) { | |
this.descs = {}; | |
this.watching = {}; | |
this.cache = {}; | |
this.cacheMeta = {}; | |
this.source = obj; | |
} | |
Meta.prototype = { | |
descs: null, | |
deps: null, | |
watching: null, | |
listeners: null, | |
cache: null, | |
cacheMeta: null, | |
source: null, | |
mixins: null, | |
bindings: null, | |
chains: null, | |
chainWatchers: null, | |
values: null, | |
proto: null | |
}; | |
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; | |
// Without non-enumerable properties, meta objects will be output in JSON | |
// unless explicitly suppressed | |
Meta.prototype.toJSON = function () { }; | |
} | |
// Placeholder for non-writable metas. | |
var EMPTY_META = new Meta(null); | |
if (MANDATORY_SETTER) { EMPTY_META.values = {}; } | |
/** | |
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. | |
@method meta | |
@for Ember | |
@private | |
@param {Object} obj The object to retrieve meta for | |
@param {Boolean} [writable=true] Pass `false` if you do not intend to modify | |
the meta hash, allowing the method to avoid making an unnecessary copy. | |
@return {Object} the meta hash for an object | |
*/ | |
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.cacheMeta = {}; | |
ret.source = obj; | |
if (MANDATORY_SETTER) { ret.values = o_create(ret.values); } | |
obj[META_KEY] = ret; | |
} | |
return ret; | |
} | |
function getMeta(obj, property) { | |
var _meta = meta(obj, false); | |
return _meta[property]; | |
} | |
__exports__.getMeta = getMeta;function setMeta(obj, property, value) { | |
var _meta = meta(obj, true); | |
_meta[property] = value; | |
return value; | |
} | |
__exports__.setMeta = setMeta;/** | |
@deprecated | |
@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. | |
@method metaPath | |
@for Ember | |
@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 | |
*/ | |
function metaPath(obj, path, writable) { | |
Ember.deprecate("Ember.metaPath is deprecated and will be removed from future releases."); | |
var _meta = 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; | |
} | |
__exports__.metaPath = metaPath;/** | |
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. | |
@private | |
@method wrap | |
@for Ember | |
@param {Function} func The function to call | |
@param {Function} superFunc The super function. | |
@return {Function} wrapped function. | |
*/ | |
function wrap(func, superFunc) { | |
function superWrapper() { | |
var ret, sup = this.__nextSuper; | |
this.__nextSuper = superFunc; | |
ret = apply(this, func, arguments); | |
this.__nextSuper = sup; | |
return ret; | |
} | |
superWrapper.wrappedFunction = func; | |
superWrapper.wrappedFunction.__ember_arity__ = func.length; | |
superWrapper.__ember_observes__ = func.__ember_observes__; | |
superWrapper.__ember_observesBefore__ = func.__ember_observesBefore__; | |
superWrapper.__ember_listens__ = func.__ember_listens__; | |
return superWrapper; | |
} | |
__exports__.wrap = wrap;var EmberArray; | |
/** | |
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`) | |
```javascript | |
Ember.isArray(); // false | |
Ember.isArray([]); // true | |
Ember.isArray( Ember.ArrayProxy.create({ content: [] }) ); // true | |
``` | |
@method isArray | |
@for Ember | |
@param {Object} obj The object to test | |
@return {Boolean} true if the passed object is an array or Array-like | |
*/ | |
// ES6TODO: Move up to runtime? This is only use in ember-metal by concatenatedProperties | |
function isArray(obj) { | |
var modulePath, type; | |
if (typeof EmberArray === "undefined") { | |
modulePath = 'ember-runtime/mixins/array'; | |
if (Ember.__loader.registry[modulePath]) { | |
EmberArray = Ember.__loader.require(modulePath)['default']; | |
} | |
} | |
if (!obj || obj.setInterval) { return false; } | |
if (Array.isArray && Array.isArray(obj)) { return true; } | |
if (EmberArray && EmberArray.detect(obj)) { return true; } | |
type = typeOf(obj); | |
if ('array' === type) { return true; } | |
if ((obj.length !== undefined) && 'object' === type) { 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. | |
```javascript | |
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 | |
``` | |
@method makeArray | |
@for Ember | |
@param {Object} obj the object | |
@return {Array} | |
*/ | |
function makeArray(obj) { | |
if (obj === null || obj === undefined) { return []; } | |
return isArray(obj) ? obj : [obj]; | |
} | |
__exports__.makeArray = makeArray;/** | |
Checks to see if the `methodName` exists on the `obj`. | |
```javascript | |
var foo = {bar: Ember.K, baz: null}; | |
Ember.canInvoke(foo, 'bar'); // true | |
Ember.canInvoke(foo, 'baz'); // false | |
Ember.canInvoke(foo, 'bat'); // false | |
``` | |
@method canInvoke | |
@for Ember | |
@param {Object} obj The object to check for the method | |
@param {String} methodName The method name to check for | |
@return {Boolean} | |
*/ | |
function canInvoke(obj, methodName) { | |
return !!(obj && typeof obj[methodName] === 'function'); | |
} | |
/** | |
Checks to see if the `methodName` exists on the `obj`, | |
and if it does, invokes it with the arguments passed. | |
```javascript | |
var d = new Date('03/15/2013'); | |
Ember.tryInvoke(d, 'getTime'); // 1363320000000 | |
Ember.tryInvoke(d, 'setFullYear', [2014]); // 1394856000000 | |
Ember.tryInvoke(d, 'noSuchMethod', [2014]); // undefined | |
``` | |
@method tryInvoke | |
@for Ember | |
@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 | |
@return {*} the return value of the invoked method or undefined if it cannot be invoked | |
*/ | |
function tryInvoke(obj, methodName, args) { | |
if (canInvoke(obj, methodName)) { | |
return args ? applyStr(obj, methodName, args) : applyStr(obj, methodName); | |
} | |
} | |
__exports__.tryInvoke = tryInvoke;// https://github.com/emberjs/ember.js/pull/1617 | |
var needsFinallyFix = (function() { | |
var count = 0; | |
try{ | |
try { } | |
finally { | |
count++; | |
throw new Error('needsFinallyFixTest'); | |
} | |
} catch (e) {} | |
return count !== 1; | |
})(); | |
/** | |
Provides try { } finally { } functionality, while working | |
around Safari's double finally bug. | |
```javascript | |
var tryable = function() { | |
someResource.lock(); | |
runCallback(); // May throw error. | |
}; | |
var finalizer = function() { | |
someResource.unlock(); | |
}; | |
Ember.tryFinally(tryable, finalizer); | |
``` | |
@method tryFinally | |
@for Ember | |
@param {Function} tryable The function to run the try callback | |
@param {Function} finalizer The function to run the finally callback | |
@param {Object} [binding] The optional calling object. Defaults to 'this' | |
@return {*} The return value is the that of the finalizer, | |
unless that value is undefined, in which case it is the return value | |
of the tryable | |
*/ | |
var tryFinally; | |
if (needsFinallyFix) { | |
tryFinally = function(tryable, finalizer, binding) { | |
var result, finalResult, finalError; | |
binding = binding || this; | |
try { | |
result = tryable.call(binding); | |
} finally { | |
try { | |
finalResult = finalizer.call(binding); | |
} catch (e) { | |
finalError = e; | |
} | |
} | |
if (finalError) { throw finalError; } | |
return (finalResult === undefined) ? result : finalResult; | |
}; | |
} else { | |
tryFinally = function(tryable, finalizer, binding) { | |
var result, finalResult; | |
binding = binding || this; | |
try { | |
result = tryable.call(binding); | |
} finally { | |
finalResult = finalizer.call(binding); | |
} | |
return (finalResult === undefined) ? result : finalResult; | |
}; | |
} | |
/** | |
Provides try { } catch finally { } functionality, while working | |
around Safari's double finally bug. | |
```javascript | |
var tryable = function() { | |
for (i=0, l=listeners.length; i<l; i++) { | |
listener = listeners[i]; | |
beforeValues[i] = listener.before(name, time(), payload); | |
} | |
return callback.call(binding); | |
}; | |
var catchable = function(e) { | |
payload = payload || {}; | |
payload.exception = e; | |
}; | |
var finalizer = function() { | |
for (i=0, l=listeners.length; i<l; i++) { | |
listener = listeners[i]; | |
listener.after(name, time(), payload, beforeValues[i]); | |
} | |
}; | |
Ember.tryCatchFinally(tryable, catchable, finalizer); | |
``` | |
@method tryCatchFinally | |
@for Ember | |
@param {Function} tryable The function to run the try callback | |
@param {Function} catchable The function to run the catchable callback | |
@param {Function} finalizer The function to run the finally callback | |
@param {Object} [binding] The optional calling object. Defaults to 'this' | |
@return {*} The return value is the that of the finalizer, | |
unless that value is undefined, in which case it is the return value | |
of the tryable. | |
*/ | |
var tryCatchFinally; | |
if (needsFinallyFix) { | |
tryCatchFinally = function(tryable, catchable, finalizer, binding) { | |
var result, finalResult, finalError; | |
binding = binding || this; | |
try { | |
result = tryable.call(binding); | |
} catch(error) { | |
result = catchable.call(binding, error); | |
} finally { | |
try { | |
finalResult = finalizer.call(binding); | |
} catch (e) { | |
finalError = e; | |
} | |
} | |
if (finalError) { throw finalError; } | |
return (finalResult === undefined) ? result : finalResult; | |
}; | |
} else { | |
tryCatchFinally = function(tryable, catchable, finalizer, binding) { | |
var result, finalResult; | |
binding = binding || this; | |
try { | |
result = tryable.call(binding); | |
} catch(error) { | |
result = catchable.call(binding, error); | |
} finally { | |
finalResult = finalizer.call(binding); | |
} | |
return (finalResult === undefined) ? result : finalResult; | |
}; | |
} | |
// ........................................ | |
// TYPING & ARRAY MESSAGING | |
// | |
var TYPE_MAP = {}; | |
var t = "Boolean Number String Function Array Date RegExp Object".split(" "); | |
forEach.call(t, function(name) { | |
TYPE_MAP[ "[object " + name + "]" ] = name.toLowerCase(); | |
}); | |
var toString = Object.prototype.toString; | |
var EmberObject; | |
/** | |
Returns a consistent type for the passed item. | |
Use this instead of the built-in `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 or String object. | | |
| 'number' | Number primitive or Number object. | | |
| 'boolean' | Boolean primitive or Boolean object. | | |
| 'null' | Null value | | |
| 'undefined' | Undefined value | | |
| 'function' | A function | | |
| 'array' | An instance of Array | | |
| 'regexp' | An instance of RegExp | | |
| 'date' | An instance of Date | | |
| 'class' | An Ember class (created using Ember.Object.extend()) | | |
| 'instance' | An Ember object instance | | |
| 'error' | An instance of the Error object | | |
| 'object' | A JavaScript object not inheriting from Ember.Object | | |
Examples: | |
```javascript | |
Ember.typeOf(); // 'undefined' | |
Ember.typeOf(null); // 'null' | |
Ember.typeOf(undefined); // 'undefined' | |
Ember.typeOf('michael'); // 'string' | |
Ember.typeOf(new String('michael')); // 'string' | |
Ember.typeOf(101); // 'number' | |
Ember.typeOf(new Number(101)); // 'number' | |
Ember.typeOf(true); // 'boolean' | |
Ember.typeOf(new Boolean(true)); // 'boolean' | |
Ember.typeOf(Ember.makeArray); // 'function' | |
Ember.typeOf([1,2,90]); // 'array' | |
Ember.typeOf(/abc/); // 'regexp' | |
Ember.typeOf(new Date()); // 'date' | |
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' | |
``` | |
@method typeOf | |
@for Ember | |
@param {Object} item the item to check | |
@return {String} the type | |
*/ | |
function typeOf(item) { | |
var ret, modulePath; | |
// ES6TODO: Depends on Ember.Object which is defined in runtime. | |
if (typeof EmberObject === "undefined") { | |
modulePath = 'ember-runtime/system/object'; | |
if (Ember.__loader.registry[modulePath]) { | |
EmberObject = Ember.__loader.require(modulePath)['default']; | |
} | |
} | |
ret = (item === null || item === undefined) ? String(item) : TYPE_MAP[toString.call(item)] || 'object'; | |
if (ret === 'function') { | |
if (EmberObject && EmberObject.detect(item)) ret = 'class'; | |
} else if (ret === 'object') { | |
if (item instanceof Error) ret = 'error'; | |
else if (EmberObject && item instanceof EmberObject) ret = 'instance'; | |
else if (item instanceof Date) ret = 'date'; | |
} | |
return ret; | |
} | |
/** | |
Convenience method to inspect an object. This method will attempt to | |
convert the object into a useful string description. | |
It is a pretty simple implementation. If you want something more robust, | |
use something like JSDump: https://github.com/NV/jsDump | |
@method inspect | |
@for Ember | |
@param {Object} obj The object you want to inspect. | |
@return {String} A description of the object | |
@since 1.4.0 | |
*/ | |
function inspect(obj) { | |
var type = typeOf(obj); | |
if (type === 'array') { | |
return '[' + obj + ']'; | |
} | |
if (type !== 'object') { | |
return obj + ''; | |
} | |
var v, ret = []; | |
for(var key in obj) { | |
if (obj.hasOwnProperty(key)) { | |
v = obj[key]; | |
if (v === 'toString') { continue; } // ignore useless items | |
if (typeOf(v) === 'function') { v = "function() { ... }"; } | |
ret.push(key + ": " + v); | |
} | |
} | |
return "{" + ret.join(", ") + "}"; | |
} | |
__exports__.inspect = inspect;// The following functions are intentionally minified to keep the functions | |
// below Chrome's function body size inlining limit of 600 chars. | |
function apply(t /* target */, m /* method */, a /* args */) { | |
var l = a && a.length; | |
if (!a || !l) { return m.call(t); } | |
switch (l) { | |
case 1: return m.call(t, a[0]); | |
case 2: return m.call(t, a[0], a[1]); | |
case 3: return m.call(t, a[0], a[1], a[2]); | |
case 4: return m.call(t, a[0], a[1], a[2], a[3]); | |
case 5: return m.call(t, a[0], a[1], a[2], a[3], a[4]); | |
default: return m.apply(t, a); | |
} | |
} | |
__exports__.apply = apply;function applyStr(t /* target */, m /* method */, a /* args */) { | |
var l = a && a.length; | |
if (!a || !l) { return t[m](); } | |
switch (l) { | |
case 1: return t[m](a[0]); | |
case 2: return t[m](a[0], a[1]); | |
case 3: return t[m](a[0], a[1], a[2]); | |
case 4: return t[m](a[0], a[1], a[2], a[3]); | |
case 5: return t[m](a[0], a[1], a[2], a[3], a[4]); | |
default: return t[m].apply(t, a); | |
} | |
} | |
__exports__.applyStr = applyStr;__exports__.GUID_KEY = GUID_KEY; | |
__exports__.GUID_PREFIX = GUID_PREFIX; | |
__exports__.META_DESC = META_DESC; | |
__exports__.EMPTY_META = EMPTY_META; | |
__exports__.META_KEY = META_KEY; | |
__exports__.meta = meta; | |
__exports__.typeOf = typeOf; | |
__exports__.tryCatchFinally = tryCatchFinally; | |
__exports__.isArray = isArray; | |
__exports__.canInvoke = canInvoke; | |
__exports__.tryFinally = tryFinally; | |
}); | |
define("ember-metal/watch_key", | |
["ember-metal/core","ember-metal/utils","ember-metal/platform","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __exports__) { | |
"use strict"; | |
var Ember = __dependency1__["default"]; | |
var meta = __dependency2__.meta; | |
var typeOf = __dependency2__.typeOf; | |
var platform = __dependency3__.platform; | |
var metaFor = meta; // utils.js | |
var MANDATORY_SETTER = Ember.ENV.MANDATORY_SETTER; | |
var o_defineProperty = platform.defineProperty; | |
function watchKey(obj, keyName, meta) { | |
// can't watch length on Array - it is special... | |
if (keyName === 'length' && typeOf(obj) === 'array') { return; } | |
var m = meta || metaFor(obj), watching = m.watching; | |
// activate watching first time | |
if (!watching[keyName]) { | |
watching[keyName] = 1; | |
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: obj.propertyIsEnumerable(keyName), | |
set: Ember.MANDATORY_SETTER_FUNCTION, | |
get: Ember.DEFAULT_GETTER_FUNCTION(keyName) | |
}); | |
} | |
} else { | |
watching[keyName] = (watching[keyName] || 0) + 1; | |
} | |
} | |
__exports__.watchKey = watchKey;function unwatchKey(obj, keyName, meta) { | |
var m = meta || metaFor(obj), watching = m.watching; | |
if (watching[keyName] === 1) { | |
watching[keyName] = 0; | |
if ('function' === typeof obj.didUnwatchProperty) { | |
obj.didUnwatchProperty(keyName); | |
} | |
if (MANDATORY_SETTER && keyName in obj) { | |
o_defineProperty(obj, keyName, { | |
configurable: true, | |
enumerable: obj.propertyIsEnumerable(keyName), | |
set: function(val) { | |
// redefine to set as enumerable | |
o_defineProperty(obj, keyName, { | |
configurable: true, | |
writable: true, | |
enumerable: true, | |
value: val | |
}); | |
delete m.values[keyName]; | |
}, | |
get: Ember.DEFAULT_GETTER_FUNCTION(keyName) | |
}); | |
} | |
} else if (watching[keyName] > 1) { | |
watching[keyName]--; | |
} | |
} | |
__exports__.unwatchKey = unwatchKey; | |
}); | |
define("ember-metal/watch_path", | |
["ember-metal/utils","ember-metal/chains","exports"], | |
function(__dependency1__, __dependency2__, __exports__) { | |
"use strict"; | |
var meta = __dependency1__.meta; | |
var typeOf = __dependency1__.typeOf; | |
var ChainNode = __dependency2__.ChainNode; | |
var metaFor = meta; | |
// get the chains for the current object. If the current object has | |
// chains inherited from the proto they will be cloned and reconfigured for | |
// the current object. | |
function chainsFor(obj, meta) { | |
var m = meta || 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; | |
} | |
function watchPath(obj, keyPath, meta) { | |
// can't watch length on Array - it is special... | |
if (keyPath === 'length' && typeOf(obj) === 'array') { return; } | |
var m = meta || metaFor(obj), watching = m.watching; | |
if (!watching[keyPath]) { // activate watching first time | |
watching[keyPath] = 1; | |
chainsFor(obj, m).add(keyPath); | |
} else { | |
watching[keyPath] = (watching[keyPath] || 0) + 1; | |
} | |
} | |
__exports__.watchPath = watchPath;function unwatchPath(obj, keyPath, meta) { | |
var m = meta || metaFor(obj), watching = m.watching; | |
if (watching[keyPath] === 1) { | |
watching[keyPath] = 0; | |
chainsFor(obj, m).remove(keyPath); | |
} else if (watching[keyPath] > 1) { | |
watching[keyPath]--; | |
} | |
} | |
__exports__.unwatchPath = unwatchPath; | |
}); | |
define("ember-metal/watching", | |
["ember-metal/utils","ember-metal/chains","ember-metal/watch_key","ember-metal/watch_path","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __exports__) { | |
"use strict"; | |
/** | |
@module ember-metal | |
*/ | |
var meta = __dependency1__.meta; | |
var META_KEY = __dependency1__.META_KEY; | |
var GUID_KEY = __dependency1__.GUID_KEY; | |
var typeOf = __dependency1__.typeOf; | |
var generateGuid = __dependency1__.generateGuid; | |
var removeChainWatcher = __dependency2__.removeChainWatcher; | |
var flushPendingChains = __dependency2__.flushPendingChains; | |
var watchKey = __dependency3__.watchKey; | |
var unwatchKey = __dependency3__.unwatchKey; | |
var watchPath = __dependency4__.watchPath; | |
var unwatchPath = __dependency4__.unwatchPath; | |
var metaFor = meta; // utils.js | |
// returns true if the passed path is just a keyName | |
function isKeyName(path) { | |
return path.indexOf('.') === -1; | |
} | |
/** | |
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()` | |
@private | |
@method watch | |
@for Ember | |
@param obj | |
@param {String} keyName | |
*/ | |
function watch(obj, _keyPath, m) { | |
// can't watch length on Array - it is special... | |
if (_keyPath === 'length' && typeOf(obj) === 'array') { return; } | |
if (isKeyName(_keyPath)) { | |
watchKey(obj, _keyPath, m); | |
} else { | |
watchPath(obj, _keyPath, m); | |
} | |
} | |
__exports__.watch = watch; | |
function isWatching(obj, key) { | |
var meta = obj[META_KEY]; | |
return (meta && meta.watching[key]) > 0; | |
} | |
__exports__.isWatching = isWatching;watch.flushPending = flushPendingChains; | |
function unwatch(obj, _keyPath, m) { | |
// can't watch length on Array - it is special... | |
if (_keyPath === 'length' && typeOf(obj) === 'array') { return; } | |
if (isKeyName(_keyPath)) { | |
unwatchKey(obj, _keyPath, m); | |
} else { | |
unwatchPath(obj, _keyPath, m); | |
} | |
} | |
__exports__.unwatch = unwatch;/** | |
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. | |
@private | |
@method rewatch | |
@for Ember | |
@param obj | |
*/ | |
function rewatch(obj) { | |
var m = obj[META_KEY], chains = m && m.chains; | |
// make sure the object has its own guid. | |
if (GUID_KEY in obj && !obj.hasOwnProperty(GUID_KEY)) { | |
generateGuid(obj); | |
} | |
// make sure any chained watchers update. | |
if (chains && chains.value() !== obj) { | |
m.chains = chains.copy(obj); | |
} | |
} | |
__exports__.rewatch = rewatch;var NODE_STACK = []; | |
/** | |
Tears down the meta on an object so that it can be garbage collected. | |
Multiple calls will have no effect. | |
@method destroy | |
@for Ember | |
@param {Object} obj the object to destroy | |
@return {void} | |
*/ | |
function destroy(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); | |
} | |
} | |
} | |
} | |
} | |
} | |
__exports__.destroy = destroy; | |
}); | |
define("ember-routing", | |
["ember-handlebars","ember-metal/core","ember-routing/ext/run_loop","ember-routing/ext/controller","ember-routing/ext/view","ember-routing/helpers/shared","ember-routing/helpers/link_to","ember-routing/location/api","ember-routing/location/none_location","ember-routing/location/hash_location","ember-routing/location/history_location","ember-routing/location/auto_location","ember-routing/system/controller_for","ember-routing/system/dsl","ember-routing/system/router","ember-routing/system/route","ember-routing/helpers/outlet","ember-routing/helpers/render","ember-routing/helpers/action","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __dependency6__, __dependency7__, __dependency8__, __dependency9__, __dependency10__, __dependency11__, __dependency12__, __dependency13__, __dependency14__, __dependency15__, __dependency16__, __dependency17__, __dependency18__, __dependency19__, __exports__) { | |
"use strict"; | |
// require('ember-runtime'); | |
// require('ember-views'); | |
// require('ember-handlebars'); | |
/** | |
Ember Routing | |
@module ember | |
@submodule ember-routing | |
@requires ember-views | |
*/ | |
var EmberHandlebars = __dependency1__["default"]; | |
var Ember = __dependency2__["default"]; | |
// ES6TODO: Cleanup modules with side-effects below | |
var resolvePaths = __dependency6__.resolvePaths; | |
var resolveParams = __dependency6__.resolveParams; | |
var deprecatedLinkToHelper = __dependency7__.deprecatedLinkToHelper; | |
var linkToHelper = __dependency7__.linkToHelper; | |
var LinkView = __dependency7__.LinkView; | |
// require('ember-views'); | |
var EmberLocation = __dependency8__["default"]; | |
var NoneLocation = __dependency9__["default"]; | |
var HashLocation = __dependency10__["default"]; | |
var HistoryLocation = __dependency11__["default"]; | |
var AutoLocation = __dependency12__["default"]; | |
var controllerFor = __dependency13__.controllerFor; | |
var generateControllerFactory = __dependency13__.generateControllerFactory; | |
var generateController = __dependency13__.generateController; | |
var RouterDSL = __dependency14__["default"]; | |
var Router = __dependency15__["default"]; | |
var Route = __dependency16__["default"]; | |
var outletHelper = __dependency17__.outletHelper; | |
var OutletView = __dependency17__.OutletView; | |
var renderHelper = __dependency18__["default"]; | |
var ActionHelper = __dependency19__.ActionHelper; | |
var actionHelper = __dependency19__.actionHelper; | |
Ember.Location = EmberLocation; | |
Ember.AutoLocation = AutoLocation; | |
Ember.HashLocation = HashLocation; | |
Ember.HistoryLocation = HistoryLocation; | |
Ember.NoneLocation = NoneLocation; | |
Ember.controllerFor = controllerFor; | |
Ember.generateControllerFactory = generateControllerFactory; | |
Ember.generateController = generateController; | |
Ember.RouterDSL = RouterDSL; | |
Ember.Router = Router; | |
Ember.Route = Route; | |
Ember.LinkView = LinkView; | |
Router.resolveParams = resolveParams; | |
Router.resolvePaths = resolvePaths; | |
EmberHandlebars.ActionHelper = ActionHelper; | |
EmberHandlebars.OutletView = OutletView; | |
EmberHandlebars.registerHelper('render', renderHelper); | |
EmberHandlebars.registerHelper('action', actionHelper); | |
EmberHandlebars.registerHelper('outlet', outletHelper); | |
EmberHandlebars.registerHelper('link-to', linkToHelper); | |
EmberHandlebars.registerHelper('linkTo', deprecatedLinkToHelper); | |
__exports__["default"] = Ember; | |
}); | |
define("ember-routing/ext/controller", | |
["ember-metal/core","ember-metal/property_get","ember-metal/property_set","ember-metal/enumerable_utils","ember-runtime/controllers/controller","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __exports__) { | |
"use strict"; | |
var Ember = __dependency1__["default"]; | |
// FEATURES, deprecate | |
var get = __dependency2__.get; | |
var set = __dependency3__.set; | |
var EnumerableUtils = __dependency4__["default"]; | |
var map = EnumerableUtils.map; | |
var ControllerMixin = __dependency5__.ControllerMixin; | |
/** | |
@module ember | |
@submodule ember-routing | |
*/ | |
ControllerMixin.reopen({ | |
/** | |
Transition the application into another route. The route may | |
be either a single route or route path: | |
```javascript | |
aController.transitionToRoute('blogPosts'); | |
aController.transitionToRoute('blogPosts.recentEntries'); | |
``` | |
Optionally supply a model for the route in question. The model | |
will be serialized into the URL using the `serialize` hook of | |
the route: | |
```javascript | |
aController.transitionToRoute('blogPost', aPost); | |
``` | |
If a literal is passed (such as a number or a string), it will | |
be treated as an identifier instead. In this case, the `model` | |
hook of the route will be triggered: | |
```javascript | |
aController.transitionToRoute('blogPost', 1); | |
``` | |
Multiple models will be applied last to first recursively up the | |
resource tree. | |
```javascript | |
App.Router.map(function() { | |
this.resource('blogPost', {path:':blogPostId'}, function(){ | |
this.resource('blogComment', {path: ':blogCommentId'}); | |
}); | |
}); | |
aController.transitionToRoute('blogComment', aPost, aComment); | |
aController.transitionToRoute('blogComment', 1, 13); | |
``` | |
It is also possible to pass a URL (a string that starts with a | |
`/`). This is intended for testing and debugging purposes and | |
should rarely be used in production code. | |
```javascript | |
aController.transitionToRoute('/'); | |
aController.transitionToRoute('/blog/post/1/comment/13'); | |
``` | |
See also [replaceRoute](/api/classes/Ember.ControllerMixin.html#method_replaceRoute). | |
@param {String} name the name of the route or a URL | |
@param {...Object} models the model(s) or identifier(s) to be used | |
while transitioning to the route. | |
@for Ember.ControllerMixin | |
@method transitionToRoute | |
*/ | |
transitionToRoute: function() { | |
// target may be either another controller or a router | |
var target = get(this, 'target'), | |
method = target.transitionToRoute || target.transitionTo; | |
return method.apply(target, arguments); | |
}, | |
/** | |
@deprecated | |
@for Ember.ControllerMixin | |
@method transitionTo | |
*/ | |
transitionTo: function() { | |
Ember.deprecate("transitionTo is deprecated. Please use transitionToRoute."); | |
return this.transitionToRoute.apply(this, arguments); | |
}, | |
/** | |
Transition into another route while replacing the current URL, if possible. | |
This will replace the current history entry instead of adding a new one. | |
Beside that, it is identical to `transitionToRoute` in all other respects. | |
```javascript | |
aController.replaceRoute('blogPosts'); | |
aController.replaceRoute('blogPosts.recentEntries'); | |
``` | |
Optionally supply a model for the route in question. The model | |
will be serialized into the URL using the `serialize` hook of | |
the route: | |
```javascript | |
aController.replaceRoute('blogPost', aPost); | |
``` | |
If a literal is passed (such as a number or a string), it will | |
be treated as an identifier instead. In this case, the `model` | |
hook of the route will be triggered: | |
```javascript | |
aController.replaceRoute('blogPost', 1); | |
``` | |
Multiple models will be applied last to first recursively up the | |
resource tree. | |
```javascript | |
App.Router.map(function() { | |
this.resource('blogPost', {path:':blogPostId'}, function(){ | |
this.resource('blogComment', {path: ':blogCommentId'}); | |
}); | |
}); | |
aController.replaceRoute('blogComment', aPost, aComment); | |
aController.replaceRoute('blogComment', 1, 13); | |
``` | |
It is also possible to pass a URL (a string that starts with a | |
`/`). This is intended for testing and debugging purposes and | |
should rarely be used in production code. | |
```javascript | |
aController.replaceRoute('/'); | |
aController.replaceRoute('/blog/post/1/comment/13'); | |
``` | |
@param {String} name the name of the route or a URL | |
@param {...Object} models the model(s) or identifier(s) to be used | |
while transitioning to the route. | |
@for Ember.ControllerMixin | |
@method replaceRoute | |
*/ | |
replaceRoute: function() { | |
// target may be either another controller or a router | |
var target = get(this, 'target'), | |
method = target.replaceRoute || target.replaceWith; | |
return method.apply(target, arguments); | |
}, | |
/** | |
@deprecated | |
@for Ember.ControllerMixin | |
@method replaceWith | |
*/ | |
replaceWith: function() { | |
Ember.deprecate("replaceWith is deprecated. Please use replaceRoute."); | |
return this.replaceRoute.apply(this, arguments); | |
} | |
}); | |
if (Ember.FEATURES.isEnabled("query-params-new")) { | |
ControllerMixin.reopen({ | |
concatenatedProperties: ['queryParams'], | |
queryParams: null, | |
_finalizingQueryParams: false, | |
_queryParamChangesDuringSuspension: null | |
}); | |
} | |
__exports__["default"] = ControllerMixin; | |
}); | |
define("ember-routing/ext/run_loop", | |
["ember-metal/run_loop"], | |
function(__dependency1__) { | |
"use strict"; | |
var run = __dependency1__["default"]; | |
/** | |
@module ember | |
@submodule ember-views | |
*/ | |
// Add a new named queue after the 'actions' queue (where RSVP promises | |
// resolve), which is used in router transitions to prevent unnecessary | |
// loading state entry if all context promises resolve on the | |
// 'actions' queue first. | |
var queues = run.queues; | |
run._addQueue('routerTransitions', 'actions'); | |
}); | |
define("ember-routing/ext/view", | |
["ember-metal/property_get","ember-metal/property_set","ember-metal/run_loop","ember-views/views/view","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __exports__) { | |
"use strict"; | |
var get = __dependency1__.get; | |
var set = __dependency2__.set; | |
var run = __dependency3__["default"]; | |
var EmberView = __dependency4__.View; | |
/** | |
@module ember | |
@submodule ember-routing | |
*/ | |
EmberView.reopen({ | |
/** | |
Sets the private `_outlets` object on the view. | |
@method init | |
*/ | |
init: function() { | |
set(this, '_outlets', {}); | |
this._super(); | |
}, | |
/** | |
Manually fill any of a view's `{{outlet}}` areas with the | |
supplied view. | |
Example | |
```javascript | |
var MyView = Ember.View.extend({ | |
template: Ember.Handlebars.compile('Child view: {{outlet "main"}} ') | |
}); | |
var myView = MyView.create(); | |
myView.appendTo('body'); | |
// The html for myView now looks like: | |
// <div id="ember228" class="ember-view">Child view: </div> | |
var FooView = Ember.View.extend({ | |
template: Ember.Handlebars.compile('<h1>Foo</h1> ') | |
}); | |
var fooView = FooView.create(); | |
myView.connectOutlet('main', fooView); | |
// The html for myView now looks like: | |
// <div id="ember228" class="ember-view">Child view: | |
// <div id="ember234" class="ember-view"><h1>Foo</h1> </div> | |
// </div> | |
``` | |
@method connectOutlet | |
@param {String} outletName A unique name for the outlet | |
@param {Object} view An Ember.View | |
*/ | |
connectOutlet: function(outletName, view) { | |
if (this._pendingDisconnections) { | |
delete this._pendingDisconnections[outletName]; | |
} | |
if (this._hasEquivalentView(outletName, view)) { | |
view.destroy(); | |
return; | |
} | |
var outlets = get(this, '_outlets'), | |
container = get(this, 'container'), | |
router = container && container.lookup('router:main'), | |
renderedName = get(view, 'renderedName'); | |
set(outlets, outletName, view); | |
if (router && renderedName) { | |
router._connectActiveView(renderedName, view); | |
} | |
}, | |
/** | |
Determines if the view has already been created by checking if | |
the view has the same constructor, template, and context as the | |
view in the `_outlets` object. | |
@private | |
@method _hasEquivalentView | |
@param {String} outletName The name of the outlet we are checking | |
@param {Object} view An Ember.View | |
@return {Boolean} | |
*/ | |
_hasEquivalentView: function(outletName, view) { | |
var existingView = get(this, '_outlets.'+outletName); | |
return existingView && | |
existingView.constructor === view.constructor && | |
existingView.get('template') === view.get('template') && | |
existingView.get('context') === view.get('context'); | |
}, | |
/** | |
Removes an outlet from the view. | |
Example | |
```javascript | |
var MyView = Ember.View.extend({ | |
template: Ember.Handlebars.compile('Child view: {{outlet "main"}} ') | |
}); | |
var myView = MyView.create(); | |
myView.appendTo('body'); | |
// myView's html: | |
// <div id="ember228" class="ember-view">Child view: </div> | |
var FooView = Ember.View.extend({ | |
template: Ember.Handlebars.compile('<h1>Foo</h1> ') | |
}); | |
var fooView = FooView.create(); | |
myView.connectOutlet('main', fooView); | |
// myView's html: | |
// <div id="ember228" class="ember-view">Child view: | |
// <div id="ember234" class="ember-view"><h1>Foo</h1> </div> | |
// </div> | |
myView.disconnectOutlet('main'); | |
// myView's html: | |
// <div id="ember228" class="ember-view">Child view: </div> | |
``` | |
@method disconnectOutlet | |
@param {String} outletName The name of the outlet to be removed | |
*/ | |
disconnectOutlet: function(outletName) { | |
if (!this._pendingDisconnections) { | |
this._pendingDisconnections = {}; | |
} | |
this._pendingDisconnections[outletName] = true; | |
run.once(this, '_finishDisconnections'); | |
}, | |
/** | |
Gets an outlet that is pending disconnection and then | |
nullifys the object on the `_outlet` object. | |
@private | |
@method _finishDisconnections | |
*/ | |
_finishDisconnections: function() { | |
if (this.isDestroyed) return; // _outlets will be gone anyway | |
var outlets = get(this, '_outlets'); | |
var pendingDisconnections = this._pendingDisconnections; | |
this._pendingDisconnections = null; | |
for (var outletName in pendingDisconnections) { | |
set(outlets, outletName, null); | |
} | |
} | |
}); | |
__exports__["default"] = EmberView; | |
}); | |
define("ember-routing/helpers/action", | |
["ember-metal/core","ember-metal/property_get","ember-metal/array","ember-metal/run_loop","ember-views/system/utils","ember-routing/system/router","ember-handlebars","ember-handlebars/ext","ember-handlebars/helpers/view","ember-routing/helpers/shared","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __dependency6__, __dependency7__, __dependency8__, __dependency9__, __dependency10__, __exports__) { | |
"use strict"; | |
var Ember = __dependency1__["default"]; | |
// Handlebars, uuid, FEATURES, assert, deprecate | |
var get = __dependency2__.get; | |
var forEach = __dependency3__.forEach; | |
var run = __dependency4__["default"]; | |
var isSimpleClick = __dependency5__.isSimpleClick; | |
var EmberRouter = __dependency6__["default"]; | |
var EmberHandlebars = __dependency7__["default"]; | |
var handlebarsGet = __dependency8__.handlebarsGet; | |
var viewHelper = __dependency9__.viewHelper; | |
var resolveParams = __dependency10__.resolveParams; | |
var resolvePath = __dependency10__.resolvePath; | |
// requireModule('ember-handlebars'); | |
/** | |
@module ember | |
@submodule ember-routing | |
*/ | |
var SafeString = EmberHandlebars.SafeString; | |
var a_slice = Array.prototype.slice; | |
function args(options, actionName) { | |
var ret = []; | |
if (actionName) { ret.push(actionName); } | |
var types = options.options.types.slice(1), | |
data = options.options.data; | |
return ret.concat(resolveParams(options.context, options.params, { types: types, data: data })); | |
} | |
var ActionHelper = { | |
registeredActions: {} | |
}; | |
__exports__.ActionHelper = ActionHelper; | |
var keys = ["alt", "shift", "meta", "ctrl"]; | |
var POINTER_EVENT_TYPE_REGEX = /^click|mouse|touch/; | |
var isAllowedEvent = function(event, allowedKeys) { | |
if (typeof allowedKeys === "undefined") { | |
if (POINTER_EVENT_TYPE_REGEX.test(event.type)) { | |
return isSimpleClick(event); | |
} else { | |
allowedKeys = ''; | |
} | |
} | |
if (allowedKeys.indexOf("any") >= 0) { | |
return true; | |
} | |
var allowed = true; | |
forEach.call(keys, function(key) { | |
if (event[key + "Key"] && allowedKeys.indexOf(key) === -1) { | |
allowed = false; | |
} | |
}); | |
return allowed; | |
}; | |
ActionHelper.registerAction = function(actionNameOrPath, options, allowedKeys) { | |
var actionId = ++Ember.uuid; | |
ActionHelper.registeredActions[actionId] = { | |
eventName: options.eventName, | |
handler: function handleRegisteredAction(event) { | |
if (!isAllowedEvent(event, allowedKeys)) { return true; } | |
if (options.preventDefault !== false) { | |
event.preventDefault(); | |
} | |
if (options.bubbles === false) { | |
event.stopPropagation(); | |
} | |
var target = options.target, | |
parameters = options.parameters, | |
actionName; | |
if (target.target) { | |
target = handlebarsGet(target.root, target.target, target.options); | |
} else { | |
target = target.root; | |
} | |
if (options.boundProperty) { | |
actionName = resolveParams(parameters.context, [actionNameOrPath], { types: ['ID'], data: parameters.options.data })[0]; | |
if(typeof actionName === 'undefined' || typeof actionName === 'function') { | |
Ember.assert("You specified a quoteless path to the {{action}} helper '" + actionNameOrPath + "' which did not resolve to an actionName. Perhaps you meant to use a quoted actionName? (e.g. {{action '" + actionNameOrPath + "'}}).", true); | |
actionName = actionNameOrPath; | |
} | |
} | |
if (!actionName) { | |
actionName = actionNameOrPath; | |
} | |
run(function runRegisteredAction() { | |
if (target.send) { | |
target.send.apply(target, args(parameters, actionName)); | |
} else { | |
Ember.assert("The action '" + actionName + "' did not exist on " + target, typeof target[actionName] === 'function'); | |
target[actionName].apply(target, args(parameters)); | |
} | |
}); | |
} | |
}; | |
options.view.on('willClearRender', 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 templates's controller | |
or supplied `target` option (see 'Specifying a Target'). | |
If the controller does not implement the event, the event is sent | |
to the current route, and it bubbles up the route hierarchy from there. | |
User interaction with that element will invoke the supplied action name on | |
the appropriate target. Specifying a non-quoted action name will result in | |
a bound property lookup at the time the event will be triggered. | |
Given the following application Handlebars template on the page | |
```handlebars | |
<div {{action 'anActionName'}}> | |
click me | |
</div> | |
``` | |
And application code | |
```javascript | |
App.ApplicationController = Ember.Controller.extend({ | |
actions: { | |
anActionName: function() { | |
} | |
} | |
}); | |
``` | |
Will result in the following rendered HTML | |
```html | |
<div class="ember-view"> | |
<div data-ember-action="1"> | |
click me | |
</div> | |
</div> | |
``` | |
Clicking "click me" will trigger the `anActionName` action of the | |
`App.ApplicationController`. In this case, no additional parameters will be passed. | |
If you provide additional parameters to the helper: | |
```handlebars | |
<button {{action 'edit' post}}>Edit</button> | |
``` | |
Those parameters will be passed along as arguments to the JavaScript | |
function implementing the action. | |
### 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. If you need to allow event propagation (to handle file inputs for | |
example) you can supply the `preventDefault=false` option to the `{{action}}` helper: | |
```handlebars | |
<div {{action "sayHello" preventDefault=false}}> | |
<input type="file" /> | |
<input type="checkbox" /> | |
</div> | |
``` | |
To disable bubbling, pass `bubbles=false` to the helper: | |
```handlebars | |
<button {{action 'edit' post bubbles=false}}>Edit</button> | |
``` | |
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](/api/classes/Ember.View.html) | |
'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: | |
```handlebars | |
<div {{action "anActionName" on="doubleClick"}}> | |
click me | |
</div> | |
``` | |
See `Ember.View` 'Responding to Browser Events' for a list of | |
acceptable DOM event names. | |
NOTE: 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 whitelisted modifier keys | |
By default the `{{action}}` helper will ignore click event with pressed modifier | |
keys. You can supply an `allowedKeys` option to specify which keys should not be ignored. | |
```handlebars | |
<div {{action "anActionName" allowedKeys="alt"}}> | |
click me | |
</div> | |
``` | |
This way the `{{action}}` will fire when clicking with the alt key pressed down. | |
Alternatively, supply "any" to the `allowedKeys` option to accept any combination of modifier keys. | |
```handlebars | |
<div {{action "anActionName" allowedKeys="any"}}> | |
click me with any key pressed | |
</div> | |
``` | |
### Specifying a Target | |
There are several possible target objects for `{{action}}` helpers: | |
In a typical Ember application, where views are managed through use of the | |
`{{outlet}}` helper, actions will bubble to the current controller, then | |
to the current route, and then up the route hierarchy. | |
Alternatively, a `target` option can be provided to the helper to change | |
which object will receive the method call. This option must be a path | |
to an object, accessible in the current context: | |
```handlebars | |
{{! the application template }} | |
<div {{action "anActionName" target=view}}> | |
click me | |
</div> | |
``` | |
```javascript | |
App.ApplicationView = Ember.View.extend({ | |
actions: { | |
anActionName: function(){} | |
} | |
}); | |
``` | |
### Additional Parameters | |
You may specify additional parameters to the `{{action}}` helper. These | |
parameters are passed along as the arguments to the JavaScript function | |
implementing the action. | |
```handlebars | |
{{#each person in people}} | |
<div {{action "edit" person}}> | |
click me | |
</div> | |
{{/each}} | |
``` | |
Clicking "click me" will trigger the `edit` method on the current controller | |
with the value of `person` as a parameter. | |
@method action | |
@for Ember.Handlebars.helpers | |
@param {String} actionName | |
@param {Object} [context]* | |
@param {Hash} options | |
*/ | |
function actionHelper(actionName) { | |
var options = arguments[arguments.length - 1], | |
contexts = a_slice.call(arguments, 1, -1); | |
var hash = options.hash, | |
controller = options.data.keywords.controller; | |
// create a hash to pass along to registerAction | |
var action = { | |
eventName: hash.on || "click", | |
parameters: { | |
context: this, | |
options: options, | |
params: contexts | |
}, | |
view: options.data.view, | |
bubbles: hash.bubbles, | |
preventDefault: hash.preventDefault, | |
target: { options: options }, | |
boundProperty: options.types[0] === "ID" | |
}; | |
if (hash.target) { | |
action.target.root = this; | |
action.target.target = hash.target; | |
} else if (controller) { | |
action.target.root = controller; | |
} | |
var actionId = ActionHelper.registerAction(actionName, action, hash.allowedKeys); | |
return new SafeString('data-ember-action="' + actionId + '"'); | |
} | |
__exports__.actionHelper = actionHelper; | |
}); | |
define("ember-routing/helpers/link_to", | |
["ember-metal/core","ember-metal/property_get","ember-metal/property_set","ember-metal/merge","ember-metal/run_loop","ember-metal/computed","ember-runtime/system/lazy_load","ember-runtime/system/string","ember-runtime/system/object","ember-runtime/keys","ember-views/system/utils","ember-views/views/component","ember-handlebars","ember-handlebars/helpers/view","ember-routing/system/router","ember-routing/helpers/shared","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __dependency6__, __dependency7__, __dependency8__, __dependency9__, __dependency10__, __dependency11__, __dependency12__, __dependency13__, __dependency14__, __dependency15__, __dependency16__, __exports__) { | |
"use strict"; | |
var Ember = __dependency1__["default"]; | |
// FEATURES, Logger, Handlebars, warn, assert | |
var get = __dependency2__.get; | |
var set = __dependency3__.set; | |
var merge = __dependency4__["default"]; | |
var run = __dependency5__["default"]; | |
var computed = __dependency6__.computed; | |
var onLoad = __dependency7__.onLoad; | |
var fmt = __dependency8__.fmt; | |
var EmberObject = __dependency9__["default"]; | |
var keys = __dependency10__["default"]; | |
var isSimpleClick = __dependency11__.isSimpleClick; | |
var EmberComponent = __dependency12__["default"]; | |
var EmberHandlebars = __dependency13__["default"]; | |
var viewHelper = __dependency14__.viewHelper; | |
var EmberRouter = __dependency15__["default"]; | |
var resolveParams = __dependency16__.resolveParams; | |
var resolvePaths = __dependency16__.resolvePaths; | |
// requireModule('ember-handlebars'); | |
/** | |
@module ember | |
@submodule ember-routing | |
*/ | |
var slice = [].slice; | |
requireModule('ember-handlebars'); | |
var numberOfContextsAcceptedByHandler = function(handler, handlerInfos) { | |
var req = 0; | |
for (var i = 0, l = handlerInfos.length; i < l; i++) { | |
req = req + handlerInfos[i].names.length; | |
if (handlerInfos[i].handler === handler) | |
break; | |
} | |
// query params adds an additional context | |
if (Ember.FEATURES.isEnabled("query-params-new")) { | |
req = req + 1; | |
} | |
return req; | |
}; | |
var QueryParams = EmberObject.extend({ | |
values: null | |
}); | |
function computeQueryParams(linkView, stripDefaultValues) { | |
var helperParameters = linkView.parameters, | |
queryParamsObject = get(linkView, 'queryParamsObject'), | |
suppliedParams = {}; | |
if (queryParamsObject) { | |
merge(suppliedParams, queryParamsObject.values); | |
} | |
var resolvedParams = get(linkView, 'resolvedParams'), | |
router = get(linkView, 'router'), | |
routeName = resolvedParams[0], | |
paramsForRoute = router._queryParamsFor(routeName), | |
qps = paramsForRoute.qps, | |
paramsForRecognizer = {}; | |
// We need to collect all non-default query params for this route. | |
for (var i = 0, len = qps.length; i < len; ++i) { | |
var qp = qps[i]; | |
// Check if the link-to provides a value for this qp. | |
var providedType = null, value; | |
if (qp.prop in suppliedParams) { | |
value = suppliedParams[qp.prop]; | |
providedType = queryParamsObject.types[qp.prop]; | |
delete suppliedParams[qp.prop]; | |
} else if (qp.urlKey in suppliedParams) { | |
value = suppliedParams[qp.urlKey]; | |
providedType = queryParamsObject.types[qp.urlKey]; | |
delete suppliedParams[qp.urlKey]; | |
} | |
if (providedType) { | |
if (providedType === 'ID') { | |
var normalizedPath = EmberHandlebars.normalizePath(helperParameters.context, value, helperParameters.options.data); | |
value = EmberHandlebars.get(normalizedPath.root, normalizedPath.path, helperParameters.options); | |
} | |
value = qp.route.serializeQueryParam(value, qp.urlKey, qp.type); | |
} else { | |
value = qp.svalue; | |
} | |
if (stripDefaultValues && value === qp.sdef) { | |
continue; | |
} | |
paramsForRecognizer[qp.urlKey] = value; | |
} | |
return paramsForRecognizer; | |
} | |
function routeArgsWithoutDefaultQueryParams(linkView) { | |
var routeArgs = linkView.get('routeArgs'); | |
if (!routeArgs[routeArgs.length-1].queryParams) { | |
return routeArgs; | |
} | |
routeArgs = routeArgs.slice(); | |
routeArgs[routeArgs.length-1] = { | |
queryParams: computeQueryParams(linkView, true) | |
}; | |
return routeArgs; | |
} | |
function getResolvedPaths(options) { | |
var types = options.options.types, | |
data = options.options.data; | |
return resolvePaths(options.context, options.params, { types: types, data: data }); | |
} | |
/** | |
`Ember.LinkView` renders an element whose `click` event triggers a | |
transition of the application's instance of `Ember.Router` to | |
a supplied route by name. | |
Instances of `LinkView` will most likely be created through | |
the `link-to` Handlebars helper, but properties of this class | |
can be overridden to customize application-wide behavior. | |
@class LinkView | |
@namespace Ember | |
@extends Ember.View | |
@see {Handlebars.helpers.link-to} | |
**/ | |
var LinkView = Ember.LinkView = EmberComponent.extend({ | |
tagName: 'a', | |
currentWhen: null, | |
/** | |
Sets the `title` attribute of the `LinkView`'s HTML element. | |
@property title | |
@default null | |
**/ | |
title: null, | |
/** | |
Sets the `rel` attribute of the `LinkView`'s HTML element. | |
@property rel | |
@default null | |
**/ | |
rel: null, | |
/** | |
The CSS class to apply to `LinkView`'s element when its `active` | |
property is `true`. | |
@property activeClass | |
@type String | |
@default active | |
**/ | |
activeClass: 'active', | |
/** | |
The CSS class to apply to `LinkView`'s element when its `loading` | |
property is `true`. | |
@property loadingClass | |
@type String | |
@default loading | |
**/ | |
loadingClass: 'loading', | |
/** | |
The CSS class to apply to a `LinkView`'s element when its `disabled` | |
property is `true`. | |
@property disabledClass | |
@type String | |
@default disabled | |
**/ | |
disabledClass: 'disabled', | |
_isDisabled: false, | |
/** | |
Determines whether the `LinkView` will trigger routing via | |
the `replaceWith` routing strategy. | |
@property replace | |
@type Boolean | |
@default false | |
**/ | |
replace: false, | |
/** | |
By default the `{{link-to}}` helper will bind to the `href` and | |
`title` attributes. It's discourage that you override these defaults, | |
however you can push onto the array if needed. | |
@property attributeBindings | |
@type Array | String | |
@default ['href', 'title', 'rel'] | |
**/ | |
attributeBindings: ['href', 'title', 'rel'], | |
/** | |
By default the `{{link-to}}` helper will bind to the `active`, `loading`, and | |
`disabled` classes. It is discouraged to override these directly. | |
@property classNameBindings | |
@type Array | |
@default ['active', 'loading', 'disabled'] | |
**/ | |
classNameBindings: ['active', 'loading', 'disabled'], | |
/** | |
By default the `{{link-to}}` helper responds to the `click` event. You | |
can override this globally by setting this property to your custom | |
event name. | |
This is particularly useful on mobile when one wants to avoid the 300ms | |
click delay using some sort of custom `tap` event. | |
@property eventName | |
@type String | |
@default click | |
*/ | |
eventName: 'click', | |
// this is doc'ed here so it shows up in the events | |
// section of the API documentation, which is where | |
// people will likely go looking for it. | |
/** | |
Triggers the `LinkView`'s routing behavior. If | |
`eventName` is changed to a value other than `click` | |
the routing behavior will trigger on that custom event | |
instead. | |
@event click | |
**/ | |
/** | |
An overridable method called when LinkView objects are instantiated. | |
Example: | |
```javascript | |
App.MyLinkView = Ember.LinkView.extend({ | |
init: function() { | |
this._super(); | |
Ember.Logger.log('Event is ' + this.get('eventName')); | |
} | |
}); | |
``` | |
NOTE: If you do override `init` for a framework class like `Ember.View` or | |
`Ember.ArrayController`, be sure to call `this._super()` in your | |
`init` declaration! If you don't, Ember may not have an opportunity to | |
do important setup work, and you'll see strange behavior in your | |
application. | |
@method init | |
*/ | |
init: function() { | |
this._super.apply(this, arguments); | |
// Map desired event name to invoke function | |
var eventName = get(this, 'eventName'); | |
this.on(eventName, this, this._invoke); | |
}, | |
/** | |
This method is invoked by observers installed during `init` that fire | |
whenever the params change | |
@private | |
@method _paramsChanged | |
@since 1.3.0 | |
*/ | |
_paramsChanged: function() { | |
this.notifyPropertyChange('resolvedParams'); | |
}, | |
/** | |
This is called to setup observers that will trigger a rerender. | |
@private | |
@method _setupPathObservers | |
@since 1.3.0 | |
**/ | |
_setupPathObservers: function(){ | |
var helperParameters = this.parameters, | |
linkTextPath = helperParameters.options.linkTextPath, | |
paths = getResolvedPaths(helperParameters), | |
length = paths.length, | |
path, i, normalizedPath; | |
if (linkTextPath) { | |
normalizedPath = EmberHandlebars.normalizePath(helperParameters.context, linkTextPath, helperParameters.options.data); | |
this.registerObserver(normalizedPath.root, normalizedPath.path, this, this.rerender); | |
} | |
for(i=0; i < length; i++) { | |
path = paths[i]; | |
if (null === path) { | |
// A literal value was provided, not a path, so nothing to observe. | |
continue; | |
} | |
normalizedPath = EmberHandlebars.normalizePath(helperParameters.context, path, helperParameters.options.data); | |
this.registerObserver(normalizedPath.root, normalizedPath.path, this, this._paramsChanged); | |
} | |
var queryParamsObject = this.queryParamsObject; | |
if (queryParamsObject) { | |
var values = queryParamsObject.values; | |
// Install observers for all of the hash options | |
// provided in the (query-params) subexpression. | |
for (var k in values) { | |
if (!values.hasOwnProperty(k)) { continue; } | |
if (queryParamsObject.types[k] === 'ID') { | |
normalizedPath = EmberHandlebars.normalizePath(helperParameters.context, values[k], helperParameters.options.data); | |
this.registerObserver(normalizedPath.root, normalizedPath.path, this, this._paramsChanged); | |
} | |
} | |
} | |
}, | |
afterRender: function(){ | |
this._super.apply(this, arguments); | |
this._setupPathObservers(); | |
}, | |
/** | |
Accessed as a classname binding to apply the `LinkView`'s `disabledClass` | |
CSS `class` to the element when the link is disabled. | |
When `true` interactions with the element will not trigger route changes. | |
@property disabled | |
*/ | |
disabled: computed(function computeLinkViewDisabled(key, value) { | |
if (value !== undefined) { this.set('_isDisabled', value); } | |
return value ? get(this, 'disabledClass') : false; | |
}), | |
/** | |
Accessed as a classname binding to apply the `LinkView`'s `activeClass` | |
CSS `class` to the element when the link is active. | |
A `LinkView` is considered active when its `currentWhen` property is `true` | |
or the application's current route is the route the `LinkView` would trigger | |
transitions into. | |
@property active | |
**/ | |
active: computed(function computeLinkViewActive() { | |
if (get(this, 'loading')) { return false; } | |
var router = get(this, 'router'), | |
routeArgs = get(this, 'routeArgs'), | |
contexts = routeArgs.slice(1), | |
resolvedParams = get(this, 'resolvedParams'), | |
currentWhen = this.currentWhen || routeArgs[0], | |
maximumContexts = numberOfContextsAcceptedByHandler(currentWhen, router.router.recognizer.handlersFor(currentWhen)); | |
// if we don't have enough contexts revert back to full route name | |
// this is because the leaf route will use one of the contexts | |
if (contexts.length > maximumContexts) | |
currentWhen = routeArgs[0]; | |
var isActive = router.isActive.apply(router, [currentWhen].concat(contexts)); | |
if (isActive) { return get(this, 'activeClass'); } | |
}).property('resolvedParams', 'routeArgs'), | |
/** | |
Accessed as a classname binding to apply the `LinkView`'s `loadingClass` | |
CSS `class` to the element when the link is loading. | |
A `LinkView` is considered loading when it has at least one | |
parameter whose value is currently null or undefined. During | |
this time, clicking the link will perform no transition and | |
emit a warning that the link is still in a loading state. | |
@property loading | |
**/ | |
loading: computed(function computeLinkViewLoading() { | |
if (!get(this, 'routeArgs')) { return get(this, 'loadingClass'); } | |
}).property('routeArgs'), | |
/** | |
Returns the application's main router from the container. | |
@private | |
@property router | |
**/ | |
router: computed(function() { | |
return get(this, 'controller').container.lookup('router:main'); | |
}), | |
/** | |
Event handler that invokes the link, activating the associated route. | |
@private | |
@method _invoke | |
@param {Event} event | |
*/ | |
_invoke: function(event) { | |
if (!isSimpleClick(event)) { return true; } | |
if (this.preventDefault !== false) { | |
if (Ember.FEATURES.isEnabled("ember-routing-linkto-target-attribute")) { | |
var targetAttribute = get(this, 'target'); | |
if (!targetAttribute || targetAttribute === '_self') { | |
event.preventDefault(); | |
} | |
} else { | |
event.preventDefault(); | |
} | |
} | |
if (this.bubbles === false) { event.stopPropagation(); } | |
if (get(this, '_isDisabled')) { return false; } | |
if (get(this, 'loading')) { | |
Ember.Logger.warn("This link-to is in an inactive loading state because at least one of its parameters presently has a null/undefined value, or the provided route name is invalid."); | |
return false; | |
} | |
var router = get(this, 'router'), | |
routeArgs = get(this, 'routeArgs'); | |
var transition; | |
if (get(this, 'replace')) { | |
transition = router.replaceWith.apply(router, routeArgs); | |
} else { | |
transition = router.transitionTo.apply(router, routeArgs); | |
} | |
// Schedule eager URL update, but after we've given the transition | |
// a chance to synchronously redirect. | |
// We need to always generate the URL instead of using the href because | |
// the href will include any rootURL set, but the router expects a URL | |
// without it! Note that we don't use the first level router because it | |
// calls location.formatURL(), which also would add the rootURL! | |
var url = router.router.generate.apply(router.router, routeArgsWithoutDefaultQueryParams(this)); | |
run.scheduleOnce('routerTransitions', this, this._eagerUpdateUrl, transition, url); | |
}, | |
/** | |
@private | |
@method _eagerUpdateUrl | |
@param transition | |
@param href | |
*/ | |
_eagerUpdateUrl: function(transition, href) { | |
if (!transition.isActive || !transition.urlMethod) { | |
// transition was aborted, already ran to completion, | |
// or it has a null url-updated method. | |
return; | |
} | |
if (href.indexOf('#') === 0) { | |
href = href.slice(1); | |
} | |
// Re-use the routerjs hooks set up by the Ember router. | |
var routerjs = get(this, 'router.router'); | |
if (transition.urlMethod === 'update') { | |
routerjs.updateURL(href); | |
} else if (transition.urlMethod === 'replace') { | |
routerjs.replaceURL(href); | |
} | |
// Prevent later update url refire. | |
transition.method(null); | |
}, | |
/** | |
Computed property that returns an array of the | |
resolved parameters passed to the `link-to` helper, | |
e.g.: | |
```hbs | |
{{link-to a b '123' c}} | |
``` | |
will generate a `resolvedParams` of: | |
```js | |
[aObject, bObject, '123', cObject] | |
``` | |
@private | |
@property | |
@return {Array} | |
*/ | |
resolvedParams: computed(function() { | |
var parameters = this.parameters, | |
options = parameters.options, | |
types = options.types, | |
data = options.data; | |
if (parameters.params.length === 0) { | |
var appController = this.container.lookup('controller:application'); | |
return [get(appController, 'currentRouteName')]; | |
} else { | |
return resolveParams(parameters.context, parameters.params, { types: types, data: data }); | |
} | |
}).property('router.url'), | |
/** | |
Computed property that returns the current route name and | |
any dynamic segments. | |
@private | |
@property | |
@return {Array} An array with the route name and any dynamic segments | |
*/ | |
routeArgs: computed(function computeLinkViewRouteArgs() { | |
var resolvedParams = get(this, 'resolvedParams').slice(0), | |
router = get(this, 'router'), | |
namedRoute = resolvedParams[0]; | |
if (!namedRoute) { return; } | |
Ember.assert(fmt("The attempt to link-to route '%@' failed. " + | |
"The router did not find '%@' in its possible routes: '%@'", | |
[namedRoute, namedRoute, keys(router.router.recognizer.names).join("', '")]), | |
router.hasRoute(namedRoute)); | |
//normalize route name | |
var handlers = router.router.recognizer.handlersFor(namedRoute); | |
var normalizedPath = handlers[handlers.length - 1].handler; | |
if (namedRoute !== normalizedPath) { | |
//set namedRoute as currentWhen only when currentWhen is not given explicitly | |
if (!this.currentWhen) { | |
this.set('currentWhen', namedRoute); | |
} | |
namedRoute = handlers[handlers.length - 1].handler; | |
resolvedParams[0] = namedRoute; | |
} | |
for (var i = 1, len = resolvedParams.length; i < len; ++i) { | |
var param = resolvedParams[i]; | |
if (param === null || typeof param === 'undefined') { | |
// If contexts aren't present, consider the linkView unloaded. | |
return; | |
} | |
} | |
if (Ember.FEATURES.isEnabled("query-params-new")) { | |
resolvedParams.push({ queryParams: get(this, 'queryParams') }); | |
} | |
return resolvedParams; | |
}).property('resolvedParams', 'queryParams'), | |
queryParamsObject: null, | |
queryParams: computed(function computeLinkViewQueryParams() { | |
return computeQueryParams(this, false); | |
}).property('resolvedParams.[]'), | |
/** | |
Sets the element's `href` attribute to the url for | |
the `LinkView`'s targeted route. | |
If the `LinkView`'s `tagName` is changed to a value other | |
than `a`, this property will be ignored. | |
@property href | |
**/ | |
href: computed(function computeLinkViewHref() { | |
if (get(this, 'tagName') !== 'a') { return; } | |
var router = get(this, 'router'), | |
routeArgs = get(this, 'routeArgs'); | |
if (!routeArgs) { | |
return get(this, 'loadingHref'); | |
} | |
if (Ember.FEATURES.isEnabled("query-params-new")) { | |
routeArgs = routeArgsWithoutDefaultQueryParams(this); | |
} | |
return router.generate.apply(router, routeArgs); | |
}).property('routeArgs'), | |
/** | |
The default href value to use while a link-to is loading. | |
Only applies when tagName is 'a' | |
@property loadingHref | |
@type String | |
@default # | |
*/ | |
loadingHref: '#' | |
}); | |
LinkView.toString = function() { return "LinkView"; }; | |
if (Ember.FEATURES.isEnabled("ember-routing-linkto-target-attribute")) { | |
LinkView.reopen({ | |
attributeBindings: ['target'], | |
/** | |
Sets the `target` attribute of the `LinkView`'s anchor element. | |
@property target | |
@default null | |
**/ | |
target: null | |
}); | |
} | |
/** | |
The `{{link-to}}` helper renders a link to the supplied | |
`routeName` passing an optionally supplied model to the | |
route as its `model` context of the route. The block | |
for `{{link-to}}` becomes the innerHTML of the rendered | |
element: | |
```handlebars | |
{{#link-to 'photoGallery'}} | |
Great Hamster Photos | |
{{/link-to}} | |
``` | |
```html | |
<a href="/hamster-photos"> | |
Great Hamster Photos | |
</a> | |
``` | |
### Supplying a tagName | |
By default `{{link-to}}` renders an `<a>` element. This can | |
be overridden for a single use of `{{link-to}}` by supplying | |
a `tagName` option: | |
```handlebars | |
{{#link-to 'photoGallery' tagName="li"}} | |
Great Hamster Photos | |
{{/link-to}} | |
``` | |
```html | |
<li> | |
Great Hamster Photos | |
</li> | |
``` | |
To override this option for your entire application, see | |
"Overriding Application-wide Defaults". | |
### Disabling the `link-to` helper | |
By default `{{link-to}}` is enabled. | |
any passed value to `disabled` helper property will disable the `link-to` helper. | |
static use: the `disabled` option: | |
```handlebars | |
{{#link-to 'photoGallery' disabled=true}} | |
Great Hamster Photos | |
{{/link-to}} | |
``` | |
dynamic use: the `disabledWhen` option: | |
```handlebars | |
{{#link-to 'photoGallery' disabledWhen=controller.someProperty}} | |
Great Hamster Photos | |
{{/link-to}} | |
``` | |
any passed value to `disabled` will disable it except `undefined`. | |
to ensure that only `true` disable the `link-to` helper you can | |
override the global behaviour of `Ember.LinkView`. | |
```javascript | |
Ember.LinkView.reopen({ | |
disabled: Ember.computed(function(key, value) { | |
if (value !== undefined) { | |
this.set('_isDisabled', value === true); | |
} | |
return value === true ? get(this, 'disabledClass') : false; | |
}) | |
}); | |
``` | |
see "Overriding Application-wide Defaults" for more. | |
### Handling `href` | |
`{{link-to}}` will use your application's Router to | |
fill the element's `href` property with a url that | |
matches the path to the supplied `routeName` for your | |
routers's configured `Location` scheme, which defaults | |
to Ember.HashLocation. | |
### Handling current route | |
`{{link-to}}` will apply a CSS class name of 'active' | |
when the application's current route matches | |
the supplied routeName. For example, if the application's | |
current route is 'photoGallery.recent' the following | |
use of `{{link-to}}`: | |
```handlebars | |
{{#link-to 'photoGallery.recent'}} | |
Great Hamster Photos from the last week | |
{{/link-to}} | |
``` | |
will result in | |
```html | |
<a href="/hamster-photos/this-week" class="active"> | |
Great Hamster Photos | |
</a> | |
``` | |
The CSS class name used for active classes can be customized | |
for a single use of `{{link-to}}` by passing an `activeClass` | |
option: | |
```handlebars | |
{{#link-to 'photoGallery.recent' activeClass="current-url"}} | |
Great Hamster Photos from the last week | |
{{/link-to}} | |
``` | |
```html | |
<a href="/hamster-photos/this-week" class="current-url"> | |
Great Hamster Photos | |
</a> | |
``` | |
To override this option for your entire application, see | |
"Overriding Application-wide Defaults". | |
### Supplying a model | |
An optional model argument can be used for routes whose | |
paths contain dynamic segments. This argument will become | |
the model context of the linked route: | |
```javascript | |
App.Router.map(function() { | |
this.resource("photoGallery", {path: "hamster-photos/:photo_id"}); | |
}); | |
``` | |
```handlebars | |
{{#link-to 'photoGallery' aPhoto}} | |
{{aPhoto.title}} | |
{{/link-to}} | |
``` | |
```html | |
<a href="/hamster-photos/42"> | |
Tomster | |
</a> | |
``` | |
### Supplying multiple models | |
For deep-linking to route paths that contain multiple | |
dynamic segments, multiple model arguments can be used. | |
As the router transitions through the route path, each | |
supplied model argument will become the context for the | |
route with the dynamic segments: | |
```javascript | |
App.Router.map(function() { | |
this.resource("photoGallery", {path: "hamster-photos/:photo_id"}, function() { | |
this.route("comment", {path: "comments/:comment_id"}); | |
}); | |
}); | |
``` | |
This argument will become the model context of the linked route: | |
```handlebars | |
{{#link-to 'photoGallery.comment' aPhoto comment}} | |
{{comment.body}} | |
{{/link-to}} | |
``` | |
```html | |
<a href="/hamster-photos/42/comment/718"> | |
A+++ would snuggle again. | |
</a> | |
``` | |
### Supplying an explicit dynamic segment value | |
If you don't have a model object available to pass to `{{link-to}}`, | |
an optional string or integer argument can be passed for routes whose | |
paths contain dynamic segments. This argument will become the value | |
of the dynamic segment: | |
```javascript | |
App.Router.map(function() { | |
this.resource("photoGallery", {path: "hamster-photos/:photo_id"}); | |
}); | |
``` | |
```handlebars | |
{{#link-to 'photoGallery' aPhotoId}} | |
{{aPhoto.title}} | |
{{/link-to}} | |
``` | |
```html | |
<a href="/hamster-photos/42"> | |
Tomster | |
</a> | |
``` | |
When transitioning into the linked route, the `model` hook will | |
be triggered with parameters including this passed identifier. | |
### Allowing Default Action | |
By default the `{{link-to}}` helper prevents the default browser action | |
by calling `preventDefault()` as this sort of action bubbling is normally | |
handled internally and we do not want to take the browser to a new URL (for | |
example). | |
If you need to override this behavior specify `preventDefault=false` in | |
your template: | |
```handlebars | |
{{#link-to 'photoGallery' aPhotoId preventDefault=false}} | |
{{aPhotoId.title}} | |
{{/link-to}} | |
``` | |
### Overriding attributes | |
You can override any given property of the Ember.LinkView | |
that is generated by the `{{link-to}}` helper by passing | |
key/value pairs, like so: | |
```handlebars | |
{{#link-to aPhoto tagName='li' title='Following this link will change your life' classNames='pic sweet'}} | |
Uh-mazing! | |
{{/link-to}} | |
``` | |
See [Ember.LinkView](/api/classes/Ember.LinkView.html) for a | |
complete list of overrideable properties. Be sure to also | |
check out inherited properties of `LinkView`. | |
### Overriding Application-wide Defaults | |
``{{link-to}}`` creates an instance of Ember.LinkView | |
for rendering. To override options for your entire | |
application, reopen Ember.LinkView and supply the | |
desired values: | |
``` javascript | |
Ember.LinkView.reopen({ | |
activeClass: "is-active", | |
tagName: 'li' | |
}) | |
``` | |
It is also possible to override the default event in | |
this manner: | |
``` javascript | |
Ember.LinkView.reopen({ | |
eventName: 'customEventName' | |
}); | |
``` | |
@method link-to | |
@for Ember.Handlebars.helpers | |
@param {String} routeName | |
@param {Object} [context]* | |
@param [options] {Object} Handlebars key/value pairs of options, you can override any property of Ember.LinkView | |
@return {String} HTML string | |
@see {Ember.LinkView} | |
*/ | |
function linkToHelper(name) { | |
var options = slice.call(arguments, -1)[0], | |
params = slice.call(arguments, 0, -1), | |
hash = options.hash; | |
if (params[params.length - 1] instanceof QueryParams) { | |
hash.queryParamsObject = params.pop(); | |
} | |
hash.disabledBinding = hash.disabledWhen; | |
if (!options.fn) { | |
var linkTitle = params.shift(); | |
var linkType = options.types.shift(); | |
var context = this; | |
if (linkType === 'ID') { | |
options.linkTextPath = linkTitle; | |
options.fn = function() { | |
return EmberHandlebars.getEscaped(context, linkTitle, options); | |
}; | |
} else { | |
options.fn = function() { | |
return linkTitle; | |
}; | |
} | |
} | |
hash.parameters = { | |
context: this, | |
options: options, | |
params: params | |
}; | |
options.helperName = options.helperName || 'link-to'; | |
return viewHelper.call(this, LinkView, options); | |
} | |
if (Ember.FEATURES.isEnabled("query-params-new")) { | |
EmberHandlebars.registerHelper('query-params', function queryParamsHelper(options) { | |
Ember.assert(fmt("The `query-params` helper only accepts hash parameters, e.g. (query-params queryParamPropertyName='%@') as opposed to just (query-params '%@')", [options, options]), arguments.length === 1); | |
return QueryParams.create({ | |
values: options.hash, | |
types: options.hashTypes | |
}); | |
}); | |
} | |
/** | |
See [link-to](/api/classes/Ember.Handlebars.helpers.html#method_link-to) | |
@method linkTo | |
@for Ember.Handlebars.helpers | |
@deprecated | |
@param {String} routeName | |
@param {Object} [context]* | |
@return {String} HTML string | |
*/ | |
function deprecatedLinkToHelper() { | |
Ember.warn("The 'linkTo' view helper is deprecated in favor of 'link-to'"); | |
return linkToHelper.apply(this, arguments); | |
} | |
__exports__.LinkView = LinkView; | |
__exports__.deprecatedLinkToHelper = deprecatedLinkToHelper; | |
__exports__.linkToHelper = linkToHelper; | |
}); | |
define("ember-routing/helpers/outlet", | |
["ember-metal/core","ember-metal/property_get","ember-metal/property_set","ember-runtime/system/lazy_load","ember-views/views/container_view","ember-handlebars/views/metamorph_view","ember-handlebars/helpers/view","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __dependency6__, __dependency7__, __exports__) { | |
"use strict"; | |
var Ember = __dependency1__["default"]; | |
// assert | |
var get = __dependency2__.get; | |
var set = __dependency3__.set; | |
var onLoad = __dependency4__.onLoad; | |
var ContainerView = __dependency5__["default"]; | |
var _Metamorph = __dependency6__._Metamorph; | |
var viewHelper = __dependency7__.viewHelper; | |
// requireModule('ember-handlebars'); | |
/** | |
@module ember | |
@submodule ember-routing | |
*/ | |
/** | |
@module ember | |
@submodule ember-routing | |
*/ | |
var OutletView = ContainerView.extend(_Metamorph); | |
__exports__.OutletView = OutletView; | |
/** | |
The `outlet` helper is a placeholder that the router will fill in with | |
the appropriate template based on the current state of the application. | |
``` handlebars | |
{{outlet}} | |
``` | |
By default, a template based on Ember's naming conventions will be rendered | |
into the `outlet` (e.g. `App.PostsRoute` will render the `posts` template). | |
You can render a different template by using the `render()` method in the | |
route's `renderTemplate` hook. The following will render the `favoritePost` | |
template into the `outlet`. | |
``` javascript | |
App.PostsRoute = Ember.Route.extend({ | |
renderTemplate: function() { | |
this.render('favoritePost'); | |
} | |
}); | |
``` | |
You can create custom named outlets for more control. | |
``` handlebars | |
{{outlet 'favoritePost'}} | |
{{outlet 'posts'}} | |
``` | |
Then you can define what template is rendered into each outlet in your | |
route. | |
``` javascript | |
App.PostsRoute = Ember.Route.extend({ | |
renderTemplate: function() { | |
this.render('favoritePost', { outlet: 'favoritePost' }); | |
this.render('posts', { outlet: 'posts' }); | |
} | |
}); | |
``` | |
You can specify the view that the outlet uses to contain and manage the | |
templates rendered into it. | |
``` handlebars | |
{{outlet view='sectionContainer'}} | |
``` | |
``` javascript | |
App.SectionContainer = Ember.ContainerView.extend({ | |
tagName: 'section', | |
classNames: ['special'] | |
}); | |
``` | |
@method outlet | |
@for Ember.Handlebars.helpers | |
@param {String} property the property on the controller | |
that holds the view for this outlet | |
@return {String} HTML string | |
*/ | |
function outletHelper(property, options) { | |
var outletSource; | |
var container; | |
var viewName; | |
var viewClass; | |
var viewFullName; | |
if (property && property.data && property.data.isRenderData) { | |
options = property; | |
property = 'main'; | |
} | |
container = options.data.view.container; | |
outletSource = options.data.view; | |
while (!outletSource.get('template.isTop')) { | |
outletSource = outletSource.get('_parentView'); | |
} | |
// provide controller override | |
viewName = options.hash.view; | |
if (viewName) { | |
viewFullName = 'view:' + viewName; | |
Ember.assert("Using a quoteless view parameter with {{outlet}} is not supported. Please update to quoted usage '{{outlet \"" + viewName + "\"}}.", options.hashTypes.view !== 'ID'); | |
Ember.assert("The view name you supplied '" + viewName + "' did not resolve to a view.", container.has(viewFullName)); | |
} | |
viewClass = viewName ? container.lookupFactory(viewFullName) : options.hash.viewClass || OutletView; | |
options.data.view.set('outletSource', outletSource); | |
options.hash.currentViewBinding = '_view.outletSource._outlets.' + property; | |
options.helperName = options.helperName || 'outlet'; | |
return viewHelper.call(this, viewClass, options); | |
} | |
__exports__.outletHelper = outletHelper; | |
}); | |
define("ember-routing/helpers/render", | |
["ember-metal/core","ember-metal/error","ember-metal/property_get","ember-metal/property_set","ember-runtime/system/string","ember-routing/system/controller_for","ember-handlebars/ext","ember-handlebars/helpers/view","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __dependency6__, __dependency7__, __dependency8__, __exports__) { | |
"use strict"; | |
var Ember = __dependency1__["default"]; | |
// assert, deprecate | |
var EmberError = __dependency2__["default"]; | |
var get = __dependency3__.get; | |
var set = __dependency4__.set; | |
var camelize = __dependency5__.camelize; | |
var generateControllerFactory = __dependency6__.generateControllerFactory; | |
var generateController = __dependency6__.generateController; | |
var handlebarsGet = __dependency7__.handlebarsGet; | |
var viewHelper = __dependency8__.viewHelper; | |
// requireModule('ember-handlebars'); | |
/** | |
@module ember | |
@submodule ember-routing | |
*/ | |
/** | |
Calling ``{{render}}`` from within a template will insert another | |
template that matches the provided name. The inserted template will | |
access its properties on its own controller (rather than the controller | |
of the parent template). | |
If a view class with the same name exists, the view class also will be used. | |
Note: A given controller may only be used *once* in your app in this manner. | |
A singleton instance of the controller will be created for you. | |
Example: | |
```javascript | |
App.NavigationController = Ember.Controller.extend({ | |
who: "world" | |
}); | |
``` | |
```handlebars | |
<!-- navigation.hbs --> | |
Hello, {{who}}. | |
``` | |
```handelbars | |
<!-- application.hbs --> | |
<h1>My great app</h1> | |
{{render "navigation"}} | |
``` | |
```html | |
<h1>My great app</h1> | |
<div class='ember-view'> | |
Hello, world. | |
</div> | |
``` | |
Optionally you may provide a second argument: a property path | |
that will be bound to the `model` property of the controller. | |
If a `model` property path is specified, then a new instance of the | |
controller will be created and `{{render}}` can be used multiple times | |
with the same name. | |
For example if you had this `author` template. | |
```handlebars | |
<div class="author"> | |
Written by {{firstName}} {{lastName}}. | |
Total Posts: {{postCount}} | |
</div> | |
``` | |
You could render it inside the `post` template using the `render` helper. | |
```handlebars | |
<div class="post"> | |
<h1>{{title}}</h1> | |
<div>{{body}}</div> | |
{{render "author" author}} | |
</div> | |
``` | |
@method render | |
@for Ember.Handlebars.helpers | |
@param {String} name | |
@param {Object?} contextString | |
@param {Hash} options | |
@return {String} HTML string | |
*/ | |
__exports__["default"] = function renderHelper(name, contextString, options) { | |
var length = arguments.length; | |
var contextProvided = length === 3, | |
container, router, controller, view, context, lookupOptions; | |
container = (options || contextString).data.keywords.controller.container; | |
router = container.lookup('router:main'); | |
if (length === 2) { | |
// use the singleton controller | |
options = contextString; | |
contextString = undefined; | |
Ember.assert("You can only use the {{render}} helper once without a model object as its second argument, as in {{render \"post\" post}}.", !router || !router._lookupActiveView(name)); | |
} else if (length === 3) { | |
// create a new controller | |
context = handlebarsGet(options.contexts[1], contextString, options); | |
} else { | |
throw new EmberError("You must pass a templateName to render"); | |
} | |
Ember.deprecate("Using a quoteless parameter with {{render}} is deprecated. Please update to quoted usage '{{render \"" + name + "\"}}.", options.types[0] !== 'ID'); | |
// # legacy namespace | |
name = name.replace(/\//g, '.'); | |
// \ legacy slash as namespace support | |
view = container.lookup('view:' + name) || container.lookup('view:default'); | |
// provide controller override | |
var controllerName = options.hash.controller || name; | |
var controllerFullName = 'controller:' + controllerName; | |
if (options.hash.controller) { | |
Ember.assert("The controller name you supplied '" + controllerName + "' did not resolve to a controller.", container.has(controllerFullName)); | |
} | |
var parentController = options.data.keywords.controller; | |
// choose name | |
if (length > 2) { | |
var factory = container.lookupFactory(controllerFullName) || | |
generateControllerFactory(container, controllerName, context); | |
controller = factory.create({ | |
model: context, | |
parentController: parentController, | |
target: parentController | |
}); | |
view.one('willDestroyElement', function() { | |
controller.destroy(); | |
}); | |
} else { | |
controller = container.lookup(controllerFullName) || | |
generateController(container, controllerName); | |
controller.setProperties({ | |
target: parentController, | |
parentController: parentController | |
}); | |
} | |
var root = options.contexts[1]; | |
if (root) { | |
view.registerObserver(root, contextString, function() { | |
controller.set('model', handlebarsGet(root, contextString, options)); | |
}); | |
} | |
options.hash.viewName = camelize(name); | |
var templateName = 'template:' + name; | |
Ember.assert("You used `{{render '" + name + "'}}`, but '" + name + "' can not be found as either a template or a view.", container.has("view:" + name) || container.has(templateName) || options.fn); | |
options.hash.template = container.lookup(templateName); | |
options.hash.controller = controller; | |
if (router && !context) { | |
router._connectActiveView(name, view); | |
} | |
options.helperName = options.helperName || ('render "' + name + '"'); | |
viewHelper.call(this, view, options); | |
} | |
}); | |
define("ember-routing/helpers/shared", | |
["ember-metal/property_get","ember-metal/array","ember-runtime/system/lazy_load","ember-runtime/controllers/controller","ember-routing/system/router","ember-handlebars/ext","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __dependency6__, __exports__) { | |
"use strict"; | |
var get = __dependency1__.get; | |
var map = __dependency2__.map; | |
var onLoad = __dependency3__.onLoad; | |
var ControllerMixin = __dependency4__.ControllerMixin; | |
var EmberRouter = __dependency5__["default"]; | |
var handlebarsResolve = __dependency6__.resolveParams; | |
var handlebarsGet = __dependency6__.handlebarsGet; | |
function resolveParams(context, params, options) { | |
return map.call(resolvePaths(context, params, options), function(path, i) { | |
if (null === path) { | |
// Param was string/number, not a path, so just return raw string/number. | |
return params[i]; | |
} else { | |
return handlebarsGet(context, path, options); | |
} | |
}); | |
} | |
__exports__.resolveParams = resolveParams;__exports__.resolvePaths = resolvePaths; | |
function resolvePaths(context, params, options) { | |
var resolved = handlebarsResolve(context, params, options), | |
types = options.types; | |
return map.call(resolved, function(object, i) { | |
if (types[i] === 'ID') { | |
return unwrap(object, params[i]); | |
} else { | |
return null; | |
} | |
}); | |
function unwrap(object, path) { | |
if (path === 'controller') { return path; } | |
if (ControllerMixin.detect(object)) { | |
return unwrap(get(object, 'model'), path ? path + '.model' : 'model'); | |
} else { | |
return path; | |
} | |
} | |
} | |
}); | |
define("ember-routing/location/api", | |
["ember-metal/core","ember-metal/property_get","ember-metal/property_set","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __exports__) { | |
"use strict"; | |
var Ember = __dependency1__["default"]; | |
// deprecate, assert | |
var get = __dependency2__.get; | |
var set = __dependency3__.set; | |
/** | |
@module ember | |
@submodule ember-routing | |
*/ | |
/** | |
Ember.Location returns an instance of the correct implementation of | |
the `location` API. | |
## Implementations | |
You can pass an implementation name (`hash`, `history`, `none`) to force a | |
particular implementation to be used in your application. | |
### HashLocation | |
Using `HashLocation` results in URLs with a `#` (hash sign) separating the | |
server side URL portion of the URL from the portion that is used by Ember. | |
This relies upon the `hashchange` event existing in the browser. | |
Example: | |
```javascript | |
App.Router.map(function() { | |
this.resource('posts', function() { | |
this.route('new'); | |
}); | |
}); | |
App.Router.reopen({ | |
location: 'hash' | |
}); | |
``` | |
This will result in a posts.new url of `/#/posts/new`. | |
### HistoryLocation | |
Using `HistoryLocation` results in URLs that are indistinguishable from a | |
standard URL. This relies upon the browser's `history` API. | |
Example: | |
```javascript | |
App.Router.map(function() { | |
this.resource('posts', function() { | |
this.route('new'); | |
}); | |
}); | |
App.Router.reopen({ | |
location: 'history' | |
}); | |
``` | |
This will result in a posts.new url of `/posts/new`. | |
Keep in mind that your server must serve the Ember app at all the routes you | |
define. | |
### AutoLocation | |
Using `AutoLocation`, the router will use the best Location class supported by | |
the browser it is running in. | |
Browsers that support the `history` API will use `HistoryLocation`, those that | |
do not, but still support the `hashchange` event will use `HashLocation`, and | |
in the rare case neither is supported will use `NoneLocation`. | |
Example: | |
```javascript | |
App.Router.map(function() { | |
this.resource('posts', function() { | |
this.route('new'); | |
}); | |
}); | |
App.Router.reopen({ | |
location: 'auto' | |
}); | |
``` | |
This will result in a posts.new url of `/posts/new` for modern browsers that | |
support the `history` api or `/#/posts/new` for older ones, like Internet | |
Explorer 9 and below. | |
When a user visits a link to your application, they will be automatically | |
upgraded or downgraded to the appropriate `Location` class, with the URL | |
transformed accordingly, if needed. | |
Keep in mind that since some of your users will use `HistoryLocation`, your | |
server must serve the Ember app at all the routes you define. | |
### NoneLocation | |
Using `NoneLocation` causes Ember to not store the applications URL state | |
in the actual URL. This is generally used for testing purposes, and is one | |
of the changes made when calling `App.setupForTesting()`. | |
## Location API | |
Each location implementation must provide the following methods: | |
* implementation: returns the string name used to reference the implementation. | |
* getURL: returns the current URL. | |
* setURL(path): sets the current URL. | |
* replaceURL(path): replace the current URL (optional). | |
* onUpdateURL(callback): triggers the callback when the URL changes. | |
* formatURL(url): formats `url` to be placed into `href` attribute. | |
Calling setURL or replaceURL will not trigger onUpdateURL callbacks. | |
@class Location | |
@namespace Ember | |
@static | |
*/ | |
__exports__["default"] = { | |
/** | |
This is deprecated in favor of using the container to lookup the location | |
implementation as desired. | |
For example: | |
```javascript | |
// Given a location registered as follows: | |
container.register('location:history-test', HistoryTestLocation); | |
// You could create a new instance via: | |
container.lookup('location:history-test'); | |
``` | |
@method create | |
@param {Object} options | |
@return {Object} an instance of an implementation of the `location` API | |
@deprecated Use the container to lookup the location implementation that you | |
need. | |
*/ | |
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); | |
}, | |
/** | |
This is deprecated in favor of using the container to register the | |
location implementation as desired. | |
Example: | |
```javascript | |
Application.initializer({ | |
name: "history-test-location", | |
initialize: function(container, application) { | |
application.register('location:history-test', HistoryTestLocation); | |
} | |
}); | |
``` | |
@method registerImplementation | |
@param {String} name | |
@param {Object} implementation of the `location` API | |
@deprecated Register your custom location implementation with the | |
container directly. | |
*/ | |
registerImplementation: function(name, implementation) { | |
Ember.deprecate('Using the Ember.Location.registerImplementation is no longer supported. Register your custom location implementation with the container instead.', false); | |
this.implementations[name] = implementation; | |
}, | |
implementations: {}, | |
_location: window.location, | |
/** | |
Returns the current `location.hash` by parsing location.href since browsers | |
inconsistently URL-decode `location.hash`. | |
https://bugzilla.mozilla.org/show_bug.cgi?id=483304 | |
@private | |
@method getHash | |
@since 1.4.0 | |
*/ | |
_getHash: function () { | |
// AutoLocation has it at _location, HashLocation at .location. | |
// Being nice and not changing | |
var href = (this._location || this.location).href, | |
hashIndex = href.indexOf('#'); | |
if (hashIndex === -1) { | |
return ''; | |
} else { | |
return href.substr(hashIndex); | |
} | |
} | |
}; | |
}); | |
define("ember-routing/location/auto_location", | |
["ember-metal/core","ember-metal/property_get","ember-metal/property_set","ember-routing/location/api","ember-routing/location/history_location","ember-routing/location/hash_location","ember-routing/location/none_location","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __dependency6__, __dependency7__, __exports__) { | |
"use strict"; | |
var Ember = __dependency1__["default"]; | |
// FEATURES | |
var get = __dependency2__.get; | |
var set = __dependency3__.set; | |
var EmberLocation = __dependency4__["default"]; | |
var HistoryLocation = __dependency5__["default"]; | |
var HashLocation = __dependency6__["default"]; | |
var NoneLocation = __dependency7__["default"]; | |
/** | |
@module ember | |
@submodule ember-routing | |
*/ | |
/** | |
Ember.AutoLocation will select the best location option based off browser | |
support with the priority order: history, hash, none. | |
Clean pushState paths accessed by hashchange-only browsers will be redirected | |
to the hash-equivalent and vice versa so future transitions are consistent. | |
Keep in mind that since some of your users will use `HistoryLocation`, your | |
server must serve the Ember app at all the routes you define. | |
@class AutoLocation | |
@namespace Ember | |
@static | |
*/ | |
__exports__["default"] = { | |
/** | |
@private | |
This property is used by router:main to know whether to cancel the routing | |
setup process, which is needed while we redirect the browser. | |
@since 1.5.1 | |
@property cancelRouterSetup | |
@default false | |
*/ | |
cancelRouterSetup: false, | |
/** | |
@private | |
Will be pre-pended to path upon state change. | |
@since 1.5.1 | |
@property rootURL | |
@default '/' | |
*/ | |
rootURL: '/', | |
/** | |
@private | |
Attached for mocking in tests | |
@since 1.5.1 | |
@property _window | |
@default window | |
*/ | |
_window: window, | |
/** | |
@private | |
Attached for mocking in tests | |
@property location | |
@default window.location | |
*/ | |
_location: window.location, | |
/** | |
@private | |
Attached for mocking in tests | |
@since 1.5.1 | |
@property _history | |
@default window.history | |
*/ | |
_history: window.history, | |
/** | |
@private | |
Attached for mocking in tests | |
@since 1.5.1 | |
@property _HistoryLocation | |
@default Ember.HistoryLocation | |
*/ | |
_HistoryLocation: HistoryLocation, | |
/** | |
@private | |
Attached for mocking in tests | |
@since 1.5.1 | |
@property _HashLocation | |
@default Ember.HashLocation | |
*/ | |
_HashLocation: HashLocation, | |
/** | |
@private | |
Attached for mocking in tests | |
@since 1.5.1 | |
@property _NoneLocation | |
@default Ember.NoneLocation | |
*/ | |
_NoneLocation: NoneLocation, | |
/** | |
@private | |
Returns location.origin or builds it if device doesn't support it. | |
@method _getOrigin | |
*/ | |
_getOrigin: function () { | |
var location = this._location, | |
origin = location.origin; | |
// Older browsers, especially IE, don't have origin | |
if (!origin) { | |
origin = location.protocol + '//' + location.hostname; | |
if (location.port) { | |
origin += ':' + location.port; | |
} | |
} | |
return origin; | |
}, | |
/** | |
@private | |
We assume that if the history object has a pushState method, the host should | |
support HistoryLocation. | |
@method _getSupportsHistory | |
*/ | |
_getSupportsHistory: function () { | |
// Boosted from Modernizr: https://github.com/Modernizr/Modernizr/blob/master/feature-detects/history.js | |
// The stock browser on Android 2.2 & 2.3 returns positive on history support | |
// Unfortunately support is really buggy and there is no clean way to detect | |
// these bugs, so we fall back to a user agent sniff :( | |
var userAgent = this._window.navigator.userAgent; | |
// We only want Android 2, stock browser, and not Chrome which identifies | |
// itself as 'Mobile Safari' as well | |
if (userAgent.indexOf('Android 2') !== -1 && | |
userAgent.indexOf('Mobile Safari') !== -1 && | |
userAgent.indexOf('Chrome') === -1) { | |
return false; | |
} | |
return !!(this._history && 'pushState' in this._history); | |
}, | |
/** | |
@private | |
IE8 running in IE7 compatibility mode gives false positive, so we must also | |
check documentMode. | |
@method _getSupportsHashChange | |
*/ | |
_getSupportsHashChange: function () { | |
var window = this._window, | |
documentMode = window.document.documentMode; | |
return ('onhashchange' in window && (documentMode === undefined || documentMode > 7 )); | |
}, | |
/** | |
@private | |
Redirects the browser using location.replace, prepending the locatin.origin | |
to prevent phishing attempts | |
@method _replacePath | |
*/ | |
_replacePath: function (path) { | |
this._location.replace(this._getOrigin() + path); | |
}, | |
/** | |
@since 1.5.1 | |
@private | |
@method _getRootURL | |
*/ | |
_getRootURL: function () { | |
return this.rootURL; | |
}, | |
/** | |
@private | |
Returns the current `location.pathname`, normalized for IE inconsistencies. | |
@method _getPath | |
*/ | |
_getPath: function () { | |
var pathname = this._location.pathname; | |
// Various versions of IE/Opera don't always return a leading slash | |
if (pathname.charAt(0) !== '/') { | |
pathname = '/' + pathname; | |
} | |
return pathname; | |
}, | |
/** | |
@private | |
Returns normalized location.hash as an alias to Ember.Location._getHash | |
@since 1.5.1 | |
@method _getHash | |
*/ | |
_getHash: EmberLocation._getHash, | |
/** | |
@private | |
Returns location.search | |
@since 1.5.1 | |
@method _getQuery | |
*/ | |
_getQuery: function () { | |
return this._location.search; | |
}, | |
/** | |
@private | |
Returns the full pathname including query and hash | |
@method _getFullPath | |
*/ | |
_getFullPath: function () { | |
return this._getPath() + this._getQuery() + this._getHash(); | |
}, | |
/** | |
@private | |
Returns the current path as it should appear for HistoryLocation supported | |
browsers. This may very well differ from the real current path (e.g. if it | |
starts off as a hashed URL) | |
@method _getHistoryPath | |
*/ | |
_getHistoryPath: function () { | |
var rootURL = this._getRootURL(), | |
path = this._getPath(), | |
hash = this._getHash(), | |
query = this._getQuery(), | |
rootURLIndex = path.indexOf(rootURL), | |
routeHash, hashParts; | |
Ember.assert('Path ' + path + ' does not start with the provided rootURL ' + rootURL, rootURLIndex === 0); | |
// By convention, Ember.js routes using HashLocation are required to start | |
// with `#/`. Anything else should NOT be considered a route and should | |
// be passed straight through, without transformation. | |
if (hash.substr(0, 2) === '#/') { | |
// There could be extra hash segments after the route | |
hashParts = hash.substr(1).split('#'); | |
// The first one is always the route url | |
routeHash = hashParts.shift(); | |
// If the path already has a trailing slash, remove the one | |
// from the hashed route so we don't double up. | |
if (path.slice(-1) === '/') { | |
routeHash = routeHash.substr(1); | |
} | |
// This is the "expected" final order | |
path += routeHash; | |
path += query; | |
if (hashParts.length) { | |
path += '#' + hashParts.join('#'); | |
} | |
} else { | |
path += query; | |
path += hash; | |
} | |
return path; | |
}, | |
/** | |
@private | |
Returns the current path as it should appear for HashLocation supported | |
browsers. This may very well differ from the real current path. | |
@method _getHashPath | |
*/ | |
_getHashPath: function () { | |
var rootURL = this._getRootURL(), | |
path = rootURL, | |
historyPath = this._getHistoryPath(), | |
routePath = historyPath.substr(rootURL.length); | |
if (routePath !== '') { | |
if (routePath.charAt(0) !== '/') { | |
routePath = '/' + routePath; | |
} | |
path += '#' + routePath; | |
} | |
return path; | |
}, | |
/** | |
Selects the best location option based off browser support and returns an | |
instance of that Location class. | |
@see Ember.AutoLocation | |
@method create | |
*/ | |
create: function (options) { | |
if (options && options.rootURL) { | |
Ember.assert('rootURL must end with a trailing forward slash e.g. "/app/"', options.rootURL.charAt(options.rootURL.length-1) === '/'); | |
this.rootURL = options.rootURL; | |
} | |
var historyPath, hashPath, | |
cancelRouterSetup = false, | |
implementationClass = this._NoneLocation, | |
currentPath = this._getFullPath(); | |
if (this._getSupportsHistory()) { | |
historyPath = this._getHistoryPath(); | |
// Since we support history paths, let's be sure we're using them else | |
// switch the location over to it. | |
if (currentPath === historyPath) { | |
implementationClass = this._HistoryLocation; | |
} else { | |
cancelRouterSetup = true; | |
this._replacePath(historyPath); | |
} | |
} else if (this._getSupportsHashChange()) { | |
hashPath = this._getHashPath(); | |
// Be sure we're using a hashed path, otherwise let's switch over it to so | |
// we start off clean and consistent. We'll count an index path with no | |
// hash as "good enough" as well. | |
if (currentPath === hashPath || (currentPath === '/' && hashPath === '/#/')) { | |
implementationClass = this._HashLocation; | |
} else { | |
// Our URL isn't in the expected hash-supported format, so we want to | |
// cancel the router setup and replace the URL to start off clean | |
cancelRouterSetup = true; | |
this._replacePath(hashPath); | |
} | |
} | |
var implementation = implementationClass.create.apply(implementationClass, arguments); | |
if (cancelRouterSetup) { | |
set(implementation, 'cancelRouterSetup', true); | |
} | |
return implementation; | |
} | |
}; | |
}); | |
define("ember-routing/location/hash_location", | |
["ember-metal/property_get","ember-metal/property_set","ember-metal/run_loop","ember-metal/utils","ember-runtime/system/object","ember-routing/location/api","ember-views/system/jquery","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __dependency6__, __dependency7__, __exports__) { | |
"use strict"; | |
var get = __dependency1__.get; | |
var set = __dependency2__.set; | |
var run = __dependency3__["default"]; | |
var guidFor = __dependency4__.guidFor; | |
var EmberObject = __dependency5__["default"]; | |
var EmberLocation = __dependency6__["default"]; | |
var jQuery = __dependency7__["default"]; | |
/** | |
@module ember | |
@submodule ember-routing | |
*/ | |
/** | |
`Ember.HashLocation` implements the location API using the browser's | |
hash. At present, it relies on a `hashchange` event existing in the | |
browser. | |
@class HashLocation | |
@namespace Ember | |
@extends Ember.Object | |
*/ | |
__exports__["default"] = EmberObject.extend({ | |
implementation: 'hash', | |
init: function() { | |
set(this, 'location', get(this, '_location') || window.location); | |
}, | |
/** | |
@private | |
Returns normalized location.hash | |
@since 1.5.1 | |
@method getHash | |
*/ | |
getHash: EmberLocation._getHash, | |
/** | |
Returns the current `location.hash`, minus the '#' at the front. | |
@private | |
@method getURL | |
*/ | |
getURL: function() { | |
return this.getHash().substr(1); | |
}, | |
/** | |
Set the `location.hash` and remembers what was set. This prevents | |
`onUpdateURL` callbacks from triggering when the hash was set by | |
`HashLocation`. | |
@private | |
@method setURL | |
@param path {String} | |
*/ | |
setURL: function(path) { | |
get(this, 'location').hash = path; | |
set(this, 'lastSetURL', path); | |
}, | |
/** | |
Uses location.replace to update the url without a page reload | |
or history modification. | |
@private | |
@method replaceURL | |
@param path {String} | |
*/ | |
replaceURL: function(path) { | |
get(this, 'location').replace('#' + path); | |
set(this, 'lastSetURL', path); | |
}, | |
/** | |
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. | |
@private | |
@method onUpdateURL | |
@param callback {Function} | |
*/ | |
onUpdateURL: function(callback) { | |
var self = this; | |
var guid = guidFor(this); | |
jQuery(window).on('hashchange.ember-location-'+guid, function() { | |
run(function() { | |
var path = self.getURL(); | |
if (get(self, 'lastSetURL') === path) { return; } | |
set(self, 'lastSetURL', null); | |
callback(path); | |
}); | |
}); | |
}, | |
/** | |
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. | |
@private | |
@method formatURL | |
@param url {String} | |
*/ | |
formatURL: function(url) { | |
return '#'+url; | |
}, | |
/** | |
Cleans up the HashLocation event listener. | |
@private | |
@method willDestroy | |
*/ | |
willDestroy: function() { | |
var guid = guidFor(this); | |
jQuery(window).off('hashchange.ember-location-'+guid); | |
} | |
}); | |
}); | |
define("ember-routing/location/history_location", | |
["ember-metal/core","ember-metal/property_get","ember-metal/property_set","ember-metal/utils","ember-runtime/system/object","ember-views/system/jquery","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __dependency6__, __exports__) { | |
"use strict"; | |
var Ember = __dependency1__["default"]; | |
// FEATURES | |
var get = __dependency2__.get; | |
var set = __dependency3__.set; | |
var guidFor = __dependency4__.guidFor; | |
var EmberObject = __dependency5__["default"]; | |
var jQuery = __dependency6__["default"]; | |
/** | |
@module ember | |
@submodule ember-routing | |
*/ | |
var popstateFired = false; | |
var supportsHistoryState = window.history && 'state' in window.history; | |
/** | |
Ember.HistoryLocation implements the location API using the browser's | |
history.pushState API. | |
@class HistoryLocation | |
@namespace Ember | |
@extends Ember.Object | |
*/ | |
__exports__["default"] = EmberObject.extend({ | |
implementation: 'history', | |
init: function() { | |
set(this, 'location', get(this, 'location') || window.location); | |
set(this, 'baseURL', jQuery('base').attr('href') || ''); | |
}, | |
/** | |
Used to set state on first call to setURL | |
@private | |
@method initState | |
*/ | |
initState: function() { | |
set(this, 'history', get(this, 'history') || window.history); | |
this.replaceState(this.formatURL(this.getURL())); | |
}, | |
/** | |
Will be pre-pended to path upon state change | |
@property rootURL | |
@default '/' | |
*/ | |
rootURL: '/', | |
/** | |
Returns the current `location.pathname` without `rootURL` or `baseURL` | |
@private | |
@method getURL | |
@return url {String} | |
*/ | |
getURL: function() { | |
var rootURL = get(this, 'rootURL'), | |
location = get(this, 'location'), | |
path = location.pathname, | |
baseURL = get(this, 'baseURL'); | |
rootURL = rootURL.replace(/\/$/, ''); | |
baseURL = baseURL.replace(/\/$/, ''); | |
var url = path.replace(baseURL, '').replace(rootURL, ''); | |
if (Ember.FEATURES.isEnabled("query-params-new")) { | |
var search = location.search || ''; | |
url += search; | |
} | |
return url; | |
}, | |
/** | |
Uses `history.pushState` to update the url without a page reload. | |
@private | |
@method setURL | |
@param path {String} | |
*/ | |
setURL: function(path) { | |
var state = this.getState(); | |
path = this.formatURL(path); | |
if (!state || state.path !== path) { | |
this.pushState(path); | |
} | |
}, | |
/** | |
Uses `history.replaceState` to update the url without a page reload | |
or history modification. | |
@private | |
@method replaceURL | |
@param path {String} | |
*/ | |
replaceURL: function(path) { | |
var state = this.getState(); | |
path = this.formatURL(path); | |
if (!state || state.path !== path) { | |
this.replaceState(path); | |
} | |
}, | |
/** | |
Get the current `history.state`. Checks for if a polyfill is | |
required and if so fetches this._historyState. The state returned | |
from getState may be null if an iframe has changed a window's | |
history. | |
@private | |
@method getState | |
@return state {Object} | |
*/ | |
getState: function() { | |
return supportsHistoryState ? get(this, 'history').state : this._historyState; | |
}, | |
/** | |
Pushes a new state. | |
@private | |
@method pushState | |
@param path {String} | |
*/ | |
pushState: function(path) { | |
var state = { path: path }; | |
get(this, 'history').pushState(state, null, path); | |
// store state if browser doesn't support `history.state` | |
if (!supportsHistoryState) { | |
this._historyState = state; | |
} | |
// used for webkit workaround | |
this._previousURL = this.getURL(); | |
}, | |
/** | |
Replaces the current state. | |
@private | |
@method replaceState | |
@param path {String} | |
*/ | |
replaceState: function(path) { | |
var state = { path: path }; | |
get(this, 'history').replaceState(state, null, path); | |
// store state if browser doesn't support `history.state` | |
if (!supportsHistoryState) { | |
this._historyState = state; | |
} | |
// used for webkit workaround | |
this._previousURL = this.getURL(); | |
}, | |
/** | |
Register a callback to be invoked whenever the browser | |
history changes, including using forward and back buttons. | |
@private | |
@method onUpdateURL | |
@param callback {Function} | |
*/ | |
onUpdateURL: function(callback) { | |
var guid = guidFor(this), | |
self = this; | |
jQuery(window).on('popstate.ember-location-'+guid, function(e) { | |
// Ignore initial page load popstate event in Chrome | |
if (!popstateFired) { | |
popstateFired = true; | |
if (self.getURL() === self._previousURL) { return; } | |
} | |
callback(self.getURL()); | |
}); | |
}, | |
/** | |
Used when using `{{action}}` helper. The url is always appended to the rootURL. | |
@private | |
@method formatURL | |
@param url {String} | |
@return formatted url {String} | |
*/ | |
formatURL: function(url) { | |
var rootURL = get(this, 'rootURL'), | |
baseURL = get(this, 'baseURL'); | |
if (url !== '') { | |
rootURL = rootURL.replace(/\/$/, ''); | |
baseURL = baseURL.replace(/\/$/, ''); | |
} else if(baseURL.match(/^\//) && rootURL.match(/^\//)) { | |
baseURL = baseURL.replace(/\/$/, ''); | |
} | |
return baseURL + rootURL + url; | |
}, | |
/** | |
Cleans up the HistoryLocation event listener. | |
@private | |
@method willDestroy | |
*/ | |
willDestroy: function() { | |
var guid = guidFor(this); | |
jQuery(window).off('popstate.ember-location-'+guid); | |
} | |
}); | |
}); | |
define("ember-routing/location/none_location", | |
["ember-metal/property_get","ember-metal/property_set","ember-runtime/system/object","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __exports__) { | |
"use strict"; | |
var get = __dependency1__.get; | |
var set = __dependency2__.set; | |
var EmberObject = __dependency3__["default"]; | |
/** | |
@module ember | |
@submodule ember-routing | |
*/ | |
/** | |
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). | |
@class NoneLocation | |
@namespace Ember | |
@extends Ember.Object | |
*/ | |
__exports__["default"] = EmberObject.extend({ | |
implementation: 'none', | |
path: '', | |
/** | |
Returns the current path. | |
@private | |
@method getURL | |
@return {String} path | |
*/ | |
getURL: function() { | |
return get(this, 'path'); | |
}, | |
/** | |
Set the path and remembers what was set. Using this method | |
to change the path will not invoke the `updateURL` callback. | |
@private | |
@method setURL | |
@param path {String} | |
*/ | |
setURL: function(path) { | |
set(this, 'path', path); | |
}, | |
/** | |
Register a callback to be invoked when the path changes. These | |
callbacks will execute when the user presses the back or forward | |
button, but not after `setURL` is invoked. | |
@private | |
@method onUpdateURL | |
@param callback {Function} | |
*/ | |
onUpdateURL: function(callback) { | |
this.updateCallback = callback; | |
}, | |
/** | |
Sets the path and calls the `updateURL` callback. | |
@private | |
@method handleURL | |
@param callback {Function} | |
*/ | |
handleURL: function(url) { | |
set(this, 'path', url); | |
this.updateCallback(url); | |
}, | |
/** | |
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. | |
@private | |
@method formatURL | |
@param url {String} | |
@return {String} url | |
*/ | |
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; | |
} | |
}); | |
}); | |
define("ember-routing/system/controller_for", | |
["ember-metal/core","ember-metal/property_get","ember-metal/utils","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __exports__) { | |
"use strict"; | |
var Ember = __dependency1__["default"]; | |
// Logger | |
var get = __dependency2__.get; | |
var isArray = __dependency3__.isArray; | |
/** | |
@module ember | |
@submodule ember-routing | |
*/ | |
/** | |
Finds a controller instance. | |
@for Ember | |
@method controllerFor | |
@private | |
*/ | |
function controllerFor(container, controllerName, lookupOptions) { | |
return container.lookup('controller:' + controllerName, lookupOptions); | |
} | |
__exports__.controllerFor = controllerFor;/** | |
Generates a controller factory | |
The type of the generated controller factory is derived | |
from the context. If the context is an array an array controller | |
is generated, if an object, an object controller otherwise, a basic | |
controller is generated. | |
You can customize your generated controllers by defining | |
`App.ObjectController` or `App.ArrayController`. | |
@for Ember | |
@method generateControllerFactory | |
@private | |
*/ | |
__exports__.generateControllerFactory = generateControllerFactory; | |
function generateControllerFactory(container, controllerName, context) { | |
var Factory, fullName, instance, name, factoryName, controllerType; | |
if (context && isArray(context)) { | |
controllerType = 'array'; | |
} else if (context) { | |
controllerType = 'object'; | |
} else { | |
controllerType = 'basic'; | |
} | |
factoryName = 'controller:' + controllerType; | |
Factory = container.lookupFactory(factoryName).extend({ | |
isGenerated: true, | |
toString: function() { | |
return "(generated " + controllerName + " controller)"; | |
} | |
}); | |
fullName = 'controller:' + controllerName; | |
container.register(fullName, Factory); | |
return Factory; | |
} | |
/** | |
Generates and instantiates a controller. | |
The type of the generated controller factory is derived | |
from the context. If the context is an array an array controller | |
is generated, if an object, an object controller otherwise, a basic | |
controller is generated. | |
@for Ember | |
@method generateController | |
@private | |
@since 1.3.0 | |
*/ | |
function generateController(container, controllerName, context) { | |
generateControllerFactory(container, controllerName, context); | |
var fullName = 'controller:' + controllerName; | |
var instance = container.lookup(fullName); | |
if (get(instance, 'namespace.LOG_ACTIVE_GENERATION')) { | |
Ember.Logger.info("generated -> " + fullName, { fullName: fullName }); | |
} | |
return instance; | |
} | |
__exports__.generateController = generateController; | |
}); | |
define("ember-routing/system/dsl", | |
["ember-metal/core","exports"], | |
function(__dependency1__, __exports__) { | |
"use strict"; | |
var Ember = __dependency1__["default"]; | |
// FEATURES, assert | |
/** | |
@module ember | |
@submodule ember-routing | |
*/ | |
function DSL(name) { | |
this.parent = name; | |
this.matches = []; | |
} | |
__exports__["default"] = DSL; | |
DSL.prototype = { | |
resource: function(name, options, callback) { | |
Ember.assert("'basic' cannot be used as a resource name.", name !== 'basic'); | |
if (arguments.length === 2 && typeof options === 'function') { | |
callback = options; | |
options = {}; | |
} | |
if (arguments.length === 1) { | |
options = {}; | |
} | |
if (typeof options.path !== 'string') { | |
options.path = "/" + name; | |
} | |
var createSubRoutes = false; | |
if (Ember.FEATURES.isEnabled('ember-routing-consistent-resources')) { | |
createSubRoutes = true; | |
} else { | |
if (callback) { createSubRoutes = true; } | |
} | |
if (createSubRoutes) { | |
var dsl = new DSL(name); | |
route(dsl, 'loading'); | |
route(dsl, 'error', { path: "/_unused_dummy_error_path_route_" + name + "/:error" }); | |
if (callback) { callback.call(dsl); } | |
this.push(options.path, name, dsl.generate()); | |
} else { | |
this.push(options.path, name, null); | |
} | |
if (Ember.FEATURES.isEnabled("ember-routing-named-substates")) { | |
// For namespace-preserving nested resource (e.g. resource('foo.bar') within | |
// resource('foo')) we only want to use the last route name segment to determine | |
// the names of the error/loading substates (e.g. 'bar_loading') | |
name = name.split('.').pop(); | |
route(this, name + '_loading'); | |
route(this, name + '_error', { path: "/_unused_dummy_error_path_route_" + name + "/:error" }); | |
} | |
}, | |
push: function(url, name, callback) { | |
var parts = name.split('.'); | |
if (url === "" || url === "/" || parts[parts.length-1] === "index") { this.explicitIndex = true; } | |
this.matches.push([url, name, callback]); | |
}, | |
route: function(name, options) { | |
Ember.assert("'basic' cannot be used as a route name.", name !== 'basic'); | |
route(this, name, options); | |
if (Ember.FEATURES.isEnabled("ember-routing-named-substates")) { | |
route(this, name + '_loading'); | |
route(this, name + '_error', { path: "/_unused_dummy_error_path_route_" + name + "/:error" }); | |
} | |
}, | |
generate: function() { | |
var dslMatches = this.matches; | |
if (!this.explicitIndex) { | |
this.route("index", { path: "/" }); | |
} | |
return function(match) { | |
for (var i=0, l=dslMatches.length; i<l; i++) { | |
var dslMatch = dslMatches[i]; | |
var matchObj = match(dslMatch[0]).to(dslMatch[1], dslMatch[2]); | |
} | |
}; | |
} | |
}; | |
function route(dsl, name, options) { | |
Ember.assert("You must use `this.resource` to nest", typeof options !== 'function'); | |
options = options || {}; | |
if (typeof options.path !== 'string') { | |
options.path = "/" + name; | |
} | |
if (dsl.parent && dsl.parent !== 'application') { | |
name = dsl.parent + "." + name; | |
} | |
dsl.push(options.path, name, null); | |
} | |
DSL.map = function(callback) { | |
var dsl = new DSL(); | |
callback.call(dsl); | |
return dsl; | |
}; | |
}); | |
define("ember-routing/system/route", | |
["ember-metal/core","ember-metal/error","ember-metal/property_get","ember-metal/property_set","ember-metal/get_properties","ember-metal/enumerable_utils","ember-metal/is_none","ember-metal/computed","ember-metal/utils","ember-metal/run_loop","ember-runtime/keys","ember-runtime/copy","ember-runtime/system/string","ember-runtime/system/object","ember-runtime/mixins/action_handler","ember-routing/system/controller_for","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __dependency6__, __dependency7__, __dependency8__, __dependency9__, __dependency10__, __dependency11__, __dependency12__, __dependency13__, __dependency14__, __dependency15__, __dependency16__, __exports__) { | |
"use strict"; | |
var Ember = __dependency1__["default"]; | |
// FEATURES, K, A, deprecate, assert, Logger | |
var EmberError = __dependency2__["default"]; | |
var get = __dependency3__.get; | |
var set = __dependency4__.set; | |
var getProperties = __dependency5__["default"]; | |
var EnumerableUtils = __dependency6__["default"]; | |
var isNone = __dependency7__.isNone; | |
var computed = __dependency8__.computed; | |
var typeOf = __dependency9__.typeOf; | |
var run = __dependency10__["default"]; | |
var keys = __dependency11__["default"]; | |
var copy = __dependency12__["default"]; | |
var classify = __dependency13__.classify; | |
var fmt = __dependency13__.fmt; | |
var EmberObject = __dependency14__["default"]; | |
var ActionHandler = __dependency15__["default"]; | |
var generateController = __dependency16__.generateController; | |
/** | |
@module ember | |
@submodule ember-routing | |
*/ | |
var a_forEach = EnumerableUtils.forEach; | |
var a_replace = EnumerableUtils.replace; | |
/** | |
The `Ember.Route` class is used to define individual routes. Refer to | |
the [routing guide](http://emberjs.com/guides/routing/) for documentation. | |
@class Route | |
@namespace Ember | |
@extends Ember.Object | |
@uses Ember.ActionHandler | |
*/ | |
var Route = EmberObject.extend(ActionHandler, { | |
/** | |
@private | |
@method exit | |
*/ | |
exit: function() { | |
if (Ember.FEATURES.isEnabled("query-params-new")) { | |
toggleQueryParamObservers(this, this.controller, false); | |
} | |
this.deactivate(); | |
this.teardownViews(); | |
}, | |
/** | |
@private | |
@method enter | |
*/ | |
enter: function() { | |
this.activate(); | |
}, | |
/** | |
The name of the view to use by default when rendering this routes template. | |
When rendering a template, the route will, by default, determine the | |
template and view to use from the name of the route itself. If you need to | |
define a specific view, set this property. | |
This is useful when multiple routes would benefit from using the same view | |
because it doesn't require a custom `renderTemplate` method. For example, | |
the following routes will all render using the `App.PostsListView` view: | |
```js | |
var PostsList = Ember.Route.extend({ | |
viewName: 'postsList', | |
}); | |
App.PostsIndexRoute = PostsList.extend(); | |
App.PostsArchivedRoute = PostsList.extend(); | |
``` | |
@property viewName | |
@type String | |
@default null | |
@since 1.4.0 | |
*/ | |
viewName: null, | |
/** | |
The name of the template to use by default when rendering this routes | |
template. | |
This is similar with `viewName`, but is useful when you just want a custom | |
template without a view. | |
```js | |
var PostsList = Ember.Route.extend({ | |
templateName: 'posts/list' | |
}); | |
App.PostsIndexRoute = PostsList.extend(); | |
App.PostsArchivedRoute = PostsList.extend(); | |
``` | |
@property templateName | |
@type String | |
@default null | |
@since 1.4.0 | |
*/ | |
templateName: null, | |
/** | |
The name of the controller to associate with this route. | |
By default, Ember will lookup a route's controller that matches the name | |
of the route (i.e. `App.PostController` for `App.PostRoute`). However, | |
if you would like to define a specific controller to use, you can do so | |
using this property. | |
This is useful in many ways, as the controller specified will be: | |
* passed to the `setupController` method. | |
* used as the controller for the view being rendered by the route. | |
* returned from a call to `controllerFor` for the route. | |
@property controllerName | |
@type String | |
@default null | |
@since 1.4.0 | |
*/ | |
controllerName: null, | |
/** | |
The `willTransition` action is fired at the beginning of any | |
attempted transition with a `Transition` object as the sole | |
argument. This action can be used for aborting, redirecting, | |
or decorating the transition from the currently active routes. | |
A good example is preventing navigation when a form is | |
half-filled out: | |
```js | |
App.ContactFormRoute = Ember.Route.extend({ | |
actions: { | |
willTransition: function(transition) { | |
if (this.controller.get('userHasEnteredData')) { | |
this.controller.displayNavigationConfirm(); | |
transition.abort(); | |
} | |
} | |
} | |
}); | |
``` | |
You can also redirect elsewhere by calling | |
`this.transitionTo('elsewhere')` from within `willTransition`. | |
Note that `willTransition` will not be fired for the | |
redirecting `transitionTo`, since `willTransition` doesn't | |
fire when there is already a transition underway. If you want | |
subsequent `willTransition` actions to fire for the redirecting | |
transition, you must first explicitly call | |
`transition.abort()`. | |
@event willTransition | |
@param {Transition} transition | |
*/ | |
/** | |
The `didTransition` action is fired after a transition has | |
successfully been completed. This occurs after the normal model | |
hooks (`beforeModel`, `model`, `afterModel`, `setupController`) | |
have resolved. The `didTransition` action has no arguments, | |
however, it can be useful for tracking page views or resetting | |
state on the controller. | |
```js | |
App.LoginRoute = Ember.Route.extend({ | |
actions: { | |
didTransition: function() { | |
this.controller.get('errors.base').clear(); | |
return true; // Bubble the didTransition event | |
} | |
} | |
}); | |
``` | |
@event didTransition | |
@since 1.2.0 | |
*/ | |
/** | |
The `loading` action is fired on the route when a route's `model` | |
hook returns a promise that is not already resolved. The current | |
`Transition` object is the first parameter and the route that | |
triggered the loading event is the second parameter. | |
```js | |
App.ApplicationRoute = Ember.Route.extend({ | |
actions: { | |
loading: function(transition, route) { | |
var view = Ember.View.create({ | |
classNames: ['app-loading'] | |
}) | |
.append(); | |
this.router.one('didTransition', function () { | |
view.destroy(); | |
}); | |
return true; // Bubble the loading event | |
} | |
} | |
}); | |
``` | |
@event loading | |
@param {Transition} transition | |
@param {Ember.Route} route The route that triggered the loading event | |
@since 1.2.0 | |
*/ | |
/** | |
When attempting to transition into a route, any of the hooks | |
may return a promise that rejects, at which point an `error` | |
action will be fired on the partially-entered routes, allowing | |
for per-route error handling logic, or shared error handling | |
logic defined on a parent route. | |
Here is an example of an error handler that will be invoked | |
for rejected promises from the various hooks on the route, | |
as well as any unhandled errors from child routes: | |
```js | |
App.AdminRoute = Ember.Route.extend({ | |
beforeModel: function() { | |
return Ember.RSVP.reject("bad things!"); | |
}, | |
actions: { | |
error: function(error, transition) { | |
// Assuming we got here due to the error in `beforeModel`, | |
// we can expect that error === "bad things!", | |
// but a promise model rejecting would also | |
// call this hook, as would any errors encountered | |
// in `afterModel`. | |
// The `error` hook is also provided the failed | |
// `transition`, which can be stored and later | |
// `.retry()`d if desired. | |
this.transitionTo('login'); | |
} | |
} | |
}); | |
``` | |
`error` actions that bubble up all the way to `ApplicationRoute` | |
will fire a default error handler that logs the error. You can | |
specify your own global default error handler by overriding the | |
`error` handler on `ApplicationRoute`: | |
```js | |
App.ApplicationRoute = Ember.Route.extend({ | |
actions: { | |
error: function(error, transition) { | |
this.controllerFor('banner').displayError(error.message); | |
} | |
} | |
}); | |
``` | |
@event error | |
@param {Error} error | |
@param {Transition} transition | |
*/ | |
/** | |
The controller associated with this route. | |
Example | |
```javascript | |
App.FormRoute = Ember.Route.extend({ | |
actions: { | |
willTransition: function(transition) { | |
if (this.controller.get('userHasEnteredData') && | |
!confirm("Are you sure you want to abandon progress?")) { | |
transition.abort(); | |
} else { | |
// Bubble the `willTransition` action so that | |
// parent routes can decide whether or not to abort. | |
return true; | |
} | |
} | |
} | |
}); | |
``` | |
@property controller | |
@type Ember.Controller | |
@since 1.6.0 | |
*/ | |
_actions: { | |
queryParamsDidChange: function(changed, totalPresent, removed) { | |
if (Ember.FEATURES.isEnabled("query-params-new")) { | |
var totalChanged = keys(changed).concat(keys(removed)); | |
for (var i = 0, len = totalChanged.length; i < len; ++i) { | |
var urlKey = totalChanged[i], | |
options = get(this.queryParams, urlKey) || {}; | |
if (get(options, 'refreshModel')) { | |
this.refresh(); | |
} | |
} | |
return true; | |
} | |
}, | |
finalizeQueryParamChange: function(params, finalParams, transition) { | |
if (Ember.FEATURES.isEnabled("query-params-new")) { | |
// In this hook we receive all the current values of | |
// serialized query params. We need to take these values | |
// and distribute them in their deserialized form into | |
// controllers and remove any that no longer belong in | |
// this route hierarchy. | |
var controller = this.controller, | |
changes = controller._queryParamChangesDuringSuspension, | |
qpMeta = get(this, '_qp'); | |
// Loop through all the query params that | |
// this controller knows about. | |
if (qpMeta) { | |
for (var i = 0, len = qpMeta.qps.length; i < len; ++i) { | |
var qp = qpMeta.qps[i], | |
qpProvided = qp.urlKey in params; | |
// Do a reverse lookup to see if the changed query | |
// param URL key corresponds to a QP property on | |
// this controller. | |
var value, svalue; | |
if (changes && qp.urlKey in changes) { | |
// Controller overrode this value in setupController | |
value = get(controller, qp.prop); | |
svalue = this.serializeQueryParam(value, qp.urlKey, qp.type); | |
} else { | |
if (qpProvided) { | |
svalue = params[qp.urlKey]; | |
value = this.deserializeQueryParam(svalue, qp.urlKey, qp.type); | |
} else { | |
// No QP provided; use default value. | |
svalue = qp.sdef; | |
value = qp.def; | |
} | |
} | |
// Delete from params so that parent routes | |
// don't also try to respond to changes to | |
// non-fully-qualified query param name changes | |
// (e.g. if two controllers in the same hiearchy | |
// specify a `page` query param) | |
delete params[qp.urlKey]; | |
// Now check if this value actually changed. | |
if (svalue !== qp.svalue) { | |
var options = get(this.queryParams, qp.urlKey) || {}; | |
// Only use replace if transition wouldn't otherwise change the url | |
if (!transition.targetName && get(options, 'replace')) { | |
transition.method('replace'); | |
} | |
// Update QP cache | |
qp.svalue = svalue; | |
qp.value = value; | |
// Update controller without firing QP observers. | |
controller._finalizingQueryParams = true; | |
set(controller, qp.prop, qp.value); | |
controller._finalizingQueryParams = false; | |
} | |
finalParams.push({ | |
value: qp.svalue, | |
visible: qp.svalue !== qp.sdef, | |
key: qp.urlKey | |
}); | |
} | |
controller._queryParamChangesDuringSuspension = null; | |
} | |
// Bubble so that parent routes can claim QPs. | |
return true; | |
} | |
} | |
}, | |
/** | |
@deprecated | |
Please use `actions` instead. | |
@method events | |
*/ | |
events: null, | |
mergedProperties: ['events'], | |
/** | |
This hook is executed when the router completely exits this route. It is | |
not executed when the model for the route changes. | |
@method deactivate | |
*/ | |
deactivate: Ember.K, | |
/** | |
This hook is executed when the router enters the route. It is not executed | |
when the model for the route changes. | |
@method activate | |
*/ | |
activate: Ember.K, | |
/** | |
Transition the application into another route. The route may | |
be either a single route or route path: | |
```javascript | |
this.transitionTo('blogPosts'); | |
this.transitionTo('blogPosts.recentEntries'); | |
``` | |
Optionally supply a model for the route in question. The model | |
will be serialized into the URL using the `serialize` hook of | |
the route: | |
```javascript | |
this.transitionTo('blogPost', aPost); | |
``` | |
If a literal is passed (such as a number or a string), it will | |
be treated as an identifier instead. In this case, the `model` | |
hook of the route will be triggered: | |
```javascript | |
this.transitionTo('blogPost', 1); | |
``` | |
Multiple models will be applied last to first recursively up the | |
resource tree. | |
```javascript | |
App.Router.map(function() { | |
this.resource('blogPost', {path:':blogPostId'}, function(){ | |
this.resource('blogComment', {path: ':blogCommentId'}); | |
}); | |
}); | |
this.transitionTo('blogComment', aPost, aComment); | |
this.transitionTo('blogComment', 1, 13); | |
``` | |
It is also possible to pass a URL (a string that starts with a | |
`/`). This is intended for testing and debugging purposes and | |
should rarely be used in production code. | |
```javascript | |
this.transitionTo('/'); | |
this.transitionTo('/blog/post/1/comment/13'); | |
``` | |
See also 'replaceWith'. | |
Simple Transition Example | |
```javascript | |
App.Router.map(function() { | |
this.route("index"); | |
this.route("secret"); | |
this.route("fourOhFour", { path: "*:"}); | |
}); | |
App.IndexRoute = Ember.Route.extend({ | |
actions: { | |
moveToSecret: function(context){ | |
if (authorized()){ | |
this.transitionTo('secret', context); | |
} | |
this.transitionTo('fourOhFour'); | |
} | |
} | |
}); | |
``` | |
Transition to a nested route | |
```javascript | |
App.Router.map(function() { | |
this.resource('articles', { path: '/articles' }, function() { | |
this.route('new'); | |
}); | |
}); | |
App.IndexRoute = Ember.Route.extend({ | |
actions: { | |
transitionToNewArticle: function() { | |
this.transitionTo('articles.new'); | |
} | |
} | |
}); | |
``` | |
Multiple Models Example | |
```javascript | |
App.Router.map(function() { | |
this.route("index"); | |
this.resource('breakfast', {path:':breakfastId'}, function(){ | |
this.resource('cereal', {path: ':cerealId'}); | |
}); | |
}); | |
App.IndexRoute = Ember.Route.extend({ | |
actions: { | |
moveToChocolateCereal: function(){ | |
var cereal = { cerealId: "ChocolateYumminess"}, | |
breakfast = {breakfastId: "CerealAndMilk"}; | |
this.transitionTo('cereal', breakfast, cereal); | |
} | |
} | |
}); | |
``` | |
@method transitionTo | |
@param {String} name the name of the route or a URL | |
@param {...Object} models the model(s) or identifier(s) to be used while | |
transitioning to the route. | |
@return {Transition} the transition object associated with this | |
attempted transition | |
*/ | |
transitionTo: function(name, context) { | |
var router = this.router; | |
return router.transitionTo.apply(router, arguments); | |
}, | |
/** | |
Perform a synchronous transition into another route without attempting | |
to resolve promises, update the URL, or abort any currently active | |
asynchronous transitions (i.e. regular transitions caused by | |
`transitionTo` or URL changes). | |
This method is handy for performing intermediate transitions on the | |
way to a final destination route, and is called internally by the | |
default implementations of the `error` and `loading` handlers. | |
@method intermediateTransitionTo | |
@param {String} name the name of the route | |
@param {...Object} models the model(s) to be used while transitioning | |
to the route. | |
@since 1.2.0 | |
*/ | |
intermediateTransitionTo: function() { | |
var router = this.router; | |
router.intermediateTransitionTo.apply(router, arguments); | |
}, | |
/** | |
Refresh the model on this route and any child routes, firing the | |
`beforeModel`, `model`, and `afterModel` hooks in a similar fashion | |
to how routes are entered when transitioning in from other route. | |
The current route params (e.g. `article_id`) will be passed in | |
to the respective model hooks, and if a different model is returned, | |
`setupController` and associated route hooks will re-fire as well. | |
An example usage of this method is re-querying the server for the | |
latest information using the same parameters as when the route | |
was first entered. | |
Note that this will cause `model` hooks to fire even on routes | |
that were provided a model object when the route was initially | |
entered. | |
@method refresh | |
@return {Transition} the transition object associated with this | |
attempted transition | |
@since 1.4.0 | |
*/ | |
refresh: function() { | |
return this.router.router.refresh(this); | |
}, | |
/** | |
Transition into another route while replacing the current URL, if possible. | |
This will replace the current history entry instead of adding a new one. | |
Beside that, it is identical to `transitionTo` in all other respects. See | |
'transitionTo' for additional information regarding multiple models. | |
Example | |
```javascript | |
App.Router.map(function() { | |
this.route("index"); | |
this.route("secret"); | |
}); | |
App.SecretRoute = Ember.Route.extend({ | |
afterModel: function() { | |
if (!authorized()){ | |
this.replaceWith('index'); | |
} | |
} | |
}); | |
``` | |
@method replaceWith | |
@param {String} name the name of the route or a URL | |
@param {...Object} models the model(s) or identifier(s) to be used while | |
transitioning to the route. | |
@return {Transition} the transition object associated with this | |
attempted transition | |
*/ | |
replaceWith: function() { | |
var router = this.router; | |
return router.replaceWith.apply(router, arguments); | |
}, | |
/** | |
Sends an action to the router, which will delegate it to the currently | |
active route hierarchy per the bubbling rules explained under `actions`. | |
Example | |
```javascript | |
App.Router.map(function() { | |
this.route("index"); | |
}); | |
App.ApplicationRoute = Ember.Route.extend({ | |
actions: { | |
track: function(arg) { | |
console.log(arg, 'was clicked'); | |
} | |
} | |
}); | |
App.IndexRoute = Ember.Route.extend({ | |
actions: { | |
trackIfDebug: function(arg) { | |
if (debug) { | |
this.send('track', arg); | |
} | |
} | |
} | |
}); | |
``` | |
@method send | |
@param {String} name the name of the action to trigger | |
@param {...*} args | |
*/ | |
send: function() { | |
return this.router.send.apply(this.router, arguments); | |
}, | |
/** | |
This hook is the entry point for router.js | |
@private | |
@method setup | |
*/ | |
setup: function(context, transition) { | |
var controllerName = this.controllerName || this.routeName, | |
controller = this.controllerFor(controllerName, true); | |
if (!controller) { | |
controller = this.generateController(controllerName, context); | |
} | |
// Assign the route's controller so that it can more easily be | |
// referenced in action handlers | |
this.controller = controller; | |
if (Ember.FEATURES.isEnabled("query-params-new")) { | |
toggleQueryParamObservers(this, controller, true); | |
} | |
if (this.setupControllers) { | |
Ember.deprecate("Ember.Route.setupControllers is deprecated. Please use Ember.Route.setupController(controller, model) instead."); | |
this.setupControllers(controller, context); | |
} else { | |
if (Ember.FEATURES.isEnabled("query-params-new")) { | |
// Prevent updates to query params in setupController | |
// from firing another transition. Updating QPs in | |
// setupController will only affect the final | |
// generated URL. | |
controller._finalizingQueryParams = true; | |
controller._queryParamChangesDuringSuspension = {}; | |
this.setupController(controller, context, transition); | |
controller._finalizingQueryParams = false; | |
} else { | |
this.setupController(controller, context); | |
} | |
} | |
if (this.renderTemplates) { | |
Ember.deprecate("Ember.Route.renderTemplates is deprecated. Please use Ember.Route.renderTemplate(controller, model) instead."); | |
this.renderTemplates(context); | |
} else { | |
this.renderTemplate(controller, context); | |
} | |
}, | |
/** | |
This hook is the first of the route entry validation hooks | |
called when an attempt is made to transition into a route | |
or one of its children. It is called before `model` and | |
`afterModel`, and is appropriate for cases when: | |
1) A decision can be made to redirect elsewhere without | |
needing to resolve the model first. | |
2) Any async operations need to occur first before the | |
model is attempted to be resolved. | |
This hook is provided the current `transition` attempt | |
as a parameter, which can be used to `.abort()` the transition, | |
save it for a later `.retry()`, or retrieve values set | |
on it from a previous hook. You can also just call | |
`this.transitionTo` to another route to implicitly | |
abort the `transition`. | |
You can return a promise from this hook to pause the | |
transition until the promise resolves (or rejects). This could | |
be useful, for instance, for retrieving async code from | |
the server that is required to enter a route. | |
```js | |
App.PostRoute = Ember.Route.extend({ | |
beforeModel: function(transition) { | |
if (!App.Post) { | |
return Ember.$.getScript('/models/post.js'); | |
} | |
} | |
}); | |
``` | |
If `App.Post` doesn't exist in the above example, | |
`beforeModel` will use jQuery's `getScript`, which | |
returns a promise that resolves after the server has | |
successfully retrieved and executed the code from the | |
server. Note that if an error were to occur, it would | |
be passed to the `error` hook on `Ember.Route`, but | |
it's also possible to handle errors specific to | |
`beforeModel` right from within the hook (to distinguish | |
from the shared error handling behavior of the `error` | |
hook): | |
```js | |
App.PostRoute = Ember.Route.extend({ | |
beforeModel: function(transition) { | |
if (!App.Post) { | |
var self = this; | |
return Ember.$.getScript('post.js').then(null, function(e) { | |
self.transitionTo('help'); | |
// Note that the above transitionTo will implicitly | |
// halt the transition. If you were to return | |
// nothing from this promise reject handler, | |
// according to promise semantics, that would | |
// convert the reject into a resolve and the | |
// transition would continue. To propagate the | |
// error so that it'd be handled by the `error` | |
// hook, you would have to either | |
return Ember.RSVP.reject(e); | |
}); | |
} | |
} | |
}); | |
``` | |
@method beforeModel | |
@param {Transition} transition | |
@param {Object} queryParams the active query params for this route | |
@return {Promise} if the value returned from this hook is | |
a promise, the transition will pause until the transition | |
resolves. Otherwise, non-promise return values are not | |
utilized in any way. | |
*/ | |
beforeModel: Ember.K, | |
/** | |
This hook is called after this route's model has resolved. | |
It follows identical async/promise semantics to `beforeModel` | |
but is provided the route's resolved model in addition to | |
the `transition`, and is therefore suited to performing | |
logic that can only take place after the model has already | |
resolved. | |
```js | |
App.PostsRoute = Ember.Route.extend({ | |
afterModel: function(posts, transition) { | |
if (posts.get('length') === 1) { | |
this.transitionTo('post.show', posts.get('firstObject')); | |
} | |
} | |
}); | |
``` | |
Refer to documentation for `beforeModel` for a description | |
of transition-pausing semantics when a promise is returned | |
from this hook. | |
@method afterModel | |
@param {Object} resolvedModel the value returned from `model`, | |
or its resolved value if it was a promise | |
@param {Transition} transition | |
@param {Object} queryParams the active query params for this handler | |
@return {Promise} if the value returned from this hook is | |
a promise, the transition will pause until the transition | |
resolves. Otherwise, non-promise return values are not | |
utilized in any way. | |
*/ | |
afterModel: Ember.K, | |
/** | |
A hook you can implement to optionally redirect to another route. | |
If you call `this.transitionTo` from inside of this hook, this route | |
will not be entered in favor of the other hook. | |
`redirect` and `afterModel` behave very similarly and are | |
called almost at the same time, but they have an important | |
distinction in the case that, from one of these hooks, a | |
redirect into a child route of this route occurs: redirects | |
from `afterModel` essentially invalidate the current attempt | |
to enter this route, and will result in this route's `beforeModel`, | |
`model`, and `afterModel` hooks being fired again within | |
the new, redirecting transition. Redirects that occur within | |
the `redirect` hook, on the other hand, will _not_ cause | |
these hooks to be fired again the second time around; in | |
other words, by the time the `redirect` hook has been called, | |
both the resolved model and attempted entry into this route | |
are considered to be fully validated. | |
@method redirect | |
@param {Object} model the model for this route | |
*/ | |
redirect: Ember.K, | |
/** | |
Called when the context is changed by router.js. | |
@private | |
@method contextDidChange | |
*/ | |
contextDidChange: function() { | |
this.currentModel = this.context; | |
}, | |
/** | |
A hook you can implement to convert the URL into the model for | |
this route. | |
```js | |
App.Router.map(function() { | |
this.resource('post', {path: '/posts/:post_id'}); | |
}); | |
``` | |
The model for the `post` route is `App.Post.find(params.post_id)`. | |
By default, if your route has a dynamic segment ending in `_id`: | |
* The model class is determined from the segment (`post_id`'s | |
class is `App.Post`) | |
* The find method is called on the model class with the value of | |
the dynamic segment. | |
Note that for routes with dynamic segments, this hook is only | |
executed when entered via the URL. If the route is entered | |
through a transition (e.g. when using the `link-to` Handlebars | |
helper), then a model context is already provided and this hook | |
is not called. Routes without dynamic segments will always | |
execute the model hook. | |
This hook follows the asynchronous/promise semantics | |
described in the documentation for `beforeModel`. In particular, | |
if a promise returned from `model` fails, the error will be | |
handled by the `error` hook on `Ember.Route`. | |
Example | |
```js | |
App.PostRoute = Ember.Route.extend({ | |
model: function(params) { | |
return App.Post.find(params.post_id); | |
} | |
}); | |
``` | |
@method model | |
@param {Object} params the parameters extracted from the URL | |
@param {Transition} transition | |
@param {Object} queryParams the query params for this route | |
@return {Object|Promise} the model for this route. If | |
a promise is returned, the transition will pause until | |
the promise resolves, and the resolved value of the promise | |
will be used as the model for this route. | |
*/ | |
model: function(params, transition) { | |
var match, name, sawParams, value; | |
var queryParams; | |
if (Ember.FEATURES.isEnabled("query-params-new")) { | |
queryParams = get(this, '_qp.map'); | |
} | |
for (var prop in params) { | |
if (prop === 'queryParams' || (queryParams && prop in queryParams)) { | |
continue; | |
} | |
if (match = prop.match(/^(.*)_id$/)) { | |
name = match[1]; | |
value = params[prop]; | |
} | |
sawParams = true; | |
} | |
if (!name && sawParams) { return copy(params); } | |
else if (!name) { | |
if (transition.resolveIndex !== transition.state.handlerInfos.length-1) { return; } | |
var parentModel = transition.state.handlerInfos[transition.resolveIndex-1].context; | |
return parentModel; | |
} | |
return this.findModel(name, value); | |
}, | |
/** | |
@private | |
@method deserialize | |
@param {Object} params the parameters extracted from the URL | |
@param {Transition} transition | |
@return {Object|Promise} the model for this route. | |
Router.js hook. | |
*/ | |
deserialize: function(params, transition) { | |
if (Ember.FEATURES.isEnabled("query-params-new")) { | |
return this.model(this.paramsFor(this.routeName), transition); | |
} else { | |
return this.model(params, transition); | |
} | |
}, | |
/** | |
@method findModel | |
@param {String} type the model type | |
@param {Object} value the value passed to find | |
*/ | |
findModel: function(){ | |
var store = get(this, 'store'); | |
return store.find.apply(store, arguments); | |
}, | |
/** | |
Store property provides a hook for data persistence libraries to inject themselves. | |
By default, this store property provides the exact same functionality previously | |
in the model hook. | |
Currently, the required interface is: | |
`store.find(modelName, findArguments)` | |
@method store | |
@param {Object} store | |
*/ | |
store: computed(function(){ | |
var container = this.container; | |
var routeName = this.routeName; | |
var namespace = get(this, 'router.namespace'); | |
return { | |
find: function(name, value) { | |
var modelClass = container.lookupFactory('model:' + name); | |
Ember.assert("You used the dynamic segment " + name + "_id in your route " + | |
routeName + ", but " + namespace + "." + classify(name) + | |
" did not exist and you did not override your route's `model` " + | |
"hook.", modelClass); | |
if (!modelClass) { return; } | |
Ember.assert(classify(name) + ' has no method `find`.', typeof modelClass.find === 'function'); | |
return modelClass.find(value); | |
} | |
}; | |
}), | |
/** | |
A hook you can implement to convert the route's model into parameters | |
for the URL. | |
```js | |
App.Router.map(function() { | |
this.resource('post', {path: '/posts/:post_id'}); | |
}); | |
App.PostRoute = Ember.Route.extend({ | |
model: function(params) { | |
// the server returns `{ id: 12 }` | |
return jQuery.getJSON("/posts/" + params.post_id); | |
}, | |
serialize: function(model) { | |
// this will make the URL `/posts/12` | |
return { post_id: model.id }; | |
} | |
}); | |
``` | |
The default `serialize` method will insert the model's `id` into the | |
route's dynamic segment (in this case, `:post_id`) if the segment contains '_id'. | |
If the route has multiple dynamic segments or does not contain '_id', `serialize` | |
will return `Ember.getProperties(model, params)` | |
This method is called when `transitionTo` is called with a context | |
in order to populate the URL. | |
@method serialize | |
@param {Object} model the route's model | |
@param {Array} params an Array of parameter names for the current | |
route (in the example, `['post_id']`. | |
@return {Object} the serialized parameters | |
*/ | |
serialize: function(model, params) { | |
if (params.length < 1) { return; } | |
if (!model) { return; } | |
var name = params[0], object = {}; | |
if (/_id$/.test(name) && params.length === 1) { | |
object[name] = get(model, "id"); | |
} else { | |
object = getProperties(model, params); | |
} | |
return object; | |
}, | |
/** | |
A hook you can use to setup the controller for the current route. | |
This method is called with the controller for the current route and the | |
model supplied by the `model` hook. | |
By default, the `setupController` hook sets the `model` property of | |
the controller to the `model`. | |
If you implement the `setupController` hook in your Route, it will | |
prevent this default behavior. If you want to preserve that behavior | |
when implementing your `setupController` function, make sure to call | |
`_super`: | |
```js | |
App.PhotosRoute = Ember.Route.extend({ | |
model: function() { | |
return App.Photo.find(); | |
}, | |
setupController: function (controller, model) { | |
// Call _super for default behavior | |
this._super(controller, model); | |
// Implement your custom setup after | |
this.controllerFor('application').set('showingPhotos', true); | |
} | |
}); | |
``` | |
This means that your template will get a proxy for the model as its | |
context, and you can act as though the model itself was the context. | |
The provided controller will be one resolved based on the name | |
of this route. | |
If no explicit controller is defined, Ember will automatically create | |
an appropriate controller for the model. | |
* if the model is an `Ember.Array` (including record arrays from Ember | |
Data), the controller is an `Ember.ArrayController`. | |
* otherwise, the controller is an `Ember.ObjectController`. | |
As an example, consider the router: | |
```js | |
App.Router.map(function() { | |
this.resource('post', {path: '/posts/:post_id'}); | |
}); | |
``` | |
For the `post` route, a controller named `App.PostController` would | |
be used if it is defined. If it is not defined, an `Ember.ObjectController` | |
instance would be used. | |
Example | |
```js | |
App.PostRoute = Ember.Route.extend({ | |
setupController: function(controller, model) { | |
controller.set('model', model); | |
} | |
}); | |
``` | |
@method setupController | |
@param {Controller} controller instance | |
@param {Object} model | |
*/ | |
setupController: function(controller, context, transition) { | |
if (controller && (context !== undefined)) { | |
set(controller, 'model', context); | |
} | |
}, | |
/** | |
Returns the controller for a particular route or name. | |
The controller instance must already have been created, either through entering the | |
associated route or using `generateController`. | |
```js | |
App.PostRoute = Ember.Route.extend({ | |
setupController: function(controller, post) { | |
this._super(controller, post); | |
this.controllerFor('posts').set('currentPost', post); | |
} | |
}); | |
``` | |
@method controllerFor | |
@param {String} name the name of the route or controller | |
@return {Ember.Controller} | |
*/ | |
controllerFor: function(name, _skipAssert) { | |
var container = this.container, | |
route = container.lookup('route:'+name), | |
controller; | |
if (route && route.controllerName) { | |
name = route.controllerName; | |
} | |
controller = container.lookup('controller:' + name); | |
// NOTE: We're specifically checking that skipAssert is true, because according | |
// to the old API the second parameter was model. We do not want people who | |
// passed a model to skip the assertion. | |
Ember.assert("The controller named '"+name+"' could not be found. Make sure " + | |
"that this route exists and has already been entered at least " + | |
"once. If you are accessing a controller not associated with a " + | |
"route, make sure the controller class is explicitly defined.", | |
controller || _skipAssert === true); | |
return controller; | |
}, | |
/** | |
Generates a controller for a route. | |
If the optional model is passed then the controller type is determined automatically, | |
e.g., an ArrayController for arrays. | |
Example | |
```js | |
App.PostRoute = Ember.Route.extend({ | |
setupController: function(controller, post) { | |
this._super(controller, post); | |
this.generateController('posts', post); | |
} | |
}); | |
``` | |
@method generateController | |
@param {String} name the name of the controller | |
@param {Object} model the model to infer the type of the controller (optional) | |
*/ | |
generateController: function(name, model) { | |
var container = this.container; | |
model = model || this.modelFor(name); | |
return generateController(container, name, model); | |
}, | |
/** | |
Returns the model of a parent (or any ancestor) route | |
in a route hierarchy. During a transition, all routes | |
must resolve a model object, and if a route | |
needs access to a parent route's model in order to | |
resolve a model (or just reuse the model from a parent), | |
it can call `this.modelFor(theNameOfParentRoute)` to | |
retrieve it. | |
Example | |
```js | |
App.Router.map(function() { | |
this.resource('post', { path: '/post/:post_id' }, function() { | |
this.resource('comments'); | |
}); | |
}); | |
App.CommentsRoute = Ember.Route.extend({ | |
afterModel: function() { | |
this.set('post', this.modelFor('post')); | |
} | |
}); | |
``` | |
@method modelFor | |
@param {String} name the name of the route | |
@return {Object} the model object | |
*/ | |
modelFor: function(name) { | |
var route = this.container.lookup('route:' + name), | |
transition = this.router.router.activeTransition; | |
// If we are mid-transition, we want to try and look up | |
// resolved parent contexts on the current transitionEvent. | |
if (transition) { | |
var modelLookupName = (route && route.routeName) || name; | |
if (transition.resolvedModels.hasOwnProperty(modelLookupName)) { | |
return transition.resolvedModels[modelLookupName]; | |
} | |
} | |
return route && route.currentModel; | |
}, | |
/** | |
A hook you can use to render the template for the current route. | |
This method is called with the controller for the current route and the | |
model supplied by the `model` hook. By default, it renders the route's | |
template, configured with the controller for the route. | |
This method can be overridden to set up and render additional or | |
alternative templates. | |
```js | |
App.PostsRoute = Ember.Route.extend({ | |
renderTemplate: function(controller, model) { | |
var favController = this.controllerFor('favoritePost'); | |
// Render the `favoritePost` template into | |
// the outlet `posts`, and display the `favoritePost` | |
// controller. | |
this.render('favoritePost', { | |
outlet: 'posts', | |
controller: favController | |
}); | |
} | |
}); | |
``` | |
@method renderTemplate | |
@param {Object} controller the route's controller | |
@param {Object} model the route's model | |
*/ | |
renderTemplate: function(controller, model) { | |
this.render(); | |
}, | |
/** | |
Renders a template into an outlet. | |
This method has a number of defaults, based on the name of the | |
route specified in the router. | |
For example: | |
```js | |
App.Router.map(function() { | |
this.route('index'); | |
this.resource('post', {path: '/posts/:post_id'}); | |
}); | |
App.PostRoute = App.Route.extend({ | |
renderTemplate: function() { | |
this.render(); | |
} | |
}); | |
``` | |
The name of the `PostRoute`, as defined by the router, is `post`. | |
By default, render will: | |
* render the `post` template | |
* with the `post` view (`PostView`) for event handling, if one exists | |
* and the `post` controller (`PostController`), if one exists | |
* into the `main` outlet of the `application` template | |
You can override this behavior: | |
```js | |
App.PostRoute = App.Route.extend({ | |
renderTemplate: function() { | |
this.render('myPost', { // the template to render | |
into: 'index', // the template to render into | |
outlet: 'detail', // the name of the outlet in that template | |
controller: 'blogPost' // the controller to use for the template | |
}); | |
} | |
}); | |
``` | |
Remember that the controller's `model` will be the route's model. In | |
this case, the default model will be `App.Post.find(params.post_id)`. | |
@method render | |
@param {String} name the name of the template to render | |
@param {Object} options the options | |
*/ | |
render: function(name, options) { | |
Ember.assert("The name in the given arguments is undefined", arguments.length > 0 ? !isNone(arguments[0]) : true); | |
var namePassed = typeof name === 'string' && !!name; | |
if (typeof name === 'object' && !options) { | |
options = name; | |
name = this.routeName; | |
} | |
options = options || {}; | |
var templateName; | |
if (name) { | |
name = name.replace(/\//g, '.'); | |
templateName = name; | |
} else { | |
name = this.routeName; | |
templateName = this.templateName || name; | |
} | |
var viewName = options.view || namePassed && name || this.viewName || name; | |
var container = this.container, | |
view = container.lookup('view:' + viewName), | |
template = view ? view.get('template') : null; | |
if (!template) { | |
template = container.lookup('template:' + templateName); | |
} | |
if (!view && !template) { | |
Ember.assert("Could not find \"" + name + "\" template or view.", Ember.isEmpty(arguments[0])); | |
if (get(this.router, 'namespace.LOG_VIEW_LOOKUPS')) { | |
Ember.Logger.info("Could not find \"" + name + "\" template or view. Nothing will be rendered", { fullName: 'template:' + name }); | |
} | |
return; | |
} | |
options = normalizeOptions(this, name, template, options); | |
view = setupView(view, container, options); | |
if (options.outlet === 'main') { this.lastRenderedTemplate = name; } | |
appendView(this, view, options); | |
}, | |
/** | |
Disconnects a view that has been rendered into an outlet. | |
You may pass any or all of the following options to `disconnectOutlet`: | |
* `outlet`: the name of the outlet to clear (default: 'main') | |
* `parentView`: the name of the view containing the outlet to clear | |
(default: the view rendered by the parent route) | |
Example: | |
```js | |
App.ApplicationRoute = App.Route.extend({ | |
actions: { | |
showModal: function(evt) { | |
this.render(evt.modalName, { | |
outlet: 'modal', | |
into: 'application' | |
}); | |
}, | |
hideModal: function(evt) { | |
this.disconnectOutlet({ | |
outlet: 'modal', | |
parentView: 'application' | |
}); | |
} | |
} | |
}); | |
``` | |
Alternatively, you can pass the `outlet` name directly as a string. | |
Example: | |
```js | |
hideModal: function(evt) { | |
this.disconnectOutlet('modal'); | |
} | |
``` | |
@method disconnectOutlet | |
@param {Object|String} options the options hash or outlet name | |
*/ | |
disconnectOutlet: function(options) { | |
if (!options || typeof options === "string") { | |
var outletName = options; | |
options = {}; | |
options.outlet = outletName; | |
} | |
options.parentView = options.parentView ? options.parentView.replace(/\//g, '.') : parentTemplate(this); | |
options.outlet = options.outlet || 'main'; | |
var parentView = this.router._lookupActiveView(options.parentView); | |
if (parentView) { parentView.disconnectOutlet(options.outlet); } | |
}, | |
willDestroy: function() { | |
this.teardownViews(); | |
}, | |
/** | |
@private | |
@method teardownViews | |
*/ | |
teardownViews: function() { | |
// Tear down the top level view | |
if (this.teardownTopLevelView) { this.teardownTopLevelView(); } | |
// Tear down any outlets rendered with 'into' | |
var teardownOutletViews = this.teardownOutletViews || []; | |
a_forEach(teardownOutletViews, function(teardownOutletView) { | |
teardownOutletView(); | |
}); | |
delete this.teardownTopLevelView; | |
delete this.teardownOutletViews; | |
delete this.lastRenderedTemplate; | |
} | |
}); | |
if (Ember.FEATURES.isEnabled("query-params-new")) { | |
Route.reopen({ | |
/** | |
Configuration hash for this route's queryParams. The possible | |
configuration options and their defaults are as follows | |
(assuming a query param whose URL key is `page`): | |
```js | |
queryParams: { | |
page: { | |
// By default, controller query param properties don't | |
// cause a full transition when they are changed, but | |
// rather only cause the URL to update. Setting | |
// `refreshModel` to true will cause an "in-place" | |
// transition to occur, whereby the model hooks for | |
// this route (and any child routes) will re-fire, allowing | |
// you to reload models (e.g., from the server) using the | |
// updated query param values. | |
refreshModel: false, | |
// By default, changes to controller query param properties | |
// cause the URL to update via `pushState`, which means an | |
// item will be added to the browser's history, allowing | |
// you to use the back button to restore the app to the | |
// previous state before the query param property was changed. | |
// Setting `replace` to true will use `replaceState` (or its | |
// hash location equivalent), which causes no browser history | |
// item to be added. This options name and default value are | |
// the same as the `link-to` helper's `replace` option. | |
replace: false | |
} | |
} | |
``` | |
@property queryParams | |
@for Ember.Route | |
@type Hash | |
*/ | |
queryParams: {}, | |
_qp: computed(function() { | |
var controllerName = this.controllerName || this.routeName, | |
fullName = this.container.normalize('controller:' + controllerName), | |
controllerClass = this.container.lookupFactory(fullName); | |
if (!controllerClass) { return; } | |
var controllerProto = controllerClass.proto(), | |
queryParams = get(controllerProto, 'queryParams'); | |
if (!queryParams || queryParams.length === 0) { return; } | |
var qps = [], map = {}; | |
for (var i = 0, len = queryParams.length; i < len; ++i) { | |
var queryParamMapping = queryParams[i], | |
parts = queryParamMapping.split(':'), | |
propName = parts[0], | |
urlKey = parts[1] || propName, | |
defaultValue = get(controllerProto, propName), | |
type = typeOf(defaultValue), | |
defaultValueSerialized = this.serializeQueryParam(defaultValue, urlKey, type), | |
qp = { | |
def: defaultValue, | |
sdef: defaultValueSerialized, | |
type: type, | |
urlKey: urlKey, | |
prop: propName, | |
ctrl: controllerName, | |
value: defaultValue, | |
svalue: defaultValueSerialized, | |
route: this | |
}; | |
// Construct all the different ways this query param | |
// can be referenced, either from link-to or transitionTo: | |
// - {{link-to (query-params page=5)}} | |
// - {{link-to (query-params articles:page=5)}} | |
// - {{link-to (query-params articles_page=5)}} | |
// - {{link-to (query-params articles:articles_page=5)}} | |
// - transitionTo({ queryParams: { page: 5 } }) | |
// ... etc. | |
map[propName] = map[urlKey] = map[controllerName + ':' + propName] = qp; | |
qps.push(qp); | |
} | |
return { | |
qps: qps, | |
map: map | |
}; | |
}), | |
mergedProperties: ['queryParams'], | |
paramsFor: function(name) { | |
var route = this.container.lookup('route:' + name); | |
if (!route) { | |
return {}; | |
} | |
var transition = this.router.router.activeTransition, | |
params, queryParams; | |
if (transition) { | |
params = transition.params[name] || {}; | |
queryParams = transition.queryParams; | |
} else { | |
var state = this.router.router.state; | |
params = state.params[name] || {}; | |
queryParams = state.queryParams; | |
} | |
var qpMeta = get(route, '_qp'); | |
if (!qpMeta) { | |
// No query params specified on the controller. | |
return params; | |
} | |
var qps = qpMeta.qps, map = qpMeta.map, qp; | |
// Loop through all the query params defined on the controller | |
for (var i = 0, len = qps.length; i < len; ++i) { | |
// Put deserialized qp on params hash. | |
qp = qps[i]; | |
params[qp.urlKey] = qp.value; | |
} | |
// Override params hash values with any input query params | |
// from the transition attempt. | |
for (var urlKey in queryParams) { | |
// Ignore any params not for this route. | |
if (!(urlKey in map)) { continue; } | |
var svalue = queryParams[urlKey]; | |
qp = map[urlKey]; | |
if (svalue === null) { | |
// Query param was removed from address bar. | |
svalue = qp.sdef; | |
} | |
// Deserialize and stash on params. | |
params[urlKey] = route.deserializeQueryParam(svalue, urlKey, qp.type); | |
} | |
return params; | |
}, | |
serializeQueryParam: function(value, urlKey, defaultValueType) { | |
// urlKey isn't used here, but anyone overriding | |
// can use it to provide serialization specific | |
// to a certain query param. | |
if (defaultValueType === 'array') { | |
return JSON.stringify(value); | |
} | |
return '' + value; | |
}, | |
deserializeQueryParam: function(value, urlKey, defaultValueType) { | |
// urlKey isn't used here, but anyone overriding | |
// can use it to provide deserialization specific | |
// to a certain query param. | |
// Use the defaultValueType of the default value (the initial value assigned to a | |
// controller query param property), to intelligently deserialize and cast. | |
if (defaultValueType === 'boolean') { | |
return (value === 'true') ? true : false; | |
} else if (defaultValueType === 'number') { | |
return (Number(value)).valueOf(); | |
} else if (defaultValueType === 'array') { | |
return Ember.A(JSON.parse(value)); | |
} | |
return value; | |
}, | |
_qpChanged: function(controller, propName) { | |
// Normalize array observer firings. | |
if (propName.slice(propName.length - 3) === '.[]') { | |
propName = propName.substr(0, propName.length-3); | |
} | |
var qpMeta = get(this, '_qp'), | |
qp = qpMeta.map[propName]; | |
if (controller._finalizingQueryParams) { | |
var changes = controller._queryParamChangesDuringSuspension; | |
if (changes) { | |
changes[qp.urlKey] = true; | |
} | |
return; | |
} | |
var value = copy(get(controller, propName)); | |
this.router._queuedQPChanges[qp.prop] = value; | |
run.once(this, this._fireQueryParamTransition); | |
}, | |
_fireQueryParamTransition: function() { | |
this.transitionTo({ queryParams: this.router._queuedQPChanges }); | |
this.router._queuedQPChanges = {}; | |
} | |
}); | |
} | |
function parentRoute(route) { | |
var handlerInfos = route.router.router.state.handlerInfos; | |
if (!handlerInfos) { return; } | |
var parent, current; | |
for (var i=0, l=handlerInfos.length; i<l; i++) { | |
current = handlerInfos[i].handler; | |
if (current === route) { return parent; } | |
parent = current; | |
} | |
} | |
function parentTemplate(route) { | |
var parent = parentRoute(route), template; | |
if (!parent) { return; } | |
if (template = parent.lastRenderedTemplate) { | |
return template; | |
} else { | |
return parentTemplate(parent); | |
} | |
} | |
function normalizeOptions(route, name, template, options) { | |
options = options || {}; | |
options.into = options.into ? options.into.replace(/\//g, '.') : parentTemplate(route); | |
options.outlet = options.outlet || 'main'; | |
options.name = name; | |
options.template = template; | |
options.LOG_VIEW_LOOKUPS = get(route.router, 'namespace.LOG_VIEW_LOOKUPS'); | |
Ember.assert("An outlet ("+options.outlet+") was specified but was not found.", options.outlet === 'main' || options.into); | |
var controller = options.controller, | |
model = options.model, | |
namedController; | |
if (options.controller) { | |
controller = options.controller; | |
} else if (namedController = route.container.lookup('controller:' + name)) { | |
controller = namedController; | |
} else { | |
controller = route.controllerName || route.routeName; | |
} | |
if (typeof controller === 'string') { | |
var controllerName = controller; | |
controller = route.container.lookup('controller:' + controllerName); | |
if (!controller) { | |
throw new EmberError("You passed `controller: '" + controllerName + "'` into the `render` method, but no such controller could be found."); | |
} | |
} | |
if (model) { | |
controller.set('model', model); | |
} | |
options.controller = controller; | |
return options; | |
} | |
function setupView(view, container, options) { | |
if (view) { | |
if (options.LOG_VIEW_LOOKUPS) { | |
Ember.Logger.info("Rendering " + options.name + " with " + view, { fullName: 'view:' + options.name }); | |
} | |
} else { | |
var defaultView = options.into ? 'view:default' : 'view:toplevel'; | |
view = container.lookup(defaultView); | |
if (options.LOG_VIEW_LOOKUPS) { | |
Ember.Logger.info("Rendering " + options.name + " with default view " + view, { fullName: 'view:' + options.name }); | |
} | |
} | |
if (!get(view, 'templateName')) { | |
set(view, 'template', options.template); | |
set(view, '_debugTemplateName', options.name); | |
} | |
set(view, 'renderedName', options.name); | |
set(view, 'controller', options.controller); | |
return view; | |
} | |
function appendView(route, view, options) { | |
if (options.into) { | |
var parentView = route.router._lookupActiveView(options.into); | |
var teardownOutletView = generateOutletTeardown(parentView, options.outlet); | |
if (!route.teardownOutletViews) { route.teardownOutletViews = []; } | |
a_replace(route.teardownOutletViews, 0, 0, [teardownOutletView]); | |
parentView.connectOutlet(options.outlet, view); | |
} else { | |
var rootElement = get(route, 'router.namespace.rootElement'); | |
// tear down view if one is already rendered | |
if (route.teardownTopLevelView) { | |
route.teardownTopLevelView(); | |
} | |
route.router._connectActiveView(options.name, view); | |
route.teardownTopLevelView = generateTopLevelTeardown(view); | |
view.appendTo(rootElement); | |
} | |
} | |
function generateTopLevelTeardown(view) { | |
return function() { view.destroy(); }; | |
} | |
function generateOutletTeardown(parentView, outlet) { | |
return function() { parentView.disconnectOutlet(outlet); }; | |
} | |
function toggleQueryParamObservers(route, controller, enable) { | |
var queryParams = get(controller, 'queryParams'), i, len, | |
method = enable ? 'addObserver' : 'removeObserver'; | |
for (i = 0, len = queryParams.length; i < len; ++i) { | |
var prop = queryParams[i].split(':')[0]; | |
controller[method](prop, route, route._qpChanged); | |
controller[method](prop + '.[]', route, route._qpChanged); | |
} | |
} | |
__exports__["default"] = Route; | |
}); | |
define("ember-routing/system/router", | |
["ember-metal/core","ember-metal/error","ember-metal/property_get","ember-metal/property_set","ember-metal/array","ember-metal/properties","ember-metal/computed","ember-metal/merge","ember-metal/run_loop","ember-metal/enumerable_utils","ember-runtime/system/string","ember-runtime/system/object","ember-runtime/mixins/evented","ember-routing/system/dsl","ember-views/views/view","ember-routing/location/api","ember-handlebars/views/metamorph_view","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __dependency6__, __dependency7__, __dependency8__, __dependency9__, __dependency10__, __dependency11__, __dependency12__, __dependency13__, __dependency14__, __dependency15__, __dependency16__, __dependency17__, __exports__) { | |
"use strict"; | |
var Ember = __dependency1__["default"]; | |
// FEATURES, Logger, K, assert | |
var EmberError = __dependency2__["default"]; | |
var get = __dependency3__.get; | |
var set = __dependency4__.set; | |
var forEach = __dependency5__.forEach; | |
var defineProperty = __dependency6__.defineProperty; | |
var computed = __dependency7__.computed; | |
var merge = __dependency8__["default"]; | |
var run = __dependency9__["default"]; | |
var EnumerableUtils = __dependency10__["default"]; | |
var fmt = __dependency11__.fmt; | |
var EmberObject = __dependency12__["default"]; | |
var Evented = __dependency13__["default"]; | |
var EmberRouterDSL = __dependency14__["default"]; | |
var EmberView = __dependency15__.View; | |
var EmberLocation = __dependency16__["default"]; | |
var _MetamorphView = __dependency17__._MetamorphView; | |
// requireModule("ember-handlebars"); | |
// requireModule("ember-runtime"); | |
// requireModule("ember-views"); | |
/** | |
@module ember | |
@submodule ember-routing | |
*/ | |
// // side effect of loading some Ember globals, for now | |
// requireModule("ember-handlebars"); | |
// requireModule("ember-runtime"); | |
// requireModule("ember-views"); | |
var Router = requireModule("router")['default']; | |
var Transition = requireModule("router/transition").Transition; | |
var slice = [].slice; | |
var forEach = EnumerableUtils.forEach; | |
var DefaultView = _MetamorphView; | |
/** | |
The `Ember.Router` class manages the application state and URLs. Refer to | |
the [routing guide](http://emberjs.com/guides/routing/) for documentation. | |
@class Router | |
@namespace Ember | |
@extends Ember.Object | |
*/ | |
var EmberRouter = EmberObject.extend(Evented, { | |
/** | |
The `location` property determines the type of URL's that your | |
application will use. | |
The following location types are currently available: | |
* `hash` | |
* `history` | |
* `none` | |
@property location | |
@default 'hash' | |
@see {Ember.Location} | |
*/ | |
location: 'hash', | |
/** | |
Represents the URL of the root of the application, often '/'. This prefix is | |
assumed on all routes defined on this router. | |
@property rootURL | |
@default '/' | |
*/ | |
rootURL: '/', | |
init: function() { | |
this.router = this.constructor.router || this.constructor.map(Ember.K); | |
this._activeViews = {}; | |
this._setupLocation(); | |
this._qpCache = {}; | |
this._queuedQPChanges = {}; | |
if (get(this, 'namespace.LOG_TRANSITIONS_INTERNAL')) { | |
this.router.log = Ember.Logger.debug; | |
} | |
}, | |
/** | |
Represents the current URL. | |
@method url | |
@return {String} The current URL. | |
*/ | |
url: computed(function() { | |
return get(this, 'location').getURL(); | |
}), | |
/** | |
Initializes the current router instance and sets up the change handling | |
event listeners used by the instances `location` implementation. | |
A property named `initialURL` will be used to determine the initial URL. | |
If no value is found `/` will be used. | |
@method startRouting | |
@private | |
*/ | |
startRouting: function() { | |
this.router = this.router || this.constructor.map(Ember.K); | |
var router = this.router, | |
location = get(this, 'location'), | |
container = this.container, | |
self = this, | |
initialURL = get(this, 'initialURL'); | |
// Allow the Location class to cancel the router setup while it refreshes | |
// the page | |
if (get(location, 'cancelRouterSetup')) { | |
return; | |
} | |
this._setupRouter(router, location); | |
container.register('view:default', DefaultView); | |
container.register('view:toplevel', EmberView.extend()); | |
location.onUpdateURL(function(url) { | |
self.handleURL(url); | |
}); | |
if (typeof initialURL === "undefined") { | |
initialURL = location.getURL(); | |
} | |
this.handleURL(initialURL); | |
}, | |
/** | |
Handles updating the paths and notifying any listeners of the URL | |
change. | |
Triggers the router level `didTransition` hook. | |
@method didTransition | |
@private | |
@since 1.2.0 | |
*/ | |
didTransition: function(infos) { | |
updatePaths(this); | |
this._cancelLoadingEvent(); | |
this.notifyPropertyChange('url'); | |
// Put this in the runloop so url will be accurate. Seems | |
// less surprising than didTransition being out of sync. | |
run.once(this, this.trigger, 'didTransition'); | |
if (get(this, 'namespace').LOG_TRANSITIONS) { | |
Ember.Logger.log("Transitioned into '" + EmberRouter._routePath(infos) + "'"); | |
} | |
}, | |
handleURL: function(url) { | |
return this._doTransition('handleURL', [url]); | |
}, | |
transitionTo: function() { | |
return this._doTransition('transitionTo', arguments); | |
}, | |
intermediateTransitionTo: function() { | |
this.router.intermediateTransitionTo.apply(this.router, arguments); | |
updatePaths(this); | |
var infos = this.router.currentHandlerInfos; | |
if (get(this, 'namespace').LOG_TRANSITIONS) { | |
Ember.Logger.log("Intermediate-transitioned into '" + EmberRouter._routePath(infos) + "'"); | |
} | |
}, | |
replaceWith: function() { | |
return this._doTransition('replaceWith', arguments); | |
}, | |
generate: function() { | |
var url = this.router.generate.apply(this.router, arguments); | |
return this.location.formatURL(url); | |
}, | |
/** | |
Determines if the supplied route is currently active. | |
@method isActive | |
@param routeName | |
@return {Boolean} | |
@private | |
*/ | |
isActive: function(routeName) { | |
var router = this.router; | |
return router.isActive.apply(router, arguments); | |
}, | |
send: function(name, context) { | |
this.router.trigger.apply(this.router, arguments); | |
}, | |
/** | |
Does this router instance have the given route. | |
@method hasRoute | |
@return {Boolean} | |
@private | |
*/ | |
hasRoute: function(route) { | |
return this.router.hasRoute(route); | |
}, | |
/** | |
Resets the state of the router by clearing the current route | |
handlers and deactivating them. | |
@private | |
@method reset | |
*/ | |
reset: function() { | |
this.router.reset(); | |
}, | |
_lookupActiveView: function(templateName) { | |
var active = this._activeViews[templateName]; | |
return active && active[0]; | |
}, | |
_connectActiveView: function(templateName, view) { | |
var existing = this._activeViews[templateName]; | |
if (existing) { | |
existing[0].off('willDestroyElement', this, existing[1]); | |
} | |
function disconnectActiveView() { | |
delete this._activeViews[templateName]; | |
} | |
this._activeViews[templateName] = [view, disconnectActiveView]; | |
view.one('willDestroyElement', this, disconnectActiveView); | |
}, | |
_setupLocation: function() { | |
var location = get(this, 'location'), | |
rootURL = get(this, 'rootURL'); | |
if (rootURL && !this.container.has('-location-setting:root-url')) { | |
this.container.register('-location-setting:root-url', rootURL, { instantiate: false }); | |
} | |
if ('string' === typeof location && this.container) { | |
var resolvedLocation = this.container.lookup('location:' + location); | |
if ('undefined' !== typeof resolvedLocation) { | |
location = set(this, 'location', resolvedLocation); | |
} else { | |
// Allow for deprecated registration of custom location API's | |
var options = {implementation: location}; | |
location = set(this, 'location', EmberLocation.create(options)); | |
} | |
} | |
if (rootURL && typeof rootURL === 'string') { | |
location.rootURL = rootURL; | |
} | |
// ensure that initState is called AFTER the rootURL is set on | |
// the location instance | |
if (typeof location.initState === 'function') { location.initState(); } | |
}, | |
_getHandlerFunction: function() { | |
var seen = {}, container = this.container, | |
DefaultRoute = container.lookupFactory('route:basic'), | |
self = this; | |
return function(name) { | |
var routeName = 'route:' + name, | |
handler = container.lookup(routeName); | |
if (seen[name]) { return handler; } | |
seen[name] = true; | |
if (!handler) { | |
container.register(routeName, DefaultRoute.extend()); | |
handler = container.lookup(routeName); | |
if (get(self, 'namespace.LOG_ACTIVE_GENERATION')) { | |
Ember.Logger.info("generated -> " + routeName, { fullName: routeName }); | |
} | |
} | |
handler.routeName = name; | |
return handler; | |
}; | |
}, | |
_setupRouter: function(router, location) { | |
var lastURL, emberRouter = this; | |
router.getHandler = this._getHandlerFunction(); | |
var doUpdateURL = function() { | |
location.setURL(lastURL); | |
}; | |
router.updateURL = function(path) { | |
lastURL = path; | |
run.once(doUpdateURL); | |
}; | |
if (location.replaceURL) { | |
var doReplaceURL = function() { | |
location.replaceURL(lastURL); | |
}; | |
router.replaceURL = function(path) { | |
lastURL = path; | |
run.once(doReplaceURL); | |
}; | |
} | |
router.didTransition = function(infos) { | |
emberRouter.didTransition(infos); | |
}; | |
}, | |
_doTransition: function(method, args) { | |
// Normalize blank route to root URL. | |
args = slice.call(args); | |
args[0] = args[0] || '/'; | |
var name = args[0], self = this, | |
isQueryParamsOnly = false, queryParams; | |
if (Ember.FEATURES.isEnabled("query-params-new")) { | |
var possibleQueryParamArg = args[args.length - 1]; | |
if (possibleQueryParamArg && possibleQueryParamArg.hasOwnProperty('queryParams')) { | |
if (args.length === 1) { | |
isQueryParamsOnly = true; | |
name = null; | |
} | |
queryParams = args[args.length - 1].queryParams; | |
} | |
} | |
if (!isQueryParamsOnly && name.charAt(0) !== '/') { | |
Ember.assert("The route " + name + " was not found", this.router.hasRoute(name)); | |
} | |
if (queryParams) { | |
// router.js expects queryParams to be passed in in | |
// their final serialized form, so we need to translate. | |
if (!name) { | |
// Need to determine destination route name. | |
var handlerInfos = this.router.activeTransition ? | |
this.router.activeTransition.state.handlerInfos : | |
this.router.state.handlerInfos; | |
name = handlerInfos[handlerInfos.length - 1].name; | |
args.unshift(name); | |
} | |
var qpCache = this._queryParamsFor(name), qps = qpCache.qps; | |
var finalParams = {}; | |
for (var key in queryParams) { | |
if (!queryParams.hasOwnProperty(key)) { continue; } | |
var inputValue = queryParams[key], | |
qp = qpCache.map[key]; | |
if (!qp) { | |
throw new EmberError("Unrecognized query param " + key + " provided as transition argument"); | |
} | |
finalParams[qp.urlKey] = qp.route.serializeQueryParam(inputValue, qp.urlKey, qp.type); | |
} | |
// Perform any necessary serialization. | |
args[args.length-1].queryParams = finalParams; | |
} | |
var transitionPromise = this.router[method].apply(this.router, args); | |
transitionPromise.then(null, function(error) { | |
if (error && error.name === "UnrecognizedURLError") { | |
Ember.assert("The URL '" + error.message + "' did not match any routes in your application"); | |
} | |
}, 'Ember: Check for Router unrecognized URL error'); | |
// We want to return the configurable promise object | |
// so that callers of this function can use `.method()` on it, | |
// which obviously doesn't exist for normal RSVP promises. | |
return transitionPromise; | |
}, | |
_queryParamsFor: function(leafRouteName) { | |
if (this._qpCache[leafRouteName]) { | |
return this._qpCache[leafRouteName]; | |
} | |
var map = {}, qps = [], qpCache = this._qpCache[leafRouteName] = { | |
map: map, | |
qps: qps | |
}; | |
var routerjs = this.router, | |
recogHandlerInfos = routerjs.recognizer.handlersFor(leafRouteName); | |
for (var i = 0, len = recogHandlerInfos.length; i < len; ++i) { | |
var recogHandler = recogHandlerInfos[i], | |
route = routerjs.getHandler(recogHandler.handler), | |
qpMeta = get(route, '_qp'); | |
if (!qpMeta) { continue; } | |
merge(map, qpMeta.map); | |
qps.push.apply(qps, qpMeta.qps); | |
} | |
return { | |
qps: qps, | |
map: map | |
}; | |
}, | |
_scheduleLoadingEvent: function(transition, originRoute) { | |
this._cancelLoadingEvent(); | |
this._loadingStateTimer = run.scheduleOnce('routerTransitions', this, '_fireLoadingEvent', transition, originRoute); | |
}, | |
_fireLoadingEvent: function(transition, originRoute) { | |
if (!this.router.activeTransition) { | |
// Don't fire an event if we've since moved on from | |
// the transition that put us in a loading state. | |
return; | |
} | |
transition.trigger(true, 'loading', transition, originRoute); | |
}, | |
_cancelLoadingEvent: function () { | |
if (this._loadingStateTimer) { | |
run.cancel(this._loadingStateTimer); | |
} | |
this._loadingStateTimer = null; | |
} | |
}); | |
function controllerOrProtoFor(controllerName, container, getProto) { | |
var fullName = container.normalize('controller:' + controllerName); | |
if (!getProto && container.cache.has(fullName)) { | |
return container.lookup(fullName); | |
} else { | |
// Controller hasn't been instantiated yet; just return its proto. | |
var controllerClass = container.lookupFactory(fullName); | |
if (controllerClass && typeof controllerClass.proto === 'function') { | |
return controllerClass.proto(); | |
} else { | |
return {}; | |
} | |
} | |
} | |
/* | |
Helper function for iterating root-ward, starting | |
from (but not including) the provided `originRoute`. | |
Returns true if the last callback fired requested | |
to bubble upward. | |
@private | |
*/ | |
function forEachRouteAbove(originRoute, transition, callback) { | |
var handlerInfos = transition.state.handlerInfos, | |
originRouteFound = false; | |
for (var i = handlerInfos.length - 1; i >= 0; --i) { | |
var handlerInfo = handlerInfos[i], | |
route = handlerInfo.handler; | |
if (!originRouteFound) { | |
if (originRoute === route) { | |
originRouteFound = true; | |
} | |
continue; | |
} | |
if (callback(route, handlerInfos[i + 1].handler) !== true) { | |
return false; | |
} | |
} | |
return true; | |
} | |
// These get invoked when an action bubbles above ApplicationRoute | |
// and are not meant to be overridable. | |
var defaultActionHandlers = { | |
willResolveModel: function(transition, originRoute) { | |
originRoute.router._scheduleLoadingEvent(transition, originRoute); | |
}, | |
error: function(error, transition, originRoute) { | |
// Attempt to find an appropriate error substate to enter. | |
var router = originRoute.router; | |
var tryTopLevel = forEachRouteAbove(originRoute, transition, function(route, childRoute) { | |
var childErrorRouteName = findChildRouteName(route, childRoute, 'error'); | |
if (childErrorRouteName) { | |
router.intermediateTransitionTo(childErrorRouteName, error); | |
return; | |
} | |
return true; | |
}); | |
if (tryTopLevel) { | |
// Check for top-level error state to enter. | |
if (routeHasBeenDefined(originRoute.router, 'application_error')) { | |
router.intermediateTransitionTo('application_error', error); | |
return; | |
} | |
} else { | |
// Don't fire an assertion if we found an error substate. | |
return; | |
} | |
var errorArgs = ['Error while loading route: ' + transition.targetName]; | |
if (error) { | |
if (error.message) { errorArgs.push(error.message); } | |
if (error.stack) { errorArgs.push(error.stack); } | |
if (typeof error === "string") { errorArgs.push(error); } | |
} | |
Ember.Logger.error.apply(this, errorArgs); | |
}, | |
loading: function(transition, originRoute) { | |
// Attempt to find an appropriate loading substate to enter. | |
var router = originRoute.router; | |
var tryTopLevel = forEachRouteAbove(originRoute, transition, function(route, childRoute) { | |
var childLoadingRouteName = findChildRouteName(route, childRoute, 'loading'); | |
if (childLoadingRouteName) { | |
router.intermediateTransitionTo(childLoadingRouteName); | |
return; | |
} | |
// Don't bubble above pivot route. | |
if (transition.pivotHandler !== route) { | |
return true; | |
} | |
}); | |
if (tryTopLevel) { | |
// Check for top-level loading state to enter. | |
if (routeHasBeenDefined(originRoute.router, 'application_loading')) { | |
router.intermediateTransitionTo('application_loading'); | |
return; | |
} | |
} | |
} | |
}; | |
function findChildRouteName(parentRoute, originatingChildRoute, name) { | |
var router = parentRoute.router, | |
childName, | |
targetChildRouteName = originatingChildRoute.routeName.split('.').pop(), | |
namespace = parentRoute.routeName === 'application' ? '' : parentRoute.routeName + '.'; | |
if (Ember.FEATURES.isEnabled("ember-routing-named-substates")) { | |
// First, try a named loading state, e.g. 'foo_loading' | |
childName = namespace + targetChildRouteName + '_' + name; | |
if (routeHasBeenDefined(router, childName)) { | |
return childName; | |
} | |
} | |
// Second, try general loading state, e.g. 'loading' | |
childName = namespace + name; | |
if (routeHasBeenDefined(router, childName)) { | |
return childName; | |
} | |
} | |
function routeHasBeenDefined(router, name) { | |
var container = router.container; | |
return router.hasRoute(name) && | |
(container.has('template:' + name) || container.has('route:' + name)); | |
} | |
function triggerEvent(handlerInfos, ignoreFailure, args) { | |
var name = args.shift(); | |
if (!handlerInfos) { | |
if (ignoreFailure) { return; } | |
throw new EmberError("Can't trigger action '" + name + "' because your app hasn't finished transitioning into its first route. To trigger an action on destination routes during a transition, you can call `.send()` on the `Transition` object passed to the `model/beforeModel/afterModel` hooks."); | |
} | |
var eventWasHandled = false; | |
for (var i = handlerInfos.length - 1; i >= 0; i--) { | |
var handlerInfo = handlerInfos[i], | |
handler = handlerInfo.handler; | |
if (handler._actions && handler._actions[name]) { | |
if (handler._actions[name].apply(handler, args) === true) { | |
eventWasHandled = true; | |
} else { | |
return; | |
} | |
} | |
} | |
if (defaultActionHandlers[name]) { | |
defaultActionHandlers[name].apply(null, args); | |
return; | |
} | |
if (!eventWasHandled && !ignoreFailure) { | |
throw new EmberError("Nothing handled the action '" + name + "'. If you did handle the action, this error can be caused by returning true from an action handler in a controller, causing the action to bubble."); | |
} | |
} | |
function updatePaths(router) { | |
var appController = router.container.lookup('controller:application'); | |
if (!appController) { | |
// appController might not exist when top-level loading/error | |
// substates have been entered since ApplicationRoute hasn't | |
// actually been entered at that point. | |
return; | |
} | |
var infos = router.router.currentHandlerInfos, | |
path = EmberRouter._routePath(infos); | |
if (!('currentPath' in appController)) { | |
defineProperty(appController, 'currentPath'); | |
} | |
set(appController, 'currentPath', path); | |
if (!('currentRouteName' in appController)) { | |
defineProperty(appController, 'currentRouteName'); | |
} | |
set(appController, 'currentRouteName', infos[infos.length - 1].name); | |
} | |
EmberRouter.reopenClass({ | |
router: null, | |
map: function(callback) { | |
var router = this.router; | |
if (!router) { | |
router = new Router(); | |
if (Ember.FEATURES.isEnabled("ember-routing-will-change-hooks")) { | |
router._willChangeContextEvent = 'willChangeModel'; | |
} else { | |
router._triggerWillChangeContext = Ember.K; | |
router._triggerWillLeave = Ember.K; | |
} | |
router.callbacks = []; | |
router.triggerEvent = triggerEvent; | |
this.reopenClass({ router: router }); | |
} | |
var dsl = EmberRouterDSL.map(function() { | |
this.resource('application', { path: "/" }, function() { | |
for (var i=0; i < router.callbacks.length; i++) { | |
router.callbacks[i].call(this); | |
} | |
callback.call(this); | |
}); | |
}); | |
router.callbacks.push(callback); | |
router.map(dsl.generate()); | |
return router; | |
}, | |
_routePath: function(handlerInfos) { | |
var path = []; | |
// We have to handle coalescing resource names that | |
// are prefixed with their parent's names, e.g. | |
// ['foo', 'foo.bar.baz'] => 'foo.bar.baz', not 'foo.foo.bar.baz' | |
function intersectionMatches(a1, a2) { | |
for (var i = 0, len = a1.length; i < len; ++i) { | |
if (a1[i] !== a2[i]) { | |
return false; | |
} | |
} | |
return true; | |
} | |
for (var i=1, l=handlerInfos.length; i<l; i++) { | |
var name = handlerInfos[i].name, | |
nameParts = name.split("."), | |
oldNameParts = slice.call(path); | |
while (oldNameParts.length) { | |
if (intersectionMatches(oldNameParts, nameParts)) { | |
break; | |
} | |
oldNameParts.shift(); | |
} | |
path.push.apply(path, nameParts.slice(oldNameParts.length)); | |
} | |
return path.join("."); | |
} | |
}); | |
__exports__["default"] = EmberRouter; | |
}); | |
define("ember-runtime", | |
["ember-metal","ember-runtime/core","ember-runtime/keys","ember-runtime/compare","ember-runtime/copy","ember-runtime/system/namespace","ember-runtime/system/object","ember-runtime/system/tracked_array","ember-runtime/system/subarray","ember-runtime/system/container","ember-runtime/system/application","ember-runtime/system/array_proxy","ember-runtime/system/object_proxy","ember-runtime/system/core_object","ember-runtime/system/each_proxy","ember-runtime/system/native_array","ember-runtime/system/set","ember-runtime/system/string","ember-runtime/system/deferred","ember-runtime/system/lazy_load","ember-runtime/mixins/array","ember-runtime/mixins/comparable","ember-runtime/mixins/copyable","ember-runtime/mixins/enumerable","ember-runtime/mixins/freezable","ember-runtime/mixins/observable","ember-runtime/mixins/action_handler","ember-runtime/mixins/deferred","ember-runtime/mixins/mutable_enumerable","ember-runtime/mixins/mutable_array","ember-runtime/mixins/target_action_support","ember-runtime/mixins/evented","ember-runtime/mixins/promise_proxy","ember-runtime/mixins/sortable","ember-runtime/computed/array_computed","ember-runtime/computed/reduce_computed","ember-runtime/computed/reduce_computed_macros","ember-runtime/controllers/array_controller","ember-runtime/controllers/object_controller","ember-runtime/controllers/controller","ember-runtime/ext/rsvp","ember-runtime/ext/string","ember-runtime/ext/function","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __dependency6__, __dependency7__, __dependency8__, __dependency9__, __dependency10__, __dependency11__, __dependency12__, __dependency13__, __dependency14__, __dependency15__, __dependency16__, __dependency17__, __dependency18__, __dependency19__, __dependency20__, __dependency21__, __dependency22__, __dependency23__, __dependency24__, __dependency25__, __dependency26__, __dependency27__, __dependency28__, __dependency29__, __dependency30__, __dependency31__, __dependency32__, __dependency33__, __dependency34__, __dependency35__, __dependency36__, __dependency37__, __dependency38__, __dependency39__, __dependency40__, __dependency41__, __dependency42__, __dependency43__, __exports__) { | |
"use strict"; | |
/** | |
Ember Runtime | |
@module ember | |
@submodule ember-runtime | |
@requires ember-metal | |
*/ | |
// BEGIN IMPORTS | |
var Ember = __dependency1__["default"]; | |
var isEqual = __dependency2__.isEqual; | |
var keys = __dependency3__["default"]; | |
var compare = __dependency4__["default"]; | |
var copy = __dependency5__["default"]; | |
var Namespace = __dependency6__["default"]; | |
var EmberObject = __dependency7__["default"]; | |
var TrackedArray = __dependency8__["default"]; | |
var SubArray = __dependency9__["default"]; | |
var Container = __dependency10__["default"]; | |
var Application = __dependency11__["default"]; | |
var ArrayProxy = __dependency12__["default"]; | |
var ObjectProxy = __dependency13__["default"]; | |
var CoreObject = __dependency14__["default"]; | |
var EachArray = __dependency15__.EachArray; | |
var EachProxy = __dependency15__.EachProxy; | |
var NativeArray = __dependency16__["default"]; | |
var Set = __dependency17__["default"]; | |
var EmberStringUtils = __dependency18__["default"]; | |
var Deferred = __dependency19__["default"]; | |
var onLoad = __dependency20__.onLoad; | |
var runLoadHooks = __dependency20__.runLoadHooks; | |
var EmberArray = __dependency21__["default"]; | |
var Comparable = __dependency22__["default"]; | |
var Copyable = __dependency23__["default"]; | |
var Enumerable = __dependency24__["default"]; | |
var Freezable = __dependency25__.Freezable; | |
var FROZEN_ERROR = __dependency25__.FROZEN_ERROR; | |
var Observable = __dependency26__["default"]; | |
var ActionHandler = __dependency27__["default"]; | |
var DeferredMixin = __dependency28__["default"]; | |
var MutableEnumerable = __dependency29__["default"]; | |
var MutableArray = __dependency30__["default"]; | |
var TargetActionSupport = __dependency31__["default"]; | |
var Evented = __dependency32__["default"]; | |
var PromiseProxyMixin = __dependency33__["default"]; | |
var SortableMixin = __dependency34__["default"]; | |
var arrayComputed = __dependency35__.arrayComputed; | |
var ArrayComputedProperty = __dependency35__.ArrayComputedProperty; | |
var reduceComputed = __dependency36__.reduceComputed; | |
var ReduceComputedProperty = __dependency36__.ReduceComputedProperty; | |
var sum = __dependency37__.sum; | |
var min = __dependency37__.min; | |
var max = __dependency37__.max; | |
var map = __dependency37__.map; | |
var sort = __dependency37__.sort; | |
var setDiff = __dependency37__.setDiff; | |
var mapBy = __dependency37__.mapBy; | |
var mapProperty = __dependency37__.mapProperty; | |
var filter = __dependency37__.filter; | |
var filterBy = __dependency37__.filterBy; | |
var filterProperty = __dependency37__.filterProperty; | |
var uniq = __dependency37__.uniq; | |
var union = __dependency37__.union; | |
var intersect = __dependency37__.intersect; | |
var ArrayController = __dependency38__["default"]; | |
var ObjectController = __dependency39__["default"]; | |
var Controller = __dependency40__.Controller; | |
var ControllerMixin = __dependency40__.ControllerMixin; | |
var RSVP = __dependency41__["default"]; | |
// just for side effect of extending Ember.RSVP | |
// just for side effect of extending String.prototype | |
// just for side effect of extending Function.prototype | |
// END IMPORTS | |
// BEGIN EXPORTS | |
Ember.compare = compare; | |
Ember.copy = copy; | |
Ember.isEqual = isEqual; | |
Ember.keys = keys; | |
Ember.Array = EmberArray; | |
Ember.Comparable = Comparable; | |
Ember.Copyable = Copyable; | |
Ember.SortableMixin = SortableMixin; | |
Ember.Freezable = Freezable; | |
Ember.FROZEN_ERROR = FROZEN_ERROR; | |
Ember.DeferredMixin = DeferredMixin; | |
Ember.MutableEnumerable = MutableEnumerable; | |
Ember.MutableArray = MutableArray; | |
Ember.TargetActionSupport = TargetActionSupport; | |
Ember.Evented = Evented; | |
Ember.PromiseProxyMixin = PromiseProxyMixin; | |
Ember.Observable = Observable; | |
Ember.arrayComputed = arrayComputed; | |
Ember.ArrayComputedProperty = ArrayComputedProperty; | |
Ember.reduceComputed = reduceComputed; | |
Ember.ReduceComputedProperty = ReduceComputedProperty; | |
// ES6TODO: this seems a less than ideal way/place to add properties to Ember.computed | |
var EmComputed = Ember.computed; | |
EmComputed.sum = sum; | |
EmComputed.min = min; | |
EmComputed.max = max; | |
EmComputed.map = map; | |
EmComputed.sort = sort; | |
EmComputed.setDiff = setDiff; | |
EmComputed.mapBy = mapBy; | |
EmComputed.mapProperty = mapProperty; | |
EmComputed.filter = filter; | |
EmComputed.filterBy = filterBy; | |
EmComputed.filterProperty = filterProperty; | |
EmComputed.uniq = uniq; | |
EmComputed.union = union; | |
EmComputed.intersect = intersect; | |
Ember.String = EmberStringUtils; | |
Ember.Object = EmberObject; | |
Ember.TrackedArray = TrackedArray; | |
Ember.SubArray = SubArray; | |
Ember.Container = Container; | |
Ember.Namespace = Namespace; | |
Ember.Enumerable = Enumerable; | |
Ember.ArrayProxy = ArrayProxy; | |
Ember.ObjectProxy = ObjectProxy; | |
Ember.ActionHandler = ActionHandler; | |
Ember.CoreObject = CoreObject; | |
Ember.EachArray = EachArray; | |
Ember.EachProxy = EachProxy; | |
Ember.NativeArray = NativeArray; | |
// ES6TODO: Currently we must rely on the global from ember-metal/core to avoid circular deps | |
// Ember.A = A; | |
Ember.Set = Set; | |
Ember.Deferred = Deferred; | |
Ember.onLoad = onLoad; | |
Ember.runLoadHooks = runLoadHooks; | |
Ember.ArrayController = ArrayController; | |
Ember.ObjectController = ObjectController; | |
Ember.Controller = Controller; | |
Ember.ControllerMixin = ControllerMixin; | |
Ember.RSVP = RSVP; | |
// END EXPORTS | |
__exports__["default"] = Ember; | |
}); | |
define("ember-runtime/compare", | |
["ember-metal/core","ember-metal/utils","ember-runtime/mixins/comparable","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __exports__) { | |
"use strict"; | |
var Ember = __dependency1__["default"]; | |
// for Ember.ORDER_DEFINITION | |
var typeOf = __dependency2__.typeOf; | |
var Comparable = __dependency3__["default"]; | |
// Used by Ember.compare | |
Ember.ORDER_DEFINITION = Ember.ENV.ORDER_DEFINITION || [ | |
'undefined', | |
'null', | |
'boolean', | |
'number', | |
'string', | |
'array', | |
'object', | |
'instance', | |
'function', | |
'class', | |
'date' | |
]; | |
/** | |
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. | |
```javascript | |
Ember.compare('hello', 'hello'); // 0 | |
Ember.compare('abc', 'dfg'); // -1 | |
Ember.compare(2, 1); // 1 | |
``` | |
@method compare | |
@for Ember | |
@param {Object} v First value to compare | |
@param {Object} w Second value to compare | |
@return {Number} -1 if v < w, 0 if v = w and 1 if v > w. | |
*/ | |
__exports__["default"] = function compare(v, w) { | |
if (v === w) { return 0; } | |
var type1 = typeOf(v); | |
var type2 = typeOf(w); | |
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 (Comparable && 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; | |
} | |
} | |
}); | |
define("ember-runtime/computed/array_computed", | |
["ember-metal/core","ember-runtime/computed/reduce_computed","ember-metal/enumerable_utils","ember-metal/platform","ember-metal/observer","ember-metal/error","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __dependency6__, __exports__) { | |
"use strict"; | |
var Ember = __dependency1__["default"]; | |
var reduceComputed = __dependency2__.reduceComputed; | |
var ReduceComputedProperty = __dependency2__.ReduceComputedProperty; | |
var EnumerableUtils = __dependency3__["default"]; | |
var create = __dependency4__.create; | |
var addObserver = __dependency5__.addObserver; | |
var EmberError = __dependency6__["default"]; | |
var a_slice = [].slice; | |
var o_create = create; | |
var forEach = EnumerableUtils.forEach; | |
function ArrayComputedProperty() { | |
var cp = this; | |
ReduceComputedProperty.apply(this, arguments); | |
this.func = (function(reduceFunc) { | |
return function (propertyName) { | |
if (!cp._hasInstanceMeta(this, propertyName)) { | |
// When we recompute an array computed property, we need already | |
// retrieved arrays to be updated; we can't simply empty the cache and | |
// hope the array is re-retrieved. | |
forEach(cp._dependentKeys, function(dependentKey) { | |
addObserver(this, dependentKey, function() { | |
cp.recomputeOnce.call(this, propertyName); | |
}); | |
}, this); | |
} | |
return reduceFunc.apply(this, arguments); | |
}; | |
})(this.func); | |
return this; | |
} | |
ArrayComputedProperty.prototype = o_create(ReduceComputedProperty.prototype); | |
ArrayComputedProperty.prototype.initialValue = function () { | |
return Ember.A(); | |
}; | |
ArrayComputedProperty.prototype.resetValue = function (array) { | |
array.clear(); | |
return array; | |
}; | |
// This is a stopgap to keep the reference counts correct with lazy CPs. | |
ArrayComputedProperty.prototype.didChange = function (obj, keyName) { | |
return; | |
}; | |
/** | |
Creates a computed property which operates on dependent arrays and | |
is updated with "one at a time" semantics. When items are added or | |
removed from the dependent array(s) an array computed only operates | |
on the change instead of re-evaluating the entire array. This should | |
return an array, if you'd like to use "one at a time" semantics and | |
compute some value other then an array look at | |
`Ember.reduceComputed`. | |
If there are more than one arguments the first arguments are | |
considered to be dependent property keys. The last argument is | |
required to be an options object. The options object can have the | |
following three properties. | |
`initialize` - An optional initialize function. Typically this will be used | |
to set up state on the instanceMeta object. | |
`removedItem` - A function that is called each time an element is | |
removed from the array. | |
`addedItem` - A function that is called each time an element is | |
added to the array. | |
The `initialize` function has the following signature: | |
```javascript | |
function (array, changeMeta, instanceMeta) | |
``` | |
`array` - The initial value of the arrayComputed, an empty array. | |
`changeMeta` - An object which contains meta information about the | |
computed. It contains the following properties: | |
- `property` the computed property | |
- `propertyName` the name of the property on the object | |
`instanceMeta` - An object that can be used to store meta | |
information needed for calculating your computed. For example a | |
unique computed might use this to store the number of times a given | |
element is found in the dependent array. | |
The `removedItem` and `addedItem` functions both have the following signature: | |
```javascript | |
function (accumulatedValue, item, changeMeta, instanceMeta) | |
``` | |
`accumulatedValue` - The value returned from the last time | |
`removedItem` or `addedItem` was called or an empty array. | |
`item` - the element added or removed from the array | |
`changeMeta` - An object which contains meta information about the | |
change. It contains the following properties: | |
- `property` the computed property | |
- `propertyName` the name of the property on the object | |
- `index` the index of the added or removed item | |
- `item` the added or removed item: this is exactly the same as | |
the second arg | |
- `arrayChanged` the array that triggered the change. Can be | |
useful when depending on multiple arrays. | |
For property changes triggered on an item property change (when | |
depKey is something like `[email protected]`), | |
`changeMeta` will also contain the following property: | |
- `previousValues` an object whose keys are the properties that changed on | |
the item, and whose values are the item's previous values. | |
`previousValues` is important Ember coalesces item property changes via | |
Ember.run.once. This means that by the time removedItem gets called, item has | |
the new values, but you may need the previous value (eg for sorting & | |
filtering). | |
`instanceMeta` - An object that can be used to store meta | |
information needed for calculating your computed. For example a | |
unique computed might use this to store the number of times a given | |
element is found in the dependent array. | |
The `removedItem` and `addedItem` functions should return the accumulated | |
value. It is acceptable to not return anything (ie return undefined) | |
to invalidate the computation. This is generally not a good idea for | |
arrayComputed but it's used in eg max and min. | |
Example | |
```javascript | |
Ember.computed.map = function(dependentKey, callback) { | |
var options = { | |
addedItem: function(array, item, changeMeta, instanceMeta) { | |
var mapped = callback(item); | |
array.insertAt(changeMeta.index, mapped); | |
return array; | |
}, | |
removedItem: function(array, item, changeMeta, instanceMeta) { | |
array.removeAt(changeMeta.index, 1); | |
return array; | |
} | |
}; | |
return Ember.arrayComputed(dependentKey, options); | |
}; | |
``` | |
@method arrayComputed | |
@for Ember | |
@param {String} [dependentKeys*] | |
@param {Object} options | |
@return {Ember.ComputedProperty} | |
*/ | |
function arrayComputed (options) { | |
var args; | |
if (arguments.length > 1) { | |
args = a_slice.call(arguments, 0, -1); | |
options = a_slice.call(arguments, -1)[0]; | |
} | |
if (typeof options !== "object") { | |
throw new EmberError("Array Computed Property declared without an options hash"); | |
} | |
var cp = new ArrayComputedProperty(options); | |
if (args) { | |
cp.property.apply(cp, args); | |
} | |
return cp; | |
} | |
__exports__.arrayComputed = arrayComputed; | |
__exports__.ArrayComputedProperty = ArrayComputedProperty; | |
}); | |
define("ember-runtime/computed/reduce_computed", | |
["ember-metal/core","ember-metal/property_get","ember-metal/property_set","ember-metal/utils","ember-metal/error","ember-metal/property_events","ember-metal/expand_properties","ember-metal/observer","ember-metal/computed","ember-metal/platform","ember-metal/enumerable_utils","ember-runtime/system/tracked_array","ember-runtime/mixins/array","ember-metal/run_loop","ember-runtime/system/set","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __dependency6__, __dependency7__, __dependency8__, __dependency9__, __dependency10__, __dependency11__, __dependency12__, __dependency13__, __dependency14__, __dependency15__, __exports__) { | |
"use strict"; | |
var Ember = __dependency1__["default"]; | |
// Ember.assert | |
var e_get = __dependency2__.get; | |
var set = __dependency3__.set; | |
var guidFor = __dependency4__.guidFor; | |
var metaFor = __dependency4__.meta; | |
var EmberError = __dependency5__["default"]; | |
var propertyWillChange = __dependency6__.propertyWillChange; | |
var propertyDidChange = __dependency6__.propertyDidChange; | |
var expandProperties = __dependency7__["default"]; | |
var addObserver = __dependency8__.addObserver; | |
var observersFor = __dependency8__.observersFor; | |
var removeObserver = __dependency8__.removeObserver; | |
var addBeforeObserver = __dependency8__.addBeforeObserver; | |
var removeBeforeObserver = __dependency8__.removeBeforeObserver; | |
var ComputedProperty = __dependency9__.ComputedProperty; | |
var cacheFor = __dependency9__.cacheFor; | |
var create = __dependency10__.create; | |
var EnumerableUtils = __dependency11__["default"]; | |
var TrackedArray = __dependency12__["default"]; | |
var EmberArray = __dependency13__["default"]; | |
var run = __dependency14__["default"]; | |
var Set = __dependency15__["default"]; | |
var isArray = __dependency4__.isArray; | |
var cacheSet = cacheFor.set; | |
var cacheGet = cacheFor.get; | |
var cacheRemove = cacheFor.remove; | |
var a_slice = [].slice; | |
var o_create = create; | |
var forEach = EnumerableUtils.forEach; | |
// Here we explicitly don't allow `@each.foo`; it would require some special | |
// testing, but there's no particular reason why it should be disallowed. | |
var eachPropertyPattern = /^(.*)\.@each\.(.*)/; | |
var doubleEachPropertyPattern = /(.*\.@each){2,}/; | |
var arrayBracketPattern = /\.\[\]$/; | |
function get(obj, key) { | |
if (key === '@this') { | |
return obj; | |
} | |
return e_get(obj, key); | |
} | |
/* | |
Tracks changes to dependent arrays, as well as to properties of items in | |
dependent arrays. | |
@class DependentArraysObserver | |
*/ | |
function DependentArraysObserver(callbacks, cp, instanceMeta, context, propertyName, sugarMeta) { | |
// user specified callbacks for `addedItem` and `removedItem` | |
this.callbacks = callbacks; | |
// the computed property: remember these are shared across instances | |
this.cp = cp; | |
// the ReduceComputedPropertyInstanceMeta this DependentArraysObserver is | |
// associated with | |
this.instanceMeta = instanceMeta; | |
// A map of array guids to dependentKeys, for the given context. We track | |
// this because we want to set up the computed property potentially before the | |
// dependent array even exists, but when the array observer fires, we lack | |
// enough context to know what to update: we can recover that context by | |
// getting the dependentKey. | |
this.dependentKeysByGuid = {}; | |
// a map of dependent array guids -> TrackedArray instances. We use | |
// this to lazily recompute indexes for item property observers. | |
this.trackedArraysByGuid = {}; | |
// We suspend observers to ignore replacements from `reset` when totally | |
// recomputing. Unfortunately we cannot properly suspend the observers | |
// because we only have the key; instead we make the observers no-ops | |
this.suspended = false; | |
// This is used to coalesce item changes from property observers. | |
this.changedItems = {}; | |
} | |
function ItemPropertyObserverContext (dependentArray, index, trackedArray) { | |
Ember.assert("Internal error: trackedArray is null or undefined", trackedArray); | |
this.dependentArray = dependentArray; | |
this.index = index; | |
this.item = dependentArray.objectAt(index); | |
this.trackedArray = trackedArray; | |
this.beforeObserver = null; | |
this.observer = null; | |
this.destroyed = false; | |
} | |
DependentArraysObserver.prototype = { | |
setValue: function (newValue) { | |
this.instanceMeta.setValue(newValue, true); | |
}, | |
getValue: function () { | |
return this.instanceMeta.getValue(); | |
}, | |
setupObservers: function (dependentArray, dependentKey) { | |
this.dependentKeysByGuid[guidFor(dependentArray)] = dependentKey; | |
dependentArray.addArrayObserver(this, { | |
willChange: 'dependentArrayWillChange', | |
didChange: 'dependentArrayDidChange' | |
}); | |
if (this.cp._itemPropertyKeys[dependentKey]) { | |
this.setupPropertyObservers(dependentKey, this.cp._itemPropertyKeys[dependentKey]); | |
} | |
}, | |
teardownObservers: function (dependentArray, dependentKey) { | |
var itemPropertyKeys = this.cp._itemPropertyKeys[dependentKey] || []; | |
delete this.dependentKeysByGuid[guidFor(dependentArray)]; | |
this.teardownPropertyObservers(dependentKey, itemPropertyKeys); | |
dependentArray.removeArrayObserver(this, { | |
willChange: 'dependentArrayWillChange', | |
didChange: 'dependentArrayDidChange' | |
}); | |
}, | |
suspendArrayObservers: function (callback, binding) { | |
var oldSuspended = this.suspended; | |
this.suspended = true; | |
callback.call(binding); | |
this.suspended = oldSuspended; | |
}, | |
setupPropertyObservers: function (dependentKey, itemPropertyKeys) { | |
var dependentArray = get(this.instanceMeta.context, dependentKey), | |
length = get(dependentArray, 'length'), | |
observerContexts = new Array(length); | |
this.resetTransformations(dependentKey, observerContexts); | |
forEach(dependentArray, function (item, index) { | |
var observerContext = this.createPropertyObserverContext(dependentArray, index, this.trackedArraysByGuid[dependentKey]); | |
observerContexts[index] = observerContext; | |
forEach(itemPropertyKeys, function (propertyKey) { | |
addBeforeObserver(item, propertyKey, this, observerContext.beforeObserver); | |
addObserver(item, propertyKey, this, observerContext.observer); | |
}, this); | |
}, this); | |
}, | |
teardownPropertyObservers: function (dependentKey, itemPropertyKeys) { | |
var dependentArrayObserver = this, | |
trackedArray = this.trackedArraysByGuid[dependentKey], | |
beforeObserver, | |
observer, | |
item; | |
if (!trackedArray) { return; } | |
trackedArray.apply(function (observerContexts, offset, operation) { | |
if (operation === TrackedArray.DELETE) { return; } | |
forEach(observerContexts, function (observerContext) { | |
observerContext.destroyed = true; | |
beforeObserver = observerContext.beforeObserver; | |
observer = observerContext.observer; | |
item = observerContext.item; | |
forEach(itemPropertyKeys, function (propertyKey) { | |
removeBeforeObserver(item, propertyKey, dependentArrayObserver, beforeObserver); | |
removeObserver(item, propertyKey, dependentArrayObserver, observer); | |
}); | |
}); | |
}); | |
}, | |
createPropertyObserverContext: function (dependentArray, index, trackedArray) { | |
var observerContext = new ItemPropertyObserverContext(dependentArray, index, trackedArray); | |
this.createPropertyObserver(observerContext); | |
return observerContext; | |
}, | |
createPropertyObserver: function (observerContext) { | |
var dependentArrayObserver = this; | |
observerContext.beforeObserver = function (obj, keyName) { | |
return dependentArrayObserver.itemPropertyWillChange(obj, keyName, observerContext.dependentArray, observerContext); | |
}; | |
observerContext.observer = function (obj, keyName) { | |
return dependentArrayObserver.itemPropertyDidChange(obj, keyName, observerContext.dependentArray, observerContext); | |
}; | |
}, | |
resetTransformations: function (dependentKey, observerContexts) { | |
this.trackedArraysByGuid[dependentKey] = new TrackedArray(observerContexts); | |
}, | |
trackAdd: function (dependentKey, index, newItems) { | |
var trackedArray = this.trackedArraysByGuid[dependentKey]; | |
if (trackedArray) { | |
trackedArray.addItems(index, newItems); | |
} | |
}, | |
trackRemove: function (dependentKey, index, removedCount) { | |
var trackedArray = this.trackedArraysByGuid[dependentKey]; | |
if (trackedArray) { | |
return trackedArray.removeItems(index, removedCount); | |
} | |
return []; | |
}, | |
updateIndexes: function (trackedArray, array) { | |
var length = get(array, 'length'); | |
// OPTIMIZE: we could stop updating once we hit the object whose observer | |
// fired; ie partially apply the transformations | |
trackedArray.apply(function (observerContexts, offset, operation, operationIndex) { | |
// we don't even have observer contexts for removed items, even if we did, | |
// they no longer have any index in the array | |
if (operation === TrackedArray.DELETE) { return; } | |
if (operationIndex === 0 && operation === TrackedArray.RETAIN && observerContexts.length === length && offset === 0) { | |
// If we update many items we don't want to walk the array each time: we | |
// only need to update the indexes at most once per run loop. | |
return; | |
} | |
forEach(observerContexts, function (context, index) { | |
context.index = index + offset; | |
}); | |
}); | |
}, | |
dependentArrayWillChange: function (dependentArray, index, removedCount, addedCount) { | |
if (this.suspended) { return; } | |
var removedItem = this.callbacks.removedItem; | |
var changeMeta; | |
var guid = guidFor(dependentArray); | |
var dependentKey = this.dependentKeysByGuid[guid]; | |
var itemPropertyKeys = this.cp._itemPropertyKeys[dependentKey] || []; | |
var length = get(dependentArray, 'length'); | |
var normalizedIndex = normalizeIndex(index, length, 0); | |
var normalizedRemoveCount = normalizeRemoveCount(normalizedIndex, length, removedCount); | |
var item, itemIndex, sliceIndex, observerContexts; | |
observerContexts = this.trackRemove(dependentKey, normalizedIndex, normalizedRemoveCount); | |
function removeObservers(propertyKey) { | |
observerContexts[sliceIndex].destroyed = true; | |
removeBeforeObserver(item, propertyKey, this, observerContexts[sliceIndex].beforeObserver); | |
removeObserver(item, propertyKey, this, observerContexts[sliceIndex].observer); | |
} | |
for (sliceIndex = normalizedRemoveCount - 1; sliceIndex >= 0; --sliceIndex) { | |
itemIndex = normalizedIndex + sliceIndex; | |
if (itemIndex >= length) { break; } | |
item = dependentArray.objectAt(itemIndex); | |
forEach(itemPropertyKeys, removeObservers, this); | |
changeMeta = new ChangeMeta(dependentArray, item, itemIndex, this.instanceMeta.propertyName, this.cp, normalizedRemoveCount); | |
this.setValue( removedItem.call( | |
this.instanceMeta.context, this.getValue(), item, changeMeta, this.instanceMeta.sugarMeta)); | |
} | |
}, | |
dependentArrayDidChange: function (dependentArray, index, removedCount, addedCount) { | |
if (this.suspended) { return; } | |
var addedItem = this.callbacks.addedItem; | |
var guid = guidFor(dependentArray); | |
var dependentKey = this.dependentKeysByGuid[guid]; | |
var observerContexts = new Array(addedCount); | |
var itemPropertyKeys = this.cp._itemPropertyKeys[dependentKey]; | |
var length = get(dependentArray, 'length'); | |
var normalizedIndex = normalizeIndex(index, length, addedCount); | |
var changeMeta, observerContext; | |
forEach(dependentArray.slice(normalizedIndex, normalizedIndex + addedCount), function (item, sliceIndex) { | |
if (itemPropertyKeys) { | |
observerContext = | |
observerContexts[sliceIndex] = | |
this.createPropertyObserverContext(dependentArray, normalizedIndex + sliceIndex, this.trackedArraysByGuid[dependentKey]); | |
forEach(itemPropertyKeys, function (propertyKey) { | |
addBeforeObserver(item, propertyKey, this, observerContext.beforeObserver); | |
addObserver(item, propertyKey, this, observerContext.observer); | |
}, this); | |
} | |
changeMeta = new ChangeMeta(dependentArray, item, normalizedIndex + sliceIndex, this.instanceMeta.propertyName, this.cp, addedCount); | |
this.setValue( addedItem.call( | |
this.instanceMeta.context, this.getValue(), item, changeMeta, this.instanceMeta.sugarMeta)); | |
}, this); | |
this.trackAdd(dependentKey, normalizedIndex, observerContexts); | |
}, | |
itemPropertyWillChange: function (obj, keyName, array, observerContext) { | |
var guid = guidFor(obj); | |
if (!this.changedItems[guid]) { | |
this.changedItems[guid] = { | |
array: array, | |
observerContext: observerContext, | |
obj: obj, | |
previousValues: {} | |
}; | |
} | |
this.changedItems[guid].previousValues[keyName] = get(obj, keyName); | |
}, | |
itemPropertyDidChange: function(obj, keyName, array, observerContext) { | |
this.flushChanges(); | |
}, | |
flushChanges: function() { | |
var changedItems = this.changedItems, key, c, changeMeta; | |
for (key in changedItems) { | |
c = changedItems[key]; | |
if (c.observerContext.destroyed) { continue; } | |
this.updateIndexes(c.observerContext.trackedArray, c.observerContext.dependentArray); | |
changeMeta = new ChangeMeta(c.array, c.obj, c.observerContext.index, this.instanceMeta.propertyName, this.cp, changedItems.length, c.previousValues); | |
this.setValue( | |
this.callbacks.removedItem.call(this.instanceMeta.context, this.getValue(), c.obj, changeMeta, this.instanceMeta.sugarMeta)); | |
this.setValue( | |
this.callbacks.addedItem.call(this.instanceMeta.context, this.getValue(), c.obj, changeMeta, this.instanceMeta.sugarMeta)); | |
} | |
this.changedItems = {}; | |
} | |
}; | |
function normalizeIndex(index, length, newItemsOffset) { | |
if (index < 0) { | |
return Math.max(0, length + index); | |
} else if (index < length) { | |
return index; | |
} else /* index > length */ { | |
return Math.min(length - newItemsOffset, index); | |
} | |
} | |
function normalizeRemoveCount(index, length, removedCount) { | |
return Math.min(removedCount, length - index); | |
} | |
function ChangeMeta(dependentArray, item, index, propertyName, property, changedCount, previousValues){ | |
this.arrayChanged = dependentArray; | |
this.index = index; | |
this.item = item; | |
this.propertyName = propertyName; | |
this.property = property; | |
this.changedCount = changedCount; | |
if (previousValues) { | |
// previous values only available for item property changes | |
this.previousValues = previousValues; | |
} | |
} | |
function addItems (dependentArray, callbacks, cp, propertyName, meta) { | |
forEach(dependentArray, function (item, index) { | |
meta.setValue( callbacks.addedItem.call( | |
this, meta.getValue(), item, new ChangeMeta(dependentArray, item, index, propertyName, cp, dependentArray.length), meta.sugarMeta)); | |
}, this); | |
} | |
function reset(cp, propertyName) { | |
var callbacks = cp._callbacks(), | |
meta; | |
if (cp._hasInstanceMeta(this, propertyName)) { | |
meta = cp._instanceMeta(this, propertyName); | |
meta.setValue(cp.resetValue(meta.getValue())); | |
} else { | |
meta = cp._instanceMeta(this, propertyName); | |
} | |
if (cp.options.initialize) { | |
cp.options.initialize.call(this, meta.getValue(), { property: cp, propertyName: propertyName }, meta.sugarMeta); | |
} | |
} | |
function partiallyRecomputeFor(obj, dependentKey) { | |
if (arrayBracketPattern.test(dependentKey)) { | |
return false; | |
} | |
var value = get(obj, dependentKey); | |
return EmberArray.detect(value); | |
} | |
function ReduceComputedPropertyInstanceMeta(context, propertyName, initialValue) { | |
this.context = context; | |
this.propertyName = propertyName; | |
this.cache = metaFor(context).cache; | |
this.dependentArrays = {}; | |
this.sugarMeta = {}; | |
this.initialValue = initialValue; | |
} | |
ReduceComputedPropertyInstanceMeta.prototype = { | |
getValue: function () { | |
var value = cacheGet(this.cache, this.propertyName); | |
if (value !== undefined) { | |
return value; | |
} else { | |
return this.initialValue; | |
} | |
}, | |
setValue: function(newValue, triggerObservers) { | |
// This lets sugars force a recomputation, handy for very simple | |
// implementations of eg max. | |
if (newValue === cacheGet(this.cache, this.propertyName)) { | |
return; | |
} | |
if (triggerObservers) { | |
propertyWillChange(this.context, this.propertyName); | |
} | |
if (newValue === undefined) { | |
cacheRemove(this.cache, this.propertyName); | |
} else { | |
cacheSet(this.cache, this.propertyName, newValue); | |
} | |
if (triggerObservers) { | |
propertyDidChange(this.context, this.propertyName); | |
} | |
} | |
}; | |
/** | |
A computed property whose dependent keys are arrays and which is updated with | |
"one at a time" semantics. | |
@class ReduceComputedProperty | |
@namespace Ember | |
@extends Ember.ComputedProperty | |
@constructor | |
*/ | |
__exports__.ReduceComputedProperty = ReduceComputedProperty; | |
// TODO: default export | |
function ReduceComputedProperty(options) { | |
var cp = this; | |
this.options = options; | |
this._dependentKeys = null; | |
// A map of dependentKey -> [itemProperty, ...] that tracks what properties of | |
// items in the array we must track to update this property. | |
this._itemPropertyKeys = {}; | |
this._previousItemPropertyKeys = {}; | |
this.readOnly(); | |
this.cacheable(); | |
this.recomputeOnce = function(propertyName) { | |
// What we really want to do is coalesce by <cp, propertyName>. | |
// We need a form of `scheduleOnce` that accepts an arbitrary token to | |
// coalesce by, in addition to the target and method. | |
run.once(this, recompute, propertyName); | |
}; | |
var recompute = function(propertyName) { | |
var dependentKeys = cp._dependentKeys, | |
meta = cp._instanceMeta(this, propertyName), | |
callbacks = cp._callbacks(); | |
reset.call(this, cp, propertyName); | |
meta.dependentArraysObserver.suspendArrayObservers(function () { | |
forEach(cp._dependentKeys, function (dependentKey) { | |
Ember.assert( | |
"dependent array " + dependentKey + " must be an `Ember.Array`. " + | |
"If you are not extending arrays, you will need to wrap native arrays with `Ember.A`", | |
!(isArray(get(this, dependentKey)) && !EmberArray.detect(get(this, dependentKey)))); | |
if (!partiallyRecomputeFor(this, dependentKey)) { return; } | |
var dependentArray = get(this, dependentKey), | |
previousDependentArray = meta.dependentArrays[dependentKey]; | |
if (dependentArray === previousDependentArray) { | |
// The array may be the same, but our item property keys may have | |
// changed, so we set them up again. We can't easily tell if they've | |
// changed: the array may be the same object, but with different | |
// contents. | |
if (cp._previousItemPropertyKeys[dependentKey]) { | |
delete cp._previousItemPropertyKeys[dependentKey]; | |
meta.dependentArraysObserver.setupPropertyObservers(dependentKey, cp._itemPropertyKeys[dependentKey]); | |
} | |
} else { | |
meta.dependentArrays[dependentKey] = dependentArray; | |
if (previousDependentArray) { | |
meta.dependentArraysObserver.teardownObservers(previousDependentArray, dependentKey); | |
} | |
if (dependentArray) { | |
meta.dependentArraysObserver.setupObservers(dependentArray, dependentKey); | |
} | |
} | |
}, this); | |
}, this); | |
forEach(cp._dependentKeys, function(dependentKey) { | |
if (!partiallyRecomputeFor(this, dependentKey)) { return; } | |
var dependentArray = get(this, dependentKey); | |
if (dependentArray) { | |
addItems.call(this, dependentArray, callbacks, cp, propertyName, meta); | |
} | |
}, this); | |
}; | |
this.func = function (propertyName) { | |
Ember.assert("Computed reduce values require at least one dependent key", cp._dependentKeys); | |
recompute.call(this, propertyName); | |
return cp._instanceMeta(this, propertyName).getValue(); | |
}; | |
} | |
ReduceComputedProperty.prototype = o_create(ComputedProperty.prototype); | |
function defaultCallback(computedValue) { | |
return computedValue; | |
} | |
ReduceComputedProperty.prototype._callbacks = function () { | |
if (!this.callbacks) { | |
var options = this.options; | |
this.callbacks = { | |
removedItem: options.removedItem || defaultCallback, | |
addedItem: options.addedItem || defaultCallback | |
}; | |
} | |
return this.callbacks; | |
}; | |
ReduceComputedProperty.prototype._hasInstanceMeta = function (context, propertyName) { | |
return !!metaFor(context).cacheMeta[propertyName]; | |
}; | |
ReduceComputedProperty.prototype._instanceMeta = function (context, propertyName) { | |
var cacheMeta = metaFor(context).cacheMeta, | |
meta = cacheMeta[propertyName]; | |
if (!meta) { | |
meta = cacheMeta[propertyName] = new ReduceComputedPropertyInstanceMeta(context, propertyName, this.initialValue()); | |
meta.dependentArraysObserver = new DependentArraysObserver(this._callbacks(), this, meta, context, propertyName, meta.sugarMeta); | |
} | |
return meta; | |
}; | |
ReduceComputedProperty.prototype.initialValue = function () { | |
if (typeof this.options.initialValue === 'function') { | |
return this.options.initialValue(); | |
} | |
else { | |
return this.options.initialValue; | |
} | |
}; | |
ReduceComputedProperty.prototype.resetValue = function (value) { | |
return this.initialValue(); | |
}; | |
ReduceComputedProperty.prototype.itemPropertyKey = function (dependentArrayKey, itemPropertyKey) { | |
this._itemPropertyKeys[dependentArrayKey] = this._itemPropertyKeys[dependentArrayKey] || []; | |
this._itemPropertyKeys[dependentArrayKey].push(itemPropertyKey); | |
}; | |
ReduceComputedProperty.prototype.clearItemPropertyKeys = function (dependentArrayKey) { | |
if (this._itemPropertyKeys[dependentArrayKey]) { | |
this._previousItemPropertyKeys[dependentArrayKey] = this._itemPropertyKeys[dependentArrayKey]; | |
this._itemPropertyKeys[dependentArrayKey] = []; | |
} | |
}; | |
ReduceComputedProperty.prototype.property = function () { | |
var cp = this, | |
args = a_slice.call(arguments), | |
propertyArgs = new Set(), | |
match, | |
dependentArrayKey, | |
itemPropertyKey; | |
forEach(args, function (dependentKey) { | |
if (doubleEachPropertyPattern.test(dependentKey)) { | |
throw new EmberError("Nested @each properties not supported: " + dependentKey); | |
} else if (match = eachPropertyPattern.exec(dependentKey)) { | |
dependentArrayKey = match[1]; | |
var itemPropertyKeyPattern = match[2], | |
addItemPropertyKey = function (itemPropertyKey) { | |
cp.itemPropertyKey(dependentArrayKey, itemPropertyKey); | |
}; | |
expandProperties(itemPropertyKeyPattern, addItemPropertyKey); | |
propertyArgs.add(dependentArrayKey); | |
} else { | |
propertyArgs.add(dependentKey); | |
} | |
}); | |
return ComputedProperty.prototype.property.apply(this, propertyArgs.toArray()); | |
}; | |
/** | |
Creates a computed property which operates on dependent arrays and | |
is updated with "one at a time" semantics. When items are added or | |
removed from the dependent array(s) a reduce computed only operates | |
on the change instead of re-evaluating the entire array. | |
If there are more than one arguments the first arguments are | |
considered to be dependent property keys. The last argument is | |
required to be an options object. The options object can have the | |
following four properties: | |
`initialValue` - A value or function that will be used as the initial | |
value for the computed. If this property is a function the result of calling | |
the function will be used as the initial value. This property is required. | |
`initialize` - An optional initialize function. Typically this will be used | |
to set up state on the instanceMeta object. | |
`removedItem` - A function that is called each time an element is removed | |
from the array. | |
`addedItem` - A function that is called each time an element is added to | |
the array. | |
The `initialize` function has the following signature: | |
```javascript | |
function (initialValue, changeMeta, instanceMeta) | |
``` | |
`initialValue` - The value of the `initialValue` property from the | |
options object. | |
`changeMeta` - An object which contains meta information about the | |
computed. It contains the following properties: | |
- `property` the computed property | |
- `propertyName` the name of the property on the object | |
`instanceMeta` - An object that can be used to store meta | |
information needed for calculating your computed. For example a | |
unique computed might use this to store the number of times a given | |
element is found in the dependent array. | |
The `removedItem` and `addedItem` functions both have the following signature: | |
```javascript | |
function (accumulatedValue, item, changeMeta, instanceMeta) | |
``` | |
`accumulatedValue` - The value returned from the last time | |
`removedItem` or `addedItem` was called or `initialValue`. | |
`item` - the element added or removed from the array | |
`changeMeta` - An object which contains meta information about the | |
change. It contains the following properties: | |
- `property` the computed property | |
- `propertyName` the name of the property on the object | |
- `index` the index of the added or removed item | |
- `item` the added or removed item: this is exactly the same as | |
the second arg | |
- `arrayChanged` the array that triggered the change. Can be | |
useful when depending on multiple arrays. | |
For property changes triggered on an item property change (when | |
depKey is something like `[email protected]`), | |
`changeMeta` will also contain the following property: | |
- `previousValues` an object whose keys are the properties that changed on | |
the item, and whose values are the item's previous values. | |
`previousValues` is important Ember coalesces item property changes via | |
Ember.run.once. This means that by the time removedItem gets called, item has | |
the new values, but you may need the previous value (eg for sorting & | |
filtering). | |
`instanceMeta` - An object that can be used to store meta | |
information needed for calculating your computed. For example a | |
unique computed might use this to store the number of times a given | |
element is found in the dependent array. | |
The `removedItem` and `addedItem` functions should return the accumulated | |
value. It is acceptable to not return anything (ie return undefined) | |
to invalidate the computation. This is generally not a good idea for | |
arrayComputed but it's used in eg max and min. | |
Note that observers will be fired if either of these functions return a value | |
that differs from the accumulated value. When returning an object that | |
mutates in response to array changes, for example an array that maps | |
everything from some other array (see `Ember.computed.map`), it is usually | |
important that the *same* array be returned to avoid accidentally triggering observers. | |
Example | |
```javascript | |
Ember.computed.max = function (dependentKey) { | |
return Ember.reduceComputed(dependentKey, { | |
initialValue: -Infinity, | |
addedItem: function (accumulatedValue, item, changeMeta, instanceMeta) { | |
return Math.max(accumulatedValue, item); | |
}, | |
removedItem: function (accumulatedValue, item, changeMeta, instanceMeta) { | |
if (item < accumulatedValue) { | |
return accumulatedValue; | |
} | |
} | |
}); | |
}; | |
``` | |
Dependent keys may refer to `@this` to observe changes to the object itself, | |
which must be array-like, rather than a property of the object. This is | |
mostly useful for array proxies, to ensure objects are retrieved via | |
`objectAtContent`. This is how you could sort items by properties defined on an item controller. | |
Example | |
```javascript | |
App.PeopleController = Ember.ArrayController.extend({ | |
itemController: 'person', | |
sortedPeople: Ember.computed.sort('@[email protected]', function(personA, personB) { | |
// `reversedName` isn't defined on Person, but we have access to it via | |
// the item controller App.PersonController. If we'd used | |
// `[email protected]` above, we would be getting the objects | |
// directly and not have access to `reversedName`. | |
// | |
var reversedNameA = get(personA, 'reversedName'), | |
reversedNameB = get(personB, 'reversedName'); | |
return Ember.compare(reversedNameA, reversedNameB); | |
}) | |
}); | |
App.PersonController = Ember.ObjectController.extend({ | |
reversedName: function () { | |
return reverse(get(this, 'name')); | |
}.property('name') | |
}) | |
``` | |
Dependent keys whose values are not arrays are treated as regular | |
dependencies: when they change, the computed property is completely | |
recalculated. It is sometimes useful to have dependent arrays with similar | |
semantics. Dependent keys which end in `.[]` do not use "one at a time" | |
semantics. When an item is added or removed from such a dependency, the | |
computed property is completely recomputed. | |
When the computed property is completely recomputed, the `accumulatedValue` | |
is discarded, it starts with `initialValue` again, and each item is passed | |
to `addedItem` in turn. | |
Example | |
```javascript | |
Ember.Object.extend({ | |
// When `string` is changed, `computed` is completely recomputed. | |
string: 'a string', | |
// When an item is added to `array`, `addedItem` is called. | |
array: [], | |
// When an item is added to `anotherArray`, `computed` is completely | |
// recomputed. | |
anotherArray: [], | |
computed: Ember.reduceComputed('string', 'array', 'anotherArray.[]', { | |
addedItem: addedItemCallback, | |
removedItem: removedItemCallback | |
}) | |
}); | |
``` | |
@method reduceComputed | |
@for Ember | |
@param {String} [dependentKeys*] | |
@param {Object} options | |
@return {Ember.ComputedProperty} | |
*/ | |
function reduceComputed(options) { | |
var args; | |
if (arguments.length > 1) { | |
args = a_slice.call(arguments, 0, -1); | |
options = a_slice.call(arguments, -1)[0]; | |
} | |
if (typeof options !== "object") { | |
throw new EmberError("Reduce Computed Property declared without an options hash"); | |
} | |
if (!('initialValue' in options)) { | |
throw new EmberError("Reduce Computed Property declared without an initial value"); | |
} | |
var cp = new ReduceComputedProperty(options); | |
if (args) { | |
cp.property.apply(cp, args); | |
} | |
return cp; | |
} | |
__exports__.reduceComputed = reduceComputed; | |
}); | |
define("ember-runtime/computed/reduce_computed_macros", | |
["ember-metal/core","ember-metal/merge","ember-metal/property_get","ember-metal/property_set","ember-metal/utils","ember-metal/error","ember-metal/enumerable_utils","ember-metal/run_loop","ember-metal/observer","ember-runtime/computed/array_computed","ember-runtime/computed/reduce_computed","ember-runtime/system/object_proxy","ember-runtime/system/subarray","ember-runtime/keys","ember-runtime/compare","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __dependency6__, __dependency7__, __dependency8__, __dependency9__, __dependency10__, __dependency11__, __dependency12__, __dependency13__, __dependency14__, __dependency15__, __exports__) { | |
"use strict"; | |
/** | |
@module ember | |
@submodule ember-runtime | |
*/ | |
var Ember = __dependency1__["default"]; | |
// Ember.assert | |
var merge = __dependency2__["default"]; | |
var get = __dependency3__.get; | |
var set = __dependency4__.set; | |
var isArray = __dependency5__.isArray; | |
var guidFor = __dependency5__.guidFor; | |
var EmberError = __dependency6__["default"]; | |
var EnumerableUtils = __dependency7__["default"]; | |
var run = __dependency8__["default"]; | |
var addObserver = __dependency9__.addObserver; | |
var arrayComputed = __dependency10__.arrayComputed; | |
var reduceComputed = __dependency11__.reduceComputed; | |
var ObjectProxy = __dependency12__["default"]; | |
var SubArray = __dependency13__["default"]; | |
var keys = __dependency14__["default"]; | |
var compare = __dependency15__["default"]; | |
var a_slice = [].slice; | |
var forEach = EnumerableUtils.forEach; | |
var SearchProxy; | |
/** | |
A computed property that returns the sum of the value | |
in the dependent array. | |
@method computed.sum | |
@for Ember | |
@param {String} dependentKey | |
@return {Ember.ComputedProperty} computes the sum of all values in the dependentKey's array | |
@since 1.4.0 | |
*/ | |
function sum(dependentKey){ | |
return reduceComputed(dependentKey, { | |
initialValue: 0, | |
addedItem: function(accumulatedValue, item, changeMeta, instanceMeta){ | |
return accumulatedValue + item; | |
}, | |
removedItem: function(accumulatedValue, item, changeMeta, instanceMeta){ | |
return accumulatedValue - item; | |
} | |
}); | |
} | |
__exports__.sum = sum;/** | |
A computed property that calculates the maximum value in the | |
dependent array. This will return `-Infinity` when the dependent | |
array is empty. | |
```javascript | |
App.Person = Ember.Object.extend({ | |
childAges: Ember.computed.mapBy('children', 'age'), | |
maxChildAge: Ember.computed.max('childAges') | |
}); | |
var lordByron = App.Person.create({children: []}); | |
lordByron.get('maxChildAge'); // -Infinity | |
lordByron.get('children').pushObject({ | |
name: 'Augusta Ada Byron', age: 7 | |
}); | |
lordByron.get('maxChildAge'); // 7 | |
lordByron.get('children').pushObjects([{ | |
name: 'Allegra Byron', | |
age: 5 | |
}, { | |
name: 'Elizabeth Medora Leigh', | |
age: 8 | |
}]); | |
lordByron.get('maxChildAge'); // 8 | |
``` | |
@method computed.max | |
@for Ember | |
@param {String} dependentKey | |
@return {Ember.ComputedProperty} computes the largest value in the dependentKey's array | |
*/ | |
function max (dependentKey) { | |
return reduceComputed(dependentKey, { | |
initialValue: -Infinity, | |
addedItem: function (accumulatedValue, item, changeMeta, instanceMeta) { | |
return Math.max(accumulatedValue, item); | |
}, | |
removedItem: function (accumulatedValue, item, changeMeta, instanceMeta) { | |
if (item < accumulatedValue) { | |
return accumulatedValue; | |
} | |
} | |
}); | |
} | |
__exports__.max = max;/** | |
A computed property that calculates the minimum value in the | |
dependent array. This will return `Infinity` when the dependent | |
array is empty. | |
```javascript | |
App.Person = Ember.Object.extend({ | |
childAges: Ember.computed.mapBy('children', 'age'), | |
minChildAge: Ember.computed.min('childAges') | |
}); | |
var lordByron = App.Person.create({children: []}); | |
lordByron.get('minChildAge'); // Infinity | |
lordByron.get('children').pushObject({ | |
name: 'Augusta Ada Byron', age: 7 | |
}); | |
lordByron.get('minChildAge'); // 7 | |
lordByron.get('children').pushObjects([{ | |
name: 'Allegra Byron', | |
age: 5 | |
}, { | |
name: 'Elizabeth Medora Leigh', | |
age: 8 | |
}]); | |
lordByron.get('minChildAge'); // 5 | |
``` | |
@method computed.min | |
@for Ember | |
@param {String} dependentKey | |
@return {Ember.ComputedProperty} computes the smallest value in the dependentKey's array | |
*/ | |
function min(dependentKey) { | |
return reduceComputed(dependentKey, { | |
initialValue: Infinity, | |
addedItem: function (accumulatedValue, item, changeMeta, instanceMeta) { | |
return Math.min(accumulatedValue, item); | |
}, | |
removedItem: function (accumulatedValue, item, changeMeta, instanceMeta) { | |
if (item > accumulatedValue) { | |
return accumulatedValue; | |
} | |
} | |
}); | |
} | |
__exports__.min = min;/** | |
Returns an array mapped via the callback | |
The callback method you provide should have the following signature. | |
`item` is the current item in the iteration. | |
```javascript | |
function(item); | |
``` | |
Example | |
```javascript | |
App.Hamster = Ember.Object.extend({ | |
excitingChores: Ember.computed.map('chores', function(chore) { | |
return chore.toUpperCase() + '!'; | |
}) | |
}); | |
var hamster = App.Hamster.create({ | |
chores: ['clean', 'write more unit tests'] | |
}); | |
hamster.get('excitingChores'); // ['CLEAN!', 'WRITE MORE UNIT TESTS!'] | |
``` | |
@method computed.map | |
@for Ember | |
@param {String} dependentKey | |
@param {Function} callback | |
@return {Ember.ComputedProperty} an array mapped via the callback | |
*/ | |
function map(dependentKey, callback) { | |
var options = { | |
addedItem: function(array, item, changeMeta, instanceMeta) { | |
var mapped = callback.call(this, item); | |
array.insertAt(changeMeta.index, mapped); | |
return array; | |
}, | |
removedItem: function(array, item, changeMeta, instanceMeta) { | |
array.removeAt(changeMeta.index, 1); | |
return array; | |
} | |
}; | |
return arrayComputed(dependentKey, options); | |
} | |
__exports__.map = map;/** | |
Returns an array mapped to the specified key. | |
```javascript | |
App.Person = Ember.Object.extend({ | |
childAges: Ember.computed.mapBy('children', 'age') | |
}); | |
var lordByron = App.Person.create({children: []}); | |
lordByron.get('childAges'); // [] | |
lordByron.get('children').pushObject({name: 'Augusta Ada Byron', age: 7}); | |
lordByron.get('childAges'); // [7] | |
lordByron.get('children').pushObjects([{ | |
name: 'Allegra Byron', | |
age: 5 | |
}, { | |
name: 'Elizabeth Medora Leigh', | |
age: 8 | |
}]); | |
lordByron.get('childAges'); // [7, 5, 8] | |
``` | |
@method computed.mapBy | |
@for Ember | |
@param {String} dependentKey | |
@param {String} propertyKey | |
@return {Ember.ComputedProperty} an array mapped to the specified key | |
*/ | |
function mapBy (dependentKey, propertyKey) { | |
var callback = function(item) { return get(item, propertyKey); }; | |
return map(dependentKey + '.@each.' + propertyKey, callback); | |
} | |
__exports__.mapBy = mapBy;/** | |
@method computed.mapProperty | |
@for Ember | |
@deprecated Use `Ember.computed.mapBy` instead | |
@param dependentKey | |
@param propertyKey | |
*/ | |
var mapProperty = mapBy; | |
__exports__.mapProperty = mapProperty; | |
/** | |
Filters the array by the callback. | |
The callback method you provide should have the following signature. | |
`item` is the current item in the iteration. | |
```javascript | |
function(item); | |
``` | |
```javascript | |
App.Hamster = Ember.Object.extend({ | |
remainingChores: Ember.computed.filter('chores', function(chore) { | |
return !chore.done; | |
}) | |
}); | |
var hamster = App.Hamster.create({chores: [ | |
{name: 'cook', done: true}, | |
{name: 'clean', done: true}, | |
{name: 'write more unit tests', done: false} | |
]}); | |
hamster.get('remainingChores'); // [{name: 'write more unit tests', done: false}] | |
``` | |
@method computed.filter | |
@for Ember | |
@param {String} dependentKey | |
@param {Function} callback | |
@return {Ember.ComputedProperty} the filtered array | |
*/ | |
function filter(dependentKey, callback) { | |
var options = { | |
initialize: function (array, changeMeta, instanceMeta) { | |
instanceMeta.filteredArrayIndexes = new SubArray(); | |
}, | |
addedItem: function(array, item, changeMeta, instanceMeta) { | |
var match = !!callback.call(this, item), | |
filterIndex = instanceMeta.filteredArrayIndexes.addItem(changeMeta.index, match); | |
if (match) { | |
array.insertAt(filterIndex, item); | |
} | |
return array; | |
}, | |
removedItem: function(array, item, changeMeta, instanceMeta) { | |
var filterIndex = instanceMeta.filteredArrayIndexes.removeItem(changeMeta.index); | |
if (filterIndex > -1) { | |
array.removeAt(filterIndex); | |
} | |
return array; | |
} | |
}; | |
return arrayComputed(dependentKey, options); | |
} | |
__exports__.filter = filter;/** | |
Filters the array by the property and value | |
```javascript | |
App.Hamster = Ember.Object.extend({ | |
remainingChores: Ember.computed.filterBy('chores', 'done', false) | |
}); | |
var hamster = App.Hamster.create({chores: [ | |
{name: 'cook', done: true}, | |
{name: 'clean', done: true}, | |
{name: 'write more unit tests', done: false} | |
]}); | |
hamster.get('remainingChores'); // [{name: 'write more unit tests', done: false}] | |
``` | |
@method computed.filterBy | |
@for Ember | |
@param {String} dependentKey | |
@param {String} propertyKey | |
@param {*} value | |
@return {Ember.ComputedProperty} the filtered array | |
*/ | |
function filterBy (dependentKey, propertyKey, value) { | |
var callback; | |
if (arguments.length === 2) { | |
callback = function(item) { | |
return get(item, propertyKey); | |
}; | |
} else { | |
callback = function(item) { | |
return get(item, propertyKey) === value; | |
}; | |
} | |
return filter(dependentKey + '.@each.' + propertyKey, callback); | |
} | |
__exports__.filterBy = filterBy;/** | |
@method computed.filterProperty | |
@for Ember | |
@param dependentKey | |
@param propertyKey | |
@param value | |
@deprecated Use `Ember.computed.filterBy` instead | |
*/ | |
var filterProperty = filterBy; | |
__exports__.filterProperty = filterProperty; | |
/** | |
A computed property which returns a new array with all the unique | |
elements from one or more dependent arrays. | |
Example | |
```javascript | |
App.Hamster = Ember.Object.extend({ | |
uniqueFruits: Ember.computed.uniq('fruits') | |
}); | |
var hamster = App.Hamster.create({fruits: [ | |
'banana', | |
'grape', | |
'kale', | |
'banana' | |
]}); | |
hamster.get('uniqueFruits'); // ['banana', 'grape', 'kale'] | |
``` | |
@method computed.uniq | |
@for Ember | |
@param {String} propertyKey* | |
@return {Ember.ComputedProperty} computes a new array with all the | |
unique elements from the dependent array | |
*/ | |
function uniq() { | |
var args = a_slice.call(arguments); | |
args.push({ | |
initialize: function(array, changeMeta, instanceMeta) { | |
instanceMeta.itemCounts = {}; | |
}, | |
addedItem: function(array, item, changeMeta, instanceMeta) { | |
var guid = guidFor(item); | |
if (!instanceMeta.itemCounts[guid]) { | |
instanceMeta.itemCounts[guid] = 1; | |
} else { | |
++instanceMeta.itemCounts[guid]; | |
} | |
array.addObject(item); | |
return array; | |
}, | |
removedItem: function(array, item, _, instanceMeta) { | |
var guid = guidFor(item), | |
itemCounts = instanceMeta.itemCounts; | |
if (--itemCounts[guid] === 0) { | |
array.removeObject(item); | |
} | |
return array; | |
} | |
}); | |
return arrayComputed.apply(null, args); | |
} | |
__exports__.uniq = uniq;/** | |
Alias for [Ember.computed.uniq](/api/#method_computed_uniq). | |
@method computed.union | |
@for Ember | |
@param {String} propertyKey* | |
@return {Ember.ComputedProperty} computes a new array with all the | |
unique elements from the dependent array | |
*/ | |
var union = uniq; | |
__exports__.union = union; | |
/** | |
A computed property which returns a new array with all the duplicated | |
elements from two or more dependent arrays. | |
Example | |
```javascript | |
var obj = Ember.Object.createWithMixins({ | |
adaFriends: ['Charles Babbage', 'John Hobhouse', 'William King', 'Mary Somerville'], | |
charlesFriends: ['William King', 'Mary Somerville', 'Ada Lovelace', 'George Peacock'], | |
friendsInCommon: Ember.computed.intersect('adaFriends', 'charlesFriends') | |
}); | |
obj.get('friendsInCommon'); // ['William King', 'Mary Somerville'] | |
``` | |
@method computed.intersect | |
@for Ember | |
@param {String} propertyKey* | |
@return {Ember.ComputedProperty} computes a new array with all the | |
duplicated elements from the dependent arrays | |
*/ | |
function intersect() { | |
var getDependentKeyGuids = function (changeMeta) { | |
return EnumerableUtils.map(changeMeta.property._dependentKeys, function (dependentKey) { | |
return guidFor(dependentKey); | |
}); | |
}; | |
var args = a_slice.call(arguments); | |
args.push({ | |
initialize: function (array, changeMeta, instanceMeta) { | |
instanceMeta.itemCounts = {}; | |
}, | |
addedItem: function(array, item, changeMeta, instanceMeta) { | |
var itemGuid = guidFor(item), | |
dependentGuids = getDependentKeyGuids(changeMeta), | |
dependentGuid = guidFor(changeMeta.arrayChanged), | |
numberOfDependentArrays = changeMeta.property._dependentKeys.length, | |
itemCounts = instanceMeta.itemCounts; | |
if (!itemCounts[itemGuid]) { itemCounts[itemGuid] = {}; } | |
if (itemCounts[itemGuid][dependentGuid] === undefined) { itemCounts[itemGuid][dependentGuid] = 0; } | |
if (++itemCounts[itemGuid][dependentGuid] === 1 && | |
numberOfDependentArrays === keys(itemCounts[itemGuid]).length) { | |
array.addObject(item); | |
} | |
return array; | |
}, | |
removedItem: function(array, item, changeMeta, instanceMeta) { | |
var itemGuid = guidFor(item), | |
dependentGuids = getDependentKeyGuids(changeMeta), | |
dependentGuid = guidFor(changeMeta.arrayChanged), | |
numberOfDependentArrays = changeMeta.property._dependentKeys.length, | |
numberOfArraysItemAppearsIn, | |
itemCounts = instanceMeta.itemCounts; | |
if (itemCounts[itemGuid][dependentGuid] === undefined) { itemCounts[itemGuid][dependentGuid] = 0; } | |
if (--itemCounts[itemGuid][dependentGuid] === 0) { | |
delete itemCounts[itemGuid][dependentGuid]; | |
numberOfArraysItemAppearsIn = keys(itemCounts[itemGuid]).length; | |
if (numberOfArraysItemAppearsIn === 0) { | |
delete itemCounts[itemGuid]; | |
} | |
array.removeObject(item); | |
} | |
return array; | |
} | |
}); | |
return arrayComputed.apply(null, args); | |
} | |
__exports__.intersect = intersect;/** | |
A computed property which returns a new array with all the | |
properties from the first dependent array that are not in the second | |
dependent array. | |
Example | |
```javascript | |
App.Hamster = Ember.Object.extend({ | |
likes: ['banana', 'grape', 'kale'], | |
wants: Ember.computed.setDiff('likes', 'fruits') | |
}); | |
var hamster = App.Hamster.create({fruits: [ | |
'grape', | |
'kale', | |
]}); | |
hamster.get('wants'); // ['banana'] | |
``` | |
@method computed.setDiff | |
@for Ember | |
@param {String} setAProperty | |
@param {String} setBProperty | |
@return {Ember.ComputedProperty} computes a new array with all the | |
items from the first dependent array that are not in the second | |
dependent array | |
*/ | |
function setDiff(setAProperty, setBProperty) { | |
if (arguments.length !== 2) { | |
throw new EmberError("setDiff requires exactly two dependent arrays."); | |
} | |
return arrayComputed(setAProperty, setBProperty, { | |
addedItem: function (array, item, changeMeta, instanceMeta) { | |
var setA = get(this, setAProperty), | |
setB = get(this, setBProperty); | |
if (changeMeta.arrayChanged === setA) { | |
if (!setB.contains(item)) { | |
array.addObject(item); | |
} | |
} else { | |
array.removeObject(item); | |
} | |
return array; | |
}, | |
removedItem: function (array, item, changeMeta, instanceMeta) { | |
var setA = get(this, setAProperty), | |
setB = get(this, setBProperty); | |
if (changeMeta.arrayChanged === setB) { | |
if (setA.contains(item)) { | |
array.addObject(item); | |
} | |
} else { | |
array.removeObject(item); | |
} | |
return array; | |
} | |
}); | |
} | |
__exports__.setDiff = setDiff;function binarySearch(array, item, low, high) { | |
var mid, midItem, res, guidMid, guidItem; | |
if (arguments.length < 4) { high = get(array, 'length'); } | |
if (arguments.length < 3) { low = 0; } | |
if (low === high) { | |
return low; | |
} | |
mid = low + Math.floor((high - low) / 2); | |
midItem = array.objectAt(mid); | |
guidMid = _guidFor(midItem); | |
guidItem = _guidFor(item); | |
if (guidMid === guidItem) { | |
return mid; | |
} | |
res = this.order(midItem, item); | |
if (res === 0) { | |
res = guidMid < guidItem ? -1 : 1; | |
} | |
if (res < 0) { | |
return this.binarySearch(array, item, mid+1, high); | |
} else if (res > 0) { | |
return this.binarySearch(array, item, low, mid); | |
} | |
return mid; | |
function _guidFor(item) { | |
if (SearchProxy.detectInstance(item)) { | |
return guidFor(get(item, 'content')); | |
} | |
return guidFor(item); | |
} | |
} | |
var SearchProxy = ObjectProxy.extend(); | |
/** | |
A computed property which returns a new array with all the | |
properties from the first dependent array sorted based on a property | |
or sort function. | |
The callback method you provide should have the following signature: | |
```javascript | |
function(itemA, itemB); | |
``` | |
- `itemA` the first item to compare. | |
- `itemB` the second item to compare. | |
This function should return negative number (e.g. `-1`) when `itemA` should come before | |
`itemB`. It should return positive number (e.g. `1`) when `itemA` should come after | |
`itemB`. If the `itemA` and `itemB` are equal this function should return `0`. | |
Therefore, if this function is comparing some numeric values, simple `itemA - itemB` or | |
`itemA.get( 'foo' ) - itemB.get( 'foo' )` can be used instead of series of `if`. | |
Example | |
```javascript | |
var ToDoList = Ember.Object.extend({ | |
// using standard ascending sort | |
todosSorting: ['name'], | |
sortedTodos: Ember.computed.sort('todos', 'todosSorting'), | |
// using descending sort | |
todosSortingDesc: ['name:desc'], | |
sortedTodosDesc: Ember.computed.sort('todos', 'todosSortingDesc'), | |
// using a custom sort function | |
priorityTodos: Ember.computed.sort('todos', function(a, b){ | |
if (a.priority > b.priority) { | |
return 1; | |
} else if (a.priority < b.priority) { | |
return -1; | |
} | |
return 0; | |
}), | |
}); | |
var todoList = ToDoList.create({todos: [ | |
{name: 'Unit Test', priority: 2}, | |
{name: 'Documentation', priority: 3}, | |
{name: 'Release', priority: 1} | |
]}); | |
todoList.get('sortedTodos'); // [{name:'Documentation', priority:3}, {name:'Release', priority:1}, {name:'Unit Test', priority:2}] | |
todoList.get('sortedTodosDesc'); // [{name:'Unit Test', priority:2}, {name:'Release', priority:1}, {name:'Documentation', priority:3}] | |
todoList.get('priorityTodos'); // [{name:'Release', priority:1}, {name:'Unit Test', priority:2}, {name:'Documentation', priority:3}] | |
``` | |
@method computed.sort | |
@for Ember | |
@param {String} dependentKey | |
@param {String or Function} sortDefinition a dependent key to an | |
array of sort properties (add `:desc` to the arrays sort properties to sort descending) or a function to use when sorting | |
@return {Ember.ComputedProperty} computes a new sorted array based | |
on the sort property array or callback function | |
*/ | |
function sort(itemsKey, sortDefinition) { | |
Ember.assert("Ember.computed.sort requires two arguments: an array key to sort and either a sort properties key or sort function", arguments.length === 2); | |
var initFn, sortPropertiesKey; | |
if (typeof sortDefinition === 'function') { | |
initFn = function (array, changeMeta, instanceMeta) { | |
instanceMeta.order = sortDefinition; | |
instanceMeta.binarySearch = binarySearch; | |
}; | |
} else { | |
sortPropertiesKey = sortDefinition; | |
initFn = function (array, changeMeta, instanceMeta) { | |
function setupSortProperties() { | |
var sortPropertyDefinitions = get(this, sortPropertiesKey), | |
sortProperty, | |
sortProperties = instanceMeta.sortProperties = [], | |
sortPropertyAscending = instanceMeta.sortPropertyAscending = {}, | |
idx, | |
asc; | |
Ember.assert("Cannot sort: '" + sortPropertiesKey + "' is not an array.", isArray(sortPropertyDefinitions)); | |
changeMeta.property.clearItemPropertyKeys(itemsKey); | |
forEach(sortPropertyDefinitions, function (sortPropertyDefinition) { | |
if ((idx = sortPropertyDefinition.indexOf(':')) !== -1) { | |
sortProperty = sortPropertyDefinition.substring(0, idx); | |
asc = sortPropertyDefinition.substring(idx+1).toLowerCase() !== 'desc'; | |
} else { | |
sortProperty = sortPropertyDefinition; | |
asc = true; | |
} | |
sortProperties.push(sortProperty); | |
sortPropertyAscending[sortProperty] = asc; | |
changeMeta.property.itemPropertyKey(itemsKey, sortProperty); | |
}); | |
sortPropertyDefinitions.addObserver('@each', this, updateSortPropertiesOnce); | |
} | |
function updateSortPropertiesOnce() { | |
run.once(this, updateSortProperties, changeMeta.propertyName); | |
} | |
function updateSortProperties(propertyName) { | |
setupSortProperties.call(this); | |
changeMeta.property.recomputeOnce.call(this, propertyName); | |
} | |
addObserver(this, sortPropertiesKey, updateSortPropertiesOnce); | |
setupSortProperties.call(this); | |
instanceMeta.order = function (itemA, itemB) { | |
var isProxy = itemB instanceof SearchProxy, | |
sortProperty, result, asc; | |
for (var i = 0; i < this.sortProperties.length; ++i) { | |
sortProperty = this.sortProperties[i]; | |
result = compare(get(itemA, sortProperty), isProxy ? itemB[sortProperty] : get(itemB, sortProperty)); | |
if (result !== 0) { | |
asc = this.sortPropertyAscending[sortProperty]; | |
return asc ? result : (-1 * result); | |
} | |
} | |
return 0; | |
}; | |
instanceMeta.binarySearch = binarySearch; | |
}; | |
} | |
return arrayComputed(itemsKey, { | |
initialize: initFn, | |
addedItem: function (array, item, changeMeta, instanceMeta) { | |
var index = instanceMeta.binarySearch(array, item); | |
array.insertAt(index, item); | |
return array; | |
}, | |
removedItem: function (array, item, changeMeta, instanceMeta) { | |
var proxyProperties, index, searchItem; | |
if (changeMeta.previousValues) { | |
proxyProperties = merge({ content: item }, changeMeta.previousValues); | |
searchItem = SearchProxy.create(proxyProperties); | |
} else { | |
searchItem = item; | |
} | |
index = instanceMeta.binarySearch(array, searchItem); | |
array.removeAt(index); | |
return array; | |
} | |
}); | |
} | |
__exports__.sort = sort; | |
}); | |
define("ember-runtime/controllers/array_controller", | |
["ember-metal/core","ember-metal/property_get","ember-metal/property_set","ember-metal/enumerable_utils","ember-runtime/system/array_proxy","ember-runtime/mixins/sortable","ember-runtime/controllers/controller","ember-metal/computed","ember-metal/error","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __dependency6__, __dependency7__, __dependency8__, __dependency9__, __exports__) { | |
"use strict"; | |
/** | |
@module ember | |
@submodule ember-runtime | |
*/ | |
var Ember = __dependency1__["default"]; | |
var get = __dependency2__.get; | |
var set = __dependency3__.set; | |
var EnumerableUtils = __dependency4__["default"]; | |
var ArrayProxy = __dependency5__["default"]; | |
var SortableMixin = __dependency6__["default"]; | |
var ControllerMixin = __dependency7__.ControllerMixin; | |
var computed = __dependency8__.computed; | |
var EmberError = __dependency9__["default"]; | |
var forEach = EnumerableUtils.forEach; | |
var replace = EnumerableUtils.replace; | |
/** | |
`Ember.ArrayController` provides a way for you to publish a collection of | |
objects so that you can easily bind to the collection from a Handlebars | |
`#each` helper, an `Ember.CollectionView`, or other controllers. | |
The advantage of using an `ArrayController` is that you only have to set up | |
your view bindings once; to change what's displayed, simply swap out the | |
`model` 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 `model` property: | |
```javascript | |
MyApp.listController = Ember.ArrayController.create(); | |
$.get('people.json', function(data) { | |
MyApp.listController.set('model', data); | |
}); | |
``` | |
Then, create a view that binds to your new controller: | |
```handlebars | |
{{#each MyApp.listController}} | |
{{firstName}} {{lastName}} | |
{{/each}} | |
``` | |
Although you are binding to the controller, the behavior of this controller | |
is to pass through any methods or properties to the underlying array. This | |
capability comes from `Ember.ArrayProxy`, which this class inherits from. | |
Sometimes you want to display computed properties within the body of an | |
`#each` helper that depend on the underlying items in `model`, but are not | |
present on those items. To do this, set `itemController` to the name of a | |
controller (probably an `ObjectController`) that will wrap each individual item. | |
For example: | |
```handlebars | |
{{#each post in controller}} | |
<li>{{post.title}} ({{post.titleLength}} characters)</li> | |
{{/each}} | |
``` | |
```javascript | |
App.PostsController = Ember.ArrayController.extend({ | |
itemController: 'post' | |
}); | |
App.PostController = Ember.ObjectController.extend({ | |
// the `title` property will be proxied to the underlying post. | |
titleLength: function() { | |
return this.get('title').length; | |
}.property('title') | |
}); | |
``` | |
In some cases it is helpful to return a different `itemController` depending | |
on the particular item. Subclasses can do this by overriding | |
`lookupItemController`. | |
For example: | |
```javascript | |
App.MyArrayController = Ember.ArrayController.extend({ | |
lookupItemController: function( object ) { | |
if (object.get('isSpecial')) { | |
return "special"; // use App.SpecialController | |
} else { | |
return "regular"; // use App.RegularController | |
} | |
} | |
}); | |
``` | |
The itemController instances will have a `parentController` property set to | |
the `ArrayController` instance. | |
@class ArrayController | |
@namespace Ember | |
@extends Ember.ArrayProxy | |
@uses Ember.SortableMixin | |
@uses Ember.ControllerMixin | |
*/ | |
__exports__["default"] = ArrayProxy.extend(ControllerMixin, SortableMixin, { | |
/** | |
The controller used to wrap items, if any. | |
@property itemController | |
@type String | |
@default null | |
*/ | |
itemController: null, | |
/** | |
Return the name of the controller to wrap items, or `null` if items should | |
be returned directly. The default implementation simply returns the | |
`itemController` property, but subclasses can override this method to return | |
different controllers for different objects. | |
For example: | |
```javascript | |
App.MyArrayController = Ember.ArrayController.extend({ | |
lookupItemController: function( object ) { | |
if (object.get('isSpecial')) { | |
return "special"; // use App.SpecialController | |
} else { | |
return "regular"; // use App.RegularController | |
} | |
} | |
}); | |
``` | |
@method lookupItemController | |
@param {Object} object | |
@return {String} | |
*/ | |
lookupItemController: function(object) { | |
return get(this, 'itemController'); | |
}, | |
objectAtContent: function(idx) { | |
var length = get(this, 'length'); | |
var arrangedContent = get(this, 'arrangedContent'); | |
var object = arrangedContent && arrangedContent.objectAt(idx); | |
var controllerClass; | |
if (idx >= 0 && idx < length) { | |
controllerClass = this.lookupItemController(object); | |
if (controllerClass) { | |
return this.controllerAt(idx, object, controllerClass); | |
} | |
} | |
// When `controllerClass` is falsy, we have not opted in to using item | |
// controllers, so return the object directly. | |
// When the index is out of range, we want to return the "out of range" | |
// value, whatever that might be. Rather than make assumptions | |
// (e.g. guessing `null` or `undefined`) we defer this to `arrangedContent`. | |
return object; | |
}, | |
arrangedContentDidChange: function() { | |
this._super(); | |
this._resetSubControllers(); | |
}, | |
arrayContentDidChange: function(idx, removedCnt, addedCnt) { | |
var subControllers = this._subControllers; | |
if (subControllers.length) { | |
var subControllersToRemove = subControllers.slice(idx, idx + removedCnt); | |
forEach(subControllersToRemove, function(subController) { | |
if (subController) { | |
subController.destroy(); | |
} | |
}); | |
replace(subControllers, idx, removedCnt, new Array(addedCnt)); | |
} | |
// The shadow array of subcontrollers must be updated before we trigger | |
// observers, otherwise observers will get the wrong subcontainer when | |
// calling `objectAt` | |
this._super(idx, removedCnt, addedCnt); | |
}, | |
init: function() { | |
this._super(); | |
this._subControllers = []; | |
}, | |
model: computed(function () { | |
return Ember.A(); | |
}), | |
/** | |
* Flag to mark as being "virtual". Used to keep this instance | |
* from participating in the parentController hierarchy. | |
* | |
* @private | |
* @property _isVirtual | |
* @type Boolean | |
*/ | |
_isVirtual: false, | |
controllerAt: function(idx, object, controllerClass) { | |
var fullName, subController, parentController; | |
var container = get(this, 'container'); | |
var subControllers = this._subControllers; | |
if (subControllers.length > idx) { | |
subController = subControllers[idx]; | |
if (subController) { | |
return subController; | |
} | |
} | |
fullName = 'controller:' + controllerClass; | |
if (!container.has(fullName)) { | |
throw new EmberError('Could not resolve itemController: "' + controllerClass + '"'); | |
} | |
if (this._isVirtual) { | |
parentController = get(this, 'parentController'); | |
} else { | |
parentController = this; | |
} | |
subController = container.lookupFactory(fullName).create({ | |
target: parentController, | |
parentController: parentController, | |
model: object | |
}); | |
subControllers[idx] = subController; | |
return subController; | |
}, | |
_subControllers: null, | |
_resetSubControllers: function() { | |
var controller; | |
var subControllers = this._subControllers; | |
if (subControllers.length) { | |
for (var i = 0, length = subControllers.length; length > i; i++) { | |
controller = subControllers[i]; | |
if (controller) { | |
controller.destroy(); | |
} | |
} | |
subControllers.length = 0; | |
} | |
}, | |
willDestroy: function() { | |
this._resetSubControllers(); | |
this._super(); | |
} | |
}); | |
}); | |
define("ember-runtime/controllers/controller", | |
["ember-metal/core","ember-metal/property_get","ember-runtime/system/object","ember-metal/mixin","ember-metal/computed","ember-runtime/mixins/action_handler","ember-runtime/mixins/controller_content_model_alias_deprecation","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __dependency6__, __dependency7__, __exports__) { | |
"use strict"; | |
var Ember = __dependency1__["default"]; | |
// Ember.assert, Ember.deprecate | |
var get = __dependency2__.get; | |
var EmberObject = __dependency3__["default"]; | |
var Mixin = __dependency4__.Mixin; | |
var computed = __dependency5__.computed; | |
var ActionHandler = __dependency6__["default"]; | |
var ControllerContentModelAliasDeprecation = __dependency7__["default"]; | |
/** | |
@module ember | |
@submodule ember-runtime | |
*/ | |
/** | |
`Ember.ControllerMixin` provides a standard interface for all classes that | |
compose Ember's controller layer: `Ember.Controller`, | |
`Ember.ArrayController`, and `Ember.ObjectController`. | |
@class ControllerMixin | |
@namespace Ember | |
@uses Ember.ActionHandler | |
*/ | |
var ControllerMixin = Mixin.create(ActionHandler, ControllerContentModelAliasDeprecation, { | |
/* ducktype as a controller */ | |
isController: true, | |
/** | |
The object to which actions from the view should be sent. | |
For example, when a Handlebars template uses the `{{action}}` helper, | |
it will attempt to send the action to the view's controller's `target`. | |
By default, the value of the target property is set to the router, and | |
is injected when a controller is instantiated. This injection is defined | |
in Ember.Application#buildContainer, and is applied as part of the | |
applications initialization process. It can also be set after a controller | |
has been instantiated, for instance when using the render helper in a | |
template, or when a controller is used as an `itemController`. In most | |
cases the `target` property will automatically be set to the logical | |
consumer of actions for the controller. | |
@property target | |
@default null | |
*/ | |
target: null, | |
container: null, | |
parentController: null, | |
store: null, | |
model: null, | |
content: computed.alias('model'), | |
deprecatedSendHandles: function(actionName) { | |
return !!this[actionName]; | |
}, | |
deprecatedSend: function(actionName) { | |
var args = [].slice.call(arguments, 1); | |
Ember.assert('' + this + " has the action " + actionName + " but it is not a function", typeof this[actionName] === 'function'); | |
Ember.deprecate('Action handlers implemented directly on controllers are deprecated in favor of action handlers on an `actions` object ( action: `' + actionName + '` on ' + this + ')', false); | |
this[actionName].apply(this, args); | |
return; | |
} | |
}); | |
/** | |
@class Controller | |
@namespace Ember | |
@extends Ember.Object | |
@uses Ember.ControllerMixin | |
*/ | |
var Controller = EmberObject.extend(ControllerMixin); | |
__exports__.Controller = Controller;// TODO: export default | |
__exports__.ControllerMixin = ControllerMixin; | |
}); | |
define("ember-runtime/controllers/object_controller", | |
["ember-runtime/controllers/controller","ember-runtime/system/object_proxy","exports"], | |
function(__dependency1__, __dependency2__, __exports__) { | |
"use strict"; | |
var ControllerMixin = __dependency1__.ControllerMixin; | |
var ObjectProxy = __dependency2__["default"]; | |
/** | |
@module ember | |
@submodule ember-runtime | |
*/ | |
/** | |
`Ember.ObjectController` is part of Ember's Controller layer. It is intended | |
to wrap a single object, proxying unhandled attempts to `get` and `set` to the underlying | |
model object, and to forward unhandled action attempts to its `target`. | |
`Ember.ObjectController` derives this functionality from its superclass | |
`Ember.ObjectProxy` and the `Ember.ControllerMixin` mixin. | |
@class ObjectController | |
@namespace Ember | |
@extends Ember.ObjectProxy | |
@uses Ember.ControllerMixin | |
**/ | |
__exports__["default"] = ObjectProxy.extend(ControllerMixin); | |
}); | |
define("ember-runtime/copy", | |
["ember-metal/enumerable_utils","ember-metal/utils","ember-runtime/system/object","ember-runtime/mixins/copyable","ember-metal/platform","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __exports__) { | |
"use strict"; | |
var EnumerableUtils = __dependency1__["default"]; | |
var typeOf = __dependency2__.typeOf; | |
var EmberObject = __dependency3__["default"]; | |
var Copyable = __dependency4__["default"]; | |
var create = __dependency5__.create; | |
var indexOf = EnumerableUtils.indexOf; | |
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 EmberObject) || (Copyable && Copyable.detect(obj))); | |
// IMPORTANT: this specific test will detect a native array only. Any other | |
// object will need to implement Copyable. | |
if (typeOf(obj) === 'array') { | |
ret = obj.slice(); | |
if (deep) { | |
loc = ret.length; | |
while(--loc>=0) ret[loc] = _copy(ret[loc], deep, seen, copies); | |
} | |
} else if (Copyable && Copyable.detect(obj)) { | |
ret = obj.copy(deep, seen, copies); | |
} else if (obj instanceof Date) { | |
ret = new Date(obj.getTime()); | |
} else { | |
ret = {}; | |
for(key in obj) { | |
if (!obj.hasOwnProperty(key)) continue; | |
// Prevents browsers that don't respect non-enumerability from | |
// copying internal Ember properties | |
if (key.substring(0,2) === '__') continue; | |
ret[key] = deep ? _copy(obj[key], deep, seen, copies) : obj[key]; | |
} | |
} | |
if (deep) { | |
seen.push(obj); | |
copies.push(ret); | |
} | |
return ret; | |
} | |
/** | |
Creates a clone of the passed object. This function can take just about | |
any type of object and create a clone of it, including primitive values | |
(which are not actually cloned because they are immutable). | |
If the passed object implements the `clone()` method, then this function | |
will simply call that method and return the result. | |
@method copy | |
@for Ember | |
@param {Object} obj The object to clone | |
@param {Boolean} deep If true, a deep copy of the object is made | |
@return {Object} The cloned object | |
*/ | |
__exports__["default"] = function copy(obj, deep) { | |
// fast paths | |
if ('object' !== typeof obj || obj===null) return obj; // can't copy primitives | |
if (Copyable && Copyable.detect(obj)) return obj.copy(deep); | |
return _copy(obj, deep, deep ? [] : null, deep ? [] : null); | |
} | |
}); | |
define("ember-runtime/core", | |
["exports"], | |
function(__exports__) { | |
"use strict"; | |
/** | |
@module ember | |
@submodule ember-runtime | |
*/ | |
/** | |
Compares two objects, returning true if they are logically equal. This is | |
a deeper comparison than a simple triple equal. For sets it will compare the | |
internal objects. For any other object that implements `isEqual()` it will | |
respect that method. | |
```javascript | |
Ember.isEqual('hello', 'hello'); // true | |
Ember.isEqual(1, 2); // false | |
Ember.isEqual([4,2], [4,2]); // false | |
``` | |
@method isEqual | |
@for Ember | |
@param {Object} a first object to compare | |
@param {Object} b second object to compare | |
@return {Boolean} | |
*/ | |
var isEqual = function isEqual(a, b) { | |
if (a && 'function'===typeof a.isEqual) return a.isEqual(b); | |
if (a instanceof Date && b instanceof Date) { | |
return a.getTime() === b.getTime(); | |
} | |
return a === b; | |
}; | |
__exports__.isEqual = isEqual; | |
}); | |
define("ember-runtime/ext/function", | |
["ember-metal/core","ember-metal/expand_properties","ember-metal/computed"], | |
function(__dependency1__, __dependency2__, __dependency3__) { | |
"use strict"; | |
/** | |
@module ember | |
@submodule ember-runtime | |
*/ | |
var Ember = __dependency1__["default"]; | |
// Ember.EXTEND_PROTOTYPES, Ember.assert | |
var expandProperties = __dependency2__["default"]; | |
var computed = __dependency3__.computed; | |
var a_slice = Array.prototype.slice; | |
var FunctionPrototype = Function.prototype; | |
if (Ember.EXTEND_PROTOTYPES === true || Ember.EXTEND_PROTOTYPES.Function) { | |
/** | |
The `property` extension of Javascript's Function prototype is available | |
when `Ember.EXTEND_PROTOTYPES` or `Ember.EXTEND_PROTOTYPES.Function` is | |
`true`, which is the default. | |
Computed properties allow you to treat a function like a property: | |
```javascript | |
MyApp.President = Ember.Object.extend({ | |
firstName: '', | |
lastName: '', | |
fullName: function() { | |
return this.get('firstName') + ' ' + this.get('lastName'); | |
// Call this flag to mark the function as a property | |
}.property() | |
}); | |
var president = MyApp.President.create({ | |
firstName: "Barack", | |
lastName: "Obama" | |
}); | |
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 | |
about these dependencies like this: | |
```javascript | |
MyApp.President = Ember.Object.extend({ | |
firstName: '', | |
lastName: '', | |
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 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. | |
See [Ember.ComputedProperty](/api/classes/Ember.ComputedProperty.html), [Ember.computed](/api/#method_computed). | |
@method property | |
@for Function | |
*/ | |
FunctionPrototype.property = function() { | |
var ret = computed(this); | |
// ComputedProperty.prototype.property expands properties; no need for us to | |
// do so here. | |
return ret.property.apply(ret, arguments); | |
}; | |
/** | |
The `observes` extension of Javascript's Function prototype is available | |
when `Ember.EXTEND_PROTOTYPES` or `Ember.EXTEND_PROTOTYPES.Function` 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: | |
```javascript | |
Ember.Object.extend({ | |
valueObserver: function() { | |
// Executes whenever the "value" property changes | |
}.observes('value') | |
}); | |
``` | |
In the future this method may become asynchronous. If you want to ensure | |
synchronous behavior, use `observesImmediately`. | |
See `Ember.observer`. | |
@method observes | |
@for Function | |
*/ | |
FunctionPrototype.observes = function() { | |
var addWatchedProperty = function (obs) { watched.push(obs); }; | |
var watched = []; | |
for (var i=0; i<arguments.length; ++i) { | |
expandProperties(arguments[i], addWatchedProperty); | |
} | |
this.__ember_observes__ = watched; | |
return this; | |
}; | |
/** | |
The `observesImmediately` extension of Javascript's Function prototype is | |
available when `Ember.EXTEND_PROTOTYPES` or | |
`Ember.EXTEND_PROTOTYPES.Function` is true, which is the default. | |
You can observe property changes simply by adding the `observesImmediately` | |
call to the end of your method declarations in classes that you write. | |
For example: | |
```javascript | |
Ember.Object.extend({ | |
valueObserver: function() { | |
// Executes immediately after the "value" property changes | |
}.observesImmediately('value') | |
}); | |
``` | |
In the future, `observes` may become asynchronous. In this event, | |
`observesImmediately` will maintain the synchronous behavior. | |
See `Ember.immediateObserver`. | |
@method observesImmediately | |
@for Function | |
*/ | |
FunctionPrototype.observesImmediately = 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.", arg.indexOf('.') === -1); | |
} | |
// observes handles property expansion | |
return this.observes.apply(this, arguments); | |
}; | |
/** | |
The `observesBefore` extension of Javascript's Function prototype is | |
available when `Ember.EXTEND_PROTOTYPES` or | |
`Ember.EXTEND_PROTOTYPES.Function` is true, which is the default. | |
You can get notified when a property change is about to happen by | |
by adding the `observesBefore` call to the end of your method | |
declarations in classes that you write. For example: | |
```javascript | |
Ember.Object.extend({ | |
valueObserver: function() { | |
// Executes whenever the "value" property is about to change | |
}.observesBefore('value') | |
}); | |
``` | |
See `Ember.beforeObserver`. | |
@method observesBefore | |
@for Function | |
*/ | |
FunctionPrototype.observesBefore = function() { | |
var addWatchedProperty = function (obs) { watched.push(obs); }; | |
var watched = []; | |
for (var i=0; i<arguments.length; ++i) { | |
expandProperties(arguments[i], addWatchedProperty); | |
} | |
this.__ember_observesBefore__ = watched; | |
return this; | |
}; | |
/** | |
The `on` extension of Javascript's Function prototype is available | |
when `Ember.EXTEND_PROTOTYPES` or `Ember.EXTEND_PROTOTYPES.Function` is | |
true, which is the default. | |
You can listen for events simply by adding the `on` call to the end of | |
your method declarations in classes or mixins that you write. For example: | |
```javascript | |
Ember.Mixin.create({ | |
doSomethingWithElement: function() { | |
// Executes whenever the "didInsertElement" event fires | |
}.on('didInsertElement') | |
}); | |
``` | |
See `Ember.on`. | |
@method on | |
@for Function | |
*/ | |
FunctionPrototype.on = function() { | |
var events = a_slice.call(arguments); | |
this.__ember_listens__ = events; | |
return this; | |
}; | |
} | |
}); | |
define("ember-runtime/ext/rsvp", | |
["ember-metal/core","ember-metal/logger","exports"], | |
function(__dependency1__, __dependency2__, __exports__) { | |
"use strict"; | |
/* globals RSVP:true */ | |
var Ember = __dependency1__["default"]; | |
var Logger = __dependency2__["default"]; | |
var RSVP = requireModule("rsvp"); | |
var Test, testModuleName = 'ember-testing/test'; | |
RSVP.onerrorDefault = function(error) { | |
if (error instanceof Error) { | |
if (Ember.testing) { | |
// ES6TODO: remove when possible | |
if (!Test && Ember.__loader.registry[testModuleName]) { | |
Test = requireModule(testModuleName)['default']; | |
} | |
if (Test && Test.adapter) { | |
Test.adapter.exception(error); | |
} else { | |
throw error; | |
} | |
} else if (Ember.onerror) { | |
Ember.onerror(error); | |
} else { | |
Logger.error(error.stack); | |
Ember.assert(error, false); | |
} | |
} | |
}; | |
RSVP.on('error', RSVP.onerrorDefault); | |
__exports__["default"] = RSVP; | |
}); | |
define("ember-runtime/ext/string", | |
["ember-metal/core","ember-runtime/system/string"], | |
function(__dependency1__, __dependency2__) { | |
"use strict"; | |
/** | |
@module ember | |
@submodule ember-runtime | |
*/ | |
var Ember = __dependency1__["default"]; | |
// Ember.EXTEND_PROTOTYPES, Ember.assert, Ember.FEATURES | |
var fmt = __dependency2__.fmt; | |
var w = __dependency2__.w; | |
var loc = __dependency2__.loc; | |
var camelize = __dependency2__.camelize; | |
var decamelize = __dependency2__.decamelize; | |
var dasherize = __dependency2__.dasherize; | |
var underscore = __dependency2__.underscore; | |
var capitalize = __dependency2__.capitalize; | |
var classify = __dependency2__.classify; | |
var StringPrototype = String.prototype; | |
if (Ember.EXTEND_PROTOTYPES === true || Ember.EXTEND_PROTOTYPES.String) { | |
/** | |
See [Ember.String.fmt](/api/classes/Ember.String.html#method_fmt). | |
@method fmt | |
@for String | |
*/ | |
StringPrototype.fmt = function() { | |
return fmt(this, arguments); | |
}; | |
/** | |
See [Ember.String.w](/api/classes/Ember.String.html#method_w). | |
@method w | |
@for String | |
*/ | |
StringPrototype.w = function() { | |
return w(this); | |
}; | |
/** | |
See [Ember.String.loc](/api/classes/Ember.String.html#method_loc). | |
@method loc | |
@for String | |
*/ | |
StringPrototype.loc = function() { | |
return loc(this, arguments); | |
}; | |
/** | |
See [Ember.String.camelize](/api/classes/Ember.String.html#method_camelize). | |
@method camelize | |
@for String | |
*/ | |
StringPrototype.camelize = function() { | |
return camelize(this); | |
}; | |
/** | |
See [Ember.String.decamelize](/api/classes/Ember.String.html#method_decamelize). | |
@method decamelize | |
@for String | |
*/ | |
StringPrototype.decamelize = function() { | |
return decamelize(this); | |
}; | |
/** | |
See [Ember.String.dasherize](/api/classes/Ember.String.html#method_dasherize). | |
@method dasherize | |
@for String | |
*/ | |
StringPrototype.dasherize = function() { | |
return dasherize(this); | |
}; | |
/** | |
See [Ember.String.underscore](/api/classes/Ember.String.html#method_underscore). | |
@method underscore | |
@for String | |
*/ | |
StringPrototype.underscore = function() { | |
return underscore(this); | |
}; | |
/** | |
See [Ember.String.classify](/api/classes/Ember.String.html#method_classify). | |
@method classify | |
@for String | |
*/ | |
StringPrototype.classify = function() { | |
return classify(this); | |
}; | |
/** | |
See [Ember.String.capitalize](/api/classes/Ember.String.html#method_capitalize). | |
@method capitalize | |
@for String | |
*/ | |
StringPrototype.capitalize = function() { | |
return capitalize(this); | |
}; | |
} | |
}); | |
define("ember-runtime/keys", | |
["ember-metal/enumerable_utils","ember-metal/platform","exports"], | |
function(__dependency1__, __dependency2__, __exports__) { | |
"use strict"; | |
var EnumerableUtils = __dependency1__["default"]; | |
var create = __dependency2__.create; | |
/** | |
Returns all of the keys defined on an object or hash. This is useful | |
when inspecting objects for debugging. On browsers that support it, this | |
uses the native `Object.keys` implementation. | |
@method keys | |
@for Ember | |
@param {Object} obj | |
@return {Array} Array containing keys of obj | |
*/ | |
var keys = Object.keys; | |
if (!keys || create.isSimulated) { | |
var prototypeProperties = [ | |
'constructor', | |
'hasOwnProperty', | |
'isPrototypeOf', | |
'propertyIsEnumerable', | |
'valueOf', | |
'toLocaleString', | |
'toString' | |
], | |
pushPropertyName = function(obj, array, key) { | |
// Prevents browsers that don't respect non-enumerability from | |
// copying internal Ember properties | |
if (key.substring(0,2) === '__') return; | |
if (key === '_super') return; | |
if (EnumerableUtils.indexOf(array, key) >= 0) return; | |
if (typeof obj.hasOwnProperty === 'function' && !obj.hasOwnProperty(key)) return; | |
array.push(key); | |
}; | |
keys = function keys(obj) { | |
var ret = [], key; | |
for (key in obj) { | |
pushPropertyName(obj, ret, key); | |
} | |
// IE8 doesn't enumerate property that named the same as prototype properties. | |
for (var i = 0, l = prototypeProperties.length; i < l; i++) { | |
key = prototypeProperties[i]; | |
pushPropertyName(obj, ret, key); | |
} | |
return ret; | |
}; | |
} | |
__exports__["default"] = keys; | |
}); | |
define("ember-runtime/mixins/action_handler", | |
["ember-metal/merge","ember-metal/mixin","ember-metal/property_get","ember-metal/utils","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __exports__) { | |
"use strict"; | |
/** | |
@module ember | |
@submodule ember-runtime | |
*/ | |
var merge = __dependency1__["default"]; | |
var Mixin = __dependency2__.Mixin; | |
var get = __dependency3__.get; | |
var typeOf = __dependency4__.typeOf; | |
/** | |
The `Ember.ActionHandler` mixin implements support for moving an `actions` | |
property to an `_actions` property at extend time, and adding `_actions` | |
to the object's mergedProperties list. | |
`Ember.ActionHandler` is available on some familiar classes including | |
`Ember.Route`, `Ember.View`, `Ember.Component`, and controllers such as | |
`Ember.Controller` and `Ember.ObjectController`. | |
(Internally the mixin is used by `Ember.CoreView`, `Ember.ControllerMixin`, | |
and `Ember.Route` and available to the above classes through | |
inheritance.) | |
@class ActionHandler | |
@namespace Ember | |
*/ | |
var ActionHandler = Mixin.create({ | |
mergedProperties: ['_actions'], | |
/** | |
The collection of functions, keyed by name, available on this | |
`ActionHandler` as action targets. | |
These functions will be invoked when a matching `{{action}}` is triggered | |
from within a template and the application's current route is this route. | |
Actions can also be invoked from other parts of your application | |
via `ActionHandler#send`. | |
The `actions` hash will inherit action handlers from | |
the `actions` hash defined on extended parent classes | |
or mixins rather than just replace the entire hash, e.g.: | |
```js | |
App.CanDisplayBanner = Ember.Mixin.create({ | |
actions: { | |
displayBanner: function(msg) { | |
// ... | |
} | |
} | |
}); | |
App.WelcomeRoute = Ember.Route.extend(App.CanDisplayBanner, { | |
actions: { | |
playMusic: function() { | |
// ... | |
} | |
} | |
}); | |
// `WelcomeRoute`, when active, will be able to respond | |
// to both actions, since the actions hash is merged rather | |
// then replaced when extending mixins / parent classes. | |
this.send('displayBanner'); | |
this.send('playMusic'); | |
``` | |
Within a Controller, Route, View or Component's action handler, | |
the value of the `this` context is the Controller, Route, View or | |
Component object: | |
```js | |
App.SongRoute = Ember.Route.extend({ | |
actions: { | |
myAction: function() { | |
this.controllerFor("song"); | |
this.transitionTo("other.route"); | |
... | |
} | |
} | |
}); | |
``` | |
It is also possible to call `this._super()` from within an | |
action handler if it overrides a handler defined on a parent | |
class or mixin: | |
Take for example the following routes: | |
```js | |
App.DebugRoute = Ember.Mixin.create({ | |
actions: { | |
debugRouteInformation: function() { | |
console.debug("trololo"); | |
} | |
} | |
}); | |
App.AnnoyingDebugRoute = Ember.Route.extend(App.DebugRoute, { | |
actions: { | |
debugRouteInformation: function() { | |
// also call the debugRouteInformation of mixed in App.DebugRoute | |
this._super(); | |
// show additional annoyance | |
window.alert(...); | |
} | |
} | |
}); | |
``` | |
## Bubbling | |
By default, an action will stop bubbling once a handler defined | |
on the `actions` hash handles it. To continue bubbling the action, | |
you must return `true` from the handler: | |
```js | |
App.Router.map(function() { | |
this.resource("album", function() { | |
this.route("song"); | |
}); | |
}); | |
App.AlbumRoute = Ember.Route.extend({ | |
actions: { | |
startPlaying: function() { | |
} | |
} | |
}); | |
App.AlbumSongRoute = Ember.Route.extend({ | |
actions: { | |
startPlaying: function() { | |
// ... | |
if (actionShouldAlsoBeTriggeredOnParentRoute) { | |
return true; | |
} | |
} | |
} | |
}); | |
``` | |
@property actions | |
@type Hash | |
@default null | |
*/ | |
/** | |
Moves `actions` to `_actions` at extend time. Note that this currently | |
modifies the mixin themselves, which is technically dubious but | |
is practically of little consequence. This may change in the future. | |
@private | |
@method willMergeMixin | |
*/ | |
willMergeMixin: function(props) { | |
var hashName; | |
if (!props._actions) { | |
Ember.assert("'actions' should not be a function", typeof(props.actions) !== 'function'); | |
if (typeOf(props.actions) === 'object') { | |
hashName = 'actions'; | |
} else if (typeOf(props.events) === 'object') { | |
Ember.deprecate('Action handlers contained in an `events` object are deprecated in favor of putting them in an `actions` object', false); | |
hashName = 'events'; | |
} | |
if (hashName) { | |
props._actions = merge(props._actions || {}, props[hashName]); | |
} | |
delete props[hashName]; | |
} | |
}, | |
/** | |
Triggers a named action on the `ActionHandler`. Any parameters | |
supplied after the `actionName` string will be passed as arguments | |
to the action target function. | |
If the `ActionHandler` has its `target` property set, actions may | |
bubble to the `target`. Bubbling happens when an `actionName` can | |
not be found in the `ActionHandler`'s `actions` hash or if the | |
action target function returns `true`. | |
Example | |
```js | |
App.WelcomeRoute = Ember.Route.extend({ | |
actions: { | |
playTheme: function() { | |
this.send('playMusic', 'theme.mp3'); | |
}, | |
playMusic: function(track) { | |
// ... | |
} | |
} | |
}); | |
``` | |
@method send | |
@param {String} actionName The action to trigger | |
@param {*} context a context to send with the action | |
*/ | |
send: function(actionName) { | |
var args = [].slice.call(arguments, 1), target; | |
if (this._actions && this._actions[actionName]) { | |
if (this._actions[actionName].apply(this, args) === true) { | |
// handler returned true, so this action will bubble | |
} else { | |
return; | |
} | |
} else if (!Ember.FEATURES.isEnabled('ember-routing-drop-deprecated-action-style') && this.deprecatedSend && this.deprecatedSendHandles && this.deprecatedSendHandles(actionName)) { | |
Ember.warn("The current default is deprecated but will prefer to handle actions directly on the controller instead of a similarly named action in the actions hash. To turn off this deprecated feature set: Ember.FEATURES['ember-routing-drop-deprecated-action-style'] = true"); | |
if (this.deprecatedSend.apply(this, [].slice.call(arguments)) === true) { | |
// handler return true, so this action will bubble | |
} else { | |
return; | |
} | |
} | |
if (target = get(this, 'target')) { | |
Ember.assert("The `target` for " + this + " (" + target + ") does not have a `send` method", typeof target.send === 'function'); | |
target.send.apply(target, arguments); | |
} | |
} | |
}); | |
__exports__["default"] = ActionHandler; | |
}); | |
define("ember-runtime/mixins/array", | |
["ember-metal/core","ember-metal/property_get","ember-metal/property_set","ember-metal/computed","ember-metal/is_none","ember-runtime/mixins/enumerable","ember-metal/enumerable_utils","ember-metal/mixin","ember-metal/property_events","ember-metal/events","ember-metal/watching","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __dependency6__, __dependency7__, __dependency8__, __dependency9__, __dependency10__, __dependency11__, __exports__) { | |
"use strict"; | |
/** | |
@module ember | |
@submodule ember-runtime | |
*/ | |
// .......................................................... | |
// HELPERS | |
// | |
var Ember = __dependency1__["default"]; | |
// ES6TODO: Ember.A | |
var get = __dependency2__.get; | |
var set = __dependency3__.set; | |
var computed = __dependency4__.computed; | |
var cacheFor = __dependency4__.cacheFor; | |
var isNone = __dependency5__.isNone; | |
var none = __dependency5__.none; | |
var Enumerable = __dependency6__["default"]; | |
var EnumerableUtils = __dependency7__["default"]; | |
var Mixin = __dependency8__.Mixin; | |
var required = __dependency8__.required; | |
var propertyWillChange = __dependency9__.propertyWillChange; | |
var propertyDidChange = __dependency9__.propertyDidChange; | |
var addListener = __dependency10__.addListener; | |
var removeListener = __dependency10__.removeListener; | |
var sendEvent = __dependency10__.sendEvent; | |
var hasListeners = __dependency10__.hasListeners; | |
var isWatching = __dependency11__.isWatching; | |
var map = EnumerableUtils.map; | |
// .......................................................... | |
// ARRAY | |
// | |
/** | |
This mixin implements Observer-friendly Array-like behavior. It is not a | |
concrete implementation, but it can be used up by other classes that want | |
to appear like arrays. | |
For example, ArrayProxy and ArrayController are both concrete classes that can | |
be instantiated to implement array-like behavior. Both of these classes use | |
the Array Mixin by way of the MutableArray mixin, which allows observable | |
changes to be made to the underlying array. | |
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 of an array changes by using `.observes('myArray.[]')`. | |
To support `Ember.Array` in your own class, you must override two | |
primitives to use it: `replace()` and `objectAt()`. | |
Note that the Ember.Array mixin also incorporates the `Ember.Enumerable` | |
mixin. All `Ember.Array`-like objects are also enumerable. | |
@class Array | |
@namespace Ember | |
@uses Ember.Enumerable | |
@since Ember 0.9.0 | |
*/ | |
__exports__["default"] = Mixin.create(Enumerable, { | |
/** | |
Your array must support the `length` property. Your replace methods should | |
set this property whenever it changes. | |
@property {Number} length | |
*/ | |
length: required(), | |
/** | |
Returns the object at the given `index`. If the given `index` is negative | |
or is greater or equal than the array length, returns `undefined`. | |
This is one of the primitives you must implement to support `Ember.Array`. | |
If your object supports retrieving the value of an array item using `get()` | |
(i.e. `myArray.get(0)`), then you do not need to implement this method | |
yourself. | |
```javascript | |
var arr = ['a', 'b', 'c', 'd']; | |
arr.objectAt(0); // "a" | |
arr.objectAt(3); // "d" | |
arr.objectAt(-1); // undefined | |
arr.objectAt(4); // undefined | |
arr.objectAt(5); // undefined | |
``` | |
@method objectAt | |
@param {Number} idx The index of the item to return. | |
@return {*} item at index or undefined | |
*/ | |
objectAt: function(idx) { | |
if ((idx < 0) || (idx >= get(this, 'length'))) return undefined; | |
return get(this, idx); | |
}, | |
/** | |
This returns the objects at the specified indexes, using `objectAt`. | |
```javascript | |
var arr =Â ['a', 'b', 'c', 'd']; | |
arr.objectsAt([0, 1, 2]); // ["a", "b", "c"] | |
arr.objectsAt([2, 3, 4]); // ["c", "d", undefined] | |
``` | |
@method objectsAt | |
@param {Array} indexes An array of indexes of items to return. | |
@return {Array} | |
*/ | |
objectsAt: function(indexes) { | |
var self = this; | |
return map(indexes, function(idx) { return self.objectAt(idx); }); | |
}, | |
// overrides Ember.Enumerable version | |
nextObject: function(idx) { | |
return this.objectAt(idx); | |
}, | |
/** | |
This is the handler for the special array content property. If you get | |
this property, it will return this. If you set this property it a new | |
array, it will replace the current content. | |
This property overrides the default property defined in `Ember.Enumerable`. | |
@property [] | |
@return this | |
*/ | |
'[]': computed(function(key, value) { | |
if (value !== undefined) this.replace(0, get(this, 'length'), value) ; | |
return this ; | |
}), | |
firstObject: computed(function() { | |
return this.objectAt(0); | |
}), | |
lastObject: computed(function() { | |
return this.objectAt(get(this, 'length')-1); | |
}), | |
// optimized version from Enumerable | |
contains: function(obj) { | |
return this.indexOf(obj) >= 0; | |
}, | |
// Add any extra methods to Ember.Array that are native to the built-in Array. | |
/** | |
Returns a new array that is a slice of the receiver. This implementation | |
uses the observable array methods to retrieve the objects for the new | |
slice. | |
```javascript | |
var arr = ['red', 'green', 'blue']; | |
arr.slice(0); // ['red', 'green', 'blue'] | |
arr.slice(0, 2); // ['red', 'green'] | |
arr.slice(1, 100); // ['green', 'blue'] | |
``` | |
@method slice | |
@param {Integer} beginIndex (Optional) index to begin slicing from. | |
@param {Integer} endIndex (Optional) index to end the slice at (but not included). | |
@return {Array} New array with specified slice | |
*/ | |
slice: function(beginIndex, endIndex) { | |
var ret = Ember.A(); | |
var length = get(this, 'length') ; | |
if (isNone(beginIndex)) beginIndex = 0 ; | |
if (isNone(endIndex) || (endIndex > length)) endIndex = length ; | |
if (beginIndex < 0) beginIndex = length + beginIndex; | |
if (endIndex < 0) endIndex = length + endIndex; | |
while(beginIndex < endIndex) { | |
ret[ret.length] = this.objectAt(beginIndex++) ; | |
} | |
return ret ; | |
}, | |
/** | |
Returns the index of the given object's first occurrence. | |
If no `startAt` argument is given, the starting location to | |
search is 0. If it's negative, will count backward from | |
the end of the array. Returns -1 if no match is found. | |
```javascript | |
var arr = ["a", "b", "c", "d", "a"]; | |
arr.indexOf("a"); // 0 | |
arr.indexOf("z"); // -1 | |
arr.indexOf("a", 2); // 4 | |
arr.indexOf("a", -1); // 4 | |
arr.indexOf("b", 3); // -1 | |
arr.indexOf("a", 100); // -1 | |
``` | |
@method indexOf | |
@param {Object} object the item to search for | |
@param {Number} startAt optional starting location to search, default 0 | |
@return {Number} index or -1 if not found | |
*/ | |
indexOf: function(object, startAt) { | |
var idx, len = get(this, 'length'); | |
if (startAt === undefined) startAt = 0; | |
if (startAt < 0) startAt += len; | |
for(idx = startAt; idx < len; idx++) { | |
if (this.objectAt(idx) === 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. | |
```javascript | |
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 | |
``` | |
@method lastIndexOf | |
@param {Object} object the item to search for | |
@param {Number} startAt optional starting location to search, default 0 | |
@return {Number} index or -1 if not found | |
*/ | |
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(observedObj, start, removeCount, addCount)` - This method will be | |
called just before the array is modified. | |
* `arrayDidChange(observedObj, start, removeCount, addCount)` - This method will be | |
called just after the array is modified. | |
Both callbacks will be passed the observed object, starting index of the | |
change as well a a count of the items to be removed and added. You can use | |
these callbacks to optionally inspect the array during the change, clear | |
caches, or do any other bookkeeping necessary. | |
In addition to passing a target, you can also include an options hash | |
which you can use to override the method names that will be invoked on the | |
target. | |
@method addArrayObserver | |
@param {Object} target The observer object. | |
@param {Hash} opts Optional hash of configuration options including | |
`willChange` and `didChange` option. | |
@return {Ember.Array} receiver | |
*/ | |
addArrayObserver: function(target, opts) { | |
var willChange = (opts && opts.willChange) || 'arrayWillChange', | |
didChange = (opts && opts.didChange) || 'arrayDidChange'; | |
var hasObservers = get(this, 'hasArrayObservers'); | |
if (!hasObservers) propertyWillChange(this, 'hasArrayObservers'); | |
addListener(this, '@array:before', target, willChange); | |
addListener(this, '@array:change', target, didChange); | |
if (!hasObservers) propertyDidChange(this, 'hasArrayObservers'); | |
return this; | |
}, | |
/** | |
Removes an array observer from the object if the observer is current | |
registered. Calling this method multiple times with the same object will | |
have no effect. | |
@method removeArrayObserver | |
@param {Object} target The object observing the array. | |
@param {Hash} opts Optional hash of configuration options including | |
`willChange` and `didChange` option. | |
@return {Ember.Array} receiver | |
*/ | |
removeArrayObserver: function(target, opts) { | |
var willChange = (opts && opts.willChange) || 'arrayWillChange', | |
didChange = (opts && opts.didChange) || 'arrayDidChange'; | |
var hasObservers = get(this, 'hasArrayObservers'); | |
if (hasObservers) propertyWillChange(this, 'hasArrayObservers'); | |
removeListener(this, '@array:before', target, willChange); | |
removeListener(this, '@array:change', target, didChange); | |
if (hasObservers) propertyDidChange(this, 'hasArrayObservers'); | |
return this; | |
}, | |
/** | |
Becomes true whenever the array currently has observers watching changes | |
on the array. | |
@property {Boolean} hasArrayObservers | |
*/ | |
hasArrayObservers: computed(function() { | |
return hasListeners(this, '@array:change') || hasListeners(this, '@array:before'); | |
}), | |
/** | |
If you are implementing an object that supports `Ember.Array`, call this | |
method just before the array content changes to notify any observers and | |
invalidate any related properties. Pass the starting index of the change | |
as well as a delta of the amounts to change. | |
@method arrayContentWillChange | |
@param {Number} startIdx The starting index in the array that will change. | |
@param {Number} removeAmt The number of items that will be removed. If you | |
pass `null` assumes 0 | |
@param {Number} addAmt The number of items that will be added. If you | |
pass `null` assumes 0. | |
@return {Ember.Array} receiver | |
*/ | |
arrayContentWillChange: function(startIdx, removeAmt, addAmt) { | |
// if no args are passed assume everything changes | |
if (startIdx===undefined) { | |
startIdx = 0; | |
removeAmt = addAmt = -1; | |
} else { | |
if (removeAmt === undefined) removeAmt=-1; | |
if (addAmt === undefined) addAmt=-1; | |
} | |
// Make sure the @each proxy is set up if anyone is observing @each | |
if (isWatching(this, '@each')) { get(this, '@each'); } | |
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; | |
}, | |
/** | |
If you are implementing an object that supports `Ember.Array`, call this | |
method just after the array content changes to notify any observers and | |
invalidate any related properties. Pass the starting index of the change | |
as well as a delta of the amounts to change. | |
@method arrayContentDidChange | |
@param {Number} startIdx The starting index in the array that did change. | |
@param {Number} removeAmt The number of items that were removed. If you | |
pass `null` assumes 0 | |
@param {Number} addAmt The number of items that were added. If you | |
pass `null` assumes 0. | |
@return {Ember.Array} receiver | |
*/ | |
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); | |
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) { | |
propertyWillChange(this, 'firstObject'); | |
propertyDidChange(this, 'firstObject'); | |
} | |
if (this.objectAt(length-1) !== cachedLast) { | |
propertyWillChange(this, 'lastObject'); | |
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. | |
If you merely want to watch for any items being added or removed to the array, | |
use the `[]` property instead of `@each`. | |
@property @each | |
*/ | |
'@each': computed(function() { | |
if (!this.__each) { | |
// ES6TODO: GRRRRR | |
var EachProxy = requireModule('ember-runtime/system/each_proxy')['EachProxy']; | |
this.__each = new EachProxy(this); | |
} | |
return this.__each; | |
}) | |
}); | |
}); | |
define("ember-runtime/mixins/comparable", | |
["ember-metal/mixin","exports"], | |
function(__dependency1__, __exports__) { | |
"use strict"; | |
var Mixin = __dependency1__.Mixin; | |
var required = __dependency1__.required; | |
/** | |
@module ember | |
@submodule ember-runtime | |
*/ | |
/** | |
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. | |
@class Comparable | |
@namespace Ember | |
@since Ember 0.9 | |
*/ | |
__exports__["default"] = Mixin.create({ | |
/** | |
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. | |
@method compare | |
@param a {Object} the first object to compare | |
@param b {Object} the second object to compare | |
@return {Integer} the result of the comparison | |
*/ | |
compare: required(Function) | |
}); | |
}); | |
define("ember-runtime/mixins/controller_content_model_alias_deprecation", | |
["ember-metal/core","ember-metal/property_get","ember-metal/mixin","exports"], | |
function(__dependency1__, __dependency2__, __dependency3__, __exports__) { | |
"use strict"; | |
var Ember = __dependency1__["default"]; | |
// Ember.deprecate | |
var get = __dependency2__.get; | |
var Mixin = __dependency3__.Mixin; | |
/** | |
The ControllerContentModelAliasDeprecation mixin is used to provide a useful | |
deprecation warning when specifying `content` directly on a `Ember.Controller` | |
(without also specifying `model`). | |
Ember versions prior to 1.7 used `model` as an alias of `content`, but due to | |
much confusion this alias was reversed (so `content` is now an alias of `model). | |
This change reduces many caveats with model/content, and also sets a | |
simple ground rule: Never set a controllers content, rather always set | |
it's model and ember will do the right thing. | |
`Ember.ControllerContentModelAliasDeprecation` is used internally by Ember in | |
`Ember.Controller`. | |
@class ControllerContentModelAliasDeprecation | |
@namespace Ember | |
*/ | |
__exports__["default"] = Mixin.create({ | |
/** | |
@private | |
Moves `content` to `model` at extend time if a `model` is not also specified. | |
Note that this currently modifies |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment