/************************************************************************
* FILE: forms.js *
* AUTHOR: Richard Shadman *
*************************************************************************
* USAGE: *
*************************************************************************
USING THE DATA TYPE VALIDATION:
1. Create a script include tag within the tag of the
document, like this:
2. Within the initialization of the page include a call to the function
setFormValidation(). You do not need to pass any parameters; this
function will look at every object in the page and set up validation
according to the format below.
3. Add appropriate attributes to input boxes and text areas as needed.
The attributes needed to be set are as follows:
ATTRIBUTE NAME DESCRIPTION VALUES REQUIRED
************************************************************************
dt Data Type First form of validation. 1 (text) YES
although listed as required 2 (numeric)
it must be ommitted in the 3 (date)
element TEXTAREA. text
numeric
date
maxlength Max Length Already handled by INPUT length in NO
elements, it is only added characters
here because of added
support for TEXTAREA.
regexp Regular Any regular expression can Any valid NO
Expression be put here, and if the regular
field passes the data type expression.
requirement, it will be
tested against this
expression. See below for
examples.
format Format An example of the required N/A NO
format in the regular
expression. if ommitted,
the regular epxression
source will be used in the
error message.
************************************************************************
USING REQUIRED FIELD VALIDATION:
1. If you have not allready, create a script include tag within the
tag of the document, like this:
2. Call one of the 2 following functions to check required fields.
FUNCTION DESCRIPTION
************************************************************************
checkRequired() Returns a string of messages for fields that are
required but not inputted. Returns an empty string
if all required fields are accounted for.
bCheckRequired() Calls checkRequired(), and alerts the messages, if
any. The function returns true if all fields are
accounted for, false if not.
************************************************************************
If your page requires unique form validation beyond the scope of this
file, chances are you will use checkRequired() within another function.
If this file can handle all your form validation, you can use
bCheckRequired() directly on the onsubmit event, as follows: