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.
angular.Array.limitTo(array, limit);
array – {Array} –
Source array to be limited.
limit – {string|Number} –
The length of the returned array. If the limit
number is
positive, limit
number of items from the beginning of the source array are copied.
If the number is negative, limit
number of items from the end of the source array are
copied. The limit
will be trimmed if it exceeds array.length
{Array}
– A new sub-array of length limit
or less if input array had less than limit
elements.
<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]'); }); it('should not exceed the maximum size of input array', function() { input('limit').enter(100); expect(binding('numbers.$limitTo(limit) | json')).toEqual('[1,2,3,4,5,6,7,8,9]'); });