img – image

Permitted contents #

empty (void element)

Permitted attributes #

global attributes & src★ & alt & height & width & usemap & ismap & border

ⓘ 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 #

An img element must have an alt attribute, except under certain conditions. For details, consult guidance on providing text alternatives for images.
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.
The hspace attribute on the img element is obsolete. Use CSS instead.
The vspace attribute on the img element is obsolete. Use CSS instead.
The border attribute on the img element is obsolete. Use CSS instead.
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;
};

Typical default display properties #

img {

display: inline-block; }

HTML: The Markup Language (an HTML language reference)

ⓘ img – image # T

Permitted contents #

Permitted attributes #

Additional constraints and admonitions #

Tag omission #

Permitted parent elements #

DOM interface #

Typical default display properties #