This package has been deprecated

Author message:

Package no longer supported. Contact Support at https://www.npmjs.com/support for more info.

bb-validation

Backbone.Validator

This plugin is for helping the validation of Backbone models in Backbone applications.

Features

• Support of client side (browser) and server side (node.js) applications.
• Validation of model with synchronous and asynchronous tests.
• Definition of custom Test classes.
• Form generation - this part is alpha version yet.
• Custom error messages which can be multi language if you use an i18n plugin.

Documentation

I promise, I will create separated repo for each of these packages and detailed documentation when days will be 48h long... :S

• Backbone.Validator - stable, code coverage about 90% - validator, parallel and series runners, abstract test - I will create multiple validator classes probably later, this one is for real time input validation, not the best choice for bash validation
• Backbone.Validator Test classes - stable, 100% code coverage - basic tests: required, type, min, max, range, identical, equal, member, match, duplicate
• jasmine.stub - beta version yet - it is for easier testing - no self tests yet, it works only with jasmine-node, never tried out with jasmine in browser
• Backbone.UI.Form - alpha version yet, it's a bit dummy, I created it for the example - it generates a form with error messages and auto disabling submit button - I develop it right now

Custom Test example:

Backbone.Validator.plugin({
    use: {
        registered: {
            exports: Backbone.Validator.Test.extend({
                registered: {
                    "[e-mail]": true,
                    "[e-mail]": true
                },
                initialize: function (schema) {
                    this.delay = schema || 1;
                },
                evaluate: function (done, asyncParams) {
                    setTimeout(function () {
                        done({error: this.registered[asyncParams.value]});
                    }.bind(this), this.delay);
                }
            }),
            deps: ["max", "match"]
        }
    }
});

Model validation example code (runs in nodejs or browser):

var validator = new Backbone.Validator({
    model: model,
    schema: {
        email: {
            required: true,
            type: String,
            match: "email",
            max: 127,
            registered: 1
        },
        password: {
            required: true,
            type: String,
            range: {
                min: 5,
                max: 14
            }
        },
        password2: {
            duplicate: "password"
        }
    }
});
validator.on("change", function () {
    console.log("pending", validator.pending, "errors", validator.errors, validator.attributes);
});
validator.test.on("end", function () {
    console.log("all running test ended");
});
validator.run();
//now tests are running for every attribute
model.set({
    email: "[e-mail]"
});
//now tests are running for email attribute again

Form generation example code (runs in browser):

new Backbone.UI.Form({
	model: new Backbone.Model(attributes),
	fields: {
		email: {
			type: Backbone.UI.TextField,
			label: "Email",
			schema: {
				required: true,
				type: String,
				match: "email",
				max: 127,
				registered: 1000
			},
			messages: {
				required: "The email address is not given.",
				type: "Email address must be string.",
				match: "Not an email address.",
				max: "The given email address is too long.",
				registered: "The email address is already registered."
			}
		},
		password: {
			type: Backbone.UI.TextField,
			options: {
				type: "password"
			},
			label: "Password",
			schema: {
				required: true,
				type: String,
				range: {
					min: 5,
					max: 14
				}
			},
			messages: {
				required: "The password is not given.",
				type: "The password must be string.",
				range: {
					min: "The password is too short.",
					max: "The password is too long."
				}
			}
		},
		password2: {
			type: Backbone.UI.TextField,
			options: {
				type: "password"
			},
			label: "Confirm Password",
			schema: {
				duplicate: "password"
			},
			messages: {
				duplicate: "The verifier password does not equal to the password."
			}
		}
	},
    buttons: {
        submit: {
            type: Backbone.UI.Button,
            label: "Register",
            messages: {
                500: "User already saved.",
                400: "Cannot register user with gmail account.",
                201: "User registered"
            }
        }
    }
});

• The Backbone.Validator is a Backbone.Model extension. It uses the schema part of the Backbone.UI.Form config to validate the model, and stores the results in its attributes: false means no error, undefined means pending, true means error, {subType: true} means error with subtype.
• The Backbone.UI.Messenger is a Backbone.View extension. It displays error messages, and uses the Backbone.Validator and the messages part of the Backbone.UI.Form config for that.
• The Backbone.UI.Form creates a Backbone.Validator instance, and multiple Backbone.UI fields, buttons and messengers, so it generates a complete form. Now you have to set the field and button classes manually, but later I'll create auto detection for that.

Requirements

This plugin works only with the libraries contained by the following list.

• underscore.js
• backbone.js

Usage in node.js

If you intend to use this plugin in node.js you'll need amdefine.

• amdefine

The node.js tests are working with jasmine.

• jasmine-node

Usage in browser

If you intend to use this plugin in browser you'll need require.js.

• require.js

The browser examples are working with several libraries. To ease the try out of the examples I attached this libraries in the example/lib directory.

• jQuery
• require.js - domReady
• require.js - tpl
• laconic, moment.js, backbone.UI, etc...