• Download source files - 7.5 KB

Introduction

Using client side JavaScript is an efficient way to validate the user input in web applications. When there are many fields in the form, the JavaScript validation becomes too complex.

A JavaScript function is presented here, which makes form validation easier.

The idea is to create a set of "validation descriptors" associated with each element in a form. The "validation descriptor" is nothing but a string specifying the type of validation to be performed.

Each field in the form can have 0, 1, or more validations. For example, the input should not be empty, should be less than 25 chars, should be alpha-numeric, etc.

Therefore, each field in the form may be having an array of validations associated. The validation function takes such an array of arrays, each representing the validation to be performed on each of the input items in the form.

Let us see how this function can be used to ease form validation.

The function syntax is like this:

• validateForm(formObject,arrValidationDesc)
• formObject is the form which should be validated
• arrValidationDesc is the array containing the validation descriptors for each input item

A Simple Example

Let us take a login form as an example. Here, the login name and password are the input fields. The login name is a required field. The maximum length of login name is 25. The password should contain 5 characters minimum and 25 characters maximum.

The code goes like this:

<SCRIPT language="JavaScript1.2" src="gen_validation.js"></SCRIPT>
<SCRIPT language="JavaScript1.2">
// The array of validation definitions
arrValidationDesc=
                [  
                  [   // Validations for the login name field
                      ["required"], // Validation 1 : It is a required field
                      ["maxlen=25"]  // Validation 2: Max number of characters 25
                  ],
                  [ // validations for the password field
                      ["minlen=5"],  // validation 1 : 5 chars minimum
                      ["maxlen=25"]  // validation 2 : 25 chars maximum
                  ]
                ];
</SCRIPT>

Now, the form:

<FORM onsubmit="return validateForm(this,arrValidationDesc);">
LoginName: <input type="text" name="LoginName"> <BR>
Password : <input type="password" name="password"> <BR>
<input type="submit" value="Submit">
</FORM>

and that’s it!

Notice that gen_validation.js is the file which contains the source code for the form validation function validateForm(). The formwiz1.zip file contains this file.

When the user presses the submit button, the onsubmit event will be triggered, which will call the validation function, passing the form object and the validation descriptions. If the user enters invalid data, or if the required fields are empty, an error message will be displayed and the validation function will return false. This will prevent the form from being submitted.

But, the Error message may not be descriptive enough as you like it to be. If the user didn't enter the login name, for example, the error message displayed will be:

"LoginName: Required field."

That too, if the name of the input text element is given as "LoginName".

It is possible to give your own error messages. The example below shows the code modified to contain the custom error messages:

<SCRIPT language="JavaScript1.2">
// The array of validation definitions
arrValidationDesc=
            [
                  [   // Validations for the login name field
                      ["required",
                 "Did you forget to enter your login name, my dear friend?"],
                      ["maxlen=25", "Too long login name ??"]  
                  ],
                  [   // validations for the password field
                      ["minlen=5"," Password should contain 5 chars minimum"],
                      ["maxlen=25"]
                  ]
            ];
</SCRIPT>

The rest is the same.

The General Format of Validation Descriptors

In general, the format of the validation description is:

arrayname=
      [
          [   // Validations for input item 1
              [ <validation_descriptor>, <error_string>]
              [ <validation_descriptor>, <error_string>]
                  ......
                  ......
          ],

          [   // Validations for input item 2
              [ <validation_descriptor>, <error_string>]
              [ <validation_descriptor>, <error_string>]
                  ......
                  ......
          ]
          .................
          .................
      ];

As you saw, the <error_string> is optional.

It is important to keep in mind that the order of the input items in the array and the order in the form should be the same.

Fields Without Any Validations

What if a particular field doesn't have any validations? Just add a null record like this:

<SCRIPT language="JavaScript1.2">
// The array of validation definitions

arrValidationDesc=
                [  
                  [   // Validations for the first field
                      ["required"],
                      ["maxlen=25"]  
                  ],
                  [ ],// the second field doesn't have any validations
                  [   // validations for the third field
                      ["minlen=5"],
                      ["maxlen=25"]
                  ]
                ];
</SCRIPT>

Handling Complex Validations

The validation descriptor records should be in the order of the corresponding fields in the form.

It may be difficult to keep track of the order in large forms. So, here is an easier way. Declare the array before the form tag. Add the descriptors for each input field just under the input field. Like this:

<SCRIPT language="JavaScript1.2">
arrValidationDesc= new Array();
idx = 0;
</SCRIPT>
<form onSubmit="return validateForm(this,arrValidationDesc);">
LoginName: <input type="text" name="LoginName">
<SCRIPT language="JavaScript1.2">
// validation description for Login Name
arrValidationDesc[idx++] =
              [
                 ["required","Please enter Login Name"],
                 ["maxlen=25","Login Name too long! "]  
              ];
</SCRIPT>
Password : <input type="password" name="password">
<SCRIPT language="JavaScript1.2">
// validation description for password
arrValidationDesc[idx++] =
              [
                  ["minlen=5"],  
                  ["maxlen=25"]  
              ];
</SCRIPT>
<input type="submit" value="Submit">
</FORM>

Table: The Validation Descriptors

License

This article has no explicit license attached to it, but may contain usage terms in the article text or the download files themselves. If in doubt, please contact the author via the discussion board below. A list of licenses authors might use can be found here.