Finbuckle.Html5Validation 10.0.0

Finbuckle.Html5Validation

1. Introduction
2. What's New in v<span class="_version">10.0.0</span>
3. Installation
4. Supported Data Annotations
5. FAQ
6. License

Introduction

Client side form validation in ASP.NET Core stinks.

Specifically, tag helpers and HTMLHelper methods generate non-standard validation attributes and require the use of the jquery.validate and jquery.validate.unobtrusive libraries.

This library overrides this behavior to generate standard HTML5 validation attributes.

<a name="whats-new"></a> What's New in v<span class="_version">10.0.0</span>

This section only lists release update details specific to v<span class="_version">10.0.0</span>. See the changelog file for all release update details.

⚠ BREAKING CHANGES

• The library now targets net10.0 only. .NET 8 and .NET 9 are no longer supported.

Features

• Add title attribute containing error message to validated inputs (#3) (b285611)
• drop .NET 8 and .NET 9 support, target .NET 10 only (#9) (14580d1)
• Update to .NET 10 (13d0ce8)

Installation

1. Add the Finbuckle.Html5Validation NuGet package to your project.

2. Add the Html5Validation service to your app:

using Finbuckle.Html5Validation;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddHtml5Validation();

// Rest of app code omitted.

Supported Data Annotations

The following data annotations are supported:

Note that [DataType(DataType.{type})] only supports simple types such as email, phone, and url.

† The title attribute is only added when a custom ErrorMessage or ErrorMessageResourceName is explicitly set on the annotation, e.g. [Required(ErrorMessage = "This field is required.")]. Browsers display the title value as a tooltip on the input and in the built-in validation popover, giving users a clear, customized error message.

Installation

1. Add the Finbuckle.Html5Validation NuGet package to your project.

2. In your app configuration add the Html5Validation service:

using Finbuckle.Html5Validation;

var builder = WebApplication.CreateBuilder(args);

// ... Add normal services.

// Add Finbuclke.Html5Validation.
builder.Services.AddHtml5Validation();

// ... rest of file omitted.

FAQ

• Why not just use the jquery.validate and jquery.validate.unobtrusive libraries?

  These libraries are not standard HTML5 validation attributes and require additional JavaScript libraries to work. This library generates standard HTML5 validation attributes that work out of the box with modern browsers.

• Does it have any imapct on server side validation?

  No, this library only affects client-side validation.

• Does this library work with Blazor?

  No, this library only works with ASP.NET Core MVC Razor Pages and MVC apps that use tag helpers and HTMLHelper form input methods.

License

This project is licensed under the MIT License. See LICENSE file for license information.