missing-list
Rule Severity : Minor
Description
Content that functions as a list must be properly marked up using appropriate list tags (<ul>
, <ol>
, <li>
). Lists not properly marked up can create confusion for users of screen readers and other assistive technologies.
The missing-list
rule aligns with WCAG Success Criterion 1.3.1 (Info and Relationships), which requires that information, structure, and relationships conveyed through presentation must be programmatically determinable.
Examples
In the following example, content that should be a list is incorrectly marked up using <div> and instead of proper list elements.
In the following corrected example, the content is properly structured as an unordered list:
How to fix?
To fix violations of the missing-list
rule, follow these steps:
- Identify content that is visually presented as a list (e.g., bulleted or numbered items).
- Ensure the content is marked up using proper list tags (
<ul>
,<ol>
,<li>
). - Use
<ul>
for unordered lists and<ol>
for ordered lists. You can also use<dl>
for descriptive lists with<dt>
and<dd>
tags.
Reference
WCAG Success Criterion 1.3.1: Info and Relationships
We're sorry to hear that. Please share your feedback so we can do better
Contact our Support team for immediate help while we work on improving our docs.
We're continuously improving our docs. We'd love to know what you liked
We're sorry to hear that. Please share your feedback so we can do better
Contact our Support team for immediate help while we work on improving our docs.
We're continuously improving our docs. We'd love to know what you liked
Thank you for your valuable feedback!