img

< html‎ | elements
Jump to: navigation, search

img

This page has been flagged with the following issues:


W3C Candidate Recommendation

Summary

The img element (<img>) represents an image.


Overview Table

DOM Interface HTMLImageElement

The img element (<img>) embeds an image in a document. The <img> element can be nested in an <a> element to create an image that links to another page or section. The value of the alt attribute (<alt>) provides equivalent content for those who cannot process images or who have image loading disabled. Alternatives to the <img> element include setting the background-image property of an element.

Attributes

States

An img is always in one of the following states:

Unavailable
The user agent hasn't obtained any image data.
Partially available
The user agent has obtained some of the image data.
Completely available
The user agent has obtained all of the image data and at least the image dimensions are available.
Broken
The user agent has obtained all of the image data that it can, but it cannot even decode the image enough to get the image dimensions (e.g. the image is corrupted, or the format is not supported, or no data could be obtained).

Examples

View live exampleThe following example shows how to use the img element to embed an image on a page with an alt attribute to specify text to display if the image isn't able to be displayed.

HTML


<p>
  You are standing in an open field west of a house.
  <img src="house.jpeg" alt="The house is white, with a boarded front door.">
  There is a small mailbox here.
</p>



Related specifications

Specification Status Related Changes
HTML 2.0 W3C Recommendation
HTML5 W3C Candidate Recommendation

Compatibility

Desktop

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic Support 1.0
1.0
1.0
5.12
1.0

Mobile

Feature Android BlackBerry Chrome for mobile Firefox Mobile (Gecko) IE Mobile Opera Mobile Opera Mini Safari Mobile
Basic support ? ? ? ? ? ? ? ?

See also

Related articles

HTML












































  • img







… further results

Multimedia









  • img



External resources

http://www.w3.org/wiki/HTML/Elements/img

Attribution

This article contains content originally from external sources.

Portions of this content come from the Microsoft Developer Network: [Windows Internet Explorer API reference Article]