nu.validator.localentities.files.vnu-alt-advice Maven / Gradle / Ivy
Show all versions of validator Show documentation
Validator.nu alt advice - WHATWG Wiki
A user account is required in order to edit this wiki, but we've had to disable public user registrations due to spam.
To request an account, ask an autoconfirmed user on IRC (such as one of these permanent autoconfirmed members) or send an e-mail to [email protected] with your desired username and an explanation of the first edit you'd like to make. (Do not use this e-mail address for any other inquiries, as they will be ignored or politely declined.)
Validator.nu alt advice
From WHATWG Wiki
The purpose of this page is to enable collaborative creation of advisory text for certain cases of alt
usage so that this advice can be displayed by Validator.nu. Note that like the rest of this wiki, editing requires you to agree to release your contributions under the MIT license (see wiki footer). Please note that while copying text from the WHATWG version of HTML 5 is OK, copying text from RFCs or W3C specs is not OK.
Contents
Image Report
The img
elements of the page are shown below categorized by their type of textual alternative. Please review that the images in each group match that group’s definition.
No textual alternative available, not linked
The following images are not links and have no textual alternative available (no alt
attribute), and are, therefore, not accessible to people who cannot see the images or understand the symbols in them.
An image belongs here if the image is significant (non-decorative) and the markup generator doesn’t have knowledge on what the image is about available. For example, a photo gallery generator does not have textual alternatives available when the user refuses to provide them.
Purely decorative images should have the empty string as the textual alternative (alt=""
), so it is a mistake for those to appear here. Also, when the markup writer knows what the images are about, (s)he should write textual alternatives.
No textual alternative available, image linked
The following images are links and have no textual alternative available (no alt
attribute). Having an img
element without a textual alternative as the content of a link is handled ungracefully by popular screen readers.
Omitted from non-graphical presentation
The following images are marked to be omitted from non-graphical presentations (alt=""
).
Purely decorative images belong in this category. Also, iconic images that are redundant with text next to them belong here.
If the page would become less understandable if the presence of an image was concealed, the image doesn't belong here. In that case, a textual alternative should be supplied or if the markup generator does not have a textual alternative available (because the user refused to provide it), the alt
attribute should be omitted by the markup generator.
Images with textual alternative
The following images have textual alternatives. Please review that the textual alternatives make sense considering the purpose of the image in the context of the page and that phrases like “Image of …” are avoided.
Note that iconic images that are redundant with text next to them or purely decorative should have alt=""
instead.
No images
No images in the document.
Fatal
Unable to show the report due to a fatal error.