samsonphp/validation

SamsonPHP validation module

SamsonPHP validation module

SamsonPHP validation implementation, _(*1)

, _(*2)

Documentation

Follow official documentation., _(*3)

Installation

You can install this package through Composer: composer require SamsonPHP/validation The packages adheres to the SemVer specification, and there will be full backward compatibility between minor versions., _(*4)

Testing

$ vendor/bin/phpunit, _(*5)

Usage example

var formValidation = new FormValidate([
    new FieldValidate({
        el: '#product_name',
        insertTo: '.error-wrapper',
        styleList: '*'
    }).required().length(),
    new FieldValidate({
        el: '#product_description',
        insertTo: '.error-wrapper',
        styleList: '*'
    }).required(),
    new FieldValidate({
        el: '#product_usp',
        insertTo: '.error-wrapper',
        styleList: '*'
    }).required()
]);

s('#send-form-button').click(function () {
    return formValidation.validate();
});

Using FieldValidator

Just create instance of FieldValidator class and pass options to it:, _(*6)

var productFieldValidator = new FieldValidate({
  el: '#product_name',
  insertTo: '.error-wrapper',
  styleList: '*'
}).required().url()

And if you want get result of validation you have to call this method:, _(*7)

productFieldValidator.validate(); //=> true|false

In this example:, _(*8)

• el - [required] Selector to field, can be string or s() element
• insertTo - Selector to field which can dysplay error message, can be string or s() element
• styleList - Prefix whcih will instet to message text(default: '')

But there can be a lot of options:, _(*9)

• trim - Need remove prefix and suffix spaces
• fieldErrorClass - Class which will be added to field, can be string or array.(default: ['class-error-field-', 'class-error-field'])

If there is array then first element of it will be prefix to all false passed validators., _(*10)

For example ['class-error-field-', 'class-error-field'], _(*11)

Will add such classes to field: , _(*12)

• showErrorBlock - Show error block or not. Default if insetTo element passed then block will show. If you want hide error block then pass false to it

• insertToType - Where insert error block(default:MODE_INSERT_TO_PARENT):, _(*13)

  MODE_INSERT_TO_DEFAULT - There no changes with insertTo element, _(*14)

  MODE_INSERT_TO_PARENT - Find elemnet insert to in parent element of this field, _(*15)

• showErrorBlockType - Where output classes(default:MODE_SHOW_ERROR_BLOCK_DEFAULT):, _(*16)

  MODE_SHOW_ERROR_BLOCK_DEFAULT - Change classes in field, _(*17)

  MODE_SHOW_ERROR_BLOCK_PARENT - Change classes in parent block, _(*18)

Crate custom validator

There very easy to create new validator. It can be class validator or alias, _(*19)

For create new validator just create class with export and validate methods export method will return object which will be added to main field object validate method which validate field with custom login, _(*20)

Constructor of class can receive field object, _(*21)

There is simple required validator:, _(*22)

 /**
 * Required validator
 */
var RequiredValidator = (function () {

    /**
     * Init class
     * @param field
     */
    var constructor = function (field) {

        // Required type default values
        this.id = 'required';
        this.defaultRequiredMessage = 'Field have to be filled';
        this.field = field;
    };

    var self = constructor.prototype;

    /**
     * Export data into field
     */
    self.export = function () {
        var validatorInstance = this;

        return {

            /**
             * Required validation
             * @param errorMessage
             * @returns {FieldValidate}
             */
            required: function (errorMessage) {

                validatorInstance.defaultRequiredMessage = errorMessage || validatorInstance.defaultRequiredMessage;
                this.reservedValidators.push(validatorInstance.id);
                return this;
            }
        }
    };

    /**
     * Validate validator
     */
    self.validate = function () {

        if (this.field._getFieldValue() == '') {
            this.field.addError(this.id, this.defaultRequiredMessage);
            this.field.valid = false;
        } else {
            this.field.removeError(this.id);
            this.field.valid = true;
        }
    };

    return constructor;
})();

You need add your validator to register validator array, _(*23)

// Register all used validators
this.registerValidator = [
    new RequiredValidator(this)
];

required method will be added to field instance and can be access as new FieldValidator(...).required() and such validator can be added, _(*24)

And you can use alias validator, _(*25)

There is when you need override some default values form another class validator and save it as new validator., _(*26)

For example lets create url validator which use regExp validator, _(*27)

/**
 * Url regexp validator
 */
var UrlValidator = {

    export: function () {
        return {

            /**
             * Url validation
             * @param errorMessage
             * @returns {FieldValidate}
             */
            url: function (errorMessage) {
                var msg = errorMessage || 'Field should be a url',
                    urlPattern = /^(https?:\/\/)?[\w]*\.[\w\-\&\#\=\/\.?\(\)]*$/;

                this.regExp(urlPattern, msg);
                return this;
            }
        }
    }
};

As you can see there is only one methond in object which return new object which will be used for extending, _(*28)

And you have to add to register array this validator as object without creating, _(*29)

// Register all used validators
this.registerValidator = [
    new RequiredValidator(this),
    new RegExpValidator(this),
    UrlValidator
];

And you can use it as:, _(*30)

new FieldValidator(...).required().url(), _(*31)

But You should not use this validator with regExp, _(*32)

Contributing

Feel free to fork and create pull requests at any time., _(*33)

Security

If you discover any security related issues, please use this repository issue tracker., _(*34)

License

Open Software License ("OSL") v 3.0. Please see License File for more information., _(*35)

SamsonOS, _(*36)