Notice: This is a work in progress. Please submit feedback or suggestions.

aria-label attribute (aria)

Screen reader support level: partial (19/20)

Voice Control support level: supported

On this page

About this feature

Defines a string value that labels the current element. See related aria-labelledby.

Age of results

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

Failing and partial results are between a year ago and a year ago.

Expectations

What are expectations?

Screen Reader support by expectation

ExpectationJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeIEFirefoxEdgeChromeFirefoxFirefoxChromeSafariSafari
MUST contribute to the accessible namesupportedsupportedsupportedpartial (1/2)supportedsupportedsupportedsupportedsupportedsupported
SHOULD convey name changes when in focusnonenonenonesupportedsupportedsupportednonenonesupportedpartial

Voice Control support by expectation

ExpectationDragon Naturally SpeakingVoice Access (Android)Voice Control (iOS)Voice Control (MacOS)Windows Speech Recognition
ChromeChromeSafariSafariChrome
MUST contribute to the accessible namesupportedsupportedsupportedsupportedsupported

Expectation: contribute to the accessible name

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: MUST
Voice Control support for 'MUST contribute to the accessible name'
TestDragon Naturally SpeakingVoice Access (Android)Voice Control (iOS)Voice Control (MacOS)Windows Speech Recognition
ChromeChromeSafariSafariChrome
HTML section element with an accessible name (aria-label) applied to: section elementnot applicablenot applicablenot applicablenot applicablenot applicable
aria-label test applied to: button elementsupportedsupportedsupportedsupportedsupported

Expectation: convey name changes when in focus

Rationale:

The user needs to know that that the name of a control has changed after interacting with it. This may be to convey a new purpose or to convey a state change which is provided by the name.

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: SHOULD
  • Voice Control: NA

Notes:

This expectation is only for when the element with the attribute is focused by a screen reader (either keyboard focus or virtual focus). It is not meant to act like a live region.

Screen Reader support for 'SHOULD convey name changes when in focus'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeIEFirefoxEdgeChromeFirefoxFirefoxChromeSafariSafari
HTML button name change test applied to: button elementnonenonenonesupportedsupportedsupportednonenonesupportedpartial