input type=image – image-coordinates input control

ⓘ input type=image – image-coordinates input control # T

The input element with a type attribute whose value is "image" represents either an image from which the UA enables a user to interactively select a pair of coordinates and submit the form, or alternatively a button from which the user can submit the form.

Permitted contents #

empty (void element)

Permitted attributes #

global attributes & name & disabled & form & type★ & alt★ & src & formaction & autofocus & formenctype & formmethod & formtarget & formnovalidate & height & width

ⓘ global attributes

Any attributes permitted globally.

ⓘ name = string #

The name part of the name/value pair associated with this element for the purposes of form submission.

ⓘ disabled = "disabled" or "" (empty string) or empty #

Specifies that the element represents a disabled control.

ⓘ form = ID reference NEW #

The value of the id attribute on the form with which to associate the element.

type = "image" #

Specifies that its input element represents either an image from which the UA enables a user to interactively select a pair of coordinates and submit the form, or alternatively a button from which the user can submit the form.

ⓘ alt = non-empty string #

Provides a textual label for an alternative button for users and UAs who cannot use the image specified by the src attribute.

Any string that is not empty.

ⓘ src = non-empty URL potentially surrounded by spaces #

Specifies the location of an image.

ⓘ formaction = non-empty URL potentially surrounded by spaces NEW #

The form-submission action for the element.

ⓘ autofocus = "autofocus" or "" (empty string) or empty NEW #

Specifies that the element represents a control to which a UA is meant to give focus as soon as the document is loaded.

ⓘ formenctype = "application/x-www-form-urlencoded" or "multipart/form-data" or "text/plain" NEW #

A MIME type with which a UA is meant to associate this element for form submission.

ⓘ formmethod = "get" or "post" NEW #

The HTTP method with which a UA is meant to associate this element for form submission.

ⓘ formtarget = browsing-context name or keyword NEW #

A browsing context name or keyword that represents the target of the control.

Any string that is either of the following:

a browsing-context name
any case-insensitive match for one of the following literal strings: "_blank", "_self", "_parent", or "_top".

ⓘ formnovalidate = "formnovalidate" or "" (empty string) or empty NEW #

Specifies that the element represents a control whose value is not meant to be validated during form submission.

ⓘ height = non-negative integer #

The height of the image, in CSS pixels.

ⓘ width = non-negative integer #

The width of the image, in CSS pixels.

Additional constraints and admonitions #

The interactive element input must not appear as a descendant of the a element.
The interactive element input must not appear as a descendant of the button element.
Any input element descendant of a label element with a for attribute must have an ID value that matches that for attribute.
The list attribute of the input element must refer to a datalist element.
Element input with attribute type whose value is “button” must have non-empty attribute value.
The usemap attribute on the input element is obsolete. Use the img element instead of the input element for image maps.
The align attribute on the input element is obsolete. Use CSS instead.

Tag omission #

The input element is a void element. An input element must have a start tag but must not have an end tag.

Permitted parent elements #

any element that can contain phrasing elements

DOM interface #

interface HTMLInputElement : HTMLElement {
           attribute DOMString accept;
           attribute DOMString alt;
           attribute DOMString autocomplete;
           attribute boolean autofocus;
           attribute boolean defaultChecked;
           attribute boolean checked;
           attribute DOMString dirName;
           attribute boolean disabled;
  readonly attribute HTMLFormElement? form;
  readonly attribute FileList? files;
           attribute DOMString formAction;
           attribute DOMString formEnctype;
           attribute DOMString formMethod;
           attribute boolean formNoValidate;
           attribute DOMString formTarget;
           attribute unsigned long height;
           attribute boolean indeterminate;
  readonly attribute HTMLElement? list;
           attribute DOMString max;
           attribute long maxLength;
           attribute DOMString min;
           attribute boolean multiple;
           attribute DOMString name;
           attribute DOMString pattern;
           attribute DOMString placeholder;
           attribute boolean readOnly;
           attribute boolean required;
           attribute unsigned long size;
           attribute DOMString src;
           attribute DOMString step;
           attribute DOMString type;
           attribute DOMString defaultValue;
           attribute DOMString value;
           attribute Date? valueAsDate;
           attribute unrestricted double valueAsNumber;
           attribute unsigned long width;

  void stepUp(optional long n);
  void stepDown(optional long n);

  readonly attribute boolean willValidate;
  readonly attribute ValidityState validity;
  readonly attribute DOMString validationMessage;
  boolean checkValidity();
  void setCustomValidity(DOMString error);

  readonly attribute NodeList labels;

  void select();
           attribute unsigned long selectionStart;
           attribute unsigned long selectionEnd;
           attribute DOMString selectionDirection;

  void setSelectionRange(unsigned long start, unsigned long end, optional DOMString direction);
};

HTML: The Markup Language (an HTML language reference)