HTMLImageElement: longDesc property
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("HTML DOM")}}
The _deprecated_ **longDesc** property of the {{domxref("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 [title](/en-US/docs/Web/HTML/Reference/Global_attributes/title) attribute. It reflects the <img> element's [longdesc](/en-US/docs/Web/HTML/Reference/Elements/img#longdesc) content attribute.
This attribute is considered obsolete in the HTML spec. It has an uncertain future; authors should use a {{glossary("WAI")}}-{{glossary("ARIA")}} alternative such as [aria-describedby](/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-describedby) or [aria-details](/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-details). You can also encapsulate the image within a link using the {{HTMLElement("a")}} element.
Value
A string 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 image's contents.
Examples
Consider the following older HTML:
<img
src="taco-tuesday.jpg"
alt="Taco Tuesday"
longdesc="image-descriptions/taco-tuesday.html" />Here, the 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 file image-descriptions/taco-tuesday.html.
This should be converted into the following HTML:
<a href="image-descriptions/taco-tuesday.html">
<img src="taco-tuesday.jpg" alt="Taco Tuesday" />
</a>With that, the image is a link to the HTML file describing the image in more detail.
Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- [
aria-details](/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-details)