| Event handler for | Form | 
| Implemented in | Navigator 2.0 | 
 
 Syntax
onSubmit="handlerText"
 Parameters
|  | JavaScript code or a call to a JavaScript function. | 
 Security
Navigator 4.0: Submitting a form to a mailto: or news: URL requires the UniversalSendMail privilege. For information on security in Navigator 4.0, see Chapter 7, "JavaScript Security," in the JavaScript Guide. 
 
 Description
You can use onSubmit to prevent a form from being submitted; to do so, put a return statement that returns false in the event handler. Any other returned value lets the form submit. If you omit the return statement, the form is submitted.
 Event properties used
| type | Indicates the type of event. | 
| target | Indicates the object to which the event was originally sent. | 
 Examples
In the following example, onSubmit calls the validate function to evaluate the data being submitted. If the data is valid, the form is submitted; otherwise, the form is not submitted.
<FORM onSubmit="return validate(this)">
See also the examples for 
...
</FORM>Form.
For general information on event handlers, see "General Information about Events".
For information about the event object, see event.
Last Updated: 10/31/97 16:34:02