img – image

Permitted contents #

empty (void element)

Permitted attributes #

global attributes & src★ & alt & height & width & usemap & ismap & border & common.attrs.aria

ⓘ global attributes: Any attributes permitted globally.
ⓘ src = non-empty URL potentially surrounded by spaces #: A URL referencing a non-interactive, optionally animated, image that is neither paged nor scripted.
ⓘ alt = any value #: The fallback content for the image.
ⓘ height = non-negative integer #: The height of the image, in CSS pixels.
ⓘ width = non-negative integer #: The width of the image, in CSS pixels.
ⓘ usemap = hash-name reference #: A hash-name reference to a map element with which to associate the image.
ⓘ ismap = d:string "ismap" or d:string "" #: Specifies that its img element provides access to a server-side image map.
ⓘ border = zero OBSOLETE #: Specifies that its img element represents a borderless image.; The literal string "0".
aria = #: (detailed attribute description to come)

Additional constraints and admonitions #

An “img” element must have an “alt” attribute, except under certain conditions. For details, consult guidance on providing text alternatives for images. http://www.w3.org/wiki/HTML/Usage/TextAlternatives
The element “img” with the attribute “usemap” must not appear as a descendant of the “a” element.
The element “img” with the attribute “usemap” must not appear as a descendant of the “button” element.
The “img” element with the “ismap” attribute set must have an ancestor “a” element with the “href” attribute.
The “longdesc” attribute on the “img” element is obsolete. Use a regular “a” element to link to the description.
The “name” attribute on the “img” element is obsolete. Use the “id” attribute instead.
The “align” attribute on the “img” element is obsolete. Use CSS instead. http://wiki.whatwg.org/wiki/Presentational_elements_and_attributes
The “hspace” attribute on the “img” element is obsolete. Use CSS instead. http://wiki.whatwg.org/wiki/Presentational_elements_and_attributes
The “vspace” attribute on the “img” element is obsolete. Use CSS instead. http://wiki.whatwg.org/wiki/Presentational_elements_and_attributes
The “border” attribute on the “img” element is obsolete. Use CSS instead. http://wiki.whatwg.org/wiki/Presentational_elements_and_attributes
The “border” attribute on the “img” element is obsolete. Consider specifying “img { border: 0; }“ in CSS instead.

Tag omission #

The img element is a void element. An img 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 #

[NamedConstructor=Image(),
 NamedConstructor=Image(unsigned long width),
 NamedConstructor=Image(unsigned long width, unsigned long height)]
interface HTMLImageElement : HTMLElement {
           attribute DOMString alt;
           attribute DOMString src;
           attribute DOMString crossOrigin;
           attribute DOMString useMap;
           attribute boolean isMap;
           attribute unsigned long width;
           attribute unsigned long height;
  readonly attribute unsigned long naturalWidth;
  readonly attribute unsigned long naturalHeight;
  readonly attribute boolean complete;
};

HTML 5: The Markup Language (ARIA Edition)

ⓘ img – image # T

Permitted contents #

Permitted attributes #

Additional constraints and admonitions #

Tag omission #

Permitted parent elements #

DOM interface #