Warning:
This wiki has been archived and is now read-only.
SC1-1-1-aria-describedby
This test case belongs to 1.1.1 Non-text Content
Status
Contents
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-describedby
attribute 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 | SemiAuto |
Test environment | rendered page |
Test subject | web page state |
User expertise and skills | No prior knowledge |
User profile | Requires sight |
Test procedure
Selector
earl:automatic
Select following elements providing an aria-describedby
attribute:
-
img
elements -
input
elements 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
earl:automatic
Check if at least one of the aria-describedby
attribute values is a valid identifier.
if yes continue with #Step 2
else return
Property | Value |
---|---|
TestCase | SC1-1-1-aria-describedby |
Identifier | SC1-1-1-aria-describedby-fail1 |
Outcome | failed |
ErrorMessage | None of the aria-describedby attribute values is a valid identifier. |
Pointer | position |
Info |
Step 2
earl: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
Property | Value |
---|---|
TestCase | SC1-1-1-aria-describedby |
Identifier | SC1-1-1-aria-describedby-fail2 |
Outcome | failed |
ErrorMessage | None of the elements referenced by aria-describedby exists. |
Pointer | position |
Info |
Step 3
earl: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
Item presented to the user: Element with T1 and T2
Question: Does T2 provide an extended description of the image additionally to T1?
Answer options: "yes/no"
Help text: 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 suggestion: If no, could you suggest an long text alternative, which would sufficiently describe the image?
Properties of the test step:
- context-sensitive = yes
- user interaction (with the web content) required = yes
if yes, return
Property | Value |
---|---|
TestCase | SC1-1-1-aria-describedby |
Identifier | SC1-1-1-aria-describedby-pass1 |
Outcome | passed |
Pointer | position |
Info |
else return
Property | Value |
---|---|
TestCase | SC1-1-1-aria-describedby |
Identifier | SC1-1-1-aria-describedby–fail3 |
Outcome | failed |
ErrorMessage | The long description provided using aria-describedby is not sufficiently descriptive. |
Pointer | position |
Info |