ember-array-computed-macros

Macros

This addon is supplemental to the already existing array computed macros existing in Ember.js

maxBy(listProperty, valueProperty)

Takes all values of valueProperty from listProperty and then picks the maximum value from that.

Example:

var ContactList = Ember.Component.extend({
  highestAge: maxBy('people', 'age')
});

const myContactList = ContactList.create({
  people: [
    { first: 'Tom', last: 'Dale', age: 21 },
    { first: 'Yehuda', last: 'Katz', age: 42 }
  ]
}).

myContactList.get('highestAge') // returns 42

minBy(listPropery, valueProperty)

See maxBy, except it takes the minimum value instead of the maximum.

orderBy(listProperty, ...sortProperties)

Takes a listProperty and returns that list sorted by the sortProperties. Append :desc to the sort property to sort in reverse order for that property.

import Ember from 'ember';
import { map } from 'ember-array-computed-macros';

export default Ember.Component.extend({
  names: [
    { first: 'Tom', last: 'Dale', age: 21 },
    { first: 'Yehuda', last: 'Katz', age: 42 }
  ],
  orderedNames: orderBy('names', 'last', 'first'. 'age:desc')
});

There is also a variant for groupBy that works with a dynamic list of sortProperties called groupByComputedProperty:

import Ember from 'ember';
import { map } from 'ember-array-computed-macros';

export default Ember.Component.extend({
  names: [
    { first: 'Tom', last: 'Dale', age: 21 },
    { first: 'Yehuda', last: 'Katz', age: 42 }
  ],

  nameOrdering: ['last', 'first', 'age:desc'],
  orderedNames: orderByComputedProperty('names', 'nameOrdering')
});

groupBy(listProperty, valueProperty)

Pushes all items in listProperty that have the same value at valueProperty into an array.

var ContactList = Ember.Component.extend({
  groupedByAge: groupBy('people', 'age')
});

const myContactList = ContactList.create({
  people: [
    { first: 'Tom', last: 'Dale', age: 21 },
    { first: 'Yehuda', last: 'Katz', age: 42 },
    { first: 'Robert', last: 'Jackson', age: 42 },
    { first: 'Stefan', last: 'Penner', age 33 }
  ]
}).

myContactList.get('groupedByAge') // returns:
//[
//  [
//    { first: 'Tom', last: 'Dale', age: 21 }
//  ],
//  [
//    { first: 'Yehuda', last: 'Katz', age: 42 },
//    { first: 'Robert', last: 'Jackson', age: 42 }
//  ],
//  [
//    { first: 'Stefan', last: 'Penner', age 33 }
//  ]
//]

sumBy(listProperty, valueProperty)

Takes all values of valueProperty from listProperty and then sums those values.

Example:

var ContactList = Ember.Component.extend({
  collectiveAge: sumBy('people', 'age')
});

const myContactList = ContactList.create({
  people: [
    { first: 'Tom', last: 'Dale', age: 21 },
    { first: 'Yehuda', last: 'Katz', age: 42 }
  ]
}).

myContactList.get('collectiveAge') // returns 53

meanBy(listProperty, valueProperty)

Takes all values of valueProperty from listProperty and calculate their arithmetic mean value.

Example:

var ContactList = Ember.Component.extend({
  averageAge: meanBy('people', 'age')
});

const myContactList = ContactList.create({
  people: [
    { first: 'Tom', last: 'Dale', age: 21 },
    { first: 'Yehuda', last: 'Katz', age: 42 }
  ]
}).

myContactList.get('collectiveAge') // returns 31.5

reverse(listProperty)

Reverses the array at listProperty with Array.prototype.reverse.

everyBy(listPropery, valueProperty)

Takes all values of valueProperty from listProperty and then checks if all of those values are truthy.

anyBy(listProperty, valueProperty)

Takes all values of valueProperty from listProperty and then checks if any of those values are truthy.

From Ember.js

The addon re-exports all array computed macros from Ember.js for convenience.

• map
• mapBy
• filter
• filterBy
• min
• max
• sum
• sort

Use with decorators

import Ember from 'ember';
import { map } from 'ember-array-computed-macros/decorators';

export default Ember.Component.extend({
  names: [
    { first: 'Tom', last: 'Dale' },
    { first: 'Yehuda', last: 'Katz' }
  ],
  
  @mapBy('names', 'first')
  firstNames
});

Installation

• git clone this repository
• npm install
• bower install

Running

• ember server
• Visit your app at http://localhost:4200.

Running Tests

• ember test
• ember test --server

Building

• ember build

For more information on using ember-cli, visit http://www.ember-cli.com/.