JavaScript: The Definitive Guide

Previous Chapter 21
JavaScript Reference
Next
 

Submit.onclick() Handler

Name

Submit.onclick() Handler---invoked when a Submit button is clicked

Availability

Navigator 2.0, Internet Explorer 3.0; enhanced in Navigator 3.0

Synopsis

<INPUT TYPE="submit" a definition of the handler
       onClick="handler-statements">
submit.onclick    a reference to the handler
submit.onclick(); an explicit invocation of the handler

Description

The Submit.onclick() event handler is defined by the onClick attribute of the HTML <INPUT> tag that defines the Submit button. The value of this attribute may be any number of JavaScript statements, separated by semicolons; these statements will be executed when the user clicks on the Submit button.

The Submit button has the special function of submitting a form to the server. This event handler may add any additional functionality to the Submit button. In Navigator 2.0, there is no way for this onclick() event handler to cancel the submit action or to prevent the form from being submitted; use the Form.onsubmit() event handler to perform input validation and to cancel form submission if necessary.

In Navigator 3.0, the onclick() event handler may return false to prevent the Submit object from submitting the form.

See Also

"Button", "Button.onclick()", "Form", "Form.onsubmit()", "Form.submit()", "Submit"


Previous Home Next
Submit.onblur() Book Index Submit.onfocus()

HTML: The Definitive Guide CGI Programming JavaScript: The Definitive Guide Programming Perl WebMaster in a Nutshell