Input Type=Image
 
End Tag: Omitted
Support Key: 2 | 3 | 3.2 | 4 | IE1 | M2B1 | N1 | O2.1
What is it?
Attributes
Tag Example
Parent/Content Model
Tips & Tricks
Browser Peculiarities
= Index DOT Html by Brian Wilson [bloo@blooberry.com] =
Main Index | Element Tree | Element Index | HTML Support History


What is it?
IMAGE is a TYPE attribute value to the INPUT element for FORMs. It specifies an image that can be clicked upon to pass information to the processing script. In implementation, this form TYPE acts much like the INPUT TYPE=SUBMIT field, but unlike the SUBMIT field, the coordinates of the image that were activated are sent back to the server in addition to the rest of the form data.

Common Attributes
%Core%
2 | 3 | 3.2 | 4 | IE4B1 | M | N | O
%Events%
2 | 3 | 3.2 | 4 | IE4B1 | M | N | O
%Language%
2 | 3 | 3.2 | 4 | IE4 | M | N | O
%Data%
2 | 3 | 3.2 | 4 | IE4?? | M | N | O

Specific Attributes
Accesskey
2 | 3 | 3.2 | 4 | IE4B1 | M | N | O
Required? No
Description:
This is a method of giving access/focus to an active HTML element using a keyboard character. This is a common GUI paradigm also known as a "keyboard shortcut" or "keyboard accelerator" A single character is used as the value of this attribute. In addition, a platform-dependent key is usually used in combination with the ACCESSKEY character to access the functionality of the active field.
Values:
A single, case-insensitive alphanumeric character from a browser's character set.
Align
2 | 3 | 3.2 | 4 | IE1 | M2B1 | N1 | O
Required? No
Description:
This attribute specifies the alignment of text following the IMG reference relative to the graphic on screen. 'Left' and 'Right' specify floating horizontal alignment of the image in the browser window, and subsequent text will wrap around the image. The other options specify vertical alignment of text relative to the image on the same line.
Values:
    Left | Right | Top [DEFAULT] | Texttop | Middle | Absmiddle | Baseline | Bottom | Absbottom
Alt
2 | 3 | 3.2 | 4 | IE4B2 | M | N | O
Required? No
Description:
This is text to be displayed in place of an image for browsers that can not handle this ability or for browsers that have disabled this ability.
Values: Alphanumeric characters
Disabled
2 | 3 | 3.2 | 4 | IE4B2 | M | N | O
Required? No
Description:
This is a stand-alone attribute which indicates the element is initially non-functional.
Values: NA
Height
2 | 3 | 3.2 | 4 | IE4B1 | M | N1.1 | O
Required? No
Description:
This attribute explicitly specifies the height of the graphic in pixels. It is mainly used to create custom image dimensions without physically changing the image itself. It can also be used to speed up display of the document being downloaded so it can pre-render the document with image placeholders while the images download.
Values: Positive integer pixel values.
Name
2 | 3 | 3.2 | 4 | IE1 | M2B1 | N1 | O2.1
Required? Yes
Description:
This is a required attribute that associates a symbolic name to the field for submittal to the form processing script.
Values: Alphanumeric characters.
Src
2 | 3 | 3.2 | 4 | IE1 | M2B1 | N1 | O2.1
Required? No
Description:
Indicates the URL to reference the graphic.
Values: Absolute or relative URLs.
Tabindex
2 | 3 | 3.2 | 4 | IE4B1 | M | N | O
Required? No
Description:
"Tabbing" is a method of giving access/focus to an active HTML element using a standard keyboard sequence. All the active elements in a document can be cycled through using this sequence (ex: Windows TAB key.) The order of the active elements in this cycle is usually the order they occur in the document, but the TABINDEX attribute allows a different order to be established. The use of this attribute should create the following tabbing order cycle if the browser supports the attribute:
  1. Active elements using the TABINDEX attribute with positive integers are navigated first. Low values are navigated first.
  2. Active elements not specifying any TABINDEX attribute
Those elements carrying a DISABLED attribute or using negative TABINDEX values do not participate in the tabbing cycle.
Values: Positive or negative integers.
Type
2 | 3 | 3.2 | 4 | IE1 | M2B1 | N1 | O2.1
Required? Yes*
Description:
* This is the required TYPE attribute for this INPUT mechanism. From the strict view, the TYPE attribute is not required.
Values: IMAGE
Usemap
2 | 3 | 3.2 | 4 | IE | M | N2 | O
Required? No
Description:
This attribute specifies the URL (usually internal to the document) of the client-side image map specification to be used if the browser has that capability. If the argument to USEMAP begins with a "#" it is assumed to be in the same document as the INPUT TYPE=IMAGE element.
Values: An absolute or relative URL or an internal anchor name.
Value
2 | 3 | 3.2 | 4 | IE1 | M2B1 | N1 | O2.1
Required? No
Description:
This represents the symbolic result of the field when activated that is passed to the form processing script.
Values: Alphanumeric characters.
Width
2 | 3 | 3.2 | 4 | IE4B1 | M | N1.1 | O
Required? No
Description:
This attribute explicitly specifies the width of the graphic in pixels. It is mainly used to create custom image dimensions without having to physically change the image itself. It can also be used to speed up display of the document being downloaded so it can pre-render the document with image placeholders while the images download.
Values: Positive integer pixel values.
Example
<form>
   <input TYPE="image" SRC="http://www.foo.com/submitimage.gif" NAME="imagesubmit1" ALIGN="top" HEIGHT=50 WIDTH=50>
</form>
Parent Model
%In-line Parent% | %Block Parent%
Content Model
This element does not accept any content.
Tips & Tricks Browser Peculiarities
Boring Copyright Stuff...