HTML5 Pocket Reference, 5th Edition

Name

img

Synopsis

<img> (XHTML: <img/> or <img />)

Represents an image in the content flow. The src and alt attributes are required.

Usage

Categories:

Flow content, phrasing content, embedded content, palpable content, interactive content if it has a usemap attribute

Permitted contexts:

Where embedded content is expected

Permitted content:

Empty

Start/end tags:

This is an empty (void) element, meaning it has only a start tag and may not have any contents. In HTML, the end tag is forbidden. In XHTML, the element must be closed with a trailing slash (<img/> or <img />).

Attributes

HTML5 Global Attributes

alt="text"

Required. Provides a string of alternative text that appears when the image is not or cannot be displayed.

crossorigin="anonymous|use-credentials "

Not in HTML 4.01. On a site that allows cross-origin access files, this attribute indicates if requests from other domains must present credentials to access the image.

height="number"

Specifies the height of the image in pixels. It is not required, but is recommended to speed up the rendering of the web page.

ismap (ismap="ismap" in XHTML)

Indicates that the graphic is used as the basis for a server-side image map (an image containing multiple hypertext links).

src="URL"

Required. Provides the location of the graphic file to be displayed.

srcset="image candidate string"

WHATWG only. Allows authors to specify alternative images for different viewport sizes and higher pixel densities. The value is a comma-separated list of image locations with a descriptor ...