AngularJS: API: ng/filter/orderBy

orderBy

- filter in module ng

通过expression来排序指定的array。字符串按字母顺序排序，数字按大小排序。注意：如果你发现数字没被正确排序，请确认它们保存的是数字而不是字符串。

用法

用于HTML模板绑定

{{orderBy_expression|orderBy:expression:reverse}}

用于JavaScript

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

参数

参数类型详述

array

Array

参数	类型	详述
array	Array	用于排序的数组。
expression	function()stringArray.<(function()\|string)>	一个用于通过比较来决定元素顺序的声明。可为下列之一： `Function`: Getter函数。这个函数的结果可使用`<`,`=`,`>`操作符进行排序。 `string`: 一个Angular表达式，对一个对象求值来排序，如用'name'来对属性名为'name'排序。用可选前缀`+`或`-`来确定是正序或倒序 (例如，+name or -name)。 `Array`: 一个函数或字符串声明数组。数组中的第一个声明用于排序，但是当两个条目相等时，会用下一个声明。
reverse (可选)	boolean	对数组进行反向排序。

用于排序的数组。

expression

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

一个用于通过比较来决定元素顺序的声明。

可为下列之一：

Function: Getter函数。这个函数的结果可使用<,=,>操作符进行排序。
string: 一个Angular表达式，对一个对象求值来排序，如用'name'来对属性名为'name'排序。用可选前缀+或-来确定是正序或倒序 (例如，+name or -name)。
Array: 一个函数或字符串声明数组。数组中的第一个声明用于排序，但是当两个条目相等时，会用下一个声明。

reverse

(可选)

boolean

对数组进行反向排序。

返回值

Array

源数组排序后的副本。

示例

index.html

ng-controller="ExampleController">Sorting predicate = {{predicate}}; reverse = {{reverse}}[href=""ng-click="predicate=''">unsorted]class="friend">href=""ng-click="predicate = 'name'; reverse=false">名称(href=""ng-click="predicate = '-name'; reverse=false">^)href=""ng-click="predicate = 'phone'; reverse=!reverse">Phone Numberhref=""ng-click="predicate = 'age'; reverse=!reverse">Ageng-repeat="friend in friends | orderBy:predicate:reverse">{{friend.name}}{{friend.phone}}{{friend.age}}

也可以手工调用orderBy过滤器，通过注入$filter，使用$filter('orderBy')获取过滤器实例，然后使用所需参数调用过滤器实例。

示例:

index.html

ng-controller="Ctrl">class="friend">href=""ng-click="reverse=false;order('name', false)">名称(href=""ng-click="order('-name',false)">^)href=""ng-click="reverse=!reverse;order('phone', reverse)">Phone Numberhref=""ng-click="reverse=!reverse;order('age',reverse)">Ageng-repeat="friend in friends">{{friend.name}}{{friend.phone}}{{friend.age}}

script.js

angular.module('orderByExample',[]).controller('ExampleController',['$scope','$filter',Function($scope,$filter){varorderBy=$filter('orderBy');$scope.friends=[{name:'John',phone:'555-1212',age:10},{name:'Mary',phone:'555-9876',age:19},{name:'Mike',phone:'555-4321',age:21},{name:'Adam',phone:'555-5678',age:35},{name:'Julie',phone:'555-8765',age:29}];$scope.order=Function(predicate,reverse){$scope.friends=orderBy($scope.friends,predicate,reverse);};$scope.order('-age',false);}]);

Previous article： Next article：