Sc1 1 1 Aria Describedby
Created by: Frank Berker
Description
This test checks the sufficient provision of a long text description for elements using the aria-describedby attribute.
Background
- ARIA15: Using aria-describedby to provide descriptions of images
- G73: Providing a long description in another location with a link to it that is immediately adjacent to the non-text content
- G74: Providing a long description in text near the non-text content, with a reference to the location of the long description in the short description
- G92: Providing long description for non-text content that serves the same purpose and presents the same information
- F67: Failure of Success Criterion 1.1.1 and 1.2.1 due to providing long descriptions for non-text content that does not serve the same purpose or does not present the same information
- The proper provision of a short text alternative is checked in SC1-1-1-text-alternative.
Assumptions
- It is not checked for references to long text descriptions within short text alternatives such as “The image is described in text below”.
- If the
aria-describedbyattribute is provided, a long description was intended and is needed for the element. - This test assumes that
role="image"is properly used.
Test properties
| Property | Value |
|---|---|
| Test name | Proper use of aria-describedby |
| Success Criterion | 1.1.1 Non-text Content |
| Test mode | Semi-automatic |
| Test environment | Rendered page |
| Test subject | Web page state |
| User profile | Requires sight |
Test procedure
Selector
Test mode: automatic
Select following elements providing an aria-describedby attribute:
imgelementsinputelements oftype="image"- all elements with
role="image"
//*[self::img[@aria-describedby] or self::input[@type="image" and @aria-describedby] or self::*[@role="image" and @aria-describedby]]
Step 1
Test mode: automatic
Check if at least one of the aria-describedby attribute values is a valid identifier.
if yes, continue with step 2
else, return
| Outcome | Failed |
|---|---|
| Testcase | SC1-1-1-aria-describedby |
| ID | SC1-1-1-aria-describedby-fail1 |
| Error | None of the aria-describedby attribute values is a valid identifier. |
Step 2
Test mode: automatic
Check if at least one of the elements referenced by the valid aria-describedby attribute values exists.
if yes, continue with step 3
else, return
| Outcome | Failed |
|---|---|
| Testcase | SC1-1-1-aria-describedby |
| ID | SC1-1-1-aria-describedby-fail2 |
| Error | None of the elements referenced by aria-describedby exists. |
Step 3
Test mode: manual
Concatenate the results of Text Alternative Computation Algorithm run on the element itself and assign it to variable T1 and on all elements referenced by the aria-describedby attribute and assign it to variable T2.
User Input Question:
| Property | Value |
|---|---|
| Presented item | Element with T1 and T2 |
| Question | Does T2 provide an extended description of the image additionally to T1? |
| Help | If the image contributes meaning to the page or provide any functionality or conveys information additional to the pages text, this must be described. |
| Repair | If no, could you suggest an long text alternative, which would sufficiently describe the image? |
| Requires context | yes |
| Requires Interaction | yes |
if yes, return
| Outcome | Passed |
|---|---|
| Testcase | SC1-1-1-aria-describedby |
| ID | SC1-1-1-aria-describedby-pass1 |
else return
| Outcome | Failed |
|---|---|
| Testcase | SC1-1-1-aria-describedby |
| ID | SC1-1-1-aria-describedby–fail3 |
| Error | The long description provided using aria-describedby is not sufficiently descriptive. |