angular.Array.limitTo

Description

Creates a new array containing only a specified number of elements in an array. The elements are taken from either the beginning or the end of the source array, as specified by the value and sign (positive or negative) of limit.

Note: This function is used to augment the Array type in Angular expressions. See angular.Array for more information about Angular arrays.

Usage

angular.Array.limitTo(array, limit);

Parameters

Returns

{Array}

A new sub-array of length limit.

Example

  <div ng:init="numbers = [1,2,3,4,5,6,7,8,9]">
    Limit [1,2,3,4,5,6,7,8,9] to: <input name="limit" value="3"/>
    <p>Output: {{ numbers.$limitTo(limit) | json }}</p>
  </div>
  it('should limit the numer array to first three items', function() {
    expect(element('.doc-example-live input[name=limit]').val()).toBe('3');
    expect(binding('numbers.$limitTo(limit) | json')).toEqual('[1,2,3]');
  });

  it('should update the output when -3 is entered', function() {
    input('limit').enter(-3);
    expect(binding('numbers.$limitTo(limit) | json')).toEqual('[7,8,9]');
  });