City of Oakland | Departments

City of Oakland | Business

City of Oakland | Transportation (OakDOT)

City of Oakland | Services

City of Oakland | Animals

City of Oakland | Meetings

City of Oakland | Adopt a Pet

City of Oakland | Oakland Fire Department

City of Oakland | Public Works

First time visit: View without clicking anything

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

June 2025

May 2025

City of Oakland

	Title / URL	Issues
	City of Oakland \| Departmentswww.oaklandca.gov/departments	1
	City of Oakland \| Businesswww.oaklandca.gov/services/category/business	1
	City of Oakland \| Transportation (OakDOT)www.oaklandca.gov/departments/transportation	1
	City of Oakland \| Serviceswww.oaklandca.gov/services	1
	City of Oakland \| Animalswww.oaklandca.gov/services/category/animals	1
	City of Oakland \| Meetingswww.oaklandca.gov/meetings	1
	City of Oakland \| Adopt a Petwww.oaklandca.gov/services/adopt-a-pet	1
	City of Oakland \| Oakland Fire Departmentwww.oaklandca.gov/departments/fire	1
	City of Oakland \| Public Workswww.oaklandca.gov/departments/public-works	1
	First time visit: View without clicking anythingwww.oaklandca.gov/	1

Ensure lists are marked up correctly

City of Oakland

Where this issue has occurred