ngx-formly实现动态日期字段的必填验证

在使用ngx-formly构建动态表单时，日期字段的验证是一个常见需求。本文将详细介绍如何为动态生成的日期字段添加必填验证功能，并确保验证消息能够正确显示。

问题背景

在ngx-formly表单中，开发者经常需要处理日期字段的验证。特别是当日期字段是动态生成时，标准的必填验证可能不会按预期工作。例如，在员工出生日期字段中，我们不仅需要验证年龄范围，还需要确保用户必须填写该字段。

解决方案

基本配置

首先，我们需要在字段配置中明确设置required属性：

{
  key: "dateOfBirth",
  type: "custom-date",
  templateOptions: {
    label: "出生日期",
    required: true,
    // 其他配置...
  }
}

自定义验证消息

为了确保必填验证消息能够正确显示，我们可以通过以下方式自定义验证：

1. 使用内置验证器： ngx-formly已经内置了必填验证器，只需设置required: true即可自动生效。

2. 自定义验证消息： 如果需要特定的错误消息，可以在模块配置中定义：

FormlyModule.forRoot({
  validationMessages: [
    { name: 'required', message: '请填写出生日期' }
  ]
})

动态字段的特殊处理

当字段是动态生成时（如示例中的setFields方法），需要注意：

1. 验证触发时机： 确保在表单提交时触发验证，可以通过监听提交事件并手动标记表单为touched：

onSubmit() {
  this.form.markAllAsTouched();
  if (this.form.valid) {
    // 提交逻辑
  }
}

2. 条件性必填： 如果需要根据条件设置必填，可以使用表达式属性：

templateOptions: {
  required: () => !this.model.dateOfBirth
}

完整实现示例

// 组件代码
export class MyFormComponent implements OnInit {
  form = new FormGroup({});
  model = {};
  fields: FormlyFieldConfig[] = [];

  ngOnInit() {
    this.setFields();
  }

  private setFields() {
    this.fields = [
      {
        key: "dateOfBirth",
        type: "custom-date",
        templateOptions: {
          label: "出生日期",
          required: true,
          minAge: 18,
          maxAge: 80
        },
        validation: {
          messages: {
            required: '请填写出生日期'
          }
        }
      }
    ];
  }

  onSubmit() {
    this.form.markAllAsTouched();
    if (this.form.valid) {
      // 提交逻辑
    }
  }
}

总结

通过合理配置ngx-formly的验证规则和消息，我们可以轻松实现动态日期字段的必填验证。关键点包括：

1. 明确设置required属性
2. 自定义验证消息提高用户体验
3. 处理动态字段的特殊情况
4. 确保验证在适当的时候触发

这些技巧不仅适用于日期字段，也可以应用于其他类型的表单字段验证场景。