Skip to content

Coverage and Quality Reports

Coverage and Quality Reports

Page last updated: April 7, 2024

About These Reports

The APG Task Force uses the reports on this page to help plan content improvements. The reports provide data about the scope and quality of content in the APG. The data delineates:

  • Which ARIA attributes (roles, states, or properties) have usage demonstrated by an example.
  • Which ARIA attributes have usage guidance provided by a pattern or practice.
  • Which ARIA attributes are not covered by APG guidance or examples.
  • Which APG examples implement specific coding practices specified in the APG code guide.

The data in the reports are generated by a script that is run by a GitHub action workflow when the main branch of the aria-practices repository is updated. The script will indicate that an ARIA attribute has guidance in a pattern or practice if any of the following conditions are met:

  • The ARIA attribute is included in the text of a heading (e.g. h2-h6) within the content of a pattern or practice.
  • The ARIA attribute is included within either the data-aria-roles or data-aria-props attribute specified on a heading within a pattern or practice. These data attributes may contain a space separated list of values.

If either of the data attributes is specified on a heading, the content of that heading will not be processed. In the generated report, the suffix "(D)" indicates a reference came from a data attribute, otherwise the reference came from the text content of a heading.

The following files and reports are generated:

CSV Formatted Reports of Role, Property, and State Coverage

Roles with No Guidance or Examples (28)

  • application
  • caption
  • code
  • definition
  • deletion
  • directory
  • document
  • emphasis
  • figure
  • generic
  • heading
  • img
  • input
  • insertion
  • list
  • listitem
  • log
  • marquee
  • math
  • paragraph
  • progressbar
  • rowheader
  • scrollbar
  • searchbox
  • status
  • term
  • textbox
  • timer

Roles with at Least One Guidance or Example (13)

NOTE: The HC abbreviation means example has High Contrast support.
Role Guidance Example
alertdialog Alert Dialog
article Feed
columnheader Table
complementary Complementary Complementary Landmark
feed Feed Pattern Feed
link Link Pattern Link
main Main Main Landmark
menuitemcheckbox Editor Menubar
rowgroup Table
search Search Search Landmark
separator Editor Menubar
tooltip Tooltip Pattern
treegrid Treegrid Pattern Treegrid Email Inbox

Roles with More than One Guidance or Example (37)

NOTE: The HC abbreviation means example has High Contrast support.
Role Guidance Examples
alert
banner Banner
button
cell Table
checkbox Checkbox Pattern
combobox
contentinfo Contentinfo
dialog
form Form Landmark
grid
gridcell
group
listbox
menu
menubar Menu and Menubar Pattern
menuitem
menuitemradio
meter Meter
navigation
none
note
option
presentation
radio
radiogroup
region Region
row
slider
spinbutton Spinbutton Pattern
switch Switch Pattern
tab Keyboard Navigation Between Components (The Tab Sequence)
table Table
tablist
tabpanel
toolbar Toolbar
tree
treeitem

Properties and States with No Guidance or Examples (12)

NOTE: The HC abbreviation means example has High Contrast support.
  • aria-details
  • aria-dropeffect
  • aria-errormessage
  • aria-flowto
  • aria-grabbed
  • aria-invalid
  • aria-keyshortcuts
  • aria-multiline
  • aria-placeholder
  • aria-readonly
  • aria-relevant
  • aria-required

Properties and States with at Least One Guidance or Example (8)

NOTE: The HC abbreviation means example has High Contrast support.

Properties and States with More than One Guidance or Example (28)

NOTE: The HC abbreviation means example has High Contrast support.
Property or State Guidance Examples
aria-activedescendant Managing Focus in Composites Using aria-activedescendant
aria-autocomplete
aria-checked
aria-colindex Data Grid
aria-controls
aria-current
aria-describedby Describing by referencing content with aria-describedby
aria-disabled
aria-expanded
aria-haspopup
aria-hidden
aria-label Naming with a String Attribute Via aria-label
aria-labelledby Naming with Referenced Content Via aria-labelledby
aria-level
aria-live
aria-modal
aria-posinset
aria-pressed
aria-roledescription
aria-rowcount Using aria-rowcount and aria-rowindex
aria-rowindex Using aria-rowcount and aria-rowindex
aria-selected
aria-setsize
aria-sort Indicating sort order with aria-sort
aria-valuemax Using aria-valuemin, aria-valuemax and aria-valuenow
aria-valuemin
aria-valuenow Using aria-valuemin, aria-valuemax and aria-valuenow
aria-valuetext Using aria-valuetext

Code Quality

Coding Summary

Total Examples 60
High Contrast Documentation 31
Uses SVG 34
Uses forced-color-adjust on SVG 13
Uses event.KeyCode 16
Uses event.which 60
Use Class 36
Use Prototype 60
Mouse Events 15
Pointer Events 59

Coding Practices

Example Created Using Uses event.keyCode Uses event.which High Contrast Documentation Example Code ID Roles in Javascript and HTML Roles in Documentation aria-* Attributes in Javascript and HTML aria-* Attributes in Documentation Differences between the documentation and the source code.
Accordion class, prototype Yes ex1 2 1 10 3 heading,aria-busy,aria-describedby,aria-errormessage,aria-hidden,aria-label,aria-required,aria-roledescription
Alert prototype Yes ex1 2 1 8 2 heading,aria-busy,aria-describedby,aria-errormessage,aria-expanded,aria-hidden,aria-label,aria-labelledby,aria-roledescription,aria-live,aria-atomic
Alert Dialog prototype Yes Yes ex_alertdialog 3 2 10 4 heading,aria-busy,aria-errormessage,aria-expanded,aria-hidden,aria-label,aria-roledescription
Breadcrumb prototype Yes ex1 2 0 9 2 heading,navigation,aria-busy,aria-describedby,aria-errormessage,aria-expanded,aria-hidden,aria-labelledby,aria-roledescription
Button (IDL Version) prototype Yes Yes example 2 1 9 2 heading,aria-busy,aria-describedby,aria-errormessage,aria-expanded,aria-label,aria-labelledby,aria-roledescription
Button prototype Yes Yes example 2 1 9 1 heading,aria-busy,aria-describedby,aria-errormessage,aria-expanded,aria-hidden,aria-label,aria-labelledby,aria-roledescription
Auto-Rotating Image Carousel with Buttons for Slide Control prototype Yes ex1 3 2 10 4 heading,aria-busy,aria-describedby,aria-errormessage,aria-expanded,aria-hidden,aria-labelledby
Auto-Rotating Image Carousel with Tabs for Slide Control prototype Yes Yes ex1 5 4 11 5 heading,aria-busy,aria-describedby,aria-errormessage,aria-expanded,aria-hidden,aria-labelledby
Checkbox (Mixed-State) class, prototype Yes Yes ex1 2 1 10 2 heading,aria-busy,aria-describedby,aria-errormessage,aria-expanded,aria-hidden,aria-label,aria-labelledby,aria-roledescription
Checkbox (Two State) class, prototype Yes Yes ex1 3 2 9 2 heading,aria-busy,aria-describedby,aria-errormessage,aria-expanded,aria-hidden,aria-label,aria-roledescription
Editable Combobox With Both List and Inline Autocomplete class, prototype Yes Yes ex1 4 3 12 6 heading,aria-busy,aria-describedby,aria-errormessage,aria-hidden,aria-labelledby,aria-roledescription
Editable Combobox With List Autocomplete class, prototype Yes Yes ex1 4 3 12 6 heading,aria-busy,aria-describedby,aria-errormessage,aria-hidden,aria-labelledby,aria-roledescription
Editable Combobox without Autocomplete class, prototype Yes Yes ex1 4 3 12 6 heading,aria-busy,aria-describedby,aria-errormessage,aria-hidden,aria-labelledby,aria-roledescription
Date Picker Combobox class, prototype Yes Yes ex1 5 3 14 10 gridcell,heading,aria-busy,aria-errormessage,aria-hidden,aria-roledescription
Select-Only Combobox prototype Yes ex1 3 3 12 5 heading,option,aria-busy,aria-describedby,aria-errormessage,aria-haspopup,aria-hidden,aria-label,aria-roledescription
Editable Combobox with Grid Popup prototype Yes Yes ex1 3 4 13 7 heading,row,gridcell,aria-busy,aria-describedby,aria-errormessage,aria-hidden,aria-label,aria-roledescription
Date Picker Dialog class, prototype Yes Yes example 4 2 11 6 gridcell,heading,aria-busy,aria-errormessage,aria-expanded,aria-hidden,aria-roledescription
Modal Dialog prototype Yes Yes ex1 2 1 9 3 heading,aria-busy,aria-errormessage,aria-expanded,aria-hidden,aria-label,aria-roledescription
Disclosure (Show/Hide) for Answers to Frequently Asked Questions class, prototype Yes Yes ex1 1 0 9 2 heading,aria-busy,aria-describedby,aria-errormessage,aria-hidden,aria-label,aria-labelledby,aria-roledescription
Disclosure (Show/Hide) for Image Description class, prototype Yes Yes ex1 1 0 9 2 heading,aria-busy,aria-describedby,aria-errormessage,aria-hidden,aria-label,aria-labelledby,aria-roledescription
Disclosure Navigation Menu with Top-Level Links class, prototype Yes ex1 5 0 10 3 banner,contentinfo,heading,navigation,region,aria-busy,aria-describedby,aria-errormessage,aria-hidden,aria-label,aria-labelledby,aria-roledescription
Disclosure Navigation Menu class, prototype Yes Yes ex1 3 0 10 3 heading,navigation,region,aria-busy,aria-describedby,aria-errormessage,aria-hidden,aria-label,aria-labelledby,aria-roledescription
Feed Display prototype Yes Yes not found 0 0 6 0 aria-busy,aria-describedby,aria-label,aria-labelledby,aria-posinset,aria-setsize
Feed prototype Yes ex1 1 2 8 5 heading,feed,article,aria-errormessage,aria-expanded,aria-hidden,aria-label,aria-roledescription,aria-posinset,aria-setsize
Advanced Data Grid prototype Yes Yes ex1 1 0 13 0 heading,aria-busy,aria-colindex,aria-controls,aria-describedby,aria-errormessage,aria-expanded,aria-haspopup,aria-hidden,aria-label,aria-labelledby,aria-roledescription,aria-rowindex,aria-sort
Data Grid prototype Yes Yes ex1 5 1 15 6 button,heading,menu,menuitem,aria-busy,aria-controls,aria-describedby,aria-errormessage,aria-expanded,aria-haspopup,aria-hidden,aria-label,aria-roledescription
Layout Grid prototype Yes Yes ex1 6 3 15 3 button,heading,region,aria-busy,aria-colindex,aria-describedby,aria-errormessage,aria-expanded,aria-haspopup,aria-hidden,aria-label,aria-live,aria-relevant,aria-roledescription,aria-sort
Link prototype Yes Yes not found 2 1 8 1 heading,aria-busy,aria-describedby,aria-errormessage,aria-expanded,aria-hidden,aria-labelledby,aria-roledescription
(Deprecated) Collapsible Dropdown Listbox class, prototype Yes ex 3 2 14 5 heading,aria-busy,aria-describedby,aria-disabled,aria-errormessage,aria-hidden,aria-keyshortcuts,aria-label,aria-multiselectable,aria-roledescription
Listbox with Grouped Options class, prototype Yes ex 5 3 13 4 heading,presentation,aria-busy,aria-describedby,aria-disabled,aria-errormessage,aria-expanded,aria-keyshortcuts,aria-label,aria-multiselectable,aria-roledescription
Listboxes with Rearrangeable Options class, prototype Yes ex1 4 2 14 5 heading,toolbar,aria-busy,aria-describedby,aria-disabled,aria-errormessage,aria-expanded,aria-keyshortcuts,aria-label,aria-live,aria-roledescription
Scrollable Listbox class, prototype Yes ex 3 2 13 4 heading,aria-busy,aria-describedby,aria-disabled,aria-errormessage,aria-expanded,aria-keyshortcuts,aria-label,aria-multiselectable,aria-roledescription
Actions Menu Button Using aria-activedescendant class, prototype Yes Yes ex1 3 2 11 5 heading,aria-busy,aria-describedby,aria-errormessage,aria-hidden,aria-label,aria-roledescription
Actions Menu Button Using element.focus() class, prototype Yes Yes ex1 3 2 10 4 heading,aria-busy,aria-describedby,aria-errormessage,aria-hidden,aria-label,aria-roledescription
Navigation Menu Button class, prototype Yes Yes ex1 4 3 10 4 heading,aria-busy,aria-describedby,aria-errormessage,aria-hidden,aria-label,aria-roledescription
Editor Menubar class, prototype Yes Yes ex1 9 7 12 6 heading,none,aria-busy,aria-describedby,aria-errormessage,aria-labelledby,aria-orientation,aria-roledescription
Navigation Menubar class, prototype Yes Yes ex1 10 8 11 5 heading,separator,aria-busy,aria-describedby,aria-errormessage,aria-hidden,aria-orientation,aria-roledescription
Meter prototype Yes example 2 1 11 4 heading,aria-busy,aria-describedby,aria-errormessage,aria-expanded,aria-hidden,aria-label,aria-roledescription
Radio Group Using aria-activedescendant class, prototype Yes Yes ex1 3 2 10 3 heading,aria-busy,aria-describedby,aria-errormessage,aria-expanded,aria-hidden,aria-label,aria-roledescription
Rating Radio Group class, prototype Yes Yes ex1 4 3 9 3 heading,aria-busy,aria-describedby,aria-errormessage,aria-expanded,aria-hidden,aria-roledescription
Radio Group Using Roving tabindex class, prototype Yes Yes ex1 3 2 9 2 heading,aria-busy,aria-describedby,aria-errormessage,aria-expanded,aria-hidden,aria-label,aria-roledescription
Horizontal Multi-Thumb Slider class, prototype Yes Yes ex1 3 2 11 5 heading,aria-busy,aria-describedby,aria-errormessage,aria-expanded,aria-labelledby,aria-roledescription
Color Viewer Slider class, prototype Yes Yes ex1 3 2 11 5 heading,aria-busy,aria-describedby,aria-errormessage,aria-expanded,aria-label,aria-roledescription
Rating Slider class, prototype Yes Yes ex1 2 1 12 6 heading,aria-busy,aria-describedby,aria-errormessage,aria-expanded,aria-label,aria-roledescription
Media Seek Slider class, prototype Yes Yes ex1 3 2 12 6 heading,aria-busy,aria-describedby,aria-errormessage,aria-expanded,aria-label,aria-roledescription
Vertical Temperature Slider class, prototype Yes Yes ex1 3 2 13 7 heading,aria-busy,aria-describedby,aria-errormessage,aria-expanded,aria-label,aria-roledescription
Date Picker Spin Button prototype Yes Yes example 3 2 12 7 heading,aria-busy,aria-describedby,aria-errormessage,aria-expanded,aria-roledescription
Switch Using HTML Button class, prototype Yes Yes ex1 3 2 9 3 heading,aria-busy,aria-describedby,aria-errormessage,aria-expanded,aria-label,aria-roledescription
Switch Using HTML Checkbox Input class, prototype Yes Yes ex1 2 1 8 1 heading,aria-busy,aria-describedby,aria-errormessage,aria-expanded,aria-label,aria-labelledby,aria-roledescription
Switch class, prototype Yes Yes ex1 2 1 9 2 heading,aria-busy,aria-describedby,aria-errormessage,aria-expanded,aria-label,aria-labelledby,aria-roledescription
Sortable Table class, prototype Yes Yes ex1 1 0 9 2 heading,aria-busy,aria-describedby,aria-errormessage,aria-expanded,aria-label,aria-labelledby,aria-roledescription
Table prototype Yes ex1 6 5 8 2 heading,aria-busy,aria-errormessage,aria-expanded,aria-hidden,aria-labelledby,aria-roledescription
Tabs with Automatic Activation class, prototype Yes Yes ex1 4 3 10 3 heading,aria-busy,aria-describedby,aria-errormessage,aria-expanded,aria-hidden,aria-label,aria-roledescription
Tabs with Manual Activation class, prototype Yes Yes ex1 4 3 10 3 heading,aria-busy,aria-describedby,aria-errormessage,aria-expanded,aria-hidden,aria-label,aria-roledescription
Toolbar prototype Yes not found 1 0 8 0 heading,aria-busy,aria-describedby,aria-errormessage,aria-expanded,aria-hidden,aria-label,aria-labelledby,aria-roledescription
Toolbar prototype Yes Yes ex1 7 6 17 12 heading,aria-busy,aria-describedby,aria-errormessage,aria-labelledby,aria-roledescription
Treegrid Email Inbox prototype Yes Yes ex1 4 3 13 5 heading,aria-activedescendant,aria-busy,aria-current,aria-describedby,aria-errormessage,aria-hidden,aria-labelledby,aria-roledescription
File Directory Treeview Using Computed Properties prototype Yes Yes ex1 4 3 9 3 heading,aria-busy,aria-describedby,aria-errormessage,aria-hidden,aria-label,aria-roledescription
File Directory Treeview Using Declared Properties prototype Yes Yes ex1 4 3 12 6 heading,aria-busy,aria-describedby,aria-errormessage,aria-hidden,aria-label,aria-roledescription
Navigation Treeview class, prototype Yes Yes Yes ex1 9 8 10 5 heading,aria-busy,aria-describedby,aria-errormessage,aria-hidden,aria-roledescription

Graphics Techniques

Example SVG in HTML SVG in CSS SVG in JS forced-color-adjust CSS ::before CSS ::after CSS content
Alert Dialog Yes Yes
Breadcrumb Yes Yes
Button (IDL Version) Yes Yes Yes Yes
Button Yes Yes Yes Yes
Auto-Rotating Image Carousel with Buttons for Slide Control Yes Yes
Auto-Rotating Image Carousel with Tabs for Slide Control Yes Yes
Checkbox (Mixed-State) Yes Yes Yes
Checkbox (Two State) Yes Yes Yes
Editable Combobox With Both List and Inline Autocomplete Yes Yes
Editable Combobox With List Autocomplete Yes Yes
Editable Combobox without Autocomplete Yes Yes
Date Picker Combobox Yes Yes Yes
Select-Only Combobox Yes Yes
Date Picker Dialog Yes
Disclosure (Show/Hide) for Answers to Frequently Asked Questions Yes Yes Yes
Disclosure (Show/Hide) for Image Description Yes Yes Yes
Disclosure Navigation Menu with Top-Level Links Yes Yes
Disclosure Navigation Menu Yes Yes
Feed Display Yes Yes Yes
Advanced Data Grid Yes Yes
Data Grid Yes Yes
Layout Grid Yes Yes Yes
Link Yes Yes Yes
(Deprecated) Collapsible Dropdown Listbox Yes Yes Yes
Listbox with Grouped Options Yes Yes Yes
Listboxes with Rearrangeable Options Yes Yes Yes
Scrollable Listbox Yes Yes Yes
Actions Menu Button Using aria-activedescendant Yes Yes
Actions Menu Button Using element.focus() Yes Yes
Navigation Menu Button Yes Yes
Editor Menubar Yes Yes
Navigation Menubar Yes Yes Yes
Meter Yes
Radio Group Using aria-activedescendant Yes Yes Yes
Rating Radio Group Yes Yes Yes
Radio Group Using Roving tabindex Yes Yes Yes
Horizontal Multi-Thumb Slider Yes Yes Yes Yes
Color Viewer Slider Yes Yes Yes Yes
Rating Slider Yes Yes Yes Yes
Media Seek Slider Yes Yes Yes Yes
Vertical Temperature Slider Yes Yes Yes Yes
Date Picker Spin Button Yes Yes
Switch Using HTML Button Yes Yes Yes Yes
Sortable Table Yes Yes
Toolbar Yes Yes Yes Yes Yes
Treegrid Email Inbox Yes Yes Yes
File Directory Treeview Using Computed Properties Yes Yes
File Directory Treeview Using Declared Properties Yes Yes
Navigation Treeview Yes Yes

Mouse and Pointer Events

Example Mouse Events Pointer Events
Accordion Yes
Alert Yes
Alert Dialog Yes
Breadcrumb Yes
Button (IDL Version) Yes
Button Yes
Auto-Rotating Image Carousel with Buttons for Slide Control Yes Yes
Auto-Rotating Image Carousel with Tabs for Slide Control Yes Yes
Checkbox (Mixed-State) Yes
Checkbox (Two State) Yes
Editable Combobox With Both List and Inline Autocomplete Yes
Editable Combobox With List Autocomplete Yes
Editable Combobox without Autocomplete Yes
Date Picker Combobox Yes Yes
Select-Only Combobox Yes Yes
Editable Combobox with Grid Popup Yes
Date Picker Dialog Yes
Modal Dialog Yes
Disclosure (Show/Hide) for Answers to Frequently Asked Questions Yes
Disclosure (Show/Hide) for Image Description Yes
Disclosure Navigation Menu with Top-Level Links Yes
Disclosure Navigation Menu Yes
Feed Yes
Advanced Data Grid Yes
Data Grid Yes
Layout Grid Yes
Link Yes
(Deprecated) Collapsible Dropdown Listbox Yes Yes
Listbox with Grouped Options Yes Yes
Listboxes with Rearrangeable Options Yes Yes
Scrollable Listbox Yes Yes
Actions Menu Button Using aria-activedescendant Yes Yes
Actions Menu Button Using element.focus() Yes Yes
Navigation Menu Button Yes Yes
Editor Menubar Yes
Navigation Menubar Yes
Meter Yes
Radio Group Using aria-activedescendant Yes
Rating Radio Group Yes
Radio Group Using Roving tabindex Yes
Horizontal Multi-Thumb Slider Yes
Color Viewer Slider Yes
Rating Slider Yes
Media Seek Slider Yes
Vertical Temperature Slider Yes
Date Picker Spin Button Yes
Switch Using HTML Button Yes
Switch Using HTML Checkbox Input Yes
Switch Yes
Sortable Table Yes
Table Yes
Tabs with Automatic Activation Yes
Tabs with Manual Activation Yes
Toolbar Yes
Toolbar Yes Yes
Treegrid Email Inbox Yes
File Directory Treeview Using Computed Properties Yes Yes
File Directory Treeview Using Declared Properties Yes Yes
Navigation Treeview Yes Yes
Back to Top