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-labelledby attribute (aria)

Screen Reader support level: partial (31/33)

Voice Control support level: partial (10/18)

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 3 years 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 contribute to the accessible namesupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedpartial (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 RecognitionWindows Voice Access
ChromeChromeSafariSafariEdgeChromeEdgeChrome
MUST contribute to the accessible namenonesupportedsupportedsupportedsupportedsupportedunknownunknown

Expectation: contribute to the accessible name

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: MUST
Screen Reader support for 'MUST contribute to the accessible name'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
APG 1.1 Checkbox Example (Two State) applied to: group rolesupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportednonenonesupported
aria-labelledby with one reference test applied to: button elementsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupported
aria-labellledby with two references test applied to: button elementsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupported
Voice Control support for 'MUST contribute to the accessible name'
TestDragon Naturally SpeakingVoice Access (Android)Voice Control (iOS)Voice Control (MacOS)Windows Speech RecognitionWindows Voice Access
ChromeChromeSafariSafariEdgeChromeEdgeChrome
APG 1.1 Checkbox Example (Two State) applied to: group rolenot applicablenot applicablenot applicablenot applicablenot applicablenot applicableunknownunknown
aria-labelledby with one reference test applied to: button elementnonesupportedsupportedsupportedsupportedsupportedunknownunknown
aria-labellledby with two references test applied to: button elementnonesupportedsupportedsupportedsupportedsupportedunknownunknown

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
TestLast update
APG 1.1 Checkbox Example (Two State)2021-08-07
aria-labelledby with one reference test2021-07-28
aria-labellledby with two references test2021-07-28
HTML button name change test2021-07-30

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