在开发中,经常会遇到这样的场景:
如用户的性别分为“男”和“女”,在数据库中保存的值为1和0,用户在查看自己的性别时后端返回的值自然是1或0,前端要转换为“男”或“女”再显示出来;
如我要换个羽毛球拍,某猫上羽毛球拍的品牌多达数十种,我想单独查看YONEX这个品牌的羽毛球拍;
买完羽毛球拍我还想买一桶羽毛球,点击按销量排序展示商品;
以上三种场景分别对数据进行了转换/筛选/排序,总而言之就是对数据的格式化,AngularJS的filter就是用来做这个事的。
一.内置过滤器
AngularJS内置了很多过滤器,在HTML模板的绑定符号{{}}内通过|来调用过滤器,如字母转换成大写:$scope.name='wangmeijian'
{{name | uppercase}} // 输出 WANGMEIJIAN
数字转成千分位写法:$scope.num = 12345678
{{num | number}} // 输出 12,345,678
日期格式化:$scope.date=new Date()
{{date | date:'yy-MM-dd'}} // 输出 2015-11-19
数字格式化成货币:$scope.num=987654321
{{num | currency:'¥'}} // 输出 ¥987,654,321.00
实例如下:
index.html
<html ng-app='app'>
<head>
<title>AngularJS过滤器filter入门</title>
</head>
<body ng-controller='myController'>
<p>{{name}}转换成大写:{{name | uppercase}}</p>
<p>12345678数字转成千分位写法:{{num | number}}</p>
<p>日期格式化:{{date | date:'yy-MM-dd'}}</p>
<p>{{987654321| currency:'¥'}}</p>
</body>
<script type="text/javascript" src="angular1.2.9.js" ></script>
<script type="text/javascript" src="filter.js" ></script>
</html>
filter.js
var app = angular.module('app',[])
.controller('myController',['$scope', function($scope){
$scope.name = 'abcdefg';
$scope.num = 12345678;
$scope.date = new Date();
}])
运行效果:
稍微复杂一点的过滤器——‘filter’,可以返回给定数组的子集,它接收一个参数,这个参数可以是字符串、对象、函数。
字符串:返回所有包含这个字符串的元素,想要返回不包含这个字符串的元素则在前面加!
demo:
{{['wang','mei','jian'] | filter:'a'}} // 返回包含字母a的元素 ['wang','jian']
对象:Angular会将待过滤对象的属性与这个对象中的同名属性进行比较,如果属性值是字符串会判断是否包含该字符串(注意这里是包含,并不需要完全相等)
demo:
{{ [
{
name: 'wangmeijian',
sex: 'boy'
},
{
name: 'bokeyuan',
sex: 'sex'
}
] | filter:{
sex: 'bo'
}
}}
// 输出 [{"name":"wangmeijian","sex":"boy"}]
函数:对每个元素都执行该函数,返回非假值的元素会出现在新的数组中并返回
demo:
$scope.getNumber = function(n){
return !isNaN(n);
}
{{ ['demo',2,3] | filter:getNumber}} // 输出 [2,3]
二.自定义过滤器
当内置函数不能满足你的业务需求时,就需要自定义一个过滤器,自定义过滤器返回一个函数,函数的参数就是HTML模板中|左侧的数据,它会自动传入过滤器中。
比如需求是将一句话中的每个单词首字母变成大写。
index02.html
<html ng-app='app'>
<head>
<title>AngularJS过滤器filter入门</title>
</head>
<body ng-controller='myController'>
<p>{{ str | capitalize}}</p>
<!-- 输出 Hello, Welcome To Iteye! -->
</body>
<script type="text/javascript" src="angular1.2.9.js" ></script>
<script type="text/javascript" src="index02Filter.js" ></script>
</html>
index02Filter.js
var app = angular.module('app',[])
.controller('myController',['$scope', function($scope){
$scope.str = 'hello, welcome to iteye!'
}])
.filter('capitalize', function(){
return function(str){
var arr = str.split(/\s+/);
for (var i = 0; i < arr.length; i++) {
arr[i] = arr[i].substr(0,1).toUpperCase() + arr[i].slice(1);
};
return arr.join(" ")
}
})
运行效果:
需要注意的是,内置过滤器‘filter’的参数是函数时,会对数组的每个元素执行该函数,自定义过滤器是对数组对象执行它return的函数。
三.实际应用
在实际应用中,会存在对金额进行取两位小数且做千位分隔符的处理,可以将其做成服务在控制器中调用,也可封装成一个过滤器。如下所示:
index03.html
<html ng-app='app'>
<head>
<title>AngularJS过滤器filter入门</title>
</head>
<body ng-controller='myController'>
<p ng-bind='formatNum'></p>
<p>{{ num | bitSeparatorFilter}}</p>
</body>
<script type="text/javascript" src="angular1.2.9.js" ></script>
<script type="text/javascript" src="index03Filter.js" ></script>
</html>
index03Filter.js
var app = angular.module('app',[])
.factory('floatUtil', function() {
return {
/**
* 将浮点数num转换为指定位数places的字符串,位数不够时会四舍五入
* */
toFixed: function (num, places) {
var times = Math.pow(10, places);
var des = num * times + 0.5;
var numStr = (parseInt(des, 10) / times) + '';
var decimalPlaces = this.getDecimalPlaces(numStr); //小数位数
if (decimalPlaces > 0) {
numStr = this.addZero(numStr, places - decimalPlaces);
} else { //整型
numStr = this.addZero(numStr + '.', places);
}
return numStr;
},
/**
* 为字符串结尾添加指定个零
* */
addZero: function (numStr, zeroNum) {
var zeroStr = '';
zeroNum = zeroNum < 0 ? 0 : zeroNum;
for (var i = 0; i < zeroNum; i++) {
zeroStr += '0';
}
return numStr + zeroStr;
},
/**
* 获取小数的位数
* */
getDecimalPlaces: function (num) {
var numStr = num.toString();
if (numStr.indexOf('.') > -1) {
return numStr.split('.')[1].length;
}
return 0;
}
};
})
.factory('baseUtil', function(floatUtil) {
/**
* 千位分隔符
* */
function bitSeparator(num) {
if (num === 0) {
return '0.00';
}
if (!num) {
return num;
}
var numStr = floatUtil.toFixed(num, 2);
var decimalStr = '';
if (numStr.indexOf('.') != -1) {//有小数位
var numArr = numStr.split('.');
numStr = numArr[0];
decimalStr = '.' + numArr[1];
}
return numStr.replace(/(\d)(?=(?:\d{3})+$)/g, '$1,') + decimalStr;
}
return {
bitSeparator: bitSeparator
};
})
.controller('myController',['$scope', 'baseUtil', function($scope, baseUtil){
$scope.num = '1352626.32';
$scope.formatNum = baseUtil.bitSeparator($scope.num);
}])
.filter('bitSeparatorFilter', function(baseUtil){
return function(str){
return baseUtil.bitSeparator(str);
};
})
运行效果: