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

dd element (html)

Screen reader support level: partial (4/40)

Voice Control support level: not applicable

On this page

About this feature

Description list - description element. See the dl element for more information.

Age of results

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

Failing and partial results are between a year ago and a year ago.

Expectations

What are expectations?

Screen Reader support by expectation

ExpectationJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeIEFirefoxEdgeChromeFirefoxFirefoxChromeSafariSafari
MUST convey its rolenonenonenonenonenonenonenonepartialsupportednone
MUST convey the position in set informationnonenonenonenonenonenonenonenonenonesupported

Voice Control support by expectation

ExpectationDragon Naturally SpeakingVoice Access (Android)Voice Control (iOS)Voice Control (MacOS)Windows Speech Recognition
ChromeChromeSafariSafariChrome
Not applicable

Expectation: convey its role

Rationale:

A user needs to be able to distinguish between a description term and its description.

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA

Examples:

  • A screen reader might announce an element as something like "<name>, <role>"
  • A screen reader might imply the role by the presence of certain context roles
  • Voice Control software might let the user say something like "click, <role>".
  • Voice Control software might let the user say something like "show numbers", and interactive roles will be flagged with numbers.
Screen Reader support for 'MUST convey its role'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeIEFirefoxEdgeChromeFirefoxFirefoxChromeSafariSafari
HTML basic description list testnonenonenonenonenonenonenonepartialsupportednone
HTML description list with wrapped groups testnonenonenonenonenonenonenonepartialsupportednone

Expectation: convey the position in set information

Rationale:

A user needs to where the position is in the list

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA

Examples:

  • A screen reader might convey the position of each item in the list as something like "x of y" where y is the number of items in the list.
  • A screen reader might convey each term and description pair as a single item, or as separate items. For example, a screen reader might convey the size of a list of 3 pairs as either 3 or 6.
Screen Reader support for 'MUST convey the position in set information'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeIEFirefoxEdgeChromeFirefoxFirefoxChromeSafariSafari
HTML basic description list testnonenonenonenonenonenonenonenonenonesupported
HTML description list with wrapped groups testnonenonenonenonenonenonenonenonenonesupported

Related features

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

dl element (description list) (html)

DragonJAWSNarratorNVDAOrcaTalkBackVoice AccessVC iOSVC MacOSVoiceOver (iOS)VoiceOver (macOS)Speech Recognition
not applicablesupportednonepartial (8/12)nonenonenot applicablenot applicablenot applicablepartial (4/6)supportednot applicable

dt element (html)

DragonJAWSNarratorNVDAOrcaTalkBackVoice AccessVC iOSVC MacOSVoiceOver (iOS)VoiceOver (macOS)Speech Recognition
not applicablenonenonesome partial supportnonenonenot applicablenot applicablenot applicablepartial (2/4)partial (2/4)not applicable