ve-form-validation

VE-Form-Validate

form-validate is a library that allows you to validate inputs and return streams of data that detect the validation.

INSTALATION

npm i ve-form-validate

API

Schema

With Validate Object user can handle all stuff validation

Validator	Description
BooleanValidator	Validate.boolean
NumberValidator	Validate.number
	validate number with minLength & maxLength
	Example: Validate.number.minLength(3)
ObjectValidator	Validate.object
	object validator has keys function
	that wrap all validation
StringValidator	Validate.string
	validate string with min & max
	validate any type of string with type method
	color - email - date - text - url - image
	for special pattern you can use pattern method
	Example: Validate.string.type('email')
	Example: Validate.string.pattern(/^([^.]+)/)
ArrayValidator	validate input array with contains method
	Example: Validate.array.contains(Validate.number.minLength(5))

Special Methods

required() is a shared method for all validators

Events

after you handle schema, you can access these events to handle more stuff when user input or on submit event

Event	Description
onValues	got a stream of form values
onMessages	this event will emit success - error messages depend on the validation
onSubmit	will send object that contains isValidating - isSubmiting - errors if found - Form Values

Access Events

const formEvents = FormValidate("validate_form_api", Validation);

formEvents.onSubmit(function(submit) {
  console.log(submit, 'onSubmit');
});
formEvents.onValues(function(values) {
  console.log(values, 'onValues');
});
formEvents.onMessages(function(messages) {
  console.log(messages, 'onMessages');
});

USAGE

you will send validation object to FormValidate Method with form className

import { FormValidate, Validate } from 've-form-validate';
const Validation = {
  schema: Validate.object.keys({
    email: Validate.string.type('email'),
    phone: Validate.number.required()
  }),
  messages: {
    email: {
      success: 'email is valid',
      error: 'email not valid'
    },
    phone: {
      error: 'phone number not correct',
      success: 'phone is correct'
    }
  }
};
const formEvents = FormValidate('validate_form_api', Validation);

EXAMPLES

Simple Filed

 
<input name="phone" placeholder="phone" />
<input name="email" placeholder="email" />
 
 Validate.object.keys({
     email: Validate.string.type("email"),
     phone: Validate.number.required()
});

Object Field

<fieldset name="person">
  <input type="text" name="firstName" value="ayman" />
  <input type="text" name="lastName" value="shafik" />
  <input type="text" name="age" />
</fieldset>;
 
Validate.object.keys({
  person: Validate.object.keys({
    firstName: Validate.string,
    lastName: Validate.string,
    age: Validate.number
  })
});

Validate array of boolean/number/string fields

<select name="cars" multiple>
  <option value="volvo">Volvo</option>
  <option value="saab">Saab</option>
  <option value="opel">Opel</option>
  <option value="audi">Audi</option>
</select>;
 
Validate.object.keys({
  cars: Validate.array.contains(Validate.string)
});

TODO

• Localization
• Validate arr of objects

LICENCE

MIT