Blazorise中利用IValidatableObject实现动态表单验证

在Blazor应用开发中，表单验证是一个常见需求。Blazorise作为一款功能丰富的Blazor组件库，提供了多种验证方式。本文将重点介绍如何结合.NET的IValidatableObject接口，在Blazorise中实现灵活的动态表单验证。

动态验证场景

在实际业务中，我们经常遇到这样的需求：表单字段的验证规则需要根据其他字段的值动态变化。例如：

• 当订单状态为"已完成"时，必须填写完成备注
• 当用户选择"企业用户"时，必须填写公司名称
• 当支付方式为"信用卡"时，必须填写卡号信息

这种依赖其他字段值的验证需求，使用静态属性注解往往难以实现。

IValidatableObject接口

.NET提供了IValidatableObject接口，允许我们在类级别实现自定义验证逻辑。该接口定义了一个方法：

IEnumerable<ValidationResult> Validate(ValidationContext validationContext)

通过实现这个方法，我们可以：

1. 访问当前对象的所有属性值
2. 编写复杂的业务验证逻辑
3. 返回针对特定属性的验证错误

Blazorise中的实现

在Blazorise中，我们可以这样使用IValidatableObject：

1. 首先定义数据模型类，实现IValidatableObject接口：

class SomeData : IValidatableObject
{
    [Required]
    public string Text1 { get; set; }

    public string Text2 { get; set; }
    public string Status { get; set; } = "New";

    public IEnumerable<ValidationResult> Validate(ValidationContext validationContext)
    {
        if (Status == "Completed")
        {
            if (string.IsNullOrEmpty(Text2))
            {
                yield return new ValidationResult("Text2是必填项", new[] { nameof(Text2) });
            }
        }
    }
}

2. 在Blazor组件中使用这个模型：

<Select @bind-SelectedValue=mydata.Status>
    <SelectItem>New</SelectItem>
    <SelectItem>Completed</SelectItem>
</Select>

<Validations @ref=valref1 Model=mydata Mode="ValidationMode.Manual">
    <Validation>
        <TextEdit @bind-Text=mydata.Text1></TextEdit>
    </Validation>
    <Validation>
        <TextEdit @bind-Text=mydata.Text2></TextEdit>
    </Validation>
</Validations>

<Button @onclick=Submit>提交</Button>

3. 手动触发验证：

async Task Submit()
{
    valref1.ClearAll();
    await valref1.ValidateAll();
}

实现原理分析

这种实现方式的优势在于：

1. 灵活性：可以在Validate方法中编写任意复杂的业务逻辑
2. 可维护性：验证逻辑集中在模型类中，便于维护
3. 兼容性：可以与数据注解验证共存，Text1使用Required注解，Text2使用动态验证
4. 用户体验：通过ValidationMode.Manual实现手动触发验证，避免频繁的即时验证干扰用户

最佳实践建议

1. 保持验证逻辑简洁：虽然可以编写复杂逻辑，但应尽量保持简单清晰
2. 合理使用缓存：对于计算量大的验证逻辑，考虑缓存中间结果
3. 错误消息友好：提供清晰明确的错误提示，帮助用户理解问题
4. 单元测试：为自定义验证逻辑编写单元测试，确保其正确性
5. 性能考虑：避免在Validate方法中执行耗时操作

总结

通过结合Blazorise的验证组件和IValidatableObject接口，开发者可以轻松实现复杂的动态表单验证需求。这种方法既保持了代码的整洁性，又提供了足够的灵活性来处理各种业务场景。对于需要根据其他字段值动态调整验证规则的场景，这无疑是一个优雅的解决方案。