ARIA Reference Guide

All Roles

  • alert
  • alert­dialog
  • app­li­ca­tion
  • arti­cle
  • banner
  • block­quote
  • button
  • cell
  • check­box
  • code
  • column­header
  • combo­box
  • com­ple­men­tary
  • con­tent­info
  • defi­ni­tion
  • del­etion
  • dialog
  • docu­ment
  • emph­asis
  • feed
  • figure
  • form
  • grid
  • grid­cell
  • group
  • heading
  • img
  • ins­ertion
  • link
  • list
  • list­box
  • list­item
  • log
  • main
  • mar­quee
  • math
  • menu
  • menu­bar
  • menu­item
  • menu­item­check­box
  • menu­item­radio
  • meter
  • navi­gation
  • none
  • note
  • option
  • para­graph
  • presen­tation
  • prog­ress­bar
  • radio
  • radio­group
  • region
  • row
  • row­group
  • row­header
  • scroll­bar
  • search
  • search­box
  • separ­ator
  • slider
  • spin­button
  • status
  • strong
  • sub­script
  • super­script
  • switch
  • tab
  • table
  • tab­list
  • tab­panel
  • term
  • text­box
  • time
  • tool­bar
  • tool­tip
  • tree
  • tree­grid
  • tree­item

The link role

WAI-ARIA spec(opens in new window)HTML-ARIA spec(opens in new window)

Semantics

An interactive reference to an internal or external resource that, when activated, causes the user agent to navigate to that resource.

Abstract Role

WidgetRepresents a focusable, interactive element.

Content Category

Phrasing ContentAn element that typically appears inline and provides semantic meaning to text content.

Allowed Descendants

Flow Children Allowed

No interactive content descendants, and no descendants with a tabindex attribute specified.

Usage

Elements that can designate the role in HTML:

  • a­[href]
  • button[role=link]
  • img[role=link]
  • span[role=link]
  • custom-element[role=link]