Indicates the element that represents the current item within a container or set of related elements.
Description

New in ARIA 1.1

Indicates the element that represents the current item within a container or set of related elements.

The aria-current attribute is an enumerated type. Any value not included in the list of allowed values SHOULD be treated by assistive technologies as if the value true had been provided. If the attribute is not present or its value is an empty string or undefined, the default value of false applies and the aria-current state MUST NOT be exposed by user agents or assistive technologies.

The aria-current attribute is used when an element within a set of related elements is visually styled to indicate it is the current item in the set. For example:

  • A page token used to indicate a link within a set of pagination links, where the link is visually styled to represent the currently-displayed page.
  • A step token used to indicate a link within a step indicator for a step-based process, where the link is visually styled to represent the current step.
  • A location token used to indicate the image that is visually highlighted as the current component of a flow chart.
  • A date token used to indicate the current date within a calendar.
  • A time token used to indicate the current time within a timetable.

Authors SHOULD only mark one element in a set of elements as current with aria-current.

Authors SHOULD NOT use the aria-current attribute as a substitute for aria-selected in widgets where aria-selected has the same meaning. For example, in a tablist, aria-selected is used on a tab to indicate the currently-displayed tabpanel.

Note: In some use cases for widgets that support aria-selected, current and selected can have different meanings and can both be used within the same set of elements. For example, aria-current="page" can be used in a navigation tree to indicate which page is currently displayed, while aria-selected="true" indicates which page will be displayed if the user activates the treeitem. Furthermore, the same tree may support operating on one or more selected pages (treeitems) by way of a context menu containing options such as "delete" and "move."

© 2018 Digital Accessibility Implementations Resources. All rights reserved.

Please publish modules in offcanvas position.