Skip to content

Structural Roles

Introduction

ARIA provides a set of roles that convey the accessibility semantics of structures on a page. These roles express the meaning that is conveyed by the layout and appearance of elements that organize and structure content, such as headings, lists, and tables.

some host languages, such as HTML, include elements that express the same semantics as an ARIA role. For instance, the HTML <p> element is mapped to accessibility APIs in exactly the same way as <div role="paragraph">. The ARIA and HTML specifications refer to this mapping of HTML elements to ARIA attributes as implied semantics, i.e., the implied ARIA role of the HTML <p> element is paragraph.

When developing HTML, it is important to use native HTML elements where ever possible. Do not use an ARIA role or property if it is possible to use an HTML element that has equivalent semantics. Circumstances where it is appropriate to use ARIA attributes instead of equivalent HTML are:

  1. When the HTML element cannot be styled in a way that meets visual design requirements.
  2. When testing reveals that browsers or assistive technologies provide better support for the ARIA equivalent.
  3. When remediating or retrofitting legacy content and altering the underlying DOM to use the HTML would be cost prohibitive.
  4. When building a web component to compose a custom element and the element being extended does not convey the appropriate or sufficient accessibility semantics.

The following table lists all structural roles defined in ARIA 1.2.

All Structural Roles

ARIA structural roles
ARIA Role HTML Equivalent
applicationNo equivalent element
articlearticle
blockquoteblockquote
captioncaption
celltd
codecode
columnheaderth
definitiondd
deletiondel
directoryNo equivalent element
documentNo equivalent element
emphasisem
feedNo equivalent element
figurefigure
genericdiv, span
groupNo equivalent element
heading with aria-level="N" where N is 1, 2, 3, 4, 5, or 6h1, h2, h3, h4, h5, h6
insertionins
imgimg
listul, ol
listitemli
mathNo equivalent element
noneNo equivalent element
noteNo equivalent element
presentationNo equivalent element
paragraphp
rowtr
rowgrouptbody, thead, tfoot
rowheaderth
separator (when not focusable)hr
strongstrong
subscriptsub
superscriptsup
tabletable
termdfn
timetime
toolbarNo equivalent element
tooltipNo equivalent element
Back to Top