Permitted content #

Permitted attributes #

Descriptions for attributes specific to this element #

src = URI

A URL referencing a non-interactive, optionally animated, image that is neither paged nor scripted.

alt = normal character data

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 = "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 border attribute on the img element is obsolete. Consider specifying “img { border: 0; }“ in CSS instead.

Additional constraints and admonitions #

• 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.

Permitted parent elements #

any element that can contain phrasing elements

DOM interface #

[NamedConstructor=Image(),
 NamedConstructor=Image(in unsigned long width),
 NamedConstructor=Image(in unsigned long width, in unsigned long height)]
interface HTMLImageElement : HTMLElement {
           attribute DOMString alt;
           attribute DOMString src;
           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;
};