OBJECT:  Submit


A Submit object (a 'Submit' button) is created with every instance of an HTML <INPUT> tag (with a 'type' value set as 'SUBMIT') on a form. These objects are then stored in the elements array of the parent form and accessed using either the name defined within the HTML tag or an integer (with '0' being the first element defined, in source order, in the specified form).

PROPERTIES

form Property
This property returns a reference to the Submit object's parent form.

Syntax: object.form

name Property
This property sets or returns the value of the Submit object's name attribute.

Syntax: object.name

type Property
Every element on a form has an associated type property. In the case of a Submit object, the value of this property is always "submit".

Syntax: object.type

value Property
This property sets or returns the Submit object's value attribute. This is the text that is actually displayed on the button face. If this is not defined within the HTML tag the string 'Submit Query' is used by default.

Syntax: object.value


METHODS

blur Method
This method removes the focus from the specified submit button.

Syntax: object.blur( )

click Method
This method simulates a mouse-click on the submit button.

Syntax: object.click( )

focus Method
This method gives focus to the specified submit button.

Syntax: object.focus( )

handleEvent Method
This method calls the handler for the specified event.

Syntax: object.handleEvent(event)


EVENT HANDLERS

onBlur Event handler
This event handler executes some specified JavaScript code on the occurrence of a blur event (when the Submit object loses focus).

Syntax: object.onBlur="myJavaScriptCode"

onClick Event handler
This event handler executes some specified JavaScript code on the occurrence of a click event (when the submit button is clicked).

Syntax: object.onClick="myJavaScriptCode"

onFocus Event handler
This event handler executes some specified JavaScript code on the occurrence of a focus event (when the submit button receives focus).

Syntax: object.onFocus="myJavaScriptCode"


Copyright 1999-2001 by Infinite Software Solutions, Inc. All rights reserved.
Trademark Information