INPUT

The INPUT tag is an HTML tag used to define a form element, such as a pushbutton or a text input field. In ION_SCRIPT, the INPUT tag is used inside the ION_FORM tag to define form elements for the ION form. All INPUT types can be used in ION Script applications. For a few types, however, ION Script has custom tags with more functionality than their corresponding INPUT type:

Use the ION_BUTTON tag instead of <INPUT TYPE="BUTTON">. Buttons created with ION_BUTTON execute an ION Script EVENT when clicked.

Use the ION_RADIO tag instead of <INPUT TYPE="RADIO">. The ION_RADIO tag allows you to maintain the selection state of a radio button group when the page is reloaded.

Use the ION_CHECKBOX tag instead of <INPUT TYPE="CHECKBOX">. The ION_CHECKBOX tag allows you to maintain the selection state of a checkbox when the page is reloaded.

Note
Not all attributes of the INPUT tag are documented here. Only the most commonly-used attributes are listed. Refer to an HTML reference, such as the one at http://www.htmlhelp.com, for a complete list of all INPUT tag attributes.

Syntax

TYPE= {"BUTTON" |
  "CHECKBOX" [CHECKED] |
  "FILE" |
  "HIDDEN" |
  "IMAGE" [ALT="text"] [SRC="url"] [ALIGN={top | middle | bottom | left | right}]|
  "PASSWORD" [MAXLENGTH="characters"] [SIZE="characters"] |
  "RADIO" [CHECKED] |
  "RESET" |
  "SUBMIT" |
  "TEXT" [MAXLENGTH="characters"] [SIZE="characters"] }

[ONBLUR=script] [ONCHANGE=script] [ONFOCUS=script] [TABINDEX="position"] [VALUE="value"] >

Attributes

ALIGN

For IMAGE fields, ALIGN specifies either the position of the image in relation to the left and right borders of the browser, or the alignment of text in relation to the image:

LEFT - The image is aligned with the left border of the browser.

RIGHT - The image is aligned with the right border of the browser.

TOP - Text to the left and right of the image is aligned with the top edge of the image.

BOTTOM - Text to the left and right of the image is aligned with the bottom edge of the image.

MIDDLE - Text to the left and right of the image is aligned with the vertical midpoint of the image.

ALT

For IMAGE fields, ALT specifies the text to be displayed in browsers that do not support images, or in browsers that have been set to not display in-line images.

CHECKED

Specifies whether a checkbox or radio button is checked or unchecked. This attribute is not set to a value—it is either included or not included. If included, the button state is checked.

MAXLENGTH

The maximum number of characters that can be entered in a TEXT or PASSWORD form field.

NAME

The name of the form field. This name is used to refer to the value of the form field using the format $Form.NAME. The NAME you specify for form fields cannot begin with ION_ _.

ONBLUR

The script to execute when the form field loses focus. Focus is lost when the user clicks the mouse outside of the form field, or presses the Tab key.

ONCHANGE

The script to execute when the value in the form field changes. This event occurs when the form field loses focus, but only if the value has changed since the last time the field had focus.

ONFOCUS

The script to execute when the form field receives focus. Focus is obtained when the user clicks in or tabs into the form field.

SIZE

SRC

TYPE

The type of form field. Valid values include BUTTON, CHECKBOX, FILE, HIDDEN, IMAGE, PASSWORD, RADIO, RESET, SUBMIT, and TEXT.

TABINDEX

The position of the form field in the Tabbing order. The Tabbing order is the order in which fields receive focus when the Tab key is pressed.

VALUE

The value assigned to the form field, which can be accessed using $Form.NAME. If this value is numeric, and you want to use it in an expression, you must declare a new INT or DOUBLE variable, assign it the value $Form.NAME, and use the new variable in the expression instead of $Form.NAME. See Using $Form Variables in Numeric Expressions.

For TEXT fields, VALUE specifies the text that initially appears in the field.

For BUTTON fields, VALUE specifies the button label.

For SUBMIT and RESET buttons, VALUE specifies the button label. If VALUE is not specified, "Submit Query" and "Reset" are the default button labels.

For CHECKBOX and RADIO buttons, VALUE does not specify whether the button is checked or unchecked (this is specified with the CHECKED attribute). Instead, VALUE simply assigns a value to the checkbox or radio button.

For HIDDEN fields, VALUE specifies the value that is passed to the server upon form submission.