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

Screen Reader support level: partial (19/22)

Voice Control support level: unknown

On this page

About this feature

Defines a short hint (a word or short phrase) intended to aid the user with data entry when the control has no value. A hint could be a sample value or a brief description of the expected format.

Age of results

Results across all tests for this feature range from 2 years ago to 2 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 2 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 aria-placeholder for text field with no valuesupportedsupportedsupportedsupportedsupportedsupportedsupportedunknownsupportedsupportedsupported
MUST NOT convey aria-placeholder when (HTML attribute) placeholder is definedsupportedsupportednonesupportedsupportedsupportedsupportedunknownsupportedsupportedsupported
SHOULD contribute to the accessible namesupportedsupportedsupportedsupportedsupportedsupportedsupportedunknownsupportedsupportedsupported
MAY convey aria-placeholder for text field with valuenonenonenonesupportednonenonenoneunknownsupportednonenone

Voice Control support by expectation

ExpectationDragon Naturally SpeakingVoice Access (Android)Voice Control (iOS)Voice Control (MacOS)Windows Speech RecognitionWindows Voice Access
ChromeChromeSafariSafariEdgeChromeEdgeChrome
SHOULD contribute to the accessible nameunknownsupportedsupportednoneunknownunknownunknownunknown

Expectation: convey aria-placeholder for text field with no value

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA

Examples:

  • Screen readers announce aria-placeholder when a labelled, empty text field receives focus
Screen Reader support for 'MUST convey aria-placeholder for text field with no value'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
aria-placeholder test applied to: input[type="text"] elementsupportedsupportedsupportedsupportedsupportedsupportedsupportedunknownsupportedsupportedsupported

Expectation: convey aria-placeholder when (HTML attribute) placeholder is defined

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MUST NOT
  • Voice Control: NA

Examples:

  • Screen reader should ignore aria-placeholder if placeholder (HTML attribute) has also been defined
Screen Reader support for 'MUST NOT convey aria-placeholder when (HTML attribute) placeholder is defined'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
aria-placeholder test applied to: input[type="text"] elementsupportedsupportednonesupportedsupportedsupportedsupportedunknownsupportedsupportedsupported

Expectation: contribute to the accessible name

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: SHOULD
  • Voice Control: SHOULD

Examples:

  • Screen readers should use aria-placeholder as the field name when no other labelling method is applied
  • Speech interfaces should use aria-placeholder to identify / activate a field when no other labelling method is applied
Screen Reader support for 'SHOULD contribute to the accessible name'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
aria-placeholder test applied to: input[type="text"] elementsupportedsupportedsupportedsupportedsupportedsupportedsupportedunknownsupportedsupportedsupported
Voice Control support for 'SHOULD contribute to the accessible name'
TestDragon Naturally SpeakingVoice Access (Android)Voice Control (iOS)Voice Control (MacOS)Windows Speech RecognitionWindows Voice Access
ChromeChromeSafariSafariEdgeChromeEdgeChrome
aria-placeholder test applied to: input[type="text"] elementunknownsupportedsupportednoneunknownunknownunknownunknown

Expectation: convey aria-placeholder for text field with value

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MAY
  • Voice Control: NA

Examples:

  • Screen readers may announce aria-placeholder when a labelled text field that contains a value receives focus
Screen Reader support for 'MAY convey aria-placeholder for text field with value'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
aria-placeholder test applied to: input[type="text"] elementnonenonenonesupportednonenonenoneunknownsupportednonenone
TestLast update
aria-placeholder test2021-11-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