jQuery.Validation.Unobtrusive.Native is a collection of ASP.Net MVC HTML helper extensions that make use of jQuery Validation's native unobtrusive support for validation driven by HTML 5 data attributes. Microsoft shipped jquery.validate.unobtrusive.js back with MVC 3. It provided a way to apply data model validations to the client side using a combination of jQuery Validation and HTML 5 data attributes (that's the "unobtrusive" part).
The principal of this was and is fantastic. But since that time the jQuery Validation project has implemented its own support for driving validation unobtrusively (this shipped with jQuery Validation 1.11.0). The advantages of the native support over jquery.validate.unobtrusive.js are:
- Dynamically created form elements are parsed automatically. jquery.validate.unobtrusive.js does not support this.
- jquery.validate.unobtrusive.js restricts how you use jQuery Validation. Want to use showErrors etc? Well you'll need to go native...
- Send less code to your browser, make your browser to do less work, get a performance benefit (though you'd probably have to be the Flash to actually notice the difference)
This project intends to be a bridge between MVC's inbuilt support for driving validation from data attributes and jQuery Validation's native support for the same. This is achieved by hooking into the MVC data attribute creation mechanism and using it to generate the data attributes used by jQuery Validation.
You can see more detail on the demo site.
##Getting started
If you haven't already, ensure that the following entries can be found in your web.config:
<appSettings>
<add key="ClientValidationEnabled" value="true" />
<add key="UnobtrusiveJavaScriptEnabled" value="true" />
</appSettings>
Include jQuery.Validation.Unobtrusive.Native into your project (available on nuget or on GitHub). With this in place you should be able to switch from using the existing TextBoxFor
/ DropDownListFor
/ CheckBoxFor
/ TextAreaFor
/ RadioButtonFor
/ ListBoxFor
/ PasswordFor
HtmlHelper statements in your views and to jQuery.Validation.Unobtrusive.Native's equivalent by passing true
to the useNativeUnobtrusiveAttributes
parameter. (By convention this is the first parameter after the Expression<Func<TModel, TProperty>> expression
parameter.
Ensure that you have the latest version of jquery.validate.js, you can find it here. Oh, and remember that you no longer need to serve up the jquery.validate.unobtrusive.js on a screen where you are using jQuery.Validation.Unobtrusive.Native. All you need is jquery.validate.js (and of course jQuery).
P.S. If you're using the source code from GitHub in Visual Studio, make sure you have the Package Manager option "Allow NuGet to download missing packages during build" set to true. This will ensure that the required packages are downloaded from NuGet.
##Examples
Where you would previously have written:
@Html.TextBoxFor(x => x.RangeAndNumberDemo)
To use jQuery.Validation.Unobtrusive.Native you would put:
@Html.TextBoxFor(x => x.RangeAndNumberDemo, true)
Or, where you would have written:
@Html.DropDownListFor(x => x.DropDownRequiredDemo, new List<SelectListItem> {
new SelectListItem{ Text = "Please select", Value = "" },
new SelectListItem{ Text = "An option", Value = "An option"}
})
Now you would put:
@Html.DropDownListFor(x => x.DropDownRequiredDemo, true, new List<SelectListItem> {
new SelectListItem{ Text = "Please select", Value = "" },
new SelectListItem{ Text = "An option", Value = "An option"}
})
The only differences above are the extra true
parameters being passed. If you had passed false
instead jQuery.Validation.Unobtrusive.Native internally calls the inbuilt MVC implementation. I have considered keeping jQuery.Validation.Unobtrusive.Native's HtmlHelpers entirely separate from the inbuilt MVC ones and instead implementing TextBoxNativeFor
/ DropDownListNativeFor
etc... methods which share the same signatures as the inbuilt MVC ones. For now this is the way it is but it could change if people feel strongly enough - if you've an opinion then drop me a line with your rationale.
By the way, the above examples (and others) can be found in the MVC demo project jVUNDemo on GitHub - this demo site be viewed at johnnyreilly.github.io/jQuery.Validation.Unobtrusive.Native/. 2 of the demos (Remote and Globalize) do not work completely as static sites (which GitHub pages are). If you would like to see these demo's in action it's best you run the jVUNDemo project locally.
##Plans
So far the basic set of the HtmlHelpers and their associated unobtrusive mappings have been implemented. If any have been missed then let me know. As time goes by I intend to:
- fill in any missing gaps there may be
- maintain both MVC 3, 4, 5 (and when / if the time comes 6+) versions of this on Nuget
- get the unit test coverage to a good level and (most importantly)
- create some really useful demos and documentation.
Author
John Reilly
Credits
Inspired by jquery.validate.unobtrusive.js and entirely dependent on http://github.com/jzaefferer/jquery-validation and http://aspnet.codeplex.com/wikipage?title=MVC.
Copyright
Copyright © 2013 John Reilly.
##License
MIT license - http://www.opensource.org/licenses/mit-license.php
##Changelog
###1.2.0 / 2015-06-08
- Added support for RegularExpression, MaxLength, MinLength and FileExtensions attributes (thanks to Ben Duguid for this)
###1.1.2 / 2015-01-07
###1.1.1 / 2014-05-27
###1.1.0.0 / 2013-10-04
- Added support for PasswordFor, previously missing.
###1.0.0.0 / 2013-09-04
- Fix to allow usage of EditorTemplates (thanks to @DavidCarroll for this)
- Fix to make range culture invariant to enable use by cultures where the decimal place is represented by something other than a decimal place (eg in Germany 20.5 is expressed as 20,5 - JavaScript can't handle this yet).
- Given major version number now that the rough edges have been dealt with.
###0.4.1.0 / 2013-08-25
- Now possible to override generated data attributes with those passed in htmlAttributes parameter.
###0.4.0.0 / 2013-08-14
- All missing helpers now covered (TextArea / ListBox etc)
- Switch to new mechanism to support users implementing their own custom validations
- Included demo of custom validations implementation
###0.2.0 / 2013-08-07
- Initial release
- Included demo of dynamic content using Knockout.
###0.1.0 / 2013-07-29
- Beta release - not fully featured