dl element (description list)

Description list element. See the related dt element and the dd element for more information.

Estimated Support About

41.67% + 33.33% = 75.0%

JAWS

Chrome

92

Edge

92

IE

11.134

Firefox

80

Narrator

Edge

85
1 2 3

NVDA

Chrome

92
4 5

Edge

92

Firefox

80
4 5

Orca

Firefox

80
1 2 3

TalkBack

Android

85
1 2 3

VoiceOver (iOS)

iOS

14
3

VoiceOver (MacOS)

Safari

14.0

Dragon Naturally Speaking

Voice Access (Android)

Voice Control (iOS)

Voice Control (MacOS)

Windows Speech Recognition

Notes

The dl element and its associated dt and dd elements have poor to non-existent support. If it is critically important to convey relationships between terms and descriptions and the values of the two can be confused with each other (think a matching list of colors such as “red: blue”, consider another approach such as a table or headings. It is often possible for a user to determine which text is a key and which text is a value just based upon the text alone. If this is the case for your implementation, it might be fine to use a dl element and hope for better support in the future.

  • 1

    Didn’t convey its role

  • 2

    Didn’t convey the boundaries of the element

  • 3

    Didn’t convey the number of items in the list

  • 4

    HTML basic description list test: Conveyed as a list, but not a description list.

  • 5

    HTML description list with wrapped groups test: Conveyed as a list, but not a description list.

Resources

Know something we don't?

Is any of the above data outdated? Or do you want to add a new software combination to the list? Heads on to GitHub and edit the data file!

Edit this page on GitHub Report an issue on GitHub

Not comfortable with GitHub? Send us an email or get in touch on Twitter.

Test it yourself

This feature was last tested on September 05, 2018.

If you want to test this feature in the same conditions as we did, you can get our test code and run a test by yourself. Make sure to follow our testing recommendations first.

View the test code