agdar/static/plugins/parsleyjs/UPGRADE-2.0.md

UPGRADE FROM 1.x to 2.0

General

• default namespace is now data-parsley- for DOM-API (not anymore 1.2.x parsley- or 1.1.x data-)
• there is only one global ParsleyValidator instance. Adding / removing validators is not made on ParsleyForm or ParsleyField instances anymore, but directly against ParsleyValidator. Same goes for errors messages.

Options / Configuration

• options is now a flat 1 dim depth object.
• These options have been removed:
  • listeners
  • validators
  • useHtml5Constraints
  • messages
  • validateIfUnchanged
• These options have been renamed:
  • validationMinlength into validationTreshold
  • errors.classHandler into classHandler
  • errors.container into errorsContainer
  • errors.errorsWrapper into errorsWrapper
  • errors.errorEleme into errorTemplate

Validators

• required validator now accepts false value and becomes inactive.
• rangelength validator is now renamed as length. Same requirements.
• rangecheck validator is now renamed as check. Same requirements.
• notnull, type="urlstrict", type="tel" have disappeared from built-in validators.
• types phone, urlstrict, dateIso have been removed. They could be crafted and submitted by someone in extra/

UI/UX

• .parsley-validated class is not added anymore on bound fields
• novalidate attr is now automatically added to <form>
• .parsley-error-list is now .parsley-errors-list
• to customize type validator error message, you do not need to add the precise type anymore. eg: parsley-type-email-message="msg" becomes data-parsley-type-message="msg"

Javascript

• .parsley('method') API is deprecated. Use .parsley().method() now eg: $('#form').parsley('validate') is now $('#form').parsley().validate()

Listeners

• can now be global with $.listen() and listen for every Parsley instance firing it (the way ParsleyUI works)
• can be Field / Form specific by using .subscribe() and .unsubscribe() on a Parsley instance.

Misc

• parsley remote validator is shipped now in parsley.remote.js
• parsley.extend is no more. Instead, extra validators are now placed in a dir and can be built with a script into a single file.