SubmitButton object (Object/DOM)

A button in a form that submits the form to the server.

Availability:

DOM level - 1
JavaScript - 1.0
JScript - 1.0
Internet Explorer - 3.02
Netscape - 2.0
Opera browser - 3.0
Inherits from:Input object
JavaScript syntax:-mySubmitButton = myDocument.aFormName.anElementName
-mySubmitButton = myDocument.aFormName.elements[anItemIndex]
IEmySubmitButton = myDocument.all.anElementID
IEmySubmitButton = myDocument.all.tags("INPUT")[anIndex]
IEmySubmitButton = myDocument.all[aName]
-mySubmitButton = myDocument.forms[aFormIndex].anElementName
-mySubmitButton = myDocument.forms[aFormIndex].elements[anItemIndex]
-mySubmitButton = myDocument.getElementById(anElementID)
-mySubmitButton = myDocument.getElementsByName(aName)[anIndex]
-mySubmitButton = myDocument.getElementsByTagName("INPUT")[anIndex]
HTML syntax:<INPUT TYPE="submit">
Argument list:anIndexA valid reference to an item in the collection
aNameThe name attribute of an element
anElementIDThe ID attribute of an element
anItemIndexA valid reference to an item in the collection
aFormIndexA reference to a particular form in the forms collection
Object properties:type, value
Object methods:handleEvent()
Event handlers:onAfterUpdate, onBeforeUpdate, onBlur, onClick, onDblClick, onFilterChange, onFocus, onHelp, onKeyDown, onKeyPress, onKeyUp, onMouseDown, onMouseMove, onMouseOut, onMouseOver, onMouseUp, onRowEnter, onRowExit

Many properties, methods and event handlers are inherited from the Input object class. Refer to topics grouped with the "Input" prefix for details of common functionality across all subclasses of the Input object superclass.

There isn't really a SubmitButton object class, but it is helpful when trying to understand the wide variety of input element types if we can reduce the complexity by discussing only the properties and methods of a submit button. In actual fact, the object is represented as an item of the Input object class.

Event handling support via properties containing function objects was added to SubmitButton objects at version 1.1 of JavaScript.

Unlike MSIE, Netscape Navigator does not support the select() method or defaultValue property for this subclass of the Input object.

Example code:

   <HTML>
   <HEAD>
   </HEAD>
   <BODY>
   <FORM>
   <SELECT ID="IN1">
   <OPTION VALUE="-1">Please select an item
   <OPTION VALUE="0">Sunday
   <OPTION VALUE="1">Monday
   <OPTION VALUE="2">Tuesday
   <OPTION VALUE="3">Wednesday
   <OPTION VALUE="4">Thursday
   <OPTION VALUE="5">Friday
   <OPTION VALUE="6">Saturday
   </SELECT>
   <INPUT ID="SUBMIT" TYPE="Submit" VALUE="CLICK ME" onClick="clickMe()">
   </FORM>
   <SCRIPT>
   //MSIE only
   function clickMe()
   {
      selectedValue  = document.all.IN1.value;
   
      if(selectedValue == -1)
      {
         alert("You must select an item first!");
      }
      else
      {
         document.all.SUBMIT.click()
      }
   }
   </SCRIPT>
   </BODY>
   </HTML>

See also:Element object, Form.elements[], FormElement object, Input object, Input.accessKey, onClick, SubmitButton.handleEvent()

PropertyJavaScriptJScriptNIEOperaNESECMADOMCSSHTMLNotes
type1.1 1.13.0 3.03.0 3.04.0 4.03.0 3.0 n/a n/a1 1 n/a n/aReadOnly.
value1.0 1.01.0 1.02.0 2.03.02 3.023.0 3.0 n/a n/a1 1 n/a n/aWarning

MethodJavaScriptJScriptNIEOperaNESECMADOMCSSHTMLNotes
handleEvent()1.2 1.2 n/a4.0 4.0 n/a n/a n/a n/a n/a n/a n/a-

Event nameJavaScriptJScriptNIEOperaNESECMADOMCSSHTMLNotes
onAfterUpdate n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/a-
onBeforeUpdate n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/a-
onBlur1.1 1.13.0 3.03.0 3.04.0 4.03.0 3.0 n/a n/a n/a n/a n/aWarning
onClick1.0 1.01.0 1.02.0 2.03.0 3.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onDblClick1.2 1.23.0 3.04.0 4.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onFilterChange n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/a-
onFocus1.0 1.03.0 3.02.0 2.04.0 4.03.0 3.0 n/a n/a n/a n/a n/aWarning
onHelp n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/aWarning
onKeyDown1.2 1.23.0 3.04.0 4.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onKeyPress1.2 1.23.0 3.04.0 4.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onKeyUp1.2 1.23.0 3.04.0 4.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onMouseDown1.2 1.23.0 3.04.0 4.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onMouseMove1.2 1.23.0 3.04.0 4.04.0 4.0 n/a n/a n/a n/a n/a4.0 4.0Warning
onMouseOut1.1 1.13.0 3.03.0 3.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onMouseOver1.0 1.01.0 1.02.0 2.03.0 3.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onMouseUp1.2 1.23.0 3.04.0 4.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onRowEnter n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/a-
onRowExit n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/a-

Inheritance chain:

Element object, Input object, Node object