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 search role

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

Semantics

A landmark region that contains a search facility.

Abstract Role

LandmarkRepresents a top-level section of a page, relevant to a specific purpose, that a user may want to scan for quickly and could appear in a site map or table of contents.

Content Category

Flow ContentAn element that structures and organizes the body of a web document.

Allowed Descendants

Flow Children Allowed

No main element descendants allowed.

Usage

Elements that can designate the role in HTML:

  • search
  • aside[role=search]
  • form[role=search]
  • section[role=search]
  • div[role=search]
  • custom-element[role=search]