In JavaScript, the ariaCurrent property of Element reflects the aria-current attribute, which marks the current item within a container or set of related elements (MDN).
Read the notes below before you get or set this property. Prefer feature detection when support is limited.
Use el.ariaCurrent. Start with this line.
el.ariaCurrent| Call | What it does |
|---|---|
el.ariaCurrent | Primary signature. |
Built into the browser. Read or assign el.ariaCurrent — no import required.
el.ariaCurrent| Parameter | Description |
|---|---|
| Single current | Required. Only one item in the set should be current |
| "false" / remove | Optional. Not exposed as current to the user |
| Return Value | Description |
|---|---|
| * | The current value of el.ariaCurrent. |
ariaCurrentMDN-style nav link: read the reflected current-page token.
const el = document.getElementById("link-home");
console.log(el.ariaCurrent); // "page"ariaCurrent. Returns the token string."page" for site navigation.Update the token from script (keep documented values).
const el = document.getElementById("link-home");
console.log(el.ariaCurrent); // "page"
el.ariaCurrent = "true";
console.log(el.ariaCurrent); // "true""true").Clear the old current item, then mark the new one.
const home = document.getElementById("link-home");
const about = document.getElementById("link-about");
home.ariaCurrent = "false";
about.ariaCurrent = "page";
console.log(home.ariaCurrent); // "false"
console.log(about.ariaCurrent); // "page""false" (or remove the attribute)."page" (or another fit token).Element.ariaCurrent is Baseline Widely available (MDN: across browsers since October 2023). It is not Deprecated, Experimental, or Non-standard.
Reflects aria-current as a string token for the current page, step, location, date, time, or generic item in a set.
Bottom line: Safe for modern apps. Use specific tokens, keep one current item per set, and use ariaSelected for tabs.
Learn the Element property that reflects aria-describedby as element references.
10 people found this page helpful