引言
模板驱动表单相比较响应式表单可以少更少的代码做同样的事情,可也损失了自由度与更易测试,当然很多人并不在乎啦。
所以我相信很多人在编写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') "color: #ff0000">总结以上所述是小编给大家介绍的Angular在模板驱动表单中自定义校验器的方法,希望对大家有所帮助,如果大家有任何疑问请给我留言,小编会及时回复大家的。在此也非常感谢大家对网站的支持!
RTX 5090要首发 性能要翻倍!三星展示GDDR7显存
三星在GTC上展示了专为下一代游戏GPU设计的GDDR7内存。
首次推出的GDDR7内存模块密度为16GB,每个模块容量为2GB。其速度预设为32 Gbps(PAM3),但也可以降至28 Gbps,以提高产量和初始阶段的整体性能和成本效益。
据三星表示,GDDR7内存的能效将提高20%,同时工作电压仅为1.1V,低于标准的1.2V。通过采用更新的封装材料和优化的电路设计,使得在高速运行时的发热量降低,GDDR7的热阻比GDDR6降低了70%。
更新日志
- 陈思安.1990-国语钢琴酒吧5CD【欣代唱片】【WAV+CUE】
- 莫文蔚《莫后年代20周年世纪典藏》3CD[WAV+CUE][2G]
- 张惠妹《我要快乐》华纳[WAV+CUE][1G]
- 罗大佑1982《之乎者也》无法盗版的青春套装版 [WAV+CUE][1G]
- 曾庆瑜1989-款款柔情[日本东芝版][WAV+CUE]
- Scelsi-IntegraledesquatuorsacordesetTrioacordes-QuatuorMolinari(2024)[24bit-WAV]
- 房东的猫2017-房东的猫[科文音像][WAV+CUE]
- 杨乃文.2016-离心力(引进版)【亚神音乐】【WAV+CUE】
- 群星.2024-珠帘玉幕影视原声带【TME】【FLAC分轨】
- 芝麻龙眼.2008-光阴隧道民歌记录3CD【乡城】【WAV+CUE】
- 谭艳《再度重相逢HQII》头版限量[低速原抓WAV+CUE][549M]
- ABC唱片《蔡琴三十周年纪念版》6N纯银镀膜 [WAV+CUE][1.1G]
- 海来阿木《西楼情歌》开盘母带[WAV+CUE][1.1G]
- TheGesualdoSix-QueenofHeartsLamentsandSongsofRegretforQueensTerrestrialandCele
- 王建杰2011-荣华富贵[喜玛拉雅][WAV+CUE]