W3cubDocs

Improve this Doc View Source limitTo

filter in module ng

Creates a new array or string containing only a specified number of elements. The elements are taken from either the beginning or the end of the source array, string or number, as specified by the value and sign (positive or negative) of limit. Other array-like objects are also supported (e.g. array subclasses, NodeLists, jqLite/jQuery collections etc). If a number is used as input, it is converted to a string.

Usage

In HTML Template Binding

{{ limitTo_expression | limitTo : limit : begin}}

In JavaScript

$filter('limitTo')(input, limit, begin)

Arguments

Param	Type	Details
input	`ArrayArrayLikestringnumber`	Array/array-like, string or number to be limited.
limit	`stringnumber`	The length of the returned array or string. If the `limit` number is positive, `limit` number of items from the beginning of the source array/string are copied. If the number is negative, `limit` number of items from the end of the source array/string are copied. The `limit` will be trimmed if it exceeds `array.length`. If `limit` is undefined, the input will be returned unchanged.
begin (optional)	`stringnumber`	Index at which to begin limitation. As a negative index, `begin` indicates an offset from the end of `input`. Defaults to `0`.

Returns

Arraystring

A new sub-array or substring of length limit or less if the input had less than limit elements.

© 2010–2017 Google, Inc.
Licensed under the Creative Commons Attribution License 4.0.
https://code.angularjs.org/1.5.11/docs/api/ng/filter/limitTo