Summary: Random, standalone functions for form analysis.

Function	Summary
gtMCSelCountOTF	How many choices are currently selected in the provided select-multiple or checkbox elements? This function is intended for "on-the-fly" analysis, before the form is actually submitted.

util_form.js: Overview

Random, standalone functions for form analysis.

TOP     util_form.gtMCSelCountOTF()

How many choices are currently selected in the provided select-multiple or checkbox elements? This function is intended for "on-the-fly" analysis, before the form is actually submitted.

This is a generically-useful debugging function, and is entirely unrelated to the other functions in validate_form.js

PARAMETERS

• cb_orSMElement: The multiple choice form element. Required, and must be of type "checkbox" or "select-multiple".

RETURNS

A number, representing the number of choices selected/checked currently. Zero if nothing is selected/checked.

NOTE

• Call this function via your form's checkboxes' and select-multiple's "onChange" event. Such as:

     <SELECT name="count" onChange="return gtMCSelCountOTF(this.form);">
         <OPTION value="0">0</OPTION>
         <OPTION value="1">1</OPTION>
   </SELECT>

• This function does no validation regarding the number of choices that are *allowed* to be selected (see documentation/concepts/sMsgMCRange.html). It just tells you how many are currently selected.
• See documentation/vf_errors.html#gtMCSelCountOTF for error examples.

SIGNATURE

gtMCSelCountOTF(cb_orSMElement)