Angular学习笔记（2）—过滤器

过滤器用来格式化需要展示给用户的数据。AngularJS有很多实用的内置过滤器，同时也提供了方便的途径可以自己创建过滤器。
  在HTML中的模板绑定符号{{ }}内通过 | 符号来调用过滤器。如果要同时使用多个过滤器，可以用 | 符号作为分割符来使用多个过滤器。例如，假设我们希望将字符串转换成大写，可以对字符串中的每个字符都单独进行转换操作，也可以使用过滤器：{{ name | uppercase }}。
  在JavaScript代码中可以通过$filter来调用过滤器。例如，在JavaScript代码中使用lowercase过滤器：

app.controller('DemoController', ['$scope', '$filter',
    function($scope, $filter) {
        $scope.name = $filter('lowercase')('Ari');
}]);

以HTML的形式使用过滤器时，如果需要传递参数给过滤器，只要在过滤器名字后面加冒号即可。如果有多个参数，可以在每个参数后面都加入冒号。例如，数值过滤器可以限制小数点后的位数，在过滤器后写上 :2 可以将2作为参数传给过滤器：

{{ 123.456789 | number:2 }}

内置过滤器

currency

currecy过滤器可以将一个数值格式化为货币格式。

{{ 123456 | currency }}  

currecy过滤器允许我们自己设置货币符号。默认情况下会采用客户端所处区域的货币符号，但是也可以自定义货币符号。给currency传递一个字符串类型的参数，就可以自定义货币符号了。

{{ 123456 | currency:'￥' }}  

date

date过滤器可以将日期格式化成需要的格式。AngularJS中内置了几种日期格式，如果没有指定使用任何格式，默认会采用mediumDate格式。
下面是内置的支持本地化的日期格式：

{{ today | date:'medium' }}  
{{ today | date:'short' }}  
{{ today | date:'fullDate' }}  
{{ today | date:'longDate' }}  
{{ today | date:'mediumDate' }}  
{{ today | date:'shortDate' }}  
{{ today | date:'mediumTime' }}  
{{ today | date:'shortTime' }}  
// 年份格式化
四位年份：{{ today | date:'yyyy' }}  
两位年份：{{ today | date:'yy' }}  
一位年份：{{ today | date:'y' }}  
// 月份格式化
英文月份：{{ today | date:'MMMM' }}  
英文月份简写：{{ today | date:'MMM' }}  
数字月份：{{ today |date:'MM' }}  
一年中的第几个月份：{{ today |date:'M' }}  
// 日期格式化
数字日期：{{ today|date:'dd' }}  
一个月中的第几天：{{ today | date:'d' }}  
英文星期：{{ today | date:'EEEE' }}  
英文星期简写：{{ today | date:'EEE' }}  
// 小时格式化
24小时制数字小时：{{today|date:'HH'}}  
一天中的第几个小时：{{today|date:'H'}}  
12小时制数字小时：{{today|date:'hh'}}  
上午或下午的第几个小时：{{today|date:'h'}}  
// 分钟格式化
数字分钟数：{{ today | date:'mm' }}  
一个小时中的第几分钟：{{ today | date:'m' }}  
// 秒数格式化
数字秒数：{{ today | date:'ss' }}  
一分钟内的第几秒：{{ today | date:'s' }}  
毫秒数：{{ today | date:'.sss' } }  
// 字符格式化
上下午标识：{{ today | date:'a' }}  
四位时区标识：{{ today | date:'Z' }}  
// 一些自定义日期格式：
{{ today | date:'MMMd, y' }}  
{{ today | date:'EEEE, d, M' }}  
{{ today | date:'hh:mm:ss.sss' }}  

filter

filter过滤器可以从给定数组中选择一个子集，并将其生成一个新数组返回。这个过滤器通常用来过滤需要进行展示的元素。
  这个过滤器的第一个参数可以是字符串、对象或是一个用来从数组中选择元素的函数。下面分情况介绍传入不同类型的参数。

• 字符串
  返回所有包含这个字符串的元素。如果我们想返回不包含该字符串的元素，在参数前加 ! 符号。
• 对象
  AngularJS会将待过滤对象的属性同这个对象中的同名属性进行比较，如果属性值是字符串就会判断是否包含该字符串。如果我们希望对全部属性都进行对比，可以将 $ 当作键名。
• 函数
  对每个元素都执行这个函数，返回非假值的元素会出现在新的数组中并返回。
  例如，用下面的过滤器可以选择所有包含字母e的单词：

{{ ['Ari','Lerner','Likes','To','Eat','Pizza'] | filter:'e' }}

如果要过滤对象，可以使用对象过滤器。例如，如果有一个由people对象组成的数组，每个对象都含有他们最喜欢吃的食物的列表，那么可以用下面的形式进行过滤：

{{ [{
    'name': 'Ari',
    'City': 'San Francisco',
    'favorite food': 'Pizza'
    },{
    'name': 'Nate',
    'City': 'San Francisco',
    'favorite food': 'indian food'
    }] | filter:{'favorite food': 'Pizza'} }}

也可以用自定义函数进行过滤：

{{ ['Ari','likes','to','travel'] | filter:isCapitalized }}

isCapitalized函数的功能是根据首字母是否为大写返回 true 或 false，具体如下所示：

$scope.isCapitalized = function(str) {
    return str[0] == str[0].toUpperCase();
};

我们也可以给filter过滤器传入第二个参数，用来指定预期值同实际值进行比较的方式。
  第二个参数可以是以下三种情况之一。

• true
  用angular.equals(expected, actual)对两个值进行严格比较。
• false
  进行区分大小写的子字符串比较。
• 函数
  运行这个函数，如果返回真值就接受这个元素。

json

json过滤器可以将一个JSON或JavaScript对象转换成字符串。这种转换对调试非常有帮助：

{{ {'name': 'Ari', 'City': 'SanFrancisco'} | json }}

limitTo

limitTo过滤器会根据传入的参数生成一个新的数组或字符串，新的数组或字符串的长度取决于传入的参数，通过传入参数的正负值来控制从前面还是从后面开始截取。如果传入的长度值大于被操作数组或字符串的长度，那么整个数组或字符串都会被返回。
例如，我们可以截取字符串的前三个字符：

{{ 'San Francisco is very cloudy' | limitTo:3 }}

或最后的六个字符：

{{ 'San Francisco is very cloudy' | limitTo:-6 }}

对数组也可以进行同样的操作。返回数组的第一个元素：

{{ ['a','b','c','d','e','f'] | limitTo:1 }}

lowercase

lowercase过滤器将字符串转为小写。

{{ "San Francisco is very cloudy" | lowercase }}

number

number过滤器将数字格式化成文本。它的第二个参数是可选的，用来控制小数点后截取的位数。如果传入了一个非数字字符，会返会空字符串。

{{ 123456789 | number }}

{{ 1.234567 | number:2 }}

orderBy

orderBy过滤器可以用表达式对指定的数组进行排序。
  orderBy可以接受两个参数，第一个是必需的，第二个是可选的。
  第一个参数是用来确定数组排序方向的谓词。
  下面分情况讨论第一个参数的类型。

• 函数
  当第一个参数是函数时，该函数会被当作待排序对象的getter方法。
• 字符串
  对这个字符串进行解析的结果将决定数组元素的排序方向。我们可以传入 + 或 - 来强制进行升序或降序排列。
• 数组
  在排序表达式中使用数组元素作为谓词。对于与表达式结果并不严格相等的每个元素，则使用第一个谓词。

第二个参数用来控制排序的方向（是否逆向）。
例如，我们将下面的对象数组用name字段进行排序：

{{ [{
    'name': 'Ari',
    'status': 'awake'
    },{
    'name': 'Q',
    'status': 'sleeping'
    },{
    'name': 'Nate',
    'status': 'awake'
}] | orderBy:'name' }}

也可以对排序结果进行反转。例如，通过将第二个参数设置为true可以将排序结果进行反转：

{{ [{
    'name': 'Ari',
    'status': 'awake'
    },{
    'name': 'Q',
    'status': 'sleeping'
    },{
    'name': 'Nate',
    'status': 'awake'
    }] | orderBy:'name':true }}

uppercase

uppercase过滤器可以将字符串转换为大写形式：

{{ "San Francisco is very cloudy" | uppercase }}

自定义过滤器

创建自定义过滤器需要将它放到自己的模块中。下面我们来实现一个过滤器，将字符串第一个字母转换为大写。

angular.module('myApp.filters', [])
.filter('capitalize', function() {
    return function(input) {
    // input是我们传入的字符串
    if (input) {
        return input[0].toUpperCase() + input.slice(1);
    }
});

过滤器本质上是一个会把我们输入的内容当作参数传入进去的函数。
  现在，如果想将一个句子的首字母转换成大写形式，可以用过滤器先将整个句子都转换成小写，再把首字母转换成大写：

{{ 'ginger loves dog treats' | lowercase | capitalize }}

表单验证

要使用表单验证，首先要确保表单有一个name属性。所有输入字段都可以进行基本的验证，比如最大、最小长度等。这些功能是由新的HTML5表单属性提供的。
  如果想要屏蔽浏览器对表单的默认验证行为，可以在表单元素上添加novalidate标记。
  下面看一下可以在input元素上使用的所有验证选项。

1.必填项

验证某个表单输入是否已填写，只要在输入字段元素上添加HTML5标记required即可：

2.最小长度

验证表单输入的文本长度是否大于某个最小值，在输入字段上使用AngularJS指令ng-minlength="{number}"：

3. 最大长度

验证表单输入的文本长度是否小于或等于某个最大值，在输入字段上使用AngularJS指令ng-maxlength="{number}"：

4. 模式匹配

使用ng-pattern="/PATTERN/"来确保输入能够匹配指定的正则表达式：

5. 电子邮件

验证输入内容是否是电子邮件：

6. 数字

验证输入内容是否是数字：

7. URL

验证输入内容是否是URL：

8. 在表单中控制变量

表单的属性可以在其所属的$scope对象中访问到，而我们又可以访问$scope对象，因此JavaScript可以间接地访问DOM中的表单属性。借助这些属性，我们可以对表单做出实时响应。这些属性包括下面这些。
（注意，可以使用下面的格式访问这些属性。）

formName.inputFieldName.property

• 未修改的表单

这是一个布尔属性，用来判断用户是否修改了表单。如果未修改，值为true，如果修改过值为false：

formName.inputFieldName.$pristine

• 修改过的表单

只要用户修改过表单，无论输入是否通过验证，该值都返回true：

formName.inputFieldName.$dirty

• 合法的表单

这个布尔型的属性用来判断表单的内容是否合法。如果当前表单内容是合法的，下面属性的值就是true：

formName.inputFieldName.$valid

• 不合法的表单

这个布尔属性用来判断表单的内容是否不合法。如果当前表单内容是不合法的，下面属性的值为true：

formName.inputFieldName.$invalid

• 错误

这是AngularJS提供的另外一个非常有用的属性：$error对象。它包含当前表单的所有验证内容，以及它们是否合法的信息。用下面的语法访问这个属性：

formName.inputfieldName.$error

如果验证失败，这个属性的值为true；如果值为false，说明输入字段的值通过了验证。

9. 一些有用的CSS样式

AngularJS处理表单时，会根据表单当前的状态添加一些CSS类。
它们包括：

.ng-pristine {}
.ng-dirty {}
.ng-valid {}
.ng-invalid {}

它们对应着表单输入字段的特定状态。
  当某个字段中的输入非法时，.ng-invlid类会被添加到这个字段上：

input.ng-invalid {
    border: 1px solid red;
}
input.ng-valid {
    border: 1px solid green;
}

• $parsers

当用户同控制器进行交互，并且ngModelController中的$setViewValue()方法被调用时，$parsers数组中的函数会以流水线的形式被逐个调用。第一个$parse被调用后，执行结果会传递给第二个$parse，以此类推。
  这些函数可以对输入值进行转换，或者通过$setValidity()函数设置表单的合法性。
  使用$parsers数组是实现自定义验证的途径之一。例如，假设我们想要确保输入值在某两个数值之间，可以在$parsers数组中入栈一个新的函数，这个函数会在验证链中被调用。每个$parser返回的值都会被传入下一个$parser中。当不希望数据模型发生更新时返回undefined。

angular.module('myApp')
         .directive('oneToTen', function() {
             return {
                 require: '?ngModel',
                 link: function(scope, ele, attrs, ngModel) {
                     if (!ngModel) return;
                     ngModel.$parsers.unshift(
                         function(viewValue) {
                             var i = parseInt(viewValue);
                             if (i >= 0 && i < 10) {
                             ngModel.$setValidity('oneToTen', true);
                             return viewValue;
                         } else {
                             ngModel.$setValidity('oneToTen', false);
                             return undefined;
                         }
                     });
                 }
            };
       });

• $formatters

当绑定的ngModel值发生了变化，并经过$parsers数组中解析器的处理后，这个值会被传递给$formatters流水线。同$parsers数组可以修改表单的合法性状态类似，$formatters中的函数也可以修改并格式化这些值。
  比起单纯的验证目的，这些函数更常用来处理视图中的可视变化。例如，假设我们要对某个值进行格式化。通过$formatters数组可以在这个值上执行过滤器：

angular.module('myApp')
         .directive('oneToTen', function() {
             return {
                 require: '?ngModel',
                 link: function(scope, ele, attrs, ngModel) {
                     if (!ngModel) return;
                     ngModel.$formatters.unshift(function(v) {
                         return $filter('number')(v);
                     });
                 }
             };
         });

10. 组合实例

下面我们一起创建一个注册表单。表单中包括用户的名字、邮件地址以及用户名。
下面开始定义表单：

    

        
Signup
        Submit
    

这个表单的名称是signup_form，当表单提交时我们要调用signupForm()。
下面添加用户的名字：

    

        Your name
        
    

我们添加了一个表单，这个表单有一个名为name的输入字段，并且这个输入字段被ng-model指令绑定到了$scope对象的signup.name上。
用$dirty属性来确保用户未对输入内容进行修改时错误内容不会显示出来：

    

        Your name
        
        

            
                Your name is required.
            
            
                Your name is required to be at least 3 characters
            
            
                Your name cannot be longer than 20 characters
            
        
    

将整个过程分开来看，我们只是像以前一样在表单发生改变，且输入内容不合法时才展示错误内容。现在，我们会在特定的属性未通过验证时只展示对应的特定DOM元素。
接下来看下一组验证，电子邮箱的验证：

    

        Your email
        
        

            
                Your email is required.
            
            
                Your email is required to be at least 3 characters
            
            
                That is not a valid email. Please input a valid email.
            
            
                Your email cannot be longer than 20 characters
            
        
    

现在整个表单都被包含进来了，我们来看一下电子邮件的输入字段。注意，我们将输入字段的type属性设置为email，并且在$error.email上添加了验证错误的信息。这个验证同时基于AngularJS和HTML5属性实现。
最后，看一下用户名的输入字段：

    Username
    
    

       
           Please input a username
       
       
           Your username is required to be at least 3 characters
       
       
           Your username cannot be longer than 20 characters
       
       
           That username is taken, please try another
       
    
 

在最后一个输入字段中除了同前面相同的验证外，还添加了一个自定义验证。这个自定义验证是用AngularJS指令定义的：

app.directive('ensureUnique', function($http) {
    return {
        require: 'ngModel',
        link: function(scope, ele, attrs, c) {
            scope.$watch(attrs.ngModel, function(n) {
                if (!n) return;
                $http({
                    method: 'POST',
                    url: '/api/check/' + attrs.ensureUnique,
                    data: {
                        field: attrs.ensureUnique,
                        value: scope.ngModel
                    }
                }).success(function(data) {
                    c.$setValidity('unique', data.isUnique);
                }).error(function(data) {
                    c.$setValidity('unique', false);
                });
            });
        }
    };
});

当表单内容通过验证后，会向/api/check/username发送一个POST请求来验证用户名是否可用。
  最后，把按钮放进去。可以用ng-disabled指令基于表单的合法性来启用或禁用按钮：

Submit

尽管实时验证非常有用，但是当用户还没有完成输入时就弹出一个错误提示，这种体验是非常糟糕的。应该在用户提交表单或完成当前字段中的输入后，再提示验证信息，这样才是用户友好的。下面看看如何实现这两种效果。

• 在提交后显示验证信息
  当用户试图提交表单时，你可以在作用域中捕获到一个submitted值，然后对表单内容进行验证并显示错误信息。
  例如，修改一下前面的例子，只在用户提交表单时才显示错误信息。在ng-show指令中加入对表单是否进行了提交的检查：

    

        
Signup
        

            

                Your name
                
                

                    
                        Your name is required.
                    
                    
                        Your name is required to be at least 3 characters
                    
                    
                        Your name cannot be longer than 20 characters
                    
                
            
        
        Submit
    

现在，仅当signup_form.submitted设置为true时，容纳错误信息的div才会展示出来。在signupForm操作中实现这个行为，如下所示：

app.controller('signupController', function($scope) {
    $scope.submitted = false;
    $scope.signupForm = function() {
        if ($scope.signup_form.$valid) {
        // 正常提交
        } else {
            $scope.signup_form.submitted = true;
        }
    }
});

如果用户试图在有非法输入的情况下提交表单，我们现在可以捕获到这个行为并展示合适的错误信息。

• 在失焦后显示验证信息
  如果想保留实时错误提示的体验，可以在用户从某个输入字段失焦后提示错误信息（例如用户已经不在某个特定的输入字段中时）。为了实现这个效果，需要实现一个不是很复杂的指令，并向表单中添加一个新的变量。
  我们需要使用的指令是ngFocus，它是这样的：

app.directive('ngFocus', [function() {
    var FOCUS_CLASS = "ng-focused";
    return {
        restrict: 'A',
        require: 'ngModel',
        link: function(scope, element, attrs, ctrl) {
            ctrl.$focused = false;
            element.bind('focus', function(evt) {
                element.addClass(FOCUS_CLASS);
                scope.$apply(function() {
                    ctrl.$focused = true;
                });
            }).bind('blur', function(evt) {
                element.removeClass(FOCUS_CLASS);
                scope.$apply(function() {
                    ctrl.$focused = false;
                });
            });
        }
    };
}]);

将ngFocus指令添加到input元素上就可以使用这个指令，如下所示：

ngFocus指令给表单输入字段的blur和focus添加了对应的行为，添加了一个名为ng-focused的类，并将$focused的值设置为true。接下来，可以根据表单是否具有焦点来展示独立的错误信息。如下所示：

也可以在ngModel控制器中使用$isEmpty()方法来判断输入字段是否为空。当输入字段为空这个方法会返回true，反之如果不为空则返回false。

ngMessages(1.3+)

Angular 1.3中，Angular核心做了一个升级。它不再需要基于一个详细的表达式状态创建元素显示或隐藏。

    

        
Signup
        

            

                Your name
                
                

                    
                        Your name is required.
                    
                    
                        Your name is required to be at least 3 characters
                    
                    
                        Your name cannot be longer than 20 characters 
                    
                
            
        
        Submit
    

本质上这一功能会检查错误对象的状态发生了变化。此外，我们还得到了站点中每个表单需要的很多额外的和重复的标记。这显然不是一个理想的解决方案。
从1.3开始，Angular中新增了一个ngMessages指令。

安装

安装ngMessages很简单，因为它被打包成了一个Angular模块。首先下载这个模块：

$ bower install --save angular-messages

或者，也可以从angular.org下载该文件并将它保存到项目中。还需要将angular-messages.js这个JavaScript引入我们的主HTML中：

最后，我们还要告诉Angular将ngMessages作为应用程序的依赖模块引入：

angular.module('myApp', ['ngMessages']);

使用ngMessages：

    Your name
    
    

        
Make sure you enter your name
        
Your name must be at least 3 characters
        
Your name cannot be longer than 20 characters
    
    Submit

然而对于这个实现，一次只会显示一个错误消息。如果我们想要更新这个实现同时显示所有的错误将会怎样？很容易。只需在ng-message指令旁边使用ng-messages-multiple属性即可。

    
 sure you enter your name
    
Your name must be at least 3 characters
    
Your name cannot be longer than 20 characters

很多时候这些信息相互之间非常相似。我们可以将它们保存到模板中从而减少麻烦，而不是重新输入每个字段的错误信息。

This field is required
The field must be at least 3 characters
The field cannot be longer than 20 characters

然后我们可以通过在视图中使用ng-messages-include属性引入这个模板来改进这个表单：

有时，你可能希望为不同的字段自定义错误信息。没问题，你可以在这个指令内简单地插入一个自定义错误信息。由于ngMessages涉及ngMessages容器中错误列表的顺序，我们可以通过在这个指令中列出自定义错误信息的方式覆盖它们。

此外，甚至还可以为自定义验证创建自定义消息。可以通过修改模型的$ parsers链做到这一点。
例如，比方说我们想要创建一个自定义验证器验证用户名在一个注册表单中是否有效：

app.directive('ensureUnipue', function($http) {
    return {
        require: 'ngModel',
        link: function(scope, ele, attrs, ctrl) {
            ctrl.$parsers.push(function(val) {
                // 在这里添加验证
            });
        }
    }
});

对于ngModel，你可以添加可以使用ngMessage指令显示/隐藏的自定义信息。还可以添加可以使用ngMessage指令检查的带有自定义的消息的指令。例如，改变前面使用ngMessages的例子。

    Your name
    
    

        

            Make sure you enter your username
        
        

            Checking...
        
        

            The username has already been taken. Please choose another
        
    
    Submit

在这种用法中，我们检查了错误信息的自定义属性。为了添加自定义错误消息，我们将会把它们应用到自定义ensureUnique指令的ngModel中。

app.directive('ensureUnique', function($http) {
    return {
        require: 'ngModel',
        link: function(scope, ele, attrs, ctrl) {
            var url = attrs.ensureUnique;
            ctrl.$parsers.push(function(val) {
                if (!val || val.length === 0) {
                    return;
                }
                ngModel.$setValidity('checkingAvailability', true);
                ngModel.$setValidity('usernameAvailablity', false);
                $http({
                    method: 'GET',
                    url: url,
                    params: {
                        username: val
                    }
                }).success(function() {
                    ngModel.$setValidity('checkingAvailability', false);
                    ngModel.$setValidity('usernameAvailablity', true);
                })['catch'](function() {
                    ngModel.$setValidity('checkingAvailability', false);
                    ngModel.$setValidity('usernameAvailablity', false);
                });
                return val;
            })
        }
    }
});