The ariaCurrent property of the Element interface reflects the value of the aria-current attribute, which indicates the element that represents the current item within a container or set of related elements.


var ariaCurrent = element.ariaCurrent;
element.ariaCurrent = ariaCurrent


A DOMString with one of the following values:

Represents the current page within a set of pages.
Represents the current step within a process.
Represents the current location, for example the current page in a breadcrumbs hierarchy.
Represents the current date within a collection of dates.
Represents the current time within a set of times.
Represents the current item within a set.
Does not represent the current item within a set.


In this example a set of links are used for site navigation. The aria-current attribute indicates the current page. The value page is incorporated into the screenreader announcement. Using ariaCurrent we can update that value.

    <li><a id="link-home" href="/" aria-current="page">Home</a></li>
    <li><a href="/">About</a></li>
    <li><a href="/">Contact</a></li>
let el = document.getElementById('link-home');
console.log(el.ariaCurrent); // "page"
el.ariaCurrent = "tab"
console.log(el.ariaCurrent); // "tab"


Specification Status Comment
Accessible Rich Internet Applications (WAI-ARIA) 1.2
The definition of 'ariaCurrent' in that specification.
Working Draft Initial definition.

Browser compatibility

BCD tables only load in the browser

See also