I run across a lot (and when I say a lot… I mean A LOT) of 4.1.2 bugs that have an inaccurate understanding of the success criterion. Here are some common bugs and some clarification. This is a living document and will be updated periodically.
Some things to remember about this is that 4.1.2 Name, Role, Value requires that user agents “can” get or set this information. It does not require the information provided to be accurate. We’ll cover this more in the following examples.
- Element has an incorrect role.
- 4.1.2 only requires that a role is provided. It doesn’t fail if the role is incorrect. An incorrect role is a failure of 1.3.1 Information and Relationships. 1.3.1 requires the role to accurately reflect the structure or relationship.
- A text document viewed on the web has no aria roles defined.
- Since the underlying technology for a text document does not have the ability to add these properties, then using consistent formatting of content is sufficient. Without any formatting, this may be considered a fail.
- Accessible name is not clear.
- Accuracy of the accessible name is not a requirement of 4.1.2.
- If the element is a form element, this is covered in 2.4.6 Headings and Labels which requires the label to describe the topic or purpose.
- If the element is an anchor element (link), this is covered in 2.4.4 Link Purpose (in context).
- If the element is a landmark or other element, then 2.4.6 would apply. Whether the label is visible or not, it must be sufficiently descriptive.
- Form labels are missing.
- If there is no visible label or element with a text alternative, then this is a failure of 3.3.2 Labels or instructions.
- If there is a visible label or element with a text alternative, then this is likely a failure of 1.3.1 Information and Relationships. The reason for this is there is no programmatic relationship between the visible label and the input.
- Screen reader does not report role.
- If there is an accurate role on an element, then this success criterion is met (at least for roles). The accuracy in reporting the role is considered a bug with the User Agent or Screen Reader.
- The status update is not automatically reported to the user.
- “Notification of changes” is often misunderstood as “Informing the user that a change has occurred.” These are two very different things. The only requirement from this is that the User Agent must be kept up to date. It does not require the end user to be informed about every change.
- Example: This would require the use of aria-expanded when content is shown/hidden. When the value of the aria-expanded is updated from true to false, that is all that is required. If the screen reader does nothing with that information, that is not a failure.