Makes the element require a given step.
-
step( value )
-
valueType: NumberStep value required
-
normalizer
Prepares/transforms the elements value for validation.
-
normalizer( value )
-
valueType: StringThe value of the element.
-
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:
- 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
. - Needs to return a String value, otherwise it will throw a
TypeError
exception.
require_from_group method
Ensures a given number of fields in a group are complete.
In the options passed to the rule, supply the minimum number of fields
within the group that must be complete and a selector to define the
group.
Then apply this rule to all the fields within the group.
The form then cannot be submitted until at least the minimum number have
been completed.
Part of the additional-methods.js file
url method
Makes the element require a valid url
Return true, if the value is a valid url.
Works with text inputs.
required method
Makes the element required.
required()
-
required( dependency-expression )
-
dependency-expressionType: StringAn expression (String) that is evaluated in the context of the element's
form, making the field required only if the expression returns more
than one element.- Very often your expression will use selector filters such as
#foo:checked
,#foo:filled
,#foo:visible
. This plugin provides custom selectors for that purpose.
- Very often your expression will use selector filters such as
-
-
required( dependency-callback )
-
dependency-callbackType: Function()The function is executed with the element as it's only argument: If it returns true, the element is required.
- Return false, if the element is empty (text input) or unchecked (radio/checkbox) or if nothing is selected (select).
- 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.
-
remote method
-
remote( options )
- Requests a resource to check the element for validity.
-
optionsType: ObjectFor the URL of the resource to request for serverside validation (String) or options to fully customize the request, see jQuery.ajax for details.
- These options deep-extend the defaults (
dataType:"json", data:{nameOfTheElement:valueOfTheElement}
). Any options you provide will override the defaults.
- These options deep-extend the defaults (
- The serverside resource is called via jQuery.ajax (XMLHttpRequest) and
gets a key/value pair corresponding to the name of the validated element
and its value as a GET parameter.- The serverside response must be a
JSON string that must be"true"
for valid elements, and can be"false"
,undefined
, ornull
for invalid elements, using the default error message. - If the serverside response is a string, eg.
"That name is already taken, try peter123 instead"
, this string will be displayed as a custom error message in place of the default. - For more examples, take a look the marketo demo and the milk demo.
- The serverside response must be a
rangelength method
-
rangelength( range )
-
rangeType: ArrayValue range required
-
Return false if the element is:
- some kind of text input and its length is too short or too long
- a set of checkboxes that doesn't have enough, or has too many boxes checked
- a select that doesn't have enough, or has too many options selected
Works with text inputs, selects and checkboxes.
range method
-
range( range )
-
rangeType: ArrayValue range required
-
phoneUS method
Validate for valid US phone number.
Works with text inputs.
Part of the additional-methods.js file
number method
Makes the element require a decimal number.
Returns true if the value contains a valid decimal number.
Works with text inputs.
-
valueType: NumberStep value required