This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.
The obsolete property
HTMLImageElement interface specifies the URL of a text or HTML file
which contains a long-form description of the image. This can be used to
provide optional added details beyond the short description provided in the
descURL = htmlImageElement.longDesc; htmlImageElement.longDesc = descURL;
DOMString which may be either an empty string (indicating that no long
description is available) or the URL of a file containing a long form description of the
For example, if the image is a PNG of a flowchart.
longDesc property could be used to provide an explanation of the flow
of control represented by the chart, using only text. This can be used by readers both
as an explanation, but also as a substitute for visually-impaired users.
This property is obsolete and should no longer be used. Instead of
longDesc to provide a link to a detailed description of an image,
encapsulate the image within a link using the
Consider the following older HTML:
<img src="taco-tuesday.jpg" longDesc="image-descriptions/taco-tuesday.html">
longDesc is used to indicate that the user should be able to
access a detailed description of the image
taco-tuesday.jpg in the HTML
This can be easily converted into modern HTML:
<a href="image-descriptions/taco-tuesday.html"> <img src="taco-tuesday.jpg"> </a>
With that, the image is a link to the HTML file describing the image in more detail.
|HTML 4.01 Specification
The definition of 'HTMLImageElement.longDesc' in that specification.
|Recommendation||Provides an actual description of this property; the HTML5 spec only says it's deprecated.|
BCD tables only load in the browser