Filter
Ng里的过滤器。
currency:把一个数字格式化成货币模式(如$1,234.56)。当没有提供任何货币符号时,默认使用当前区域的符号。
使用:
HTML:{{ currency_expression | currency:symbol:fractionSize}}
JS:$filter(“currency”)(amount,symbol,fractionSize);
amount:数值,过滤的值。
symbol:字符串,要显示的货币符号或标识符。
fractionSize:数值,整数的小数位数,默认为当前的最大位数。
date:基于需要的格式将时间格式化成字符串。
使用:
HTML:{{date_expression | date:format:timezone}}
JS:$filter(“date”)(date,format,timezone);
date:格式化为日期的日期对象。如果没有指定输入的时区字符串,时间则是当地时间。
format:格式规则/格式。
timezone:时区。
filter:从数组中选出一个子集,并将其作为一个新数组返回。
使用:
HTML:{{filter_expression | filter:expression:comparator}}
JS:$filter(“filter”)(array,expression,comparator);
array:被过滤的数组。
expression:字符串/对象/函数,用于从数组中选择数据的判断表达式。使用$可以匹配任何字段。
comparator:函数/Boolean/undefined,用于确定预期的值(从filter表达式返回)和实际的值(数组中的对象)进行比较,应视为匹配。function(actual,expected);
json:允许将一个javascript对象转换为json字符串。
使用:
HTML:{{json_expression | json:spacing}}
JS:$filter(“json”)(object,spacing);
object:过滤的对象。
spacing:每个缩进的空格数,默认为2。
limitTo:创建一个只包含指定数目元素的数组或字符串。元素是按指定的值和符号(+或-)从数组、字符串或数字的开头或结尾获取的。如果输入一个数字,则转换为字符串。
使用:
HTML:{{limitTo_expression | limitTo:limit:begin}}
JS:$filter(“limitTo”)(input,limit,begin);
input:限制的数组,字符串,数字。
limit:限制的长度。
begin:限制长度开始的位置(根据索引)。
lowercase:将字符串转换为小写。
使用:
HTML:{{lowercase_expression | lowercase}}
JS:$filter(“lowercase”)(input);
Input:过滤的字符串。
number:将数值转换为文本。
如果输入是null或undefined,那么其将被返回。如果输入的是无穷(正无穷/负无穷),将会返回无穷大的符号“∞”。如果输入不是一个数字,返回一个空字符串。
使用:
HTML:{{number_expression | number:fractionSize}}
JS:$filter(“number”)(number,fractionSize);
number:转换的数值。
fractionSize:数值,整数的小数位数,默认为当前的最大位数。在默认的区域设置的情况下这个数值是3。
orderBy:通过判断表达式将指定的数组进行排序。它是按字符串的字母顺序和数值的数字排序的。
注意:如果你发现数字没有按预期排序,请确保它们实际上是被保存为数字而不是字符串。
使用:
HTML:{{orderBy_expression | orderBy:expression:reverse}}
JS:$filter(“orderBy”)(array,expression,reverse);
array:排序的数组。
expression:字符串/函数/数组,用来确定元素顺序的表达式。
reverse:boolean,颠倒数组的顺序。默认为false。
uppercase:将字符串转换为大写。
使用:
HTML:{{uppercase_expression |uppercase}}
JS:$filter(“uppercase”)(input);
Input:过滤的字符串。
自带filter使用代码:
<div ng-app="Demo" ng-controller="testCtrl as ctrl">
<!-- HTML: {{ctrl.currencyValue | currency:"USD$":1}} -->
{{ctrl.currencyValue}}
<!-- HTML: {{ctrl.dateValue | date:"yyyy-MM-dd"}} -->
{{ctrl.dateValue}}
<!-- HTML: <div ng-repeat="i in newArr = (ctrl.arr | filter:'2')">{{i}}</div> -->
<div ng-repeat="i in ctrl.newArr">{{i}}</div>
<!-- HTML: <div ng-repeat="i in newArr = (ctrl.arr | filter:{check:true})">{{i}}</div> -->
<div ng-repeat="i in ctrl._newArr">{{i}}</div>
{{ctrl.obj | json}}
<!-- HTML: <div ng-repeat="i in ctrl.arr | limitTo:3:2">{{i}}</div> -->
<div ng-repeat="i in ctrl.secondNewArr">{{i}}</div>
<!-- HTML: {{ctrl.str | lowercase}} -->
{{ctrl.str}}
<!-- HTML: <div ng-repeat="i in ctrl.arr | orderBy:'name':true">{{i}}</div> -->
<div ng-repeat="i in ctrl.thirdNewArr">{{i}}</div>
<!-- HTML: {{ctrl.str | uppercase}} -->
{{ctrl.newStr}}
</div>
(function () {
angular.module("Demo", [])
.controller("testCtrl", ["$filter",testCtrl]);
function testCtrl($filter) {
this.currencyValue = 1234.56;
this.currencyValue = $filter("currency")(this.currencyValue,"USD$",1);
this.dateValue = new Date();
this.dateValue = $filter("date")(this.dateValue,"yyyy-MM-dd");
this.arr = [{name:'John', phone:'555-1276',check:true},
{name:'Mary', phone:'800-BIG-MARY',check:false},
{name:'Mike', phone:'555-4321',check:true},
{name:'Adam', phone:'555-5678',check:true},
{name:'Julie', phone:'555-8765',check:false},
{name:'Juliette', phone:'555-5678',check:true}];
this.newArr = $filter("filter")(this.arr,"2");
this._newArr = $filter("filter")(this.arr,{check:true});
this.obj = {"name":"beast","age":21};
this.secondNewArr = $filter("limitTo")(this.arr,3,2);
this.str = "Hello World";
this.str = $filter("lowercase")(this.str);
this.thirdNewArr = $filter("orderBy")(this.arr,"name",true);
this.newStr = $filter("uppercase")(this.str);
};
}());
自定义filter
基本代码:
angular.module(“x”,[]).filter(“filterName”,[“dependancy”,function(dependancy){
return function(value){
//your code return the data which passed filter(返回过滤后的数据)
};
}]);
filterName:过滤器名称。
dependency:注入的服务。
value:需要过滤的数据。
自定义filter使用代码:
<div ng-app="Demo" ng-controller="testCtrl as ctrl">
<div ng-repeat="i in newArr=(ctrl.arr | myFilter)">
{{i.value}}
</div>
</div>
(function () {
angular.module("Demo", [])
.filter("myFilter",myFilter)
.controller("testCtrl", ["$filter",testCtrl]);
function myFilter(){
return function(value){
var arr = [];
angular.forEach(value,function(item,index){
if(item.value.indexOf("this")>=0){
arr.push(item);
}
});
return arr;
}
};
function testCtrl($filter) {
this.arr = [{"value":"this is a."},{"value":"that is b."},{"value":"this is c."},{"value":"that is a."}];
};
}());
这里对数组arr进行过滤,把数组中对象value属性的值含有”this“文本的对象都放进个新数组并返回该数组。
关于自定义filter中为什么执行两次的问题请参考:Stack Overflow