Frequently Asked Questions - Maryland.gov

Maryland.gov - Official Website of the State of Maryland

Our Customer Service Promise - Maryland.gov

An error has occurred - Maryland.gov

First time visit: View without clicking anything

Maryland Education Resources - Maryland.gov

Maryland State Online Services Directory - Maryland.gov

My Maryland - Maryland.gov

Maryland.gov Social Media Hub - Maryland.gov

Lists (e.g., `<ul>` or `<ol>`) should only contain list items (`<li>`) as a direct descendant 
to ensure that screen readers can accurately report the amount of items contained in the list. 

## Example

In the following example, some screen readers would say this list has two items, instead of 
four: 

```html
<ul>
    <div class="some_class">
        <li>Example 1</li>
    </div>
    <div class="some_other_class">
        <li>Example 2</li>
        <li>Example 3</li>
        <li>Example 4</li>
    </div>
</ul>
```

To fix this, you would need to remove the `<div class="some_class">` and 
`<div class="some_other_class>` elements and ensure only `<li>` list items remain.

## Further reading

The [formal specification for the list element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/ul)
shows what is and is not permitted inside an `<ul>` and `<ol>`.

See [Technique H88](https://www.w3.org/TR/WCAG20-TECHS/H88.html) for more information.

list-not-following-semantics

January 2025

December 2024

State of Maryland

Title / URL	Issues
Frequently Asked Questions - Maryland.govwww.maryland.gov/pages/faq.aspx	1
Maryland.gov - Official Website of the State of Marylandwww.maryland.gov/pages/default.aspx	1
Our Customer Service Promise - Maryland.govwww.maryland.gov/pages/customerservice.aspx	1
Maryland.gov - Official Website of the State of Marylandwww.maryland.gov/Pages/default.aspx	1
An error has occurred - Maryland.govwww.maryland.gov/Pages/Error.aspx?requestUrl=https://www.maryland.gov/invented-url-for-404-page	1
First time visit: View without clicking anythingwww.maryland.gov/Pages/default.aspx	1
Maryland Education Resources - Maryland.govwww.maryland.gov/pages/education.aspx	1
Maryland State Online Services Directory - Maryland.govwww.maryland.gov/pages/online_services.aspx	1
My Maryland - Maryland.govwww.maryland.gov/pages/my-maryland.aspx	1
Maryland.gov Social Media Hub - Maryland.govwww.maryland.gov/pages/social_hub.aspx	1

Ensure lists are marked up correctly

State of Maryland

Where this issue has occurred