In reactive forms

在响应式表单中会使用到三个类FormBuilderFormGroupFormControl,这三个类均有内置了AbstractControlOptions

  1. interface AbstractControlOptions {
  2. validators?: ValidatorFn | ValidatorFn[] | null
  3. asyncValidators?: AsyncValidatorFn | AsyncValidatorFn[] | null
  4. updateOn?: 'change' | 'blur' | 'submit'
  5. }

方式一:使用FormGroup、FormControl

  1. this.validateForm = new FormGroup({
  2. userName: new FormControl(null, {
  3. validators: [Validators.required, Validators.pattern(/^[0-9]{4,8}$/)],
  4. updateOn: 'blur'
  5. }),
  6. password: new FormControl(null, [Validators.required, Validators.pattern(/^[0-9a-zA-Z]{6,8}$/)]),
  7. }, { updateOn: 'submit' });

方式二:使用FormBuilder、FormControl

  1. this.validateForm = this.fb.group({
  2. userName: new FormControl(null, {
  3. validators: [Validators.required, Validators.pattern(/^[0-9]{4,8}$/)],
  4. updateOn: 'blur'
  5. }),
  6. password: [null, {
  7. validators: [Validators.required, Validators.pattern(/^[0-9a-zA-Z]{6,8}$/)],
  8. updateOn: 'submit'
  9. }],
  10. }, { updateOn: 'submit' });

In Template-driven forms

NgForm中使用ngFormOptions

updateOn:为所有子级的 [NgModel](https://angular.cn/api/forms/NgModel) 设置 updateOn 的默认值(除非子 [NgModel](https://angular.cn/api/forms/NgModel) 通过 ngModelOptions 显式指定了这个值)。 可能的值有:’change’ | ‘blur’ | ‘submit’。

  1. <form [ngFormOptions]="{updateOn: 'blur'}">
  2. <input name="one" ngModel> <!-- this ngModel will update on blur -->
  3. </form>

NgModel中使用ngModelOptions

跟踪该 [ngModel](https://angular.cn/api/forms/NgModel) 实例的配置项。
name:用来设置表单控件元素的 name 属性的另一种方式。
standalone:如果为 true,则此 [ngModel](https://angular.cn/api/forms/NgModel) 不会把自己注册进它的父表单中,其行为就像没在表单中一样。默认为 false。
updateOn: 用来定义该何时更新表单控件的值和有效性。默认为 change。可能的取值为:’change’ | ‘blur’ | ‘submit’。

  1. <form>
  2. <my-person-control
  3. name="Nancy"
  4. ngModel
  5. [ngModelOptions]="{name: 'user', updateOn: 'submit'}"
  6. >
  7. </my-person-control>
  8. </form>

总结

以上的方法均可以实现更新表单控件的值和有效性,父级的 updateOn 属性可以为每个子级设置校验的时机,子级本身的 updateOn 属性可为子级本身设置校验时机。使用时请注意项目Angular的版本!