Important: This website does not attempt to establish a standard for how assistive technologies must behave. Read the FAQ for more information. Additionally, this is a work in progress. Please submit feedback or suggestions.

aria-current attribute (aria)

Screen Reader support level: partial (53/66)

On this page

About this feature

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

Age of results

Results across all tests for this feature range from a year ago to 5 years ago. Detailed dates and version information can be found in associated tests.

Caution

Failing or partial results may be out of date. The oldest result is from 5 years ago. Consider running the associated tests and contributing results.

Expectations

What are expectations?

Screen Reader support by expectation

ExpectationJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
MUST convey the "date" valuesupportedsupportedsupportednonesupportedsupportedsupportednonesupportedsupportedsupported
MUST convey the "location" valuesupportedsupportedsupportednonesupportedsupportedsupportednonesupportedsupportedsupported
MUST convey the "page" valuesupportedsupportedsupportednonesupportedsupportedsupportednonesupportedsupportedsupported
MUST convey the "step" valuesupportedsupportedsupportednonesupportedsupportedsupportednonesupportedsupportedsupported
MUST convey the "time" valuesupportedsupportedsupportednonesupportedsupportedsupportednonenonesupportedsupported
MUST convey the "true" valuesupportedsupportedsupportednonesupportedsupportedsupportednonesupportedsupportedsupported
SHOULD convey when the state is addednonenonenonenonesupportedsupportedsupportednonenonesupportednone

Expectation: convey the "date" value

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA
Screen Reader support for 'MUST convey the "date" value'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
aria-current attribute applied to: td elementsupportedsupportedsupportednonesupportedsupportedsupportednonesupportedsupportedsupported

Expectation: convey the "location" value

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA
Screen Reader support for 'MUST convey the "location" value'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
aria-current attribute applied to: hyperlink elementsupportedsupportedsupportednonesupportedsupportedsupportednonesupportedsupportedsupported

Expectation: convey the "page" value

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA
Screen Reader support for 'MUST convey the "page" value'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
aria-current attribute applied to: hyperlink elementsupportedsupportedsupportednonesupportedsupportedsupportednonesupportedsupportedsupported

Expectation: convey the "step" value

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA
Screen Reader support for 'MUST convey the "step" value'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
aria-current attribute applied to: hyperlink elementsupportedsupportedsupportednonesupportedsupportedsupportednonesupportedsupportedsupported

Expectation: convey the "time" value

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA
Screen Reader support for 'MUST convey the "time" value'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
aria-current attribute applied to: li elementsupportedsupportedsupportednonesupportedsupportedsupportednonenonesupportedsupported

Expectation: convey the "true" value

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA
Screen Reader support for 'MUST convey the "true" value'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
aria-current attribute applied to: hyperlink elementsupportedsupportedsupportednonesupportedsupportedsupportednonesupportedsupportedsupported

Expectation: convey when the state is added

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: SHOULD
  • Voice Control: NA

Examples:

  • If focus is on a link that becomes the current link upon activation, then the screen reader should announce the new current state (this can be helpful in the context of a single-page-application).
Screen Reader support for 'SHOULD convey when the state is added'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
aria-current change test applied to: placeholder link elementnonenonenonenonesupportedsupportedsupportednonenonesupportednone
TestLast update
aria-current change test2023-03-04
aria-current attribute2021-11-19

Is something not right?

We use our GitHub repository to manage our issue tracking. Please provide as much information as you can for issues, and please leave the id in the issue title intact.

Create an issue for this feature