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

aria-placeholder attribute (aria)

Screen reader support level: partial (19/23)

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 6 months ago to 6 months ago. Detailed dates and version information can be found in associated tests.

Failing and partial results are between 6 months ago and 6 months ago.

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 Recognition
ChromeChromeSafariSafariChrome
SHOULD contribute to the accessible nameunknownsupportedsupportednoneunknown

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 Recognition
ChromeChromeSafariSafariChrome
aria-placeholder test applied to: input[type="text"] elementunknownsupportedsupportednoneunknown

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