Blazor.FluentValidation 1.0.1

Blazor.FluentValidation

Integrasi otomatis FluentValidation ke dalam <EditForm> Blazor.
Kompatibel dengan .NET 10+, mendukung nested object, collection, rule set, dan validasi real-time per field.

Fitur Utama

• Integrasi langsung ke <EditForm> tanpa konfigurasi kompleks
• Auto-discovery validator dari DI berdasarkan tipe model — tanpa perlu set parameter apapun
• Support ValidatorType (resolve dari DI) dan ValidatorInstance (instance manual)
• Validasi nested object otomatis (Address.City, Order.Items[0].Name)
• Dukungan collection dengan indexer (Items[0], Tags[2])
• Validasi real-time saat field berubah (OnFieldChanged)
• Support Rule Set FluentValidation via parameter RuleSets
• Opsi menonaktifkan validasi per field via ValidateOnFieldChange
• Penanganan error yang aman — tidak merusak Blazor Server circuit

Instalasi

dotnet add package Blazor.FluentValidation

Registrasi DI

Daftarkan validator ke DI container di Program.cs:

using FluentValidation;

// Satu assembly
builder.Services.AddValidatorsFromAssemblyContaining<PersonValidator>();

// Atau semua assembly yang ter-load
var assemblies = AppDomain.CurrentDomain
    .GetAssemblies()
    .Where(a => !a.IsDynamic && !string.IsNullOrWhiteSpace(a.Location));

builder.Services.AddValidatorsFromAssemblies(assemblies, includeInternalTypes: true);

Parameter

Contoh Penggunaan

Mode 1: Auto-Discovery (Direkomendasikan)

Jika IValidator<TModel> sudah terdaftar di DI, tidak perlu set parameter apapun:

<EditForm Model="@person" OnValidSubmit="@HandleSubmit">
    <FluentValidationExtension />

    <InputText @bind-Value="person.Name" />
    <ValidationMessage For="@(() => person.Name)" />

    <button type="submit">Simpan</button>
</EditForm>

Mode 2: ValidatorType (dari DI)

<EditForm Model="@person" OnValidSubmit="@HandleSubmit">
    <FluentValidationExtension ValidatorType="typeof(PersonValidator)" />

    <InputText @bind-Value="person.Name" />
    <ValidationMessage For="@(() => person.Name)" />
</EditForm>

Mode 3: ValidatorInstance (manual, tanpa DI)

<EditForm Model="@person" OnValidSubmit="@HandleSubmit">
    <FluentValidationExtension ValidatorInstance="@(new PersonValidator())" />

    <InputText @bind-Value="person.Name" />
    <ValidationMessage For="@(() => person.Name)" />
</EditForm>

Mode 4: Rule Set

<EditForm Model="@person" OnValidSubmit="@HandleSubmit">
    <FluentValidationExtension RuleSets="@(new[] { "Create", "Default" })" />

    <InputText @bind-Value="person.Name" />
    <ValidationMessage For="@(() => person.Name)" />
</EditForm>

Mode 5: Hanya Validasi saat Submit

<EditForm Model="@person" OnValidSubmit="@HandleSubmit">
    <FluentValidationExtension ValidateOnFieldChange="false" />

    <InputText @bind-Value="person.Name" />
    <ValidationMessage For="@(() => person.Name)" />
</EditForm>

Nested Object

Model

public class Person
{
    public string Name { get; set; } = string.Empty;
    public Address Address { get; set; } = new();
}

public class Address
{
    public string Street { get; set; } = string.Empty;
    public string City { get; set; } = string.Empty;
}

Validator

public class PersonValidator : AbstractValidator<Person>
{
    public PersonValidator()
    {
        RuleFor(p => p.Name)
            .NotEmpty().WithMessage("Nama wajib diisi.")
            .MinimumLength(3).WithMessage("Minimal 3 karakter.");

        RuleFor(p => p.Address)
            .SetValidator(new AddressValidator());
    }
}

public class AddressValidator : AbstractValidator<Address>
{
    public AddressValidator()
    {
        RuleFor(a => a.Street).NotEmpty().WithMessage("Jalan wajib diisi.");
        RuleFor(a => a.City).NotEmpty().WithMessage("Kota wajib diisi.");
    }
}

Form

<EditForm Model="@person" OnValidSubmit="@HandleSubmit">
    <FluentValidationExtension />

    <InputText @bind-Value="person.Name" />
    <ValidationMessage For="@(() => person.Name)" />

    <InputText @bind-Value="person.Address.Street" />
    <ValidationMessage For="@(() => person.Address.Street)" />

    <InputText @bind-Value="person.Address.City" />
    <ValidationMessage For="@(() => person.Address.City)" />

    <button type="submit">Simpan</button>
</EditForm>

Collection

public class Order
{
    public List<OrderItem> Items { get; set; } = [];
}

public class OrderItem
{
    public string ProductName { get; set; } = string.Empty;
    public int Quantity { get; set; }
}

public class OrderValidator : AbstractValidator<Order>
{
    public OrderValidator()
    {
        RuleForEach(o => o.Items).SetValidator(new OrderItemValidator());
    }
}

public class OrderItemValidator : AbstractValidator<OrderItem>
{
    public OrderItemValidator()
    {
        RuleFor(i => i.ProductName).NotEmpty().WithMessage("Nama produk wajib diisi.");
        RuleFor(i => i.Quantity).GreaterThan(0).WithMessage("Jumlah harus lebih dari 0.");
    }
}

<EditForm Model="@order" OnValidSubmit="@HandleSubmit">
    <FluentValidationExtension />

    @for (int i = 0; i < order.Items.Count; i++)
    {
        var item = order.Items[i];

        <InputText @bind-Value="item.ProductName" />
        <ValidationMessage For="@(() => item.ProductName)" />

        <InputNumber @bind-Value="item.Quantity" />
        <ValidationMessage For="@(() => item.Quantity)" />
    }

    <button type="submit">Pesan</button>
</EditForm>

Catatan untuk .NET 8+ (Static SSR)

Jika menggunakan [SupplyParameterFromForm], wajib menyertakan FormName yang unik:

<EditForm FormName="personForm" Model="@person" OnValidSubmit="@HandleSubmit">
    <FluentValidationExtension />
    ...
</EditForm>

Tanpa FormName, Blazor akan melempar error:

The POST request does not specify which form is being submitted.

Kontribusi & Dukungan

Kontribusi terbuka. Silakan laporkan issue, ajukan fitur, atau buat pull request di:

https://github.com/ganiputras/Blazor.FluentValidation

Lisensi

Blazor.FluentValidation dirilis di bawah MIT License.