Invalid aria-describedby on UI control

Compliance Data & User Impact

User Impact: Major

60% Complete

Disabilities Affected:

  • blindness
  • deafblindness

WCAG Version:

WCAG Levels:

  • A

WCAG Guidelines:

Solution Techniques:

Automated Test Accuracy:

Check1st Severity:

DRRSAG Designations:

  • relationship

How to Fix the Problem

The aria-describedby attribute should associate a UI control with its text description, via the id attribute on the element where the text to be used as the description is found.

The Algorithm, in Simple Terms

Find <input>,<select>,<a>,<textarea>,<button>,[role='button'],[role='checkbox'],[role='combobox'],[role='link'],[role='listbox'],[role='menuitem'],[role='menuitemcheckbox'],[role='menuitemradio'],[role='option'],[role='radio'],[role='scrollbar'],[role='slider'],[role='spinbutton'],[role='switch'],[role='tab'],[role='textbox'] elements using an aria-describedby attribute where one of the following apply:

  • at least one of the id references does not refer to any element in the document.
  • one of the referred elements does not contain any text

Why Is it Important?

The aria-describedby attribute provides additional information to help AT users get descriptive information about a user interface element.

Address: 401 9th St NW, 6th Floor
Washington, DC 20004
Phone number: (888) 995-WCAG
International number: 1(888) 995-9224