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

Обзор

Возвращает массив, содержащий элементы из указанного collection, отсортированные по comparator функции на основе значений, вычисленных с помощью expression предиката.

Например, [{id: 'foo'}, {id: 'bar'}] | orderBy:'id' приведет к [{id: 'bar'}, {id: 'foo'}].

collection может быть массивом или массивоподобным объектом (например, NodeList, объект jQuery, TypedArray, строка и т. д.).

expression может быть одним предикатом или списком предикатов, каждый из которых служит разрывом для предыдущего. expression оценивается для каждого элемента, а вывод используется для сравнения с другими элементами.

Вы можете изменить порядок сортировки, установив reverse в true. По умолчанию элементы сортируются по возрастанию.

Сравнение выполняется с помощью функции comparator. Если она не указана, используется по умолчанию встроенный компаратор (подробности см. ниже — вкратце, он сравнивает числа численно, а строки по алфавиту).

Внутри

Сортировка указанного collection происходит в два этапа:

1. Все элементы передаются через предикат (или предикаты), и возвращаемые значения сохраняются вместе с их типом (string, number и т. д.). Например, элемент {label: 'foo'}, прошедший через предикат, извлекающий значение свойства label, будет преобразован в:

   {
     value: 'foo',
     type: 'string',
     index: ...
   }
   

2. Функция компаратора используется для сортировки элементов на основе полученных значений, типов и индексов.

Если вы используете пользовательский компаратор, он будет вызываться с парами объектов вида {value: ..., type: '...', index: ...} и должен возвращать 0, если объекты равны (с точки зрения компаратора), -1, если первый объект должен иметь более высокую позицию, чем второй, или 1 в противном случае.

Чтобы гарантировать детерминированную сортировку на всех платформах, если ни один из указанных предикатов не может отличить два элемента, orderBy автоматически введет дополнительный предикат, который возвращает индекс элемента в качестве value. (Если вы используете пользовательский компаратор, убедитесь, что он также может обрабатывать этот предикат.)

Если пользовательский компаратор по-прежнему не может отличить два элемента, они будут отсортированы по своему индексу с использованием встроенного компаратора.

Наконец, чтобы упростить вещи, если предикат возвращает объект в качестве извлечённого значения для элемента, orderBy попытается преобразовать этот объект в примитивное значение перед передачей его компаратору. Следующие правила управляют преобразованием:

1. Если объект имеет метод valueOf(), который возвращает примитив, его возвращаемое значение будет использоваться вместо него.
   (Если объект имеет метод valueOf(), который возвращает другой объект, то возвращаемый объект будет использоваться на последующих шагах.)
2. Если у объекта есть пользовательский метод toString() (т. е. не унаследованный от Object), который возвращает примитив, его возвращаемое значение будет использоваться вместо него.
   (Если объект имеет метод toString(), который возвращает другой объект, то возвращаемый объект будет использоваться на последующих шагах.)
3. Преобразование не выполняется; используется сам объект.

Встроенный компаратор по умолчанию

Встроенный компаратор по умолчанию должен подойти для большинства случаев использования. Короче говоря, он сравнивает числа численно, строки алфавитно (и регистронезависимо), для объектов использует их индекс в исходном наборе, и сортирует значения разных типов по типу.

Более конкретно, он выполняет следующие действия для определения относительного порядка элементов:

1. Если сравниваемые значения имеют разные типы, сравните типы сами по алфавиту.
2. Если оба значения имеют тип string, сравните их алфавитно, не учитывая регистр и локаль.
3. Если оба значения являются объектами, сравните их индексы.
4. В противном случае верните:
   • 0, если значения равны (по точному сравнению, т. е. используя ===).
   • -1, если первое значение "меньше", чем второе значение (сравнение выполняется с помощью оператора <).
   • 1, в противном случае.

Примечание: Если вы заметили, что числа не сортируются так, как ожидается, убедитесь, что они фактически сохраняются как числа, а не строки. Примечание: Для целей сортировки значения null обрабатываются как строка 'null' (т. е. type: 'string', value: 'null'). Это может привести к неожиданному порядку сортировки по сравнению с другими значениями.

{{ orderBy_expression | orderBy : expression : reverse : comparator}}

$filter('orderBy')(collection, expression, reverse, comparator)