jQuery Validation Plugin library sources
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
Go to file
Mohamed Baddi 0c811ce17c
Localization: Update Arabic translations (#2485)
1 week ago
.github Update 02_feature_request.md 7 months ago
build Update generateArtifacts command in build/release.js 6 months ago
demo Demo: fix minlength validation in ajaxSubmit-integration-demo.html (#2454) 1 year ago
lib Core: Support jquery3. Closes #1866 7 years ago
src Localization: Update Arabic translations (#2485) 1 week ago
test Core: Added escapeHtml option to avoid XSS attacks via showLabel methods (#2462) 1 year ago
.editorconfig Use LF to match jQuery Styleguide 10 years ago
.gitattributes Use LF to match jQuery Styleguide 10 years ago
.gitignore Build: Cleanup gitignores, jscs settings, package descriptions 10 years ago
.jscsrc Build: Cleanup gitignores, jscs settings, package descriptions 10 years ago
.jshintignore JSHint: Extract configuration to dotfiles 10 years ago
.jshintrc Build: Bump and merge JSHint/JSCS config 10 years ago
CONTRIBUTING.md README: Fixed wording 6 years ago
Gruntfile.js Gruntfile.js: add LICENSE.md to zip tarball (#2386) 2 years ago
LICENSE.md Build: Add a copy of the MIT license 9 years ago
README.md README: update build status badge (#2424) 2 years ago
SECURITY.md Create SECURITY.md 3 years ago
bower.json All: Use https 7 years ago
changelog.md Chore: update changelog.md 6 months ago
package.json Build: Updating the master version to 1.20.1-pre. 6 months ago
validation.jquery.json All: Fix links after move to organization 7 years ago

README.md

jQuery Validation Plugin - Form validation made easy

release Build Status devDependency Status jsDelivr Hits

The jQuery Validation Plugin provides drop-in validation for your existing forms, while making all kinds of customizations to fit your application really easy.

Getting Started

Downloading the prebuilt files

Prebuilt files can be downloaded from https://jqueryvalidation.org/

Downloading the latest changes

The unreleased development files can be obtained by:

  1. Downloading or Forking this repository
  2. Setup the build
  3. Run grunt to create the built files in the "dist" directory

Including it on your page

Include jQuery and the plugin on a page. Then select a form to validate and call the validate method.

<form>
	<input required>
</form>
<script src="jquery.js"></script>
<script src="jquery.validate.js"></script>
<script>
    $("form").validate();
</script>

Alternatively include jQuery and the plugin via requirejs in your module.

define(["jquery", "jquery.validate"], function( $ ) {
	$("form").validate();
});

For more information on how to setup a rules and customizations, check the documentation.

Reporting issues and contributing code

See the Contributing Guidelines for details.

IMPORTANT NOTE ABOUT EMAIL VALIDATION. As of version 1.12.0 this plugin is using the same regular expression that the HTML5 specification suggests for browsers to use. We will follow their lead and use the same check. If you think the specification is wrong, please report the issue to them. If you have different requirements, consider using a custom method. In case you need to adjust the built-in validation regular expression patterns, please follow the documentation.

IMPORTANT NOTE ABOUT REQUIRED METHOD. As of version 1.14.0 this plugin stops trimming white spaces from the value of the attached element. If you want to achieve the same result, you can use the normalizer that can be used to transform the value of an element before validation. This feature was available since v1.15.0. In other words, you can do something like this:

$("#myForm").validate({
	rules: {
		username: {
			required: true,
			// Using the normalizer to trim the value of the element
			// before validating it.
			//
			// The value of `this` inside the `normalizer` is the corresponding
			// DOMElement. In this example, `this` references the `username` element.
			normalizer: function(value) {
				return $.trim(value);
			}
		}
	}
});

Accessibility

For an invalid field, the default output for the jQuery Validation Plugin is an error message in a <label> element. This results in two <label> elements pointing to a single input field using the for attribute. While this is valid HTML, it has inconsistent support across screen readers.

For greater screen reader support in your form's validation, use the errorElement parameter in the validate() method. This option outputs the error in an element of your choice and automatically adds ARIA attributes to the HTML that help with screen reader support.

aria-describedby is added to the input field and it is programmatically tied to the error element chosen in the errorElement parameter.

$("#myform").validate({
  errorElement: "span"
});
<label for="name">Name</label>
<input id="name" aria-describedby="unique-id-here">
<span class="error" id="unique-id-here">This field is required</span>

Learn more about errorElement

License

Copyright © Jörn Zaefferer
Licensed under the MIT license.