Angular在模板驱动表单中自定义校验器的方法

引言

模板驱动表单相比较响应式表单可以少更少的代码做同样的事情，可也损失了自由度与更易测试，当然很多人并不在乎啦。

所以我相信很多人在编写Angular不自由自主去更倾向于模板驱动表单的写法。

表单最核心的是校验体验，在Angular中简直就是发挥到了极致，比如：required、min、max、pattern 等，这些原本是HTML DOM元素中的表述，而Angular默认实现了一整套的校验指令，比如：required 对应 RequiredValidator。

然后很多时候我们需要一些特殊的校验，比如：数据比较、远程校验等。那在模板驱动表单风格中我们要如何优雅的实现这样一个校验器呢？

一、Angular是如何校验？

一般在编写一个手机文本框可能是这样：

<input [(ngModel)]="user.mobile" #mobile="ngModel" autocomplete="off" type="tel" class="form-control" name="mobile" required maxlength="11"><div *ngIf="mobile.errors">  <p *ngIf="mobile.errors.required">手机号必填</p>  <p *ngIf="mobile.errors.pattern">手机号格式不正确</p></div>

以上几行很友好的实现从必填项、格式进行校验，而这一切都是依靠 [(ngModel)] 统一采集，得以只需要利用一个模板引用变量访问到每个校验指令的错误信息。

1、[(ngModel)] 到底做了什么？

在解析这个问题前需要先了解一下 RequiredValidator 是如何定义的。

@Directive({ providers: [{   provide: NG_VALIDATORS,   useExisting: forwardRef(() => RequiredValidator),   multi: true  }]})export class RequiredValidator {}

只看最核心向 NG_VALIDATORS 标识符注册一个 RequiredValidator 指令。这样就可以使 ngModel 指令中注入 NG_VALIDATORS 后就能得到这个指令对象。

ngModel 我把它简化了一下：

export class NgModel extends NgControl {  constructor(@Inject(NG_VALIDATORS) validators: Array<Validator|ValidatorFn>) {}    get validator(): ValidatorFn|null {    // 各种校验并返回结果  }}

有关更多ng_model.ts可以深入阅读源代码。

Angular会在每一次表单值变更时，对所有的表单中已经安装的校验器进行一次遍历。

二、编写一个校验器

诚如 required 校验器一样，依然是把自定义校验器挂到 NG_VALIDATORS 当中。假如我们希望手机文本框只能输入 159 开头的一个校验器。

定义Directive

@Directive({  selector: '[user-mobile]',  exportAs: 'userMobile',  providers: [{    provide: NG_VALIDATORS,    useExisting: forwardRef(() => UserMobileDirective),    multi: true  }]})export class UserMobileDirective {}

一个非常普通的指令定义方法，只是多了一个将 UserMobileDirective 注册到 NG_VALIDATORS 标识符当中而已。别问我为什么，一种约定。