Accessible description
An element's accessible description is part of the accessibility tree that makes web content available to screen readers and other assistive technologies, which, in turn, make that content available to the users of those technologies.
The accessible description for a
<table >
is its first
<caption >
, for the
<figure >
, is the
<figcaption >
, for the
<summary >
, is the content of the
<details >
it is nested in, and for the button
<input >
elements, it is the value
attribute's value, unless the element also has a aria-describedby
or aria-description
attribute, which takes precedence.
For other elements, the description needs to be programmatically associated with the related element. In these cases, the accessible description is provided by the
aria-describedby
attribute,
aria-description
attribute, or the
title
attribute, if the title
would not otherwise also be the accessible name
for that element, in that order of precedence.
Descriptions are reduced to text strings. For example, if an element's aria-describedby
attribute value is the id
of an HTML
<img >
, the description is the description of the image (usually the image's alt
attribute).
You can inspect the accessible description for any element on your page: look at your browser's developer tools' accessibility tab, which provides the accessibility information for the currently selected element.
See also
- accessible name glossary term
- ARIA roles
- ARIA attribute
- Accessibility
- Learn accessibility