Angular Form表单自定义验证器(同步)

在web应用里,我们都知道表单基本无处不在,如登录、注册、个人信息收集等。为了在应用里提高用户体验,在处理表单时,我们往往要引入表单验证。在Angular里有一些内置验证器,但是在实际应用当中,内置验证器往往不够我们用。

表单验证

通过验证用户输入的准确性和完整性,来增强整体数据质量。

对angular Form学习后我们知道表单分为两种:

  • 模板驱动型表单:它们很容易添加到应用中,但是不像响应式表单那么容易扩展。
  • 响应式驱动(模型驱动)表单:提供了一种模型驱动的方式来处理表单输入,其中的值会随时间而变化.响应式表单使用显式的、不可变的方式,管理表单在特定的时间点上的状态.

在自定义验证器时需要分别去对应这两种类型的表单。在本文里,我们不讨论这两种表单的数据流,只讨论自定义验证器的实现。对于内置验证器,可以去官方文档里查看,每一验证器都有例子。

模板驱动型表单自定义验证器(同步)

我们用一个简单的例子来帮助我们实现一个模板驱动型表单的自定义同步验证器。这个例子是:禁止输入Patrick。

  1. 第一步创建指令。
  2. 导入Input,NG_VALIDATORS, Validators, AbstractControl。
import { Directive, Input } from '@angular/core';
import { NG_VALIDATORS, Validators, AbstractControl } from "@angular/forms"

@Directive({
  selector: '[appMyValidationTwo]',
  providers:[{provide: NG_VALIDATORS, useExisting: MyValidationTwoDirective, multi: true}]
})
export class MyValidationTwoDirective implements Validators{
  constructor() { }
  @Input('appMyValidationTwo') forbiddenName:string;

  validate(contrl: AbstractControl): {[key:string]:any} | null{
    return this.forbiddenName ? (this.forbiddenName === contrl.value?{'forbiddenName':contrl.value} :null) : null;
    // 这里面书写你的验证器的逻辑。
  }

}
  • 导入Input:因为验证器需要模板输入值
  • NG_VALIDATORS:指令把自己注册到了NG_VALIDATORS提供商中,该提供商拥有一组可扩展的验证器

3.添加到模板驱动表单中

  {{name.errors | json}} //把错误打印在页面中。
<input id="name" name="name" class="form-control"
       required minlength="2" appMyValidationTwo = 'Patrick'
       [(ngModel)]="hero.name" #name="ngModel" >
    
<div *ngIf="name.invalid && (name.dirty || name.touched)"
     class="alert alert-danger">

  <div *ngIf="name.errors.required">
    Name is required.
  </div>
  <div *ngIf="name.errors.minlength">
    Name must be at least 2 characters long.
  </div>
  <div *ngIf="name.errors.forbiddenName">
    Name cannot be Patrick.
  </div>
</div>

就像属性指令那样,在元素上使用即可。当在输入框输入Patrick时,该验证器会返回一个错误对象;如果输入的内容不是验证器禁止的内容时,会返回null,返回null即代表表单输入无误。试一试。

响应式驱动表单自定义验证器(同步)

以同样的例子(禁止输入Patrick)来实现响应式驱动表单的同步自定义验证器。

  1. 创建一个工厂函数
  import {ValidatorFn, AbstractControl} from "@angular/forms"

//响应式表单自定义模板验证器
export function forbiddenNameValidator(name:string):ValidatorFn{
    return (contrl:AbstractControl): {[key: string]: any} | null=>{
      const forbidden = name === contrl.value;
      return forbidden ? {'forbiddenName': {value: contrl.value}} : null;
    }
  }
  1. 把自定义验证器添加到响应式驱动表单
  profileForm = this.fb.group({
    nameTwo : ['Bob',
      [Validators.required,Validators.minLength(2),forbiddenNameValidator("Patrick")]
    ],
      id : [123,Validators.required]
  });

  get id(){
    return this.profileForm.get('id');
  }
  get nameTwo(){
    return this.profileForm.get('nameTwo');
  }

我们用getter获取formControl并设置给nameTwo属性,这样我们就能在模板里处理验证器的错误了。

  <form [formGroup] = 'profileForm'>
  <div class="form-group">
    <label for="nameTwo">Name</label>
    <input type="text" class="form-control" id="nameTwo" formControlName="nameTwo" required>
  </div>
  <div *ngIf="nameTwo.errors && nameTwo.errors.required">
    Name is required.
  </div>
  <div *ngIf="nameTwo.errors && nameTwo.errors.minlength">
    姓名的最小长度为2
  </div>
  <div *ngIf="nameTwo.errors && nameTwo.errors.forbiddenName">  //对自定义同步验证器错误的处理
    姓名不能为Patrick
  </div>
  <div class="form-group">
    <label for="id">Id</label>
    <input type="text" class="form-control" id="id" formControlName="id" required>
  </div>
  <div *ngIf="id.errors && id.errors.required">ID是必选项</div>
  <button type="submit" class="btn btn-default" [disabled]="profileForm.invalid">Submit</button>
</form>

这就是一个实现响应式模板驱动表单的验证器的简单例子。试试吧。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 222,104评论 6 515
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 94,816评论 3 399
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 168,697评论 0 360
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 59,836评论 1 298
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 68,851评论 6 397
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 52,441评论 1 310
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,992评论 3 421
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,899评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 46,457评论 1 318
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 38,529评论 3 341
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 40,664评论 1 352
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 36,346评论 5 350
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 42,025评论 3 334
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 32,511评论 0 24
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,611评论 1 272
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 49,081评论 3 377
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 45,675评论 2 359

推荐阅读更多精彩内容