이 번역은 완료되지 않았습니다. 이 문서를 번역해 주세요.
This page lists reference pages covering all the WAI-ARIA roles discussed on MDN. For a full list of roles, see Using ARIA: Roles, States, and Properties
- ARIA: alert role
- The alert role should be used to tell the user that an element has been dynamically updated. Screen readers will instantly start reading out the updated content when the role is added. If the user is expected to close the alert, then the alertdialog role should be used instead.
- ARIA: Application Role
- The application role indicates to assistive technologies that this element and all of its children should be treated similar to a desktop application, and no traditional HTML interpretation techniques should be used. This is being used in very dynamic and desktop-like web applications only.
- ARIA: Article Role
- The article role indicates a section of a page that could easily stand on its own on a page, in a document, or on a web site. It is usually set on related content items such as comments, forum posts, news paper articles or other items grouped together on one page.
- ARIA: button role
- The button role should be used for clickable elements that trigger a response when activated by the user. On its own,
role="button"can make any element (e.g.
<div>) appear as a button control to a screen reader. This role can be used in combination with the
aria-pressedattribute to create toggle buttons.
- ARIA: Cell Role
cellvalue of the ARIA role attribute identifies an element as being a cell in a tabular container that does not contain column or row header information. To be supported, the cell must nested in an element with the role of
- ARIA: checkbox role
- The checkbox role is used for checkable interactive controls. If an element uses
role="checkbox"it is required for that element to also have the
aria-checkedattribute that exposes the checkbox's state to assistive technology.
- ARIA: Contentinfo role
contentinfolandmark role is used to identify information repeated at the end of every page of a website, including copyright information, navigation links, and privacy statements. This section is commonly called a footer.
- ARIA: dialog role
dialogrole is used to mark up an HTML based application dialog or window that separates content or UI from the rest of the web application or page. Dialogs are generally placed on top of the rest of the page content using an overlay. Dialogs can be either non-modal (it's still possible to interact with content outside of the dialog) or modal (only the content in the dialog can be interacted with).
- ARIA: document
- The document role indicates to an assistive technology which has a reading or browse mode, that it should use that mode to read the content contained within this element. Use this in complex composit widgets to allow users of assistive technologies to easily read static text.
- ARIA: feed
- The summary paragraph — start by naming the role or attribute and saying what it does. This should ideally be 1 or 2 short sentences. This content will appear as a tool tip on links to this page, so craft it well.
- ARIA: Figure
- The ARIA
figurerole can be used to identify a figure inside page content where appropriate semantics do not already exist. A figure is generally considered to be one or more images, code snippets, or other content that puts across information in a different way to a regular flow of text.
- ARIA: Form
formlandmark role can be used to identify a group of elements on a page that provide equivalent functionality to an HTML form.
- ARIA: grid role
- The grid role is for a widget that contains one or more rows of cells. The position of each cell is significant and can be focused using keyboard input.
- ARIA: heading
- The heading role defines this element as a heading to a page or section. To give the page more structure, a level should also be provided to indicate relationships between sections.
- ARIA: Img
- The ARIA
imgrole can be used to identify multiple elements inside page content that should be considered as a single image. These elements could be images, code snippets, text, or other content that can be combined to deliver information in a visual manner.
- ARIA: List role
- The ARIA
listrole can be used to identify a list of items. It is normally used in conjunction with the
listitemrole, which is used to identify a list item contained inside the list.
- ARIA: Listitem role
- The ARIA
listitemrole can be used to identify an item inside a list of items. It is normally used in conjunction with the
listrole, which is used to identify a list container.
- ARIA: Main role
mainlandmark role is used to indicate the primary content of a document. The main content area consists of content that is directly related to or expands upon the central topic of a document, or the central functionality of an application.
- ARIA: Navigation Role
navigationlandmark role is used to identify major groups of links used for navigating through a website or page conrent.
- ARIA: Region role
regionlandmark role is used to identify an area in the document that the author has identified as significant. It is used to provide a generic landmark for people to be able to navigate to easily when none of the other landmark roles are appropriate.
- ARIA: row role
- An element with
role="row"is a row of cells within a tabular structure. A row contains one or more cells, grid cells, column headers, or row headers within a
treegrid, and optionally within a
- ARIA: rowgroup role
- A structure containing one or more row elements in a grid or table container.
- ARIA: Search role
searchlandmark role is used to identify a section of the page used to search the page, site, or collection of sites.
- ARIA: switch role
- The ARIA
switchrole is functionally identical to the
checkboxrole, except that instead of representing "checked" and "unchecked" states, which are fairly generic in meaning, the
switchrole represents the states "on" and "off."
- ARIA: Tab Role
- The ARIA tab role indicates an interactive element that, when activated, displays its associated tab panel.
- ARIA: table role
- The table value of the ARIA role attribute identifies the element containing the role as having a non-interactive table structure containing data arranged in rows and columns, similar to the native
- ARIA: textbox role
textboxrole is used to identify an element that allows the input of free-form text.
Please claim the role you want to work on by adding your name after the role's name: (old pages are linked from https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques). Ones for which the first draft is completed have been removed from the below list.
- Columnheader (Estelle)
- Gridcell (Eric E)
- Link - old page
- Log - old page
- Progressbar - old page
- Radio - old page
- Slider - old page
- Status - old page
- tablist (Michiel)
- Tabpanel (Michiel)