-
Notifications
You must be signed in to change notification settings - Fork 783
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
feat(image-alt): require alt text or empty strings #1260
Conversation
The image-alt rule now checks for space characters, and fails if they are present. Empty alt attributes are still fine, and text content is still fine. This fixes cases where ATs do not skip decorative images because of the space characters in the alt attribute. Closes #1174
37962e2
to
c5682ce
Compare
(there are no actual changes)
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I would prefer adding this as a separate rule because it would allow us to expand beyond <img>
related to that, has someone actually tested those elements with spaces in their alt
attributes?
lib/checks/label/alt-empty-space.js
Outdated
@@ -0,0 +1,5 @@ | |||
let nn = node.nodeName.toLowerCase(); | |||
let validSetup = | |||
node.hasAttribute('alt') && (nn === 'img' || nn === 'input' || nn === 'area'); |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The rule selector will not include <input>
and <area>
elements. Why not make this a new, separate rule altogether?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This check doesn't need to include input
or area
, so that part can be removed. This only applies to image alt, so in my opinion it should not be a separate rule. input
and area
both use the existing check non-empty-alt
.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I agree with Marcy on this one. I think this one is better as a check that's part of image-alt, provided that we split off the [role=img]
, which we have a separate support ticket for.
Waiting for @marcysutton to update. Putting this into WIP. |
PR updated and ready to go. |
lib/checks/label/alt-empty-space.js
Outdated
let validSetup = | ||
node.hasAttribute('alt') && (nn === 'img' || nn === 'input' || nn === 'area'); | ||
let validAttrValue = /^\s+$/.test(node.getAttribute('alt')); | ||
return validSetup && validAttrValue; |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Nitpick. Best to use const
instead of let
when you're not reassigning the variable. It's just as easy to do and it creates greater security.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Fixed.
"impact": "critical", | ||
"messages": { | ||
"pass": "Element has a valid alt attribute value", | ||
"fail": "Element has an alt attribute containing only a space character" |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I'd prefer that we be explicit that alt attributes with white space only is not ignored by all screen readers. WDYT?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
That's fine by me, I've updated the PR.
I've updated this PR, I don't understand what's happening with the rule-descriptions though. Git is acting really weird with that file, I tried adding/committing it and it keeps popping up again. |
This change to the image-alt rule accounts for space characters, and fails if they are present. Empty alt attributes are still fine, and text content is still fine. This fixes cases where ATs do not skip decorative images because of the space characters in the alt attribute.
I'm open to name changes for the check, so please review.
Closes #1174
Reviewer checks
Required fields, to be filled out by PR reviewer(s)