- Jump To … +
  <<< back to documentation base.js constraint.js defaults.js factory.js field.js form.js main.js multiple.js pubsub.js remote.js ui.js utils.js validator.js validator_registry.js

- # main.js

- ¶

      import $ from 'jquery';
      import Utils from './utils';
      import Defaults from './defaults';
      import Base from './base';
      import ValidatorRegistry from './validator_registry';
      import UI from './ui';
      import Form from './form';
      import Field from './field';
      import Multiple from './multiple';
      import Factory from './factory';

      var vernums = $.fn.jquery.split('.');
      if (parseInt(vernums[0]) <= 1 && parseInt(vernums[1]) < 8) {
        throw "The loaded version of jQuery is too old. Please upgrade to 1.8.x or better.";
      }
      if (!vernums.forEach) {
        Utils.warn('Parsley requires ES5 to run properly. Please include https://github.com/es-shims/es5-shim');
      }

- ¶

  Inherit `on`, `off` & `trigger` to Parsley:

      var Parsley = Object.assign(new Base(), {
          element: document,
          $element: $(document),
          actualizeOptions: null,
          _resetOptions: null,
          Factory: Factory,
          version: '@@version'
        });

- ¶

  Supplement Field and Form with Base This way, the constructors will have access to those methods

      Object.assign(Field.prototype, UI.Field, Base.prototype);
      Object.assign(Form.prototype, UI.Form, Base.prototype);

- ¶

  Inherit actualizeOptions and _resetOptions:

      Object.assign(Factory.prototype, Base.prototype);

- ¶

  ### jQuery API

  `$('.elem').parsley(options)` or `$('.elem').psly(options)`

      $.fn.parsley = $.fn.psly = function (options) {
        if (this.length > 1) {
          var instances = [];

          this.each(function () {
            instances.push($(this).parsley(options));
          });

          return instances;
        }

- ¶

  Return undefined if applied to non existing DOM element

        if (this.length == 0) {
          return;
        }

        return new Factory(this[0], options);
      };

- ¶

  ### Field and Form extension

  Ensure the extension is now defined if it wasn’t previously

      if ('undefined' === typeof window.ParsleyExtend)
        window.ParsleyExtend = {};

- ¶

  ### Parsley config

  Inherit from ParsleyDefault, and copy over any existing values

      Parsley.options = Object.assign(Utils.objectCreate(Defaults), window.ParsleyConfig);
      window.ParsleyConfig = Parsley.options; // Old way of accessing global options

- ¶

  ### Globals

      window.Parsley = window.psly = Parsley;
      Parsley.Utils = Utils;
      window.ParsleyUtils = {};
      $.each(Utils, (key, value) => {
        if ('function' === typeof value) {
          window.ParsleyUtils[key] = (...args) => {
            Utils.warnOnce('Accessing `window.ParsleyUtils` is deprecated. Use `window.Parsley.Utils` instead.');
            return Utils[key](...args);
          };
        }
      });

- ¶

  ### Define methods that forward to the registry, and deprecate all access except through window.Parsley

      var registry = window.Parsley._validatorRegistry = new ValidatorRegistry(window.ParsleyConfig.validators, window.ParsleyConfig.i18n);
      window.ParsleyValidator = {};
      $.each('setLocale addCatalog addMessage addMessages getErrorMessage formatMessage addValidator updateValidator removeValidator hasValidator'.split(' '), function (i, method) {
        window.Parsley[method] = (...args) => registry[method](...args);
        window.ParsleyValidator[method] = function () {
          Utils.warnOnce(`Accessing the method '${method}' through Validator is deprecated. Simply call 'window.Parsley.${method}(...)'`);
          return window.Parsley[method](...arguments);
        };
      });

- ¶

  ### UI

  Deprecated global object

      window.Parsley.UI = UI;
      window.ParsleyUI = {
        removeError: function (instance, name, doNotUpdateClass) {
          var updateClass = true !== doNotUpdateClass;
          Utils.warnOnce(`Accessing UI is deprecated. Call 'removeError' on the instance directly. Please comment in issue 1073 as to your need to call this method.`);
          return instance.removeError(name, {updateClass});
        },
        getErrorsMessages: function (instance) {
          Utils.warnOnce(`Accessing UI is deprecated. Call 'getErrorsMessages' on the instance directly.`);
          return instance.getErrorsMessages();
        }
      };
      $.each('addError updateError'.split(' '), function (i, method) {
        window.ParsleyUI[method] = function (instance, name, message, assert, doNotUpdateClass) {
          var updateClass = true !== doNotUpdateClass;
          Utils.warnOnce(`Accessing UI is deprecated. Call '${method}' on the instance directly. Please comment in issue 1073 as to your need to call this method.`);
          return instance[method](name, {message, assert, updateClass});
        };
      });

- ¶

  ### PARSLEY auto-binding

  Prevent it by setting `ParsleyConfig.autoBind` to `false`

      if (false !== window.ParsleyConfig.autoBind) {
        $(function () {

- ¶

  Works only on `data-parsley-validate`.

          if ($('[data-parsley-validate]').length)
            $('[data-parsley-validate]').parsley();
        });
      }

      export default Parsley;