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 admin@wiki.whatwg.org 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.)

Note: This wiki is used to supplement, not replace, specification discussions. If you would like to request changes to existing specifications, please use IRC or a mailing list first.

Validator.nu alt advice

From WHATWG Wiki
Jump to: navigation, search

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.

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.