1.0.0 • Published 6 years ago

verifiable v1.0.0

Weekly downloads
3
License
ISC
Repository
github
Last release
6 years ago

#Shape Validation http://twitter.com/madebyshape

##Description

Very easy to use & simple form validation plugin built on jQuery. With Email, Password & Field Type validation included. It can also validate multiple forms on one page.

##Usage

Note: This requires jQuery 1.10.x to work correctly. This is not included in the repo but can be downloaded from http://jquery.com or from a Google CDN - https://developers.google.com/speed/libraries/#jquery

###Installing

<form class="shape-validate">
	<label>Full Name *</label>
	<input type="text" name="full_name" class="validate-required">
</form>

<script>
	$(document).ready(function(){
		$('.form-validate').shapeValidate();
	});
</script>

(See "demo.html" if you need to see a live example)

##Options

####Example

	<script>
		$(document).ready(function(){
			$('.form-validate').shapeValidate({
				debug: true,
				selectors: {
					required: 'this-is-required'
				},
				alerts: {
					required: 'You missed this one out!',
					email: 'Uh oh, invalid email address!'
				}
			});
		});
	</script>

General

<script>
	$(document).ready(function(){
		$('.form-validate')
			.shapeValidate(
				{
					selectors: {
						required: 'required'
					}
				}
			);
	});
</script>

Selectors

Mainly because I hate it when jQuery plugins don't let you customise the classes that get added to elements dynamically.

<script>
	$(document).ready(function(){
		$('.form-validate')
			.shapeValidate(
				{
					selectors: {
						required: 'required'
					}
				}
			);
	});
</script>

Alerts

These are all the visible messages that appear throughout the validation process

<script>
	$(document).ready(function(){
		$('.form-validate')
			.shapeValidate(
				{
					alerts: {
						required: 'This is required'
					}
				}
			);
	});
</script>

Gateways

Some gateways require specific validation settings. If your using any gateways below, you may want to enable these settings

Example:

<script>
	$(document).ready(function(){
		$('.form-validate')
			.shapeValidate(
				{
					gateways: {
						stripe: true
					}
				}
			);
	});
</script>

##Advanced Usage

###Password Fields Soon

###Checkbox & Radio Fields Soon

###Subbmiting The Form Soon

##Roadmap

  • Option to turn summary messages off
  • Option to set password minimum length