Skip to content

Conversation

@kosamari
Copy link
Contributor

This PR adds description list as a feature.

Note: in draft features for HTML, this was labled as dd element, so I hanged name and file name as well.

@github-actions github-actions bot added the feature definition Creating or defining new features or groups of features. label Jul 11, 2024
@kosamari kosamari closed this Jul 11, 2024
@kosamari kosamari reopened this Jul 11, 2024
name: <dd>
description: The `<dd>` element TODO.
name: Description list
description: Elements to represent a description list.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
description: Elements to represent a description list.
description: The `<dl>`, `<dt>`, and `<dd>` elements create a list of terms and their associated descriptions. Use a description list to to create glossaries or other similar key-value pair lists.

Just a suggestion to make it more straightforward to understand. Not completely set on it though.

One more thing to consider: accessibility doesn't seem to be the best with DL. See https://adrianroselli.com/2022/12/brief-note-on-description-list-support.html and https://developer.mozilla.org/en-US/docs/Web/HTML/Element/dl#accessibility
In particular, it looks like keyboard navigation isn't supported everywhere.

Baseline currently doesn't cover assistive tech (see https://github.com/web-platform-dx/web-features/blob/main/docs/baseline.md#non-goals) so this is probably fine as is, but it might be good to do a bit of research for a11y best practices with DL and add a short mention of this in the description.

@vwallen vwallen mentioned this pull request Nov 26, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

feature definition Creating or defining new features or groups of features.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants