jQuery validator plugin之Validator

Validator.destroy()

Destroys this instance of validator freeing up resources and unregistering events.

jQuery.validator.methods

Object holding all validation methods known to the validator. This can be accessed to override individual methods, while keeping the default messages.

jQuery.validator.addClassRules()

• jQuery.validator.addClassRules( name, rules )

  • name
    Type: String
    The name of the class rule to add
  • rules
    Type: Object
    The compound rules (see example)

• jQuery.validator.addClassRules( rules )

  • rules
    Type: Object
    A map of className-rules pairs (see example).

jQuery.validator.setDefaults()

• jQuery.validator.setDefaults( options )

  • options
    Type: Object
    Options to set as default.

Accepts everything that validate() accepts.

jQuery.validator.format()

• jQuery.validator.format( template, argument, argumentN… )

  • template
    Type: String
    The string to format.
  • argument
    Type: Object
    The first argument to insert, or an array of Strings to insert
  • argumentN…
    Type: Object
    The second etc. argument to insert

One or more arguments can be passed, in addition to the string template itself, to insert into the string.

If you're familiar with the term, this makes this function support currying. If you don't care about that, just use the first argument.

jQuery.validator.addMethod()

Add a custom validation method. It must consist of a name (must be a legal javascript identifier), a javascript based function and a default string message.

• jQuery.validator.addMethod( name, method [, message ] )

  • name
    Type: String
    The name of the method used to identify it and referencing it; this must be a valid JavaScript identifier
  • method
    Type: Function()
    The actual method implementation, returning true if an element is valid. First argument: Current value. Second argument: Validated element. Third argument: Parameters.
    • value
      Type: String
      the current value of the validated element
    • element
      Type: Element
      the element to be validated
    • params
      Type: Object
      parameters specified for the method, e.g. for min: 5, the parameter is 5, for range: [1, 5] it's [1, 5]
    • message
      Type: String
      The default message to display for this method. Can be a function created by ''jQuery.validator.format(value)''. When undefined, an existing message is used (handy for localization), otherwise the field-specific messages have to be defined.

For simple one-off validation, you can use the bundled pattern method (in additional methods, source in src/additional/pattern.js) to validate a field against a regular expression.

In general, it is a good idea to encapsulate those regular expressions inside their own method.

If you need lots of slightly different expressions, try to extract a common parameter.

See also a library of regular expressions.

Validator.showErrors()

Show the specified messages.

• Validator.showErrors( errors )

  • errors
    Type: Object
    One or more key/value pairs of input names and messages.

Validator.resetForm()

Resets the controlled form.

Validator.numberOfInvalids()

• Validator.numberOfInvalids( errors )

  • errors
    Type: Object
    One or more key/value pairs of input names and messages.

Returns the number of invalid fields.

Validator.form()

Validates the form, returns true if it is valid, false otherwise.