Skip to main content

Accessibility: Why have the issue names changed?

Grace Lam avatar
By Grace Lam

We're always striving to make our interface copy easier to understand for our users. That's why we updated the issue names in the Accessibility module to be clearer about why something has been flagged as an issue.

If you've been used to seeing an issue referred to under a different name, you may have noticed some of the changes. Here's a handy list of the old and new wording of all the Accessibility issue names which have changed.

Some of the wording changes are cosmetic, while others are more substantive and systematic. For example, we've re-phrased all Review issues in the form of a question, so that it's clear that the issue at hand has not been automatically determined to be an error.

Issue type (Error, Warning, or Review) Previous Issue Name Current Issue Name
Error Use unique identification for elements Element ID is not unique
Error The instruction is not connected to anything Label is not connected to a form control
Error The table has an incorrect reference Cell references non-existent table heading ID
Error Link refers to a non-existing element Local link destination does not exist
Error Non-distinguishable links Link text used for multiple different destinations
Error Do not use the 'center' tag to center content "Center" tag used to format content
Error The field needs a description Form control label is missing text
Error Use correct styling of text "Small" tag used to alter text size
Error Do not use ‘big’ for text size "Big" tag used to alter text size
Error The link text seems not to be descriptive Link text is too generic
Error The referenced page does not exist "Longdesc" attribute does not link to existing resource
Error The image does not have the correct alternative Image marked as decorative but has title element
Error Wrong use of time limit with meta direct Use of automatic redirect after a time delay
Error Wrong use of time limit Use of automatic refresh after a time delay
Error Use correct markup for highlighting text "u" tag used to format text
Error Missing button in form Form is missing button
Error Wrong location of navigational link Navigational link not located in document "head"
Error Set the language of the page Language of page has not been set
Error Presentational attributes used HTML is used to format content
Error Provide a button for 'select box' Select box has no submit button
Error Do not use ’spacer’ "spacer" tag used to format content
Error Highlighting elements Element not highlighted on focus
Error Language declaration is invalid Language attribute is not set to a valid value
Error Wrong way of redirecting Re-direct occurs in browser
Error Skip repeated content No option to skip repeated content
Error The page contains no headings No headings on page
Error Links should be combined Adjacent links used for same destination
Error Incorrect reference for 'aria-describedby' "Aria-describedby" has incorrect (ID) reference
Error Naming generic landmarks Generic landmarks are not named
Error Descriptive 'aria-label' on link Does the "aria-label" accurately describe the link?
Error WAI-ARIA validation error on load WAI-ARIA validation error is present when page loads 
Error Reference to non existing image map Reference to non-existent image map
Error 'Area' element with no alternative text "Area" element is missing alternative text
Error Image link has no alternative text Image link is missing alternative text
Error Input field is missing a description Input field has no description
Error 'Text area' is missing a description Text area has no description
Error 'Select box' without a description Select box has no description
Error Image-button without a description Image button has no description
Error The webpage should have exactly one title element Webpage has multiple title elements or no title element
Error The webpage title has no text Webpage title is missing text
Error The frame does not have a description Frame is missing a description
Error The iFrame is missing a description iFrame is missing a description
Error The heading is missing text Heading is missing text
Error Page element is missing a description Page element has no description
Error 'Applet' needs an alternative Applet is missing an alternative
Error Color contrast is not sufficient Color contrast is insufficient
Error Group form elements Form elements are not grouped
Error The link text is not sufficient Link text is too generic in its current context
Error Avoid the use of 'font' tag "Font" tag used to format text
Error Avoid using the 'marquee' tag "Marquee" tag is used
Error Avoid using the 'bold' tag "Bold" tag used to format text
Review The table does not have a description Should the table have a description?
Review Grouping options Can options logically be grouped together?
Review Providing table heading association Does the table have clearly defined headers?
Review Order of tabbing Is the tabbing sequence logical?
Review Decorative images Should image be marked as decorative?
Review Video / audio needs alternative Does video/audio have an alternative?
Review Multi media content needs captions Is multimedia content captioned?
Review Multi media content needs alternative Does multimedia content have an alternative?
Review Live multi media content needs captions Is live multimedia content captioned?
Review Multi media content needs audio description Does multimedia content have audio description?
Review Multi media content needs Sign Language Interpretation Does multimedia content have Sign Language Interpretation?
Review Multi media content needs Extended Audio Description Does multimedia content have Extended Audio Description?
Review Multi media content and video needs alternative Does multimedia content/video have an alternative?
Review Live audio needs alternative Does live audio have an alternative?
Review Low or no background audio in multi media content Is foreground audio clearly distinguishable from background audio?
Review Audio control Are there options to control audio that auto-plays?
Review Make sure images do not contain text Is the image free of text?
Review Provide enough time Are users unrestricted by time limits on the page?
Review Use correct styling of text Is the "small" tag correctly used?
Review Using standard landmarks Could a standard landmark be used?
Review Appropriate landmark Are landmarks appropriately applied?
Review WAI-ARIA role matches functionality Do WAI-ARIA roles match the functionality of the element?
Review Links might have to be combined Should adjacent links be combined?
Review Links might be non-distinguishable Do identical link texts link to the same destination?
Review Additional information with WAI-ARIA Do "aria-describedby" attributes provide additional information?
Review Descriptive 'aria-label' on interface controls Does the "aria-label" attribute accurately describe the interface control?
Review Descriptive 'aria-label' attribute Does the "aria-label" attribute accurately describe the element?
Review Appropriate names for landmarks Does the "aria-labelledby" attribute accurately describe the landmark?
Review Descriptive 'aria-labelledby' on interface controls Does the "aria-labelledby" attribute accurately describe the interface control?
Review Descriptive 'aria-labelledby' attribute Does the "aria-labelledby" attribute accurately describe the element?
Warning Use correct markup "s" or "strike" tags used to format text
Warning Using correct markup "tt" tag used to format text
Warning There is no top level heading (H1) on the page No top-level heading on the page
Warning WAI-ARIA image alternative will be ignored Image marked as decorative but has "aria-describedby" attribute
Warning WAI-ARIA alert dialog included on load WAI-ARIA alert is present when page loads
Warning Non-corresponding image alternatives Image alternatives don't match
Warning Content outside of landmarks Content not included in landmarks
Warning Avoid using the 'i' tag  "i" tag used to format text

 

Was this article helpful?
0 out of 0 found this helpful