SC1-1-1-aria-describedby

From Automated WCAG Monitoring Community Group
Jump to: navigation, search

This test case belongs to 1.1.1 Non-text Content

Status

Version 1.0

Description

This test checks the sufficient provision of a long text description for elements using the aria-describedby attribute.

Background

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

Test mode: earl:automatic


Select following elements providing an aria-describedby attribute:

  • img elements
  • input elements of type="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: 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

Test mode: 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

Test mode: 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