/* * forms.js * by Andy Tidball * last revised: 05/27/2002 * * This module encapsulates client-side form validation into a simple interface for the developer * This module is designed to work with Internet Explorer 5.0+ and Netscape 6.0+ * * Usage: * First, include this file in the HTML page containing the form by putting the following inside the page's tag: * * * Next, have the form process the validation procedure when it is submitted by modifying the
tag to include the "onsubmit" attribute, as follows: * * Make doubly sure that the word "return" is in there, if it's not the form will validate, but will continue to the next page even if there are errors * * There are two ways to call validate. You must always pass it the form object to validate (by passing "this" as the first argument), but after that you have the option to pass the address of a callback function if you'd like to do some customized validation as well. For Example: * * Using this variation, the validation procedure will first call "myValidateFunction()" and pass it the form object that is being validated. You'll need to write that function ("myValidationFunction(form)" in this example) and have it do any custom validation you require. If your funciton returns true (meaning your validation succeeded), the normal validation procedure will then run as usual. If your function returns false, the validation procedure will stop immediately and the form will not be submitted. * * Lastly, add "rules" to each of the input tags that require validation. You do this by adding a "valid" attribute to the tag, and specifying a list of rules as its value. For Example: * * The two rules specified for the above tag are "exists" and "email", meaning that the user must fill something into this field, and that something must be in the form of an e-mail address. * The order that rules are specified in does not matter. * * That's all there is to it! Valid rules are listed below, any JavaScript developer is welcome to add new rules by simply adding new "else if" statements to the processing portion of the script, I'm sure you can find it. * * List of Rules: * exists: If this rule is specified, an error will be reported if the field is left blank * number: If this rule is specified, an error will be reported if the value entered is not a number * email: If this rule is specified, an error will be reported if the value entered doesn't conform to standard e-mail address notation * phone: If this rule is specified, an error will be reported if the value entered doesn't conform to standard phone number representations * date: If this rule is specified, an error will be reported if the value entered doesn't conform to standard date representations * choose: This rule is for use with