AngularJS 表单(ng-form)验证

AngularJS CSS DOM HTML JavaScript MVC 模板 表单 模块化 数据绑定 正则表达式

在HTML中,用户通过input, select, textarea等元素进行输入,我们通常用表单来包装和管理这些控件。客户端表单验证非常重要,可以及时地为用户提供表单验证信息。但客户端表单验证只是为了增强用户体验,服务器端验证仍然是必要的。

AngularJS最大的特点便是数据绑定。利用Angular在客户端脚本中构建MVC框架,Model和View之间可以实现双向绑定。因此AngularJS的表单验证可以做到实时的用户反馈

事实上,正是因为实时的用户反馈这个神奇的特性,我们团队在 http://tianmaying.com 中也继续引入了AngularJS,尽管此时我们对单页应用已经不感兴趣。

一个简单的表单

Angular是模块化的,每个APP都是一个Angular Module。我们知道Module下可以包含这样四种内容:

  • 控制器(controllers),用来完成页面逻辑,不包含DOM操作、资源获取。
  • 服务(services),用来提供资源访问和获取,控制资源的访问,维护数据一致性。
  • 过滤器(filters),用来格式化数据显示,很多第三方插件以提供filter为主,例如angular-moment
  • 语义标签(directives),增强的HTML标签,DOM操作都应当抽象为directive

Angular表单其实是Angular提供的Directive,它有一个别名叫ng-form。是这个Directive实例化了一个FormController来负责表单内的页面逻辑(主要是表单验证)。

<div ng-app>
  <ng-form name=someForm>
    <input name="username" type="text" ng-model="user.username" pattern="^\w{6,18}$">
    <div class="alert alert-danger" ng-show="someForm.username.$error.pattern">
      用户名必须为6-18个字母、数字或下划线
    </div>
  </ng-form>
</div>

ng-model可以把input的值双向地绑定到当前上下文的user.username变量。我们设置了用户名的pattern为6到18位。我们输入用户名时,.alert错误提示便会实时地显示或者隐藏。

这里我们指定了formname属性,form Directive 实例化的FormController就会以someForm命名,并插入到当前$scope。所以在模板中才能够访问userForm变量。另外,Angular的Pattern使用Javascript正则表达式语法,这里\w相当于[a-zA-Z_]

SELECT标签

HTML中的select标签是一个单选的下拉列表,Angular对select也提供了支持(事实上,是在ngModule里面提供了一个叫select的Directive)。假如上下文中有这样的对象:

$scope.selectValue = [{value: 0, label: 'Banana'}, {value: 1, label: 'Apple'}];
$socpe.selectedValue = 1;

在模板中这样写:

<select ng-model="selectedValue"
        ng-options="option.value as option.label for option in myOptions"></select>

这个<select>的便会有两个选项:BananaApple,且默认选中Banana。当你选择Apple时,$socpe.selectedValue会被赋值为1option.value指定了<select><option>value,而option.label指定了<option>的内容。

事实上,因为select下拉项的样式不可通过CSS控制,select在追求视觉体验的网站不常使用。Bootstrap的.dropdown就是一个更好的替代品。Angular也有类似的Dropdown插件。

表单嵌套

多数浏览器不允许form嵌套,如果你出于自身的需求(例如:在账号表单中,头像表单需要单独提交)需要嵌套的表单,请使用ng-form标签:

<ng-form name="outterForm">
  <ng-form name="innerForm" ng-repeat="file in doc.files">
    ...
    <button ng-disabled="innerForm.$invalid">Save Inner</button>
  </ng-form>
  <button ng-disabled="outterForm.$invalid || innerForm.$invalid">Save Outter</button>
</ng-form>

这里的outterForm下有一个动态的innerForm列表,

  • innerForm下的元素$scope中是当前列表项的innerForm。因此Save Inner的状态会根据正确地绑定到当前表单的状态。
  • outterForm下的Save Outter则会同时绑定outterForminnerForm的状态,当所有innerForm合法且outterForm合法时,按钮被激活。

至于你自己的Directive希望通过属性的方式来启用还是通过标签的方式来启用,可以在你的Directive中设置restrict字段。

渐进呈现

在页面载入时,由于Angular的控制器仍为完成构造过程,表单会短暂地显示为原始的HTML,比如:

raw form

当然你能想到最直接的解决方案是给表单加一个隐藏的样式,在载入后去掉它。然而Angular已经提供ngCloakDirective来完成这件事情,我们只需要在表单上加一个ng-cloak

<form ng-cloak>...</form>

ng-cloak可以直接加在body上,但在载入过程中,整个body都会隐藏。这与HTML的渐进呈现的原则是相悖的。建议在表单上单独地应用ng-cloak

HTML属于流式文档,已载入的部分的呈现方式总是已知的。在带宽小的情况下,HTML会逐步显示已载入的部分。

Harttle

致力于简单的、一致的、高效的前端开发

看看这个?