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

aria-labelledby attribute (aria)

Screen reader support level: partial (35/40)

Voice Control support level: partial (8/11)

On this page

About this feature

Identifies the element (or elements) that labels the current element. See related aria-describedby.

Age of results

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

Failing and partial results are between 2 years ago and 2 years ago.

Expectations

What are expectations?

Screen Reader support by expectation

ExpectationJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
MUST contribute to the accessible namesupportedsupportedsupportedpartial (1/3)supportedsupportedsupportedsupportedpartial (2/3)partial (2/3)supported
SHOULD convey name changes when in focusnonenonenonesupportedsupportedsupportednonenonenonesupportedpartial

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 namenonesupportedsupportedsupportedsupported

Expectation: contribute to the accessible name

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: MUST

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)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
HTML button name change test applied to: button element; references: button elementnonenonenonesupportedsupportedsupportednonenonenonesupportedpartial