HTML 5: The Markup Language (ARIA Edition)

imgimage # T

The img element represents an image.

Permitted contents #

empty (void element)

Permitted attributes #

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 #

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(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;