You can specify multiple mime-types by separating them with a comma, e.g. "image/x-eps,application/pdf".
Works with type="file" inputs.
- +Part of the additional-methods.js file
Note: This method used to look at just the filename, specifically the file extension. That behaviour is now available as the "extension" method inside src/additional/extension.js.
Works with text inputs.
+Part of the additional-methods.js file
Note: The algorithm used can't verify the validity of the number - it is just an integrity check. As with any other clientside validation, you have to implement the same or better validation on the serverside.
This method should not be used, since it relies on the new Date constructor, which behaves very differently across browsers and locales. Use dateISO instead or one of the locale specific methods (in localizations/ and additional-methods.js).
DEPRECATION warning:
+This method is deprecated and will be removed in version 2.0.0.
Please don't use it, since it relies on the Date constructor, which behaves very differently across browsers and locales. Use dateISO instead or one of the locale specific methods (in localizations/ and additional-methods.js).
Works with text inputs.
+IMPORTANT NOTE:
+As of version 1.12.0 we started using the same regular expression that the HTML5 specification suggests for browsers to use. We will follow their lead and use the same check. In case you need to adjust the built-in validation regular expression patterns, please use the $.validator.methods property. If you have different requirements, please consider using a custom method.
Works with text inputs.
+Part of the additional-methods.js file
Transform the value of an element and the result for validation instead of the initial value. The normalizer can be defined global to all elements or local to only one element. With that said, the local normalizer will only run for the element for which it was defined. The global normalizer will run for all validated elements. This normalizer can be then overrided for each element, as needed, by attaching one to it. This way only the local one will run for that element, and the global one will run for others.
+Note that this method:
+Has been available since version 1.15.0
Doesn't change the elements' value, it only changes the value used for validation.
Gets the value passed as argument, and "this" within it references the corresponding DOMElement.
For versions between 1.15.0 and 1.17.0, it must return a string value. And as of 1.17.1, it can return any value including null and undefined.
Part of the additional-methods.js file
Works with text inputs, selects, checkboxes and radio buttons.
To force a user to select an option from a select box, provide an empty option element like <option value="">Choose...</option>
+Note that white spaces are considered valid.
and data-rule-[method].
When setting, the rules can also contain a messages-object, specifying custom messages for existing or added rules.
@@ -51,7 +51,7 @@ $( "#myinput" ).rules( "add", {
minlength: 2,
messages: {
required: "Required input",
- minlength: jQuery.format("Please, at least {0} characters are necessary")
+ minlength: jQuery.validator.format("Please, at least {0} characters are necessary")
}
});
]]>
diff --git a/entries/step-method.xml b/entries/step-method.xml
new file mode 100644
index 0000000..5202f29
--- /dev/null
+++ b/entries/step-method.xml
@@ -0,0 +1,35 @@
+
+window.console property exists). Try to enable when a form is just submitted instead of validation stopping the submit.
Example: Prevents the form from submitting and tries to help setting up the validation with warnings about missing methods and other debug messages.
- $(".selector").validate({
+ $("#myform").validate({
debug: true
});
Example: Submits the form via Ajax when valid.
+ Callback for handling the actual submit when the form is valid. Gets the form and the submit event as the only arguments. Replaces the default submit. The right place to submit a form via Ajax after it is validated. +Example: Submits the form via Ajax, using jQuery Form plugin, when valid.
- $(".selector").validate({
+ $("#myform").validate({
submitHandler: function(form) {
$(form).ajaxSubmit();
}
@@ -36,18 +36,21 @@
Example: Use submitHandler to process something and then using the default submit. Note that "form" refers to a DOM element, this way the validation isn't triggered again.
- $(".selector").validate({
+ $("#myform").validate({
submitHandler: function(form) {
// do other things for a valid form
form.submit();
}
});
The callback gets passed one argument:
+The callback gets passed two arguments:
Example: Displays a message above the form, indicating how many fields are invalid when the user tries to submit an invalid form.
- $(".selector").validate({
+ $("#myform").validate({
invalidHandler: function(event, validator) {
// 'this' refers to the form
var errors = validator.numberOfInvalids();
@@ -98,7 +101,7 @@
Key/value pairs defining custom rules. Key is the name of an element (or a group of checkboxes/radio buttons), value is an object consisting of rule/parameter pairs or a plain String. Can be combined with class/attribute/data rules. Each rule can be specified as having a depends-property to apply the rule only in certain conditions. See the second example below for details.
Example: Specifies a name element as required and an email element as required (using the shortcut for a single rule) and a valid email address (using another object literal).
- $(".selector").validate({
+ $("#myform").validate({
rules: {
// simple rule, converted to {required:true}
name: "required",
@@ -112,13 +115,31 @@
Example: Specifies a contact element as required and as email address, the latter depending on a checkbox being checked for contact via email.
- $(".selector").validate({
+ $("#myform").validate({
rules: {
contact: {
required: true,
email: {
depends: function(element) {
- return $("#contactform_email:checked")
+ return $("#contactform_email").is(":checked");
+ }
+ }
+ }
+ }
+ });
+
+ Example: Configure a rule that requires a parameter, along with a depends callback.
+
+ $("#myform").validate({
+ rules: {
+ // at least 15€ when bonus material is included
+ pay_what_you_want: {
+ required: true
+ min: {
+ // min needs a parameter passed to it
+ param: 15,
+ depends: function(element) {
+ return $("#bonus-material").is(":checked");
}
}
}
@@ -133,7 +154,7 @@
Key/value pairs defining custom messages. Key is the name of an element, value the message to display for that element. Instead of a plain message, another map with specific messages for each rule can be used. Overrides the title attribute of an element or the default message for the method (in that order). Each message can be a String or a Callback. The callback is called in the scope of the validator, with the rule's parameters as the first argument and the element as the second, and must return a String to display as the message.
Example: Specifies a name element as required and an email element as required and a valid email address. A single message is specified for the name element, and two messages for email.
- $(".selector").validate({
+ $("#myform").validate({
rules: {
name: "required",
email: {
@@ -150,9 +171,9 @@
}
});
- Example: Validates the name-field as required and having at least two characters. Provides a callback message using jQuery.format to avoid having to specify the parameter in two places.
+ Example: Validates the name-field as required and having at least two characters. Provides a callback message using jQuery.validator.format to avoid having to specify the parameter in two places.
- $(".selector").validate({
+ $("#myform").validate({
rules: {
name: {
required: true,
@@ -162,7 +183,7 @@
messages: {
name: {
required: "We need your email address to contact you",
- minlength: jQuery.format("At least {0} characters required!")
+ minlength: jQuery.validator.format("At least {0} characters required!")
}
}
});
@@ -191,14 +212,19 @@
Set to a Function to decide for yourself when to run validation.
-A boolean true is not a valid value.
Example: Disables onsubmit validation, allowing the user to submit whatever he wants, while still validating on keyup/blur/click events (if not specified otherwise).
- $(".selector").validate({
+ $("#myform").validate({
onsubmit: false
});
Set to a Function to decide for yourself when to run validation.
A boolean true is not a valid value.
-Example: Disables onblur validation.
+Example: Disables focusout validation.
- $(".selector").validate({
+ $("#myform").validate({
onfocusout: false
});
A boolean true is not a valid value.
Example: Disables onkeyup validation.
- $(".selector").validate({
+ $("#myform").validate({
onkeyup: false
});
Set to a Function to decide for yourself when to run validation.
A boolean true is not a valid value.
-Example: Disables onclick validation of checkboxes and radio buttons.
+Example: Disables onclick validation of checkboxes, radio buttons, and select elements.
- $(".selector").validate({
+ $("#myform").validate({
onclick: false
});
Example: Disables focusing of invalid elements.
- $(".selector").validate({
+ $("#myform").validate({
focusInvalid: false
});
Example: Enables cleanup when focusing elements, removing the error class and hiding error messages when an element is focused.
- $(".selector").validate({
+ $("#myform").validate({
focusCleanup: true
});
Example: Sets the error class to "invalid".
- $(".selector").validate({
+ $("#myform").validate({
errorClass: "invalid"
});
Example: Sets the valid class to "success".
- $(".selector").validate({
+ $("#myform").validate({
validClass: "success"
});
Example: Sets the error element to "em".
- $(".selector").validate({
+ $("#myform").validate({
errorElement: "em"
});
Example: Wrap each error element with a list item, useful when using an ordered or unordered list as the error container.
- $(".selector").validate({
+ $("#myform").validate({
wrapper: "li"
});
Example: Update the number of invalid elements each time an error is displayed. Delegates to the default implementation for the actual error display.
- $(".selector").validate({
+ $("#myform").validate({
showErrors: function(errorMap, errorList) {
$("#summary").html("Your form contains "
+ this.numberOfInvalids()
@@ -458,7 +484,7 @@
How to highlight invalid fields. Override to decide which fields and how to highlight.
Example: Highlights an invalid element by fading it out and in again.
- $(".selector").validate({
+ $("#myform").validate({
highlight: function(element, errorClass) {
$(element).fadeOut(function() {
$(element).fadeIn();
@@ -468,7 +494,7 @@
Example: Adds the error class to both the invalid element and its label
- $(".selector").validate({
+ $("#myform").validate({
highlight: function(element, errorClass, validClass) {
$(element).addClass(errorClass).removeClass(validClass);
$(element.form).find("label[for=" + element.id + "]")
@@ -505,7 +531,7 @@
Set to skip reading messages from the title attribute, helps to avoid issues with Google Toolbar; default is false for compability, the message-from-title is likely to be completely removed in a future release.
Example: Configure the plugin to ignore title attributes on validated elements when looking for messages.
- $(".selector").validate({
+ $("#myform").validate({
ignoreTitle: true
});
diff --git a/entries2html.xsl b/entries2html.xsl
index 50955aa..bcd622d 100644
--- a/entries2html.xsl
+++ b/entries2html.xsl
@@ -9,14 +9,14 @@
<head>
<meta charset="utf-8">
<title><style>
</head>
<body>
<form id="myform">