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

datalist element (html)

Screen reader support level: partial (7/30)

Voice Control support level: supported

On this page

The datalist element represents a set of option elements that represent predefined options for other controls. It is attached to an input via the list attribute.

Expectations

What are expectations?

Screen Reader support by expectation

ExpectationJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
MUST convey an appropriate rolesome partial supportsupportedpartial (1/2)partialsupportednonenone
MUST convey the boundaries of the elementsome partial supportsupportednonesupportedpartialsupportednone
MUST convey that changes in suggestions were madenonesupportednonenonenonenonenone

Voice Control support by expectation

ExpectationDragon Naturally SpeakingVoice Access (Android)Voice Control (iOS)Voice Control (MacOS)Windows Speech Recognition
MUST convey an appropriate rolesupportednot applicablenot applicablenot applicablenot applicable

Expectation: convey an appropriate role

Rationale: A screen reader user needs to know how they can interact with the element. Voice control software might use the role to help users activate controls that do not have a visible name.

Strength of these expectations for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: MUST
Screen Reader support for 'MUST convey an appropriate role'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeIEFirefoxEdgeChromeFirefoxFirefoxChromeSafariSafari
HTML input with datalist testpartialnonenonesupportedsupportedpartialpartialsupportednonenone
Voice Control support for 'MUST convey an appropriate role'
TestDragon Naturally SpeakingVoice Access (Android)Voice Control (iOS)Voice Control (MacOS)Windows Speech Recognition
ChromeChromeSafariSafariChrome
HTML input with datalist testsupportednot applicablenot applicablenot applicablenot applicable

Expectation: convey the boundaries of the element

Rationale: A user needs to know when they enter and exit an element

Strength of these expectations for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA
Screen Reader support for 'MUST convey the boundaries of the element'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeIEFirefoxEdgeChromeFirefoxFirefoxChromeSafariSafari
HTML input with datalist testpartialnonenonesupportednonenonesupportedpartialsupportednone

Expectation: convey that changes in suggestions were made

Rationale: The user needs to know that the list of suggestions changed

Strength of these expectations for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA
Screen Reader support for 'MUST convey that changes in suggestions were made'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeIEFirefoxEdgeChromeFirefoxFirefoxChromeSafariSafari
HTML input with datalist testnonenonenonesupportednonenonenonenonenonenone

Related features

These are features that are usually used in combination with this feature.

list attribute (html)

DragonJAWSNarratorNVDAOrcaTalkBackVoice AccessVC iOSVC MacOSVoiceOver (iOS)VoiceOver (macOS)Speech Recognition
not applicablepartial (2/3)supportedsupportednonesupportednot applicablenot applicablenot applicablenonenonenot applicable

option element (html)

DragonJAWSNarratorNVDAOrcaTalkBackVoice AccessVC iOSVC MacOSVoiceOver (iOS)VoiceOver (macOS)Speech Recognition
partial (1/5)partial (8/15)partial (4/5)partial (7/10)partial (3/5)supportedsupportednonepartial (3/5)partial (4/5)partial (2/5)none

optgroup element (html)

DragonJAWSNarratorNVDAOrcaTalkBackVoice AccessVC iOSVC MacOSVoiceOver (iOS)VoiceOver (macOS)Speech Recognition
not applicablesome partial supportnonenonenonepartial (1/3)not applicablenot applicablenot applicablepartial (1/3)partial (1/3)not applicable