Skip to content
PHP Ecosystem
Explore

Role

enumUIAwesome\Html\Attribute\Values\Role
Backed bystring
Sourcesrc/Values/Role.php

Represents values for the HTML role global attribute.

See also: https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles.

CaseValueDescription
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.