Availability

JavaScript 1.1

Synopsis

<form ... onreset="handler" ... >
form.onreset

Description

The onreset property of a Form object specifies an event handler function that is invoked when the user clicks on a Reset button in the form or when Form.reset( ) is called.

The initial value of this property is a function that contains the semicolon-separated JavaScript statements specified by the onreset attribute of the HTML <form> tag. When an event handler function is defined by an HTML attribute, it is executed in the scope of element rather than the scope of the containing window.

In the Netscape 4 event model, the onreset handler function is passed an Event object as an argument. In the IE event model, no argument is passed, but the applicable Event object is available as the event property of the Window object that contains the element.

If the onreset handler returns false, the elements of the form are not reset.

Example

You could use the following event handler to ask the user to confirm that they really want to reset the form:

<form ...
    onreset="return confirm('Really erase all entered data?')"
> 

See Also

Form.onsubmit, Form.reset( ); Chapter 19; Section , EventListener, and EventTarget in the DOM reference section