Улучшить эту документацию Посмотреть исходный код orderBy

Фильтр в модуле ng

Сортирует указанный array по заданному expression предикату. Строки сортируются по алфавиту, а числа — по числовому значению. Примечание: если вы заметили, что числа сортируются неправильно, убедитесь, что они сохраняются как числа, а не строки.

Использование

В привязке шаблона HTML

{{ orderBy_expression | orderBy : expression : reverse}}

В JavaScript

$filter('orderBy')(array, expression, reverse)

Аргументы

Параметр Тип Подробности

массив

Параметр	Тип	Подробности
массив	`Array`	Массив для сортировки.
выражение	`function()stringArray.<(function()\|string)>=`	Предикат, используемый компаратором для определения порядка элементов. Может быть одним из следующих: `function`: Функция-получатель. Результат этой функции будет отсортирован с использованием `<`, `=`, `>` оператора. `string`: Выражение Angular. Результат этого выражения используется для сравнения элементов (например, `name` для сортировки по свойству с именем `name` или `name.substr(0, 3)` для сортировки по первым 3 символам свойства с именем `name`). Результат константного выражения интерпретируется как имя свойства, используемого для сравнений (например, `"special name"` для сортировки объектов по значению их свойства `special name`). Выражение можно дополнительно префиксровать `+` или `-` для управления порядком сортировки по возрастанию или убыванию (например, `+name` или `-name`). Если свойство не указано (например, `'+'`) , то для сравнения используется сам элемент массива. `Array`: Массив функций или строковых предикатов. Первый предикат в массиве используется для сортировки, но если два элемента эквивалентны, используется следующий предикат. Если предикат отсутствует или пуст, по умолчанию используется `'+'`.
reverse (необязательно)	`boolean`	Инвертировать порядок элементов массива.

Array

Массив для сортировки.

выражение

function(*)stringArray.<(function(*)|string)>=

Предикат, используемый компаратором для определения порядка элементов.

Может быть одним из следующих:

function: Функция-получатель. Результат этой функции будет отсортирован с использованием <, =, > оператора.
string: Выражение Angular. Результат этого выражения используется для сравнения элементов (например, name для сортировки по свойству с именем name или name.substr(0, 3) для сортировки по первым 3 символам свойства с именем name). Результат константного выражения интерпретируется как имя свойства, используемого для сравнений (например, "special name" для сортировки объектов по значению их свойства special name). Выражение можно дополнительно префиксровать + или - для управления порядком сортировки по возрастанию или убыванию (например, +name или -name). Если свойство не указано (например, '+') , то для сравнения используется сам элемент массива.
Array: Массив функций или строковых предикатов. Первый предикат в массиве используется для сортировки, но если два элемента эквивалентны, используется следующий предикат.

Если предикат отсутствует или пуст, по умолчанию используется '+'.

reverse

(необязательно)

boolean

Инвертировать порядок элементов массива.

Возвращает

Array

Отсортированная копия исходного массива.

Также возможно вызвать фильтр orderBy вручную, внедрив $filter, получив функцию фильтра с помощью $filter('orderBy'), и вызвав полученную функцию с нужными параметрами.

Пример:

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