a11y-automation
a11y-automation copied to clipboard
Considering short titles/descriptions for potential violations
I've been thinking about how to word potential violations so that they are more uniform than they are now.
Previous feedback has suggested that the "error word" should come first. Given that feedback, I'm working on a new list of short titles/descriptions for potential violations.
I'm going to shop around this issue link to get some feedback, so if you are following this repo and have feedback, please do provide some.
This is my first iteration. I've tried using it in a RL scenario and ran into a few issues with it but I don't know if it's because it's simply new to me, or is actually a little unwieldy.
Short Descriptions, a working list:
- Clipped or hidden content on text resize
- Clipped or hidden content on zoom
- Disabled interactive element(s)
- Disabled zooming and scaling
- Disallowed keyboard trap
- Disallowed links inside of alert messages
- Disallowed: popup appears on page load
- Disallowed: whitespace used for layout
- Illegal use of positional word(s)
- Illogical focus sequence
- Incomplete accessible name
- Inconsistent identification
- Inconsistent navigation
- Incorrect ARIA attribute value
- Incorrect image ALT attribute value
- Incorrect use of alerts
- Incorrect use of autofocus
- Incorrect use of input/label (not associated)
- Incorrect use of toast for error message
- Incorrectly hidden interactive/focusable elements
- Incorrectly marked presentational image
- Insufficient abbreviation label
- Insufficient color contrast
- Insufficient color contrast with surrounding text
- Insufficient distinguishability
- Insufficient image ALT attribute value
- Insufficient target size
- Invalid ARIA attribute used
- Invalid color-only link
- Invalid link text
- Invalid role used
- Invisible focused interactive element
- Lack of multiple ways
- Malformed alerts cause alert to be missed
- Malformed autocomplete
- Malformed element
- Malformed HTML
- Mis-ordered heading levels
- Missing accessible name for button
- Missing accessible name for duplicate landmark
- Missing accessible name for link
- Missing accessible name for list element
- Missing attribute
- Missing autocomplete
- Missing error prevention
- Missing focus indicator
- Missing focus management after modal closes
- Missing focus trap
- Missing h1 on page
- Missing keyboard support
- Missing label for input
- Missing role
- Missing scrollable region keyboard access
- Missing skiplink/bypass block
- Missing status announcement
- Missing table header text
- Missing visible label in accessible name
- Missing warning for automatic actions
- multiple h1 per page
- multiple main landmarks
- nested interactive
- Obscured focusable element
- Redundant attribute(s)
- Redundant label
- Unassociated error message for input
- Unclear error text
- Unclear heading
- Unclear help text
- Unclear label
- Unmarked headings
- Unprevented data loss
- Unreachable element via keyboard
- Unsupported orientation
- Unsupported text spacing
I think I need to pair these with some kind of category so they are easier to scan. They might be good on their own for something like an issue title, but if used for something like an audit, then it would be better to provide an additional category, so the potential violations can be grouped that way. I don't know if that will work just yet, I should try it out though.