AngularJS权威教程 第7章 过滤器filters
过滤器用来格式化需要展示给用户的数据。AngularJS有很多实用的内置过滤器，同时也提供了方便的途径可以自己创建过滤器
在HTML中的模板绑定符号{{ }}内通过|符号来调用过滤器。例如，假设我们希望将字符串转换成大写，可以对字符串中的每个字
符都单独进行转换操作，也可以使用过滤器：{{ name | uppercase }}
在JavaScript代码中可以通过$filter来调用过滤器。例如，在JavaScript代码中使用lowercase过滤器：
app.controller('DemoController', ['$scope', '$filter',
function($scope, $filter) {
$scope.name = $filter('lowercase')('Ari');
}]);参数后面都加入冒号。例如，数值过滤器可以限制小数点后的位数，在过滤器后写上:2可以将2作为参数传给过滤器：
<span style="font-family:Microsoft YaHei;font-size:14px;"><!-- 显示：123.46 -->
{{ 123.456789 | number:2 }}</span>内置过滤器。
1. currency
currecy过滤器可以将一个数值格式化为货币格式。用{{ 123 | currency }}来将123转化成货币格式。
currecy过滤器允许我们自己设置货币符号。默认情况下会采用客户端所处区域的货币符号，但是也可以自定义货币符号。
2. date
date过滤器可以将日期格式化成需要的格式。AngularJS中内置了几种日期格式，如果没有指定使用任何格式，默认会采用
mediumDate格式，下面的例子中展示了这个格式。
下面是内置的支持本地化的日期格式：
{{ today | date:'medium' }} <!-- Aug 09, 2013 12:09:02 PM -->
{{ today | date:'short' }} <!-- 8/9/1312:09PM -->
{{ today | date:'fullDate' }} <!-- Thursday, August 09, 2013 -->
{{ today | date:'longDate' }} <!-- August 09, 2013 -->
{{ today | date:'mediumDate' }}<!-- Aug 09, 2013 -->
{{ today | date:'shortDate' }} <!-- 8/9/13 -->
{{ today | date:'mediumTime' }}<!-- 12:09:02 PM -->
{{ today | date:'shortTime' }} <!-- 12:09 PM -->- 年份格式化
四位年份：{{ today | date:'yyyy' }} <!-- 2013 -->
两位年份：{{ today | date:'yy' }} <!-- 13 -->
一位年份：{{ today | date:'y' }} <!-- 2013 -->
- 月份格式化
英文月份：{{ today | date:'MMMM' }} <!-- August -->
英文月份简写：{{ today | date:'MMM' }} <!-- Aug -->
数字月份：{{ today |date:'MM' }} <!-- 08 -->
一年中的第几个月份：{{ today |date:'M' }} <!-- 8 -->
- 日期格式化
数字日期：{{ today|date:'dd' }} <!-- 09 -->
一个月中的第几天：{{ today | date:'d' }} <!-- 9 -->
英文星期：{{ today | date:'EEEE' }} <!-- Thursday -->
英文星期简写：{{ today | date:'EEE' }} <!-- Thu -->
- 小时格式化
24小时制数字小时：{{today|date:'HH'}} <!--00-->
一天中的第几个小时：{{today|date:'H'}} <!--0-->
12小时制数字小时：{{today|date:'hh'}} <!--12-->
上午或下午的第几个小时：{{today|date:'h'}} <!--12-->
- 分钟格式化
数字分钟数：{{ today | date:'mm' }} <!-- 09 -->
一个小时中的第几分钟：{{ today | date:'m' }} <!-- 9 -->
- 秒数格式化
数字秒数：{{ today | date:'ss' }} <!-- 02 -->
一分钟内的第几秒：{{ today | date:'s' }} <!-- 2 -->
毫秒数：{{ today | date:'.sss' }} <!-- .995 -->
- 字符格式化
上下午标识：{{ today | date:'a' }} <!-- AM -->
四位时区标识：{{ today | date:'Z' }} <!--- 0700 -->
下面是一些自定义日期格式的示例：
{{ today | date:'MMMd, y' }} <!-- Aug9, 2013 -->
{{ today | date:'EEEE, d, M' }} <!-- Thursday, 9, 8-->
{{ today | date:'hh:mm:ss.sss' }} <!-- 12:09:02.995 -->3. filter
filter过滤器可以从给定数组中选择一个子集，并将其生成一个新数组返回。这个过滤器通常用来过滤需要进行展示的元素。例
如，在做客户端搜索时，可以从一个数组中立刻过滤出所需的结果。
这个过滤器的第一个参数可以是字符串、对象或是一个用来从数组中选择元素的函数。
下面分情况介绍传入不同类型的参数。
- 字符串
返回所有包含这个字符串的元素。如果我们想返回不包含该字符串的元素，在参数前加!符号。
- 对象
AngularJS会将待过滤对象的属性同这个对象中的同名属性进行比较，如果属性值是字符串就会判断是否包含该字符串。如果
我们希望对全部属性都进行对比，可以将$当作键名。
- 函数
对每个元素都执行这个函数，返回非假值的元素会出现在新的数组中并返回。
例如，用下面的过滤器可以选择所有包含字母e的单词：
{{ ['Ari','Lerner','Likes','To','Eat','Pizza'] | filter:'e' }}
<!-- ["Lerner","Likes","Eat"] -->吃的食物的列表，那么可以用下面的形式进行过滤：
{{ [{
'name': 'Ari',
'City': 'San Francisco',
'favorite food': 'Pizza'
},{
'name': 'Nate',
'City': 'San Francisco',
'favorite food': 'indian food'
}] | filter:{'favorite food': 'Pizza'} }}
<!-- [{"name":"Ari","City":"SanFrancisco","favoritefood":"Pizza"}] -->{{ ['Ari','likes','to','travel'] | filter:isCapitalized }}
<!-- ["Ari"] -->$scope.isCapitalized = function(str) {
return str[0] == str[0].toUpperCase();
};第二个参数可以是以下三种情况之一。
- true
用angular.equals(expected, actual)对两个值进行严格比较。
- false
进行区分大小写的子字符串比较。
- 函数
运行这个函数，如果返回真值就接受这个元素。
4. json
json过滤器可以将一个JSON或JavaScript对象转换成字符串。这种转换对调试非常有帮助：
{{ {'name': 'Ari', 'City': 'SanFrancisco'} | json }}
<!--
{
"name": "Ari",
"City": "San Francisco"
}
-->5. limitTo
limitTo过滤器会根据传入的参数生成一个新的数组或字符串，新的数组或字符串的长度取决于传入的参数，通过传入参数的正负
值来控制从前面还是从后面开始截取。
如果传入的长度值大于被操作数组或字符串的长度，那么整个数组或字符串都会被返回。
例如，我们可以截取字符串的前三个字符：
{{ San Francisco is very cloudy | limitTo:3 }}
<!-- San -->{{ San Francisco is very cloudy | limitTo:-6 }}
<!-- cloudy -->{{ ['a','b','c','d','e','f'] | limitTo:1 }}
<!-- ["a"] -->
6. lowercase
lowercase过滤器将字符串转为小写。{{ "San Francisco is very cloudy" | lowercase }}
<!-- san francisco is very cloudy -->
7. number
number过滤器将数字格式化成文本。它的第二个参数是可选的，用来控制小数点后截取的位数。如果传入了一个非数字字符，会返会空字符串。
{{ 123456789 | number }}
<!-- 1,234,567,890 -->
{{ 1.234567 | number:2 }}
<!-- 1.23 -->8. orderBy
orderBy过滤器可以用表达式对指定的数组进行排序。
orderBy可以接受两个参数，第一个是必需的，第二个是可选的。
第一个参数是用来确定数组排序方向的谓词。下面分情况讨论第一个参数的类型。
- 函数
当第一个参数是函数时，该函数会被当作待排序对象的getter方法。
- 字符串
对这个字符串进行解析的结果将决定数组元素的排序方向。我们可以传入+或-来强制进行升序或降序排列。
- 数组
在排序表达式中使用数组元素作为谓词。对于与表达式结果并不严格相等的每个元素，则使用第一个谓词。
第二个参数用来控制排序的方向（是否逆向）。例如，我们将下面的对象数组用name字段进行排序：
{{ [{
'name': 'Ari',
'status': 'awake'
},{
'name': 'Q',
'status': 'sleeping'
},{
'name': 'Nate',
'status': 'awake'
}] | orderBy:'name' }}
<!--
[
{"name":"Ari","status":"awake"},
{"name":"Nate","status":"awake"},
{"name":"Q","status":"sleeping"}
]
-->{{ [{
'name': 'Ari',
'status': 'awake'
},{
'name': 'Q',
'status': 'sleeping'
},{
'name': 'Nate',
'status': 'awake'
}] | orderBy:'name':true }}
<!--
[
{"name":"Q","status":"sleeping"},
{"name":"Nate","status":"awake"},
{"name":"Ari","status":"awake"}
]
-->uppercase过滤器可以将字符串转换为大写形式：
{{ "San Francisco is very cloudy" | uppercase }}
<!-- SAN FRANCISCO IS VERY CLOUDY -->7.1 自定义过滤器
正如前面所见，创建自定义过滤器非常容易。创建自定义过滤器需要将它放到自己的模块中。下面我们一起来实现一个过滤器，
将字符串第一个字母转换为大写。
首先，创建一个模块用以在应用中进行引用（这是一个非常好的实践）：
angular.module('myApp.filters', [])
.filter('capitalize', function() {
return function(input) {};
});符串来处理。可以在这个函数中做一些错误检查：
angular.module('myApp.filters', [])
.filter('capitalize', function() {
return function(input) {
// input是我们传入的字符串
if (input) {
return input[0].toUpperCase() + input.slice(1);
}
});<!-- Ginger loves dog treats -->
{{ 'ginger loves dog treats' | lowercase | capitalize }}7.2 表单验证
能够根据用户在表单中输入的内容给出实时视觉反馈是非常重要的。在人与人沟通的语境中，表单验证给出来的反馈同获得正确
输入同等重要。
表单验证不仅能给用户提供有用的反馈，同时也能保护我们的Web应用不会被恶意或者错误的输入所破坏。我们要在Web前端尽
力保护后端。
AngularJS能够将HTML5表单验证功能同它自己的验证指令结合起来使用，并且非常方便。
AngularJS提供了很多表单验证指令，我们会介绍其中一些核心的验证功能，然后介绍如何创建自己的验证器。
<form name="form" novalidate>
<label name="email">Your email</label>
<input type="email"
name="email"
ng-model="email" placeholder="Email Address" />
</form>证，但客户端验证可以提供表单状态的实时反馈。
要使用表单验证，首先要确保表单像上面的例子一样有一个name属性。
所有输入字段都可以进行基本的验证，比如最大、最小长度等。这些功能是由新的HTML5表单属性提供的。如果想要屏蔽浏览器
对表单的默认验证行为，可以在表单元素上添加novalidate标记。
下面看一下可以在input元素上使用的所有验证选项。
- 1. 必填项
验证某个表单输入是否已填写，只要在输入字段元素上添加HTML5标记required即可：
<input type="text" required />- 2. 最小长度
验证表单输入的文本长度是否大于某个最小值，在输入字段上使用AngularJS指令ng-minleng="{number}"：
<input type="text" ng-minlength="5" />- 3. 最大长度
验证表单输入的文本长度是否小于或等于某个最大值，在输入字段上使用AngularJS指令ng-maxlength="{number}"：
<input type="text" ng-maxlength="20" />- 4. 模式匹配
使用ng-pattern="/PATTERN/"来确保输入能够匹配指定的正则表达式：
<input type="text" ng-pattern="[a-zA-Z]" />- 5. 电子邮件
验证输入内容是否是电子邮件，只要像下面这样将input的类型设置为email即可：
<input type="email" name="email" ng-model="user.email" />- 6. 数字
验证输入内容是否是数字，将input的类型设置为number：
<input type="number" name="age" ng-model="user.age" />- 7. URL
验证输入内容是否是URL，将input的类型设置为 url：
<input type="url" name="homepage" ng-model="user.facebook_url" />- 8. 自定义验证
在AngularJS中自定义指令是非常容易的。鉴于目前还没有介绍到指令的相关内容，第10章再深入研究如何创建自定义验证。
目前先来看一下如何通过向后端服务器发送请求，并通过响应的结果来将输入字段设置为合法或不合法，以确保输入字段中的内容
是唯一的。
- 9. 在表单中控制变量
表单的属性可以在其所属的$scope对象中访问到，而我们又可以访问$scope对象，因此JavaScript可以间接地访问DOM中的
表单属性。借助这些属性，我们可以对表单做出实时（和AngularJS中其他东西一样）响应。这些属性包括下面这些。（注意，可以
使用下面的格式访问这些属性。）
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，说明输入字段的值通过了验证。
- 10. 一些有用的CSS样式
AngularJS处理表单时，会根据表单当前的状态添加一些CSS类（例如当前是合法的、未发生变化的，等等），这些CSS类的
命名和前面介绍的属性很相似。
它们包括：
.ng-pristine {}
.ng-dirty {}
.ng-valid {}
.ng-invalid {}当某个字段中的输入非法时，.ng-invlid类会被添加到这个字段上。当前例子中的站点将对应的CSS样式设置为：
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);
});
}
};
});- 11. 组合实例
开始之前，首先看一下我们希望这个表单长成什么样子，如图所示。
<form name="signup_form" novalidateng-submit="signupForm()">
<fieldset>
<legend>Signup</legend>
<button type="submit" class="button radius">Submit</button>
</fieldset>
</form>下面添加用户的名字：
<div class="row">
<div class="large-12 columns">
<label>Your name</label>
<input type="text"
placeholder="Name"
name="name"
ng-model="signup.name"
ng-minlength="3"
ng-maxlength="20" required />
</div>
</div>我们添加了一个表单，这个表单有一个名为name的输入字段，并且这个输入字段被ng-model指令绑定到了$scope对象的
signup.name上。(不要忘记给输入字段添加name属性。给输入字段添加name属性非常重要：这决定了我们将验证信息展示给用户
时如何引用表单输入字段。)
同时，我们也设置了一些验证。验证要求name字段的最小长度是3个字符，最大长度是20个字符（当长度大于等于21时输入会
变为不合法）。
最后，我们要求name字段是必填项。通过使用这些属性，可以在表单未通过验证时控制展示或隐藏错误列表用$dirty属性来
确保用户未对输入内容进行修改时错误内容不会显示出来：
<divclass="row">
<div class="large-12 columns">
<label>Your name</label>
<input type="text"
placeholder="Name"
name="name"
ng-model="signup.name"
ng-minlength="3"
ng-maxlength="20" required />
<div class="error"
ng-show="signup_form.name.$dirty && signup_form.name.$invalid">
<small class="error"
ng-show="signup_form.name.$error.required">
Your name is required.
</small>
<small class="error"
ng-show="signup_form.name.$error.minlength">
Your name is required to be at least 3 characters
</small>
<small class="error"
ng-show="signup_form.name.$error.maxlength">
Your name cannot be longer than 20 characters
</small>
</div>
</div>
</div>将整个过程分开来看，我们只是像以前一样在表单发生改变，且输入内容不合法时才展示错误内容。现在，我们会在特定的属
性未通过验证时只展示对应的特定DOM元素。
接下来看下一组验证，电子邮箱的验证：
<div class="row">
<div class="large-12 columns">
<label>Your email</label>
<input type="email"
placeholder="Email"
name="email"
ng-model="signup.email"
ng-minlength="3" ng-maxlength="20" required />
<div class="error"
ng-show="signup_form.email.$dirty && signup_form.email.$invalid">
<small class="error"
ng-show="signup_form.email.$error.required">
Your email is required.
</small>
<small class="error"
ng-show="signup_form.email.$error.minlength">
Your email is required to be at least 3 characters
</small>
<small class="error"
ng-show="signup_form.email.$error.email">
That is not a valid email. Please input a valid email.
</small>
<small class="error"
ng-show="signup_form.email.$error.maxlength">
Your email cannot be longer than 20 characters
</small>
</div>
</div>
</div>在$error.email上添加了验证错误的信息。这个验证同时基于AngularJS和HTML5属性实现。
最后，看一下用户名的输入字段：
<div class="large-12 columns">
<label>Username</label>
<input type="text"
placeholder="Desired username"
name="username"
ng-model="signup.username"
ng-minlength="3"
ng-maxlength="20"
ensure-unique="username" required />
<div class="error"
ng-show="signup_form.username.$dirty &&
signup_form.username.$invalid">
<small class="error"
ng-show="signup_form.username.$error.required">
Please input a username
</small>
<small class="error"
ng-show="signup_form.username.$error.minlength">
Your username is required to be at least 3 characters
</small>
<small class="error"
ng-show="signup_form.username.$error.maxlength">
Your username cannot be longer than 20 characters
</small>
<small class="error"
ng-show="signup_form.username.$error.unique">
That username is taken, please try another
</small>
</div>
</div>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);
});
});
}
};
});端的代码，现在并没有可以用来测试这些内容的后端，尽管实现这个后端并不复杂。
最后，把按钮放进去。可以用ng-disabled指令基于表单的合法性来启用或禁用按钮：
<button type="submit"
ng-disabled="signup_form.$invalid"
class="button radius">Submit</button>尽管实时验证非常有用，但是当用户还没有完成输入时就弹出一个错误提示，这种体验是非常糟糕的。应该在用户提交表单或
完成当前字段中的输入后，再提示验证信息，这样才是用户友好的。下面看看如何实现这两种效果。
- 在提交后显示验证信息
当用户试图提交表单时，你可以在作用域中捕获到一个submitted值，然后对表单内容进行验证并显示错误信息。
例如，修改一下前面的例子，只在用户提交表单时才显示错误信息。在ng-show指令中加入对表单是否进行了提交的检查
（后面会实现这个功能）：
<form name="signup_form"
novalidate
ng-submit="signupForm()"
ng-controller="signupController">
<fieldset>
<legend>Signup</legend>
<div class="row">
<div class="large-12 columns">
<label>Your name</label>
<input type="text"
placeholder="Name"
name="name"
ng-model="signup.name"
ng-minlength="3"
ng-maxlength="20" required />
<div class="error"
ng-show="signup_form.name.$dirty && signup_form.name.$invalid &&
signup_form.submitted">
<small class="error"
ng-show="signup_form.name.$error.required">
Your name is required.
</small>
<small class="error"
ng-show="signup_form.name.$error.minlength">
Your name is required to be at least 3 characters
</small>
<small class="error"
ng-show="signup_form.name.$error.maxlength">
Your name cannot be longer than 20 characters
</small>
</div>
</div>
</div>
<button type="submit" >Submit</button>
</fieldset>
</form>为，如下所示：
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;
});
});
}
};
}]);<input ng-class="{error: signup_form.name.$dirty && signup_form.name.$invalid}"
type="text"
placeholder="Name"
name="name"
ng-model="signup.name"
ng-minlength="3"
ng-maxlength="20" required ng-focus />置为true。接下来，可以根据表单是否具有焦点来展示独立的错误信息。如下所示：
<div class="error"
ng-show="signup_form.name.$dirty && signup_form.name.$invalid && !signup_form.name.$focused">果不为空则返回false。
完整代码如下：
效果如图：<!doctype html> <html ng-app="myApp"> <head> <link rel="stylesheet" href="http://cdn.jsdelivr.net/foundation/4.3.2/css/foundation.min.css"> <script src="http://apps.bdimg.com/libs/angular.js/1.3.9/angular.min.js"></script> <style> body { background-color: #fff; border-top: 5px solid #3399cc; } html { background: #fff; } .row { border: 0px solid green; } input.ng-invalid { border: 1px solid red; } input.ng-valid { border: 1px solid green; } </style> </head> <body> <form name="signup_form" novalidate ng-submit="signupForm()" ng-controller="signupController"> <fieldset> <legend>Signup</legend> <div class="row"> <div class="large-12 columns"> <label>Your name</label> <input type="text" placeholder="Name" name="name" ng-model="signup.name" ng-minlength=3 ng-maxlength=20 ng-class="{error: signup_form.name.$dirty && signup_form.name.$invalid}" required /> <div class="error" ng-show="signup_form.name.$dirty && signup_form.name.$invalid && !signup_form.name.$focused"> <small class="error" ng-show="signup_form.name.$error.required"> Your name is required. </small> <small class="error" ng-show="signup_form.name.$error.minlength"> Your name is required to be at least 3 characters </small> <small class="error" ng-show="signup_form.name.$error.maxlength"> Your name cannot be longer than 20 characters </small> </div> </div> </div> <div class="row"> <div class="large-12 columns"> <label>Your email</label> <input type="email" placeholder="Email" name="email" ng-model="signup.email" ng-minlength=3 ng-maxlength=20 ng-class="{error: signup_form.name.$dirty && signup_form.name.$invalid}" required /> <div class="error" ng-show="signup_form.email.$dirty && signup_form.email.$invalid && signup_form.submitted"> <small class="error" ng-show="signup_form.email.$error.required"> Your email is required. </small> <small class="error" ng-show="signup_form.email.$error.minlength"> Your email is required to be at least 3 characters </small> <small class="error" ng-show="signup_form.email.$error.email"> That is not a valid email. Please input a valid email. </small> <small class="error" ng-show="signup_form.email.$error.maxlength"> Your email cannot be longer than 20 characters </small> </div> </div> </div> <div class="large-12 columns"> <label>Username</label> <input type="text" placeholder="Desired username" name="username" ng-model="signup.username" ng-minlength=3 ng-maxlength=20 ng-class="{error: signup_form.name.$dirty && signup_form.name.$invalid}" ensure-unique="username" required /> <div class="error" ng-show="signup_form.email.$dirty && signup_form.email.$invalid && signup_form.submitted"> <small class="error" ng-show="signup_form.username.$error.required"> Please input a username </small> <small class="error" ng-show="signup_form.username.$error.minlength"> Your username is required to be at least 3 characters </small> <small class="error" ng-show="signup_form.username.$error.maxlength"> Your username cannot be longer than 20 characters </small> <small class="error" ng-show="signup_form.username.$error.unique"> That username is taken, please try another </small> </div> </div> <button type="submit" class="button radius">Submit</button> </fieldset> </form> <script> angular.module('myApp', []) .directive('ensureUnique', ['$http', function($http) { return { require: 'ngModel', link: function(scope, ele, attrs, c) { scope.$watch(attrs.ngModel, function() { $http({ method: 'POST', url: '/api/check/' + attrs.ensureUnique, data: {'field': attrs.ensureUnique} }).success(function(data, status, headers, cfg) { c.$setValidity('unique', data.isUnique); }).error(function(data, status, headers, cfg) { c.$setValidity('unique', false); }); }); } }; }]) .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;}); }); } } }]) .controller('signupController', ['$scope', function($scope) { $scope.submitted = false; $scope.signupForm = function() { if ($scope.signup_form.$valid) { // Submit as normal } else { $scope.signup_form.submitted = true; } } }]); </script> </body> </html>
ngMessages(1.3+)
众所周知，表单和验证是Angular中复杂的组件之一。上面的例子不是特别好，不简洁。在Angular 1.3发布前，表单验证必须以
这种方式编写。
然而在发布的Angular 1.3中，Angular核心做了一个升级。它不再需要基于一个详细的表达式状态创建元素显示或隐藏（正如我
们在本章所做的那样）。
<form name="signup_form" novalidate ng-submit="signupForm()"
ng-controller="signupController">
<fieldset>
<legend>Signup</legend>
<div class="row">
<div class="large-12 columns">
<label>Your name</label>
<input type="text" placeholder="Name" name="name" ng-model="signup.name"
ng-minlength=3 ng-maxlength=20 required />
<div class="error" ng-show="signup_form.name.$dirty && signup_form.name.
$invalid && signup_form.submitted">
<small class="error" ng-show="signup_form.name.$error.required">
Your name is required.</small>
<small class="error" ng-show="signup_form.name.$error.minlength">
Your name is required to be at least 3 characters</small>
<small class="error" ng-show="signup_form.name.$error.maxlength">
Your name cannot be longer than 20 characters </small>
</div>
</div>
</div>
<button type="submit">Submit</button>
</fieldset>
</form>本质上这一功能会检查错误对象的状态发生了变化。此外，我们还得到了站点中每个表单需要的很多额外的和重复的标记。这显
然不是一个理想的解决方案。
从1.3开始，Angular中新增了一个ngMessages指令。
安装
安装ngMessages很简单，因为它被打包成了一个Angular模块。首先下载这个模块：
$ bower install --save angular-messages中：
<script type="text/javascript" src="bower_components/angular-messages/angular-messages.js">
</script>angular.module('myApp', ['ngMessages']);使用ngMessages的一个更简洁的实现替换它。
<form name="signup_form" novalidate ng-submit="signupForm()"
ng-controller="signupController">
<label>Your name</label>
<input type="text" placeholder="Name" name="name" ng-model="signup.name" ng-minlength=
3 ng-maxlength=20 required />
<div class="error" ng-messages="signup_form.name.$error">
<div ng-message="required">Make sure you enter your name</div>
<div ng-message="minlength">Your name must be at least 3 characters</div>
<div ng-message="maxlength">Your name cannot be longer than 20 characters</div>
</div>
<button type="submit">Submit</button>
</form>然而对于这个实现，一次只会显示一个错误消息。如果我们想要更新这个实现同时显示所有的错误将会怎样？很容易。只需在
ng-message指令旁边使用ng-messages-multiple属性即可。
<div class="error" ng-messages="signup_form.name.$error" ng-messages-multiple>
<div ng-message="required"> sure you enter your name</div>
<div ng-message="minlength">Your name must be at least 3 characters</div>
<div ng-message="maxlength">Your name cannot be longer than 20 characters</div>
</div><!-- In templates/errors.html -->
<div ng-message="required">This field is required</div>
<div ng-message="minlength">The field must be at least 3 characters</div>
<div ng-message="maxlength">The field cannot be longer than 20 characters</div><div class+'error' ng-messages="signup_form.name.$error"
ng-messages-include="templates/errors.html">
</div>
ngMessages涉及ngMessages容器中错误列表的顺序，我们可以通过在这个指令中列出自定义错误信息的方式覆盖它们。
<div class="error" ng-messages="signup_form.name.$error"
ng-messages-include="templates/errors.html">
<!--
除了minlength会被覆盖之外，其他每个信息都会保持不变
-->
</div> 例如，比方说我们想要创建一个自定义验证器验证用户名在一个注册表单中是否有效：
app.directive('ensureUnipue', function($http) {
return {
require: 'ngModel',
link: function(scope, ele, attrs, ctrl) {
ctrl.$parsers.push(function(val) {
// 在这里添加验证
});
}
}
});有自定义的消息的指令。例如，改变前面使用ngMessages的例子。
<form name="signup_form" novalidate ng-submit="signupForm()" ng-controller="signupController"
ensure-unique="/api/checkUsername.json">
<label>
Your name
</label>
<input type="text" placeholder="Username" name="username" ng-model="signup.username"
ng-minlength=3 ng-maxlength=20 required />
<div class="error" ng-messages="signup_form.username.$error">
<div ng-message="required">
Make sure you enter your username
</div>
<div ng-message="checkingAvailability">
Checking...
</div>
<div ng-message="usernameAvailablity">
The username has already been taken. Please choose another
</div>
</div>
<button type="submit">
Submit
</button>
</form>令的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;
})
}
}
});
扫一扫
72
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
