Улучшить эту документацию Просмотреть исходный код 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: ...
   }
   

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

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

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

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

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

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

Встроенная функция сравнения

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

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

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

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

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

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