dist/ember-runtime.js in ember-source-1.11.0.beta.2.2 vs dist/ember-runtime.js in ember-source-1.11.0.beta.3

- old
+ new

@@ -3,11 +3,11 @@ * @copyright Copyright 2011-2015 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.11.0-beta.2 + * @version 1.11.0-beta.3.780ac356 */ (function() { var enifed, requireModule, eriuqer, requirejs, Ember; var mainContext = this; @@ -4110,12 +4110,14 @@ fullName: function () { return this.get('firstName') + ' ' + this.get('lastName'); }.property('firstName', 'lastName') ``` - @method computed - @for Ember + @class computed + @namespace Ember + @constructor + @static @param {String} [dependentKeys*] Optional dependent keys that trigger this computed property. @param {Function} func The computed property function. @return {Ember.ComputedProperty} property descriptor instance */ function computed(func) { @@ -4248,12 +4250,12 @@ todoList.get('todos').clear(); todoList.get('isDone'); // true ``` @since 1.6.0 - @method computed.empty - @for Ember + @method empty + @for Ember.computed @param {String} dependentKey @return {Ember.ComputedProperty} computed property which negate the original value for property */ function empty(dependentKey) { @@ -4278,12 +4280,12 @@ hamster.get('hasStuff'); // true hamster.get('backpack').clear(); // [] hamster.get('hasStuff'); // false ``` - @method computed.notEmpty - @for Ember + @method notEmpty + @for Ember.computed @param {String} dependentKey @return {Ember.ComputedProperty} computed property which returns true if original value for property is not empty. */ function notEmpty(dependentKey) { @@ -4311,12 +4313,12 @@ hamster.get('isHungry'); // false hamster.set('food', null); hamster.get('isHungry'); // true ``` - @method computed.none - @for Ember + @method none + @for Ember.computed @param {String} dependentKey @return {Ember.ComputedProperty} computed property which returns true if original value for property is null or undefined. */ function none(dependentKey) { @@ -4341,12 +4343,12 @@ user.get('isAnonymous'); // true user.set('loggedIn', true); user.get('isAnonymous'); // false ``` - @method computed.not - @for Ember + @method not + @for Ember.computed @param {String} dependentKey @return {Ember.ComputedProperty} computed property which returns inverse of the original value for property */ function not(dependentKey) { @@ -4373,12 +4375,12 @@ hamster.get('hasBananas'); // true hamster.set('numBananas', null); hamster.get('hasBananas'); // false ``` - @method computed.bool - @for Ember + @method bool + @for Ember.computed @param {String} dependentKey @return {Ember.ComputedProperty} computed property which converts to boolean the original value for property */ function bool(dependentKey) { @@ -4406,12 +4408,12 @@ user.get('hasValidEmail'); // false user.set('email', 'ember_hamster@example.com'); user.get('hasValidEmail'); // true ``` - @method computed.match - @for Ember + @method match + @for Ember.computed @param {String} dependentKey @param {RegExp} regexp @return {Ember.ComputedProperty} computed property which match the original value for property against a given RegExp */ @@ -4441,12 +4443,12 @@ hamster.get('napTime'); // true hamster.set('state', 'hungry'); hamster.get('napTime'); // false ``` - @method computed.equal - @for Ember + @method equal + @for Ember.computed @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. */ @@ -4474,12 +4476,12 @@ hamster.get('hasTooManyBananas'); // false hamster.set('numBananas', 11); hamster.get('hasTooManyBananas'); // true ``` - @method computed.gt - @for Ember + @method gt + @for Ember.computed @param {String} dependentKey @param {Number} value @return {Ember.ComputedProperty} computed property which returns true if the original value for property is greater than given value. */ @@ -4507,12 +4509,12 @@ hamster.get('hasTooManyBananas'); // false hamster.set('numBananas', 10); hamster.get('hasTooManyBananas'); // true ``` - @method computed.gte - @for Ember + @method gte + @for Ember.computed @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. */ @@ -4540,12 +4542,12 @@ hamster.get('needsMoreBananas'); // false hamster.set('numBananas', 2); hamster.get('needsMoreBananas'); // true ``` - @method computed.lt - @for Ember + @method lt + @for Ember.computed @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. */ @@ -4573,12 +4575,12 @@ hamster.get('needsMoreBananas'); // false hamster.set('numBananas', 3); hamster.get('needsMoreBananas'); // true ``` - @method computed.lte - @for Ember + @method lte + @for Ember.computed @param {String} dependentKey @param {Number} value @return {Ember.ComputedProperty} computed property which returns true if the original value for property is less or equal than given value. */ @@ -4608,12 +4610,12 @@ hamster.get('readyForCamp'); // true hamster.set('hasBackpack', 'Yes'); hamster.get('readyForCamp'); // 'Yes' ``` - @method computed.and - @for Ember + @method and + @for Ember.computed @param {String} dependentKey* @return {Ember.ComputedProperty} computed property which performs a logical `and` on the values of all the original values for properties. */ var and = generateComputedWithProperties(function(properties) { @@ -4645,12 +4647,12 @@ hamster.get('readyForRain'); // true hamster.set('hasJacket', 'Yes'); hamster.get('readyForRain'); // 'Yes' ``` - @method computed.or - @for Ember + @method or + @for Ember.computed @param {String} dependentKey* @return {Ember.ComputedProperty} computed property which performs a logical `or` on the values of all the original values for properties. */ var or = generateComputedWithProperties(function(properties) { @@ -4678,12 +4680,12 @@ hamster.get('hasClothes'); // null hamster.set('shirt', 'Hawaiian Shirt'); hamster.get('hasClothes'); // 'Hawaiian Shirt' ``` - @method computed.any - @for Ember + @method any + @for Ember.computed @param {String} dependentKey* @return {Ember.ComputedProperty} computed property which returns the first truthy value of given list of properties. @deprecated Use `Ember.computed.or` instead. */ @@ -4713,12 +4715,12 @@ hamster.set('hat', 'Camp Hat'); hamster.set('shirt', 'Camp Shirt'); hamster.get('clothes'); // ['Camp Hat', 'Camp Shirt'] ``` - @method computed.collect - @for Ember + @method collect + @for Ember.computed @param {String} dependentKey* @return {Ember.ComputedProperty} computed property which maps values of all passed in properties to an array. */ var collect = generateComputedWithProperties(function(properties) { @@ -4753,12 +4755,12 @@ alex.set('nomen', '@machty'); alex.get('name'); // '@machty' ``` - @method computed.alias - @for Ember + @method alias + @for Ember.computed @param {String} dependentKey @return {Ember.ComputedProperty} computed property which creates an alias to the original value for property. */ @@ -4786,12 +4788,12 @@ teddy.get('nickName'); // 'Teddy' teddy.set('nickName', 'TeddyBear'); // 'TeddyBear' teddy.get('firstName'); // 'Teddy' ``` - @method computed.oneWay - @for Ember + @method oneWay + @for Ember.computed @param {String} dependentKey @return {Ember.ComputedProperty} computed property which creates a one way computed property to the original value for property. */ function oneWay(dependentKey) { @@ -4834,12 +4836,12 @@ 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 + @method readOnly + @for Ember.computed @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 */ @@ -4865,12 +4867,12 @@ hamster.set('wishList', 'More Unit Tests'); hamster.get('wishList'); // 'More Unit Tests' hamster.get('favoriteFood'); // 'Banana' ``` - @method computed.defaultTo - @for Ember + @method defaultTo + @for Ember.computed @param {String} defaultPath @return {Ember.ComputedProperty} computed property which acts like a standard getter and setter, but defaults to the value from `defaultPath`. @deprecated Use `Ember.computed.oneWay` or custom CP with default instead. */ @@ -4888,12 +4890,12 @@ 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 + @method deprecatingAlias + @for Ember.computed @param {String} dependentKey @return {Ember.ComputedProperty} computed property which creates an alias with a deprecation to the original value for property. @since 1.7.0 */ @@ -4943,11 +4945,11 @@ The core Runtime framework is based on the jQuery API with a number of performance optimizations. @class Ember @static - @version 1.11.0-beta.2 + @version 1.11.0-beta.3.780ac356 */ 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. @@ -4971,14 +4973,14 @@ /** @property VERSION @type String - @default '1.11.0-beta.2' + @default '1.11.0-beta.3.780ac356' @static */ - Ember.VERSION = '1.11.0-beta.2'; + Ember.VERSION = '1.11.0-beta.3.780ac356'; /** Standard environmental variables. You can define these in a global `EmberENV` variable before loading Ember to control various configuration settings. @@ -12987,12 +12989,12 @@ /** A computed property that returns the sum of the value in the dependent array. - @method computed.sum - @for Ember + @method sum + @for Ember.computed @param {String} dependentKey @return {Ember.ComputedProperty} computes the sum of all values in the dependentKey's array @since 1.4.0 */ @@ -13036,12 +13038,12 @@ age: 8 }]); lordByron.get('maxChildAge'); // 8 ``` - @method computed.max - @for Ember + @method max + @for Ember.computed @param {String} dependentKey @return {Ember.ComputedProperty} computes the largest value in the dependentKey's array */ function max(dependentKey) { return reduce_computed.reduceComputed(dependentKey, { @@ -13085,12 +13087,12 @@ age: 8 }]); lordByron.get('minChildAge'); // 5 ``` - @method computed.min - @for Ember + @method min + @for Ember.computed @param {String} dependentKey @return {Ember.ComputedProperty} computes the smallest value in the dependentKey's array */ function min(dependentKey) { return reduce_computed.reduceComputed(dependentKey, { @@ -13133,12 +13135,12 @@ }); hamster.get('excitingChores'); // ['CLEAN!', 'WRITE MORE UNIT TESTS!'] ``` - @method computed.map - @for Ember + @method map + @for Ember.computed @param {String} dependentKey @param {Function} callback @return {Ember.ComputedProperty} an array mapped via the callback */ function map(dependentKey, callback) { @@ -13178,24 +13180,24 @@ age: 8 }]); lordByron.get('childAges'); // [7, 5, 8] ``` - @method computed.mapBy - @for Ember + @method mapBy + @for Ember.computed @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 property_get.get(item, propertyKey); }; return map(dependentKey + '.@each.' + propertyKey, callback); } /** - @method computed.mapProperty - @for Ember + @method mapProperty + @for Ember.computed @deprecated Use `Ember.computed.mapBy` instead @param dependentKey @param propertyKey */ var mapProperty = mapBy; @@ -13228,12 +13230,12 @@ }); hamster.get('remainingChores'); // [{name: 'write more unit tests', done: false}] ``` - @method computed.filter - @for Ember + @method filter + @for Ember.computed @param {String} dependentKey @param {Function} callback @return {Ember.ComputedProperty} the filtered array */ function filter(dependentKey, callback) { @@ -13284,12 +13286,12 @@ }); hamster.get('remainingChores'); // [{ name: 'write more unit tests', done: false }] ``` - @method computed.filterBy - @for Ember + @method filterBy + @for Ember.computed @param {String} dependentKey @param {String} propertyKey @param {*} value @return {Ember.ComputedProperty} the filtered array */ @@ -13308,12 +13310,12 @@ return filter(dependentKey + '.@each.' + propertyKey, callback); } /** - @method computed.filterProperty - @for Ember + @method filterProperty + @for Ember.computed @param dependentKey @param propertyKey @param value @deprecated Use `Ember.computed.filterBy` instead */ @@ -13340,12 +13342,12 @@ }); hamster.get('uniqueFruits'); // ['banana', 'grape', 'kale'] ``` - @method computed.uniq - @for Ember + @method uniq + @for Ember.computed @param {String} propertyKey* @return {Ember.ComputedProperty} computes a new array with all the unique elements from the dependent array */ function uniq() { @@ -13384,12 +13386,12 @@ } /** Alias for [Ember.computed.uniq](/api/#method_computed_uniq). - @method computed.union - @for Ember + @method union + @for Ember.computed @param {String} propertyKey* @return {Ember.ComputedProperty} computes a new array with all the unique elements from the dependent array */ var union = uniq; @@ -13408,12 +13410,12 @@ }); obj.get('friendsInCommon'); // ['William King', 'Mary Somerville'] ``` - @method computed.intersect - @for Ember + @method intersect + @for Ember.computed @param {String} propertyKey* @return {Ember.ComputedProperty} computes a new array with all the duplicated elements from the dependent arrays */ function intersect() { @@ -13495,12 +13497,12 @@ }); hamster.get('wants'); // ['banana'] ``` - @method computed.setDiff - @for Ember + @method setDiff + @for Ember.computed @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 @@ -13639,11 +13641,11 @@ 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 + @method sort + @for Ember.computed @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