
true = Represents the current item within a setĪria-current must never be used as a substitute for aria-selected where aria-selected is a required attribute for specific roles. time = Represents the current time within a set of times.
date = Represents the current date within a collection of dates. location = Represents the current location within an environment or context. step = Represents the current step within a process. page = Represents the current page within a set of pages. Otherwise, aria-current accepts a list of token values that convey the type of item being represented in the set. When set to “false”, “”, or the attribute is undefined, nothing is exposed to assistive technologies. The aria-current attribute is meant to convey to an assistive technology that this is the current item within an associated collection of elements. Does not represent the current item within a set. Represents the current item within a set. Represents the current time within a set of times. Represents the current date within a collection of dates. Represents the current location within an environment or context. Represents the current step within a process. Represents the current page within a set of pages. An explicit value of undefined for this type is the equivalent of providing no value. Screen Reader Support For aria-current Expectation 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.” Browser Compatibility For aria-current 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.
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, in a tablist, aria-selected is used on a tab to indicate the currently-displayed tabpanel. A time token used to indicate the current time within a timetable.Īuthors SHOULD only mark one element in a set of elements as current with aria-current.Īuthors SHOULD NOT use the aria-current attribute as a substitute for aria-selected in widgets where aria-selected has the same meaning.A date token used to indicate the current date within a calendar.A location token used to indicate the image that is visually highlighted as the current component of a flow chart.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 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.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.
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. Any value not included in the list of allowed values SHOULD be treated by assistive technologies as if the value true had been provided. The aria-current attribute is an enumerated type. Indicates the element that represents the current item within a container or set of related elements.