decorative-image
Rule Severity : Moderate
Description
Decorative images do not add meaningful content to a web page. They convey information that is already provided through other content. To prevent assistive technologies from announcing them unnecessarily, decorative images should be marked and hidden from assistive technologies.
Users with visual impairments rely on screen readers to navigate websites efficiently. If decorative images are not correctly marked, screen readers may announce them, adding unnecessary auditory clutter and disrupting the user experience.
Examples
The following example includes an alt text for a purely decorative image, causing screen readers to read it aloud.
In the following corrected example, the image is accurately marked as decorative by using an empty alt attribute, ensuring that screen readers ignore it.
How to fix?
To mark decorative images properly, use one of the following methods:
- Assign the null
alt
attribute (alt=""
) to purely decorative images. - Use
role="presentation"
to indicate that the image should be ignored. - Implement decorative images as CSS background images.
References
We're sorry to hear that. Please share your feedback so we can do better
Contact our Support team for immediate help while we work on improving our docs.
We're continuously improving our docs. We'd love to know what you liked
We're sorry to hear that. Please share your feedback so we can do better
Contact our Support team for immediate help while we work on improving our docs.
We're continuously improving our docs. We'd love to know what you liked
Thank you for your valuable feedback!