欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

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

程序员文章站 2022-04-29 08:01:32
引言 模板驱动表单相比较响应式表单可以少更少的代码做同样的事情,可也损失了*度与更易测试,当然很多人并不在乎啦。 所以我相信很多人在编写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 标识符当中而已。别问我为什么,一种约定。

export class usermobiledirective implements validator {
  validate(c: abstractcontrol): { [key: string]: any; } {
    let value: string = c.value || '';
    if (!value.startswith('159')) {
      return {
        mobile: {
          msg: '手机号必须是159开头',
          actualvalue: value
        }
      };
    }
    return null;
  }
}

只需要实现 validator 接口的 validate 方法即可。

从 c 中获取dom值,当遇到非 159 开头时,返回一个用于表述消息的对象即可,否则返回一个 null。这个对象会被统一采集在 ngmodel.errors 对象下面。故而,只需要在dom元素加上 user-mobile 指令即可。

<input user-mobile [(ngmodel)]="user.mobile" #mobile="ngmodel" autocomplete="off" type="tel" class="form-control" name="mobile" id="mobile" required maxlength="11">
<div *ngif="mobile.errors">
  <p *ngif="mobile.errors.required">手机号必填</p>
  <p *ngif="mobile.errors.mobile">{{mobile.errors.mobile.msg}}</p>
</div>

接口还包括一个 registeronvalidatorchange 可选方法,当某些其它外部属性的变更时,允许重新手动触发校验。

三、异步校验器

如果说用户手机校验器需要检查手机是否为黑名单的情况下,正常黑名单数据都存在远程当中。这样情况下需要发送http请求,而这一过程就是异步。

angular针对这类异步校验有独立的另一个标识符,即:ng_async_validators,而其它代码都是相通的。

@directive({
  selector: '[user-async]',
  exportas: 'userasync',
  providers: [{
    provide: ng_async_validators,
    useexisting: forwardref(() => userasyncdirective),
    multi: true
  }]
})
export class userasyncdirective implements validator {
  validate(c: abstractcontrol): observable<any> {
    return c.valuechanges
        // 去抖
        .debouncetime(300)
        // 抑制重复值
        .distinctuntilchanged()
        // 1、可以使用flatmap进行远程校验
        // .flatmap(value => value)
        // 2、本地模拟判断
        .map((value: string) => {
          if ([ '15900000001', '15900000002' ].includes(value)) {
            return {
              mobile: {
                msg: '手机号为黑名',
                actualvalue: value
              }
            }
          }
          return null;
        })
        .first();    
  }
}

除了 ng_async_validators 核心的结构完全没有变动。

而对于 validate 方法返回的是一个 observable 类型,利用对 valuechanges 的订阅可以制作一些像去抖动作。

而最后必须使用 first() 做为结尾,原因每一次校验,对于结果而言只允许一个。

结论

本章介绍的是如何对模板驱动表单创建自定义校验器,它相比较响应式表单自定义校验器略为复杂一些。但是实际运用中,我们不应该只为某个构建表单风格做一种自定义校验器,应该二者是共存的。

比如上面 159 开头的示例。更合理的编写方式应该是将校验逻辑独立:

export class myvalidators {
  static checkmobile(value: string): validationerrors|null {
    return !value.startswith('159') ? { mobile: { msg: '手机号必须是159开头' } } : null;
  }
}
// 校验器类
export class usermobiledirective implements validator {
  validate(c: abstractcontrol): { [key: string]: any; } {
    let value: string = c.value || '';
    return myvalidators.checkmobile(value);
  }
}

这样,同一个校验器,不管是模板驱动表单还是响应式表单,都能是通用的。

总结

以上所述是小编给大家介绍的angular在模板驱动表单中自定义校验器的方法,希望对大家有所帮助