News & Events | Alamo Colleges

Palo Alto College | Alamo Colleges

Transparency, Taxes & Compliance | Alamo Colleges

Our District | Alamo Colleges

Alamo Colleges District

AlamoFORWARD | Alamo Colleges

About Us | Alamo Colleges

Employee Portal | Alamo Colleges

Plan | Alamo Institutes | Alamo Colleges

Academic Advising & Advising Centers | Alamo Colleges

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

Alamo Colleges

Title / URL	Issues
News & Events \| Alamo Collegeswww.alamo.edu/news--events/	4
Palo Alto College \| Alamo Collegeswww.alamo.edu/pac/	4
Transparency, Taxes & Compliance \| Alamo Collegeswww.alamo.edu/about-us/compliance/	4
Our District \| Alamo Collegeswww.alamo.edu/about-us/our-district/	4
Alamo Colleges Districtwww.alamo.edu/	4
AlamoFORWARD \| Alamo Collegeswww.alamo.edu/about-us/strategic-planning/	4
About Us \| Alamo Collegeswww.alamo.edu/about-us/	4
Employee Portal \| Alamo Collegeswww.alamo.edu/about-us/offices-departments/employees/	4
Plan \| Alamo Institutes \| Alamo Collegeswww.alamo.edu/enroll/plan/	4
Academic Advising & Advising Centers \| Alamo Collegeswww.alamo.edu/academics/academic-resources/advising/	4

Ensure lists are marked up correctly

Alamo Colleges

Where this issue has occurred