Open mxmason opened 3 years ago
Will start working on this now
Quoting from the suggestions: So, here's the issues that jumped out at me when reviewing:
Make sure that button, a, and label element content is unique and descriptive.
this is likely more a 2.4.4 issue for links (possibly 2.4.9 depending on context) and a 2.4.6 issue for labels... possibly buttons. It's a bit dicey putting these all together, but the point being that 1.3.1 doesn't really apply here. I'm not sure exactly what you want to do here, but I suggest at the very least removing the SC if you can't cite multiple SCs.
What should I do with this? remove it as it is suggested? we do not currently support having multiple SCs.
i'd personally separate these out. labels / buttons could remain together under a 2.4.6 "make sure labels (which does not necessarily mean <label>
s) are unique and descriptive to their purpose"
and then links could be separate checklist item like (reword as you see fit): "ensure that link content is descriptive and understandable in context" pointing to 2.4.4
Summary
The checklist currently makes incorrect references to specific WCAG criteria. The community should review the checklist content for better accuracy
Suggested edits courtesy of Scott O'Hara:
>> Make sure that button, a, and label element content is unique and descriptive. > this is likely more a 2.4.4 issue for links (possibly 2.4.9 depending on context) and a 2.4.6 issue for labels... possibly buttons. It's a bit dicey putting these all together, but the point being that 1.3.1 doesn't really apply here. I'm not sure exactly what you want to do here, but I suggest at the very least removing the SC if you can't cite multiple SCs. >> Use landmark elements to indicate important content regions. > This would be a 1.3.1 issue. 4.1.2 is more about interactive content >> Avoid using the autofocus attribute. > Generally agree with this, but arguable if this would be a 2.4.3 issue. Sometimes using autofocus is exactly what you should do. Might be worth at least stating this is something to watch out for, rather than how this presently reads (to me) that it's an autofail. >> Remove title attribute tooltips. > This is arguably more of a 2.1.1 keyboard issue as - if the content is actually important - would generally be inaccessible to keyboard only users. since title is generally exposed to AT, 4.1.2 doesn't really hold true here. >> Check to see that keyboard focus order matches the visual layout. > 1.3.2 may not apply here as content doesn't necessarily need to match visual focus order. 2.4.3 may be more appropriate to cite. >> headings > All checklist items in the headings section incorrectly cite 2.4.6. 2.4.6 is about the quality of heading text, but has nothing to do with whether the text is properly exposed as a heading. These would all be 1.3.1/best practice issues. >> Use the th element for table headers (with appropriate scope attributes). > Unsure why this is cited as a 4.1.1 issue. Seems it should be a 1.3.1 >> Use the caption element to provide a title for the table. > Again, not a 2.4.6 unless there is a