17. 自定义过滤器
先来回顾一下 ng 中的一些概念:
- module ,代码的组织单元,其它东西都是在定义在具体的模块中的。
- app ,业务概念,可能会用到多个模块。
- service ,仅在数据层面实现特定业务功能的代码封装。
- controller ,与 DOM 结构相关联的东西,即是一种业务封装概念,又体现了项目组织的层级结构。
- filter ,改变输入数据的一种机制。
- directive ,与 DOM 结构相关联的,特定功能的封装形式。
上面的这几个概念基本上就是 ng 的全部。每一部分都可以自由定义,使用时通过各要素的相互配合来实现我们的业务需求。
我们从最开始一致打交道的东西基本上都是 controller 层面的东西。在前面,也介绍了 module 和 service 的自定义。剩下的会介绍 filter 和 directive 的定义。基本上这几部分的定义形式都是一样的,原理上是通过 provider
来做注入形式的声明,在实际操作过程中,又有很多 shortcut 式的声明方式。
过滤器的自定义是最简单的,就是一个函数,接受输入,然后返回结果。在考虑过滤器时,我觉得很重要的一点: 无状态 。
具体来说,过滤器就是一个函数,函数的本质含义就是确定的输入一定得到确定的输出。虽然 filter 是定义在 module 当中的,而且 filter 又是在 controller 的 DOM 范围内使用的,但是,它和具体的 module , controller , scope 这些概念都没有关系(虽然在这里你可以使用 js 的闭包机制玩些花样),它仅仅是一个函数,而已。换句话说,它没有任何上下文关联的能力。
过滤器基本的定义方式:
- var app = angular.module('Demo', [], angular.noop);
app.filter('map', function(){
var filter = function(input){
return input + '…';
};
return filter;
});
上面的代码定义了一个叫做 map
的过滤器。使用时:
- <p>示例数据: {{ a|map }}</p>
过滤器也可以带参数,多个参数之间使用 :
分割,看一个完整的例子:
- 1 <div ng-controller="TestCtrl">
2 <p>示例数据: {{ a|map:map_value:'>>':'(no)' }}</p>
3 <p>示例数据: {{ b|map:map_value:'>>':'(no)' }}</p>
4 </div>
5
6
7 <script type="text/javascript">
8
9 var app = angular.module('Demo', [], angular.noop);
10 app.controller('TestCtrl', function($scope){
11 $scope.map_value = {
12 a: '一',
13 b: '二',
14 c: '三'
15 }
16 $scope.a = 'a';
17 });
18
19 app.filter('map', function(){
20 var filter = function(input, map_value, append, default_value){
21 var r = map_value[input];
22 if(r === undefined){ return default_value + append }
23 else { return r + append }
24 };
25 return filter;
26 });
27
28 angular.bootstrap(document, ['Demo']);
29 </script>