HTML: The Markup Language (an HTML language reference)

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 #
Equivalent content for those who cannot process images or who have image loading disabled.
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 = "ismap" or "" (empty string) or empty #
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".

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;

Typical default display properties #

img {
display: inline-block; }