Role
API reference › HTML Attribute › Values › Role
Represents values for the HTML role global attribute.
See also: https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles.
| Case | Value | Description |
|---|---|---|
ALERT | 'alert' | Alert role (alert). For important, usually time-sensitive information (atomic live region). |
ALERT_DIALOG | 'alertdialog' | Alertdialog role (alertdialog). Modal alert dialog that requires a response. |
APPLICATION | 'application' | Application role (application). Indicates an application-like region. |
ARTICLE | 'article' | Article role (article). Section of a page that could stand alone. |
ASSOCIATIONLIST | 'associationlist' | Association list role (associationlist). Structural role included for completeness. |
ASSOCIATIONLISTITEMKEY | 'associationlistitemkey' | Association list item key role (associationlistitemkey). Structural role (completeness). |
ASSOCIATIONLISTITEMVALUE | 'associationlistitemvalue' | Association list item value role (associationlistitemvalue). Structural role (completeness). |
BANNER | 'banner' | Banner role (banner). Global site header landmark. |
BLOCKQUOTE | 'blockquote' | Blockquote role (blockquote). Structural role for quoted sections (reference). |
BUTTON | 'button' | Button role (button). Clickable element that triggers a response. |
CAPTION | 'caption' | Caption role (caption). Structural role for captions. |
CELL | 'cell' | Cell role (cell). A cell in a tabular container (like td). |
CHECKBOX | 'checkbox' | Checkbox role (checkbox). Checkable interactive control. |
CODE | 'code' | Code role (code). Structural role for code fragments. |
COLUMN_HEADER | 'columnheader' | Columnheader role (columnheader). Header cell for a column (like th scope=“col”). |
COMBOBOX | 'combobox' | Combobox role (combobox). An input or button that controls a popup (listbox/grid). |
COMMAND | 'command' | Command role (command). Abstract role for widgets that perform an action. |
COMMENT | 'comment' | Comment role (comment). Denotes a comment or reaction. |
COMPLEMENTARY | 'complementary' | Complementary role (complementary). Supporting section (sidebar/aside). |
COMPOSITE | 'composite' | Composite role (composite). Abstract role for widgets that contain navigable descendants. |
CONTENTINFO | 'contentinfo' | Contentinfo role (contentinfo). Footer-like landmark (document footer). |
DEFINITION | 'definition' | Definition role (definition). Indicates a definition of a term or concept. |
DELETION | 'deletion' | Deletion role (deletion). Structural role for deletions. |
DIALOG | 'dialog' | Dialog role (dialog). Application dialog or window overlay. |
DIRECTORY | 'directory' | Directory role (directory). List of references to members of a group. |
DOCUMENT | 'document' | Document role (document). Focusable reading region within complex widgets or apps. |
EMPHASIS | 'emphasis' | Emphasis role (emphasis). Structural role for emphasized text. |
FEED | 'feed' | Feed role (feed). Dynamic, scrollable list of articles. |
FIGURE | 'figure' | Figure role (figure). Identifies a figure when native semantics are not available. |
FORM | 'form' | Form role (form). Identifies a group of elements equivalent to an HTML form. |
GENERIC | 'generic' | Generic role (generic). A nameless container with no semantic meaning. |
GRID | 'grid' | Grid role (grid). Widget containing rows of cells where position matters. |
GRIDCELL | 'gridcell' | Gridcell role (gridcell). A cell in a grid or treegrid, akin to td. |
GROUP | 'group' | Group role (group). Identifies a set of UI objects not intended for summaries. |
HEADING | 'heading' | Heading role (heading). Defines a heading with an aria-level. |
IMG | 'img' | Img role (img). Identifies content that should be considered a single image. |
INPUT | 'input' | Input role (input). Abstract role for widgets that accept user input. |
INSERTION | 'insertion' | Insertion role (insertion). Structural role for insertions. |
LANDMARK | 'landmark' | Landmark abstract role (landmark). Abstract superclass for landmark roles. |
LINK | 'link' | Link role (link). Interactive reference to a resource. |
LIST | 'list' | List role (list). Container for a set of items (used with listitem). |
LISTBOX | 'listbox' | Listbox role (listbox). Selectable list of items (may contain images). |
LISTITEM | 'listitem' | Listitem role (listitem). Item inside a list container. |
LOG | 'log' | Log role (log). Live region where new information is added in order. |
MAIN | 'main' | Main role (main). Primary content of a document. |
MARK | 'mark' | Mark role (mark). Denotes marked or highlighted content. |
MARQUEE | 'marquee' | Marquee role (marquee). A live region with frequently changing non-essential info. |
MATH | 'math' | Math role (math). Indicates the content is a mathematical expression. |
MENU | 'menu' | Menu role (menu). Composite widget offering a list of choices. |
MENUBAR | 'menubar' | Menubar role (menubar). Presentation of menu usually horizontal and visible. |
MENUITEM | 'menuitem' | Menuitem role (menuitem). An option in a menu or menubar. |
MENUITEM_CHECKBOX | 'menuitemcheckbox' | Menuitemcheckbox role (menuitemcheckbox). A checkable menuitem. |
MENUITEM_RADIO | 'menuitemradio' | Menuitemradio role (menuitemradio). A radio-like menuitem where only one can be checked. |
METER | 'meter' | Meter role (meter). Identifies an element being used as a meter. |
NAVIGATION | 'navigation' | Navigation role (navigation). Landmark for major groups of navigation links. |
NONE | 'none' | None role (none). Synonym for presentation, removes implicit semantics. |
NOTE | 'note' | Note role (note). Section with ancillary or parenthetic content. |
OPTION | 'option' | Option role (option). Selectable item in a listbox. |
PARAGRAPH | 'paragraph' | Paragraph role (paragraph). Structural role for paragraphs. |
PRESENTATION | 'presentation' | Presentation role (presentation). Removes element’s implicit ARIA semantics. |
PROGRESSBAR | 'progressbar' | Progressbar role (progressbar). Displays progress status for long tasks. |
RADIO | 'radio' | Radio role (radio). A member of a set of checkable radio buttons. |
RADIOGROUP | 'radiogroup' | Radiogroup role (radiogroup). Grouping of radio buttons. |
RANGE | 'range' | Range abstract role (range). Generic structure role representing a range. |
REGION | 'region' | Region role (region). Landmark for significant document areas. |
ROLETYPE | 'roletype' | Roletype abstract role (roletype). Base role from which others inherit. |
ROW | 'row' | Row role (row). Row of cells within tabular structures. |
ROWGROUP | 'rowgroup' | Rowgroup role (rowgroup). Group of rows within a tabular structure. |
ROWHEADER | 'rowheader' | Rowheader role (rowheader). Header cell for a row (like th scope=“row”). |
SCROLLBAR | 'scrollbar' | Scrollbar role (scrollbar). Graphical object controlling scrolling. |
SEARCH | 'search' | Search role (search). Landmark for search functionality. |
SEARCHBOX | 'searchbox' | Searchbox role (searchbox). Textbox intended for specifying search criteria. |
SECTION | 'section' | Section abstract role (section). Superclass for renderable structural containment. |
SECTIONHEAD | 'sectionhead' | Sectionhead role (sectionhead). Abstract superclass for labels/summaries of sections. |
SELECT | 'select' | Select abstract role (select). Superclass for form widgets that allow selection. |
SEPARATOR | 'separator' | Separator role (separator). Divider that separates sections or groups of menuitems. |
SLIDER | 'slider' | Slider role (slider). Input where user selects a value from a range. |
SPINBUTTON | 'spinbutton' | Spinbutton role (spinbutton). Range-like widget with discrete choices. |
STATUS | 'status' | Status role (status). Advisory live region not as important as alert. |
STRONG | 'strong' | Strong role (strong). Structural role indicating strong importance. |
STRUCTURE | 'structure' | Structure abstract role (structure). For document structural elements. |
SUBSCRIPT | 'subscript' | Subscript role (subscript). Structural role for subscript text. |
SUGGESTION | 'suggestion' | Suggestion role (suggestion). Denotes a proposed change in an editable document. |
SUPERSCRIPT | 'superscript' | Superscript role (superscript). Structural role for superscript text. |
SWITCH | 'switch' | Switch role (switch). Functionally like checkbox but represents on/off. |
TAB | 'tab' | Tab role (tab). Interactive element inside a tablist. |
TABLIST | 'tablist' | Tablist role (tablist). Container for a set of tab elements. |
TABPANEL | 'tabpanel' | Tabpanel role (tabpanel). Container for layered content associated with a tab. |
TERM | 'term' | Term role (term). A word or phrase with an optional corresponding definition. |
TEXTBOX | 'textbox' | Textbox role (textbox). Allows input of free-form text. |
TIME | 'time' | Time role (time). Structural role for time elements. |
TIMER | 'timer' | Timer role (timer). Numerical counter with implicit aria-live of off. |
TOOLBAR | 'toolbar' | Toolbar role (toolbar). Container of commonly used function buttons or controls. |
TOOLTIP | 'tooltip' | Tooltip role (tooltip). Contextual text bubble that appears on hover or focus. |
TREE | 'tree' | Tree role (tree). Widget for selecting items from a hierarchical collection. |
TREEGRID | 'treegrid' | Treegrid role (treegrid). Grid whose rows can be expanded/collapsed like a tree. |
TREEITEM | 'treeitem' | Treeitem role (treeitem). An item in a tree. |
WIDGET | 'widget' | Widget abstract role (widget). Interactive component of a GUI (abstract). |
WINDOW | 'window' | Window role (window). Defines a browser or app window. |