Educational Technology & Design - SAISD

San Antonio ISD

Early Childhood Education - SAISD

Family & Community Engagement - SAISD

Advancement Via Individual Determination (AVID) - SAISD

SAISD Office of Access and Enrollment Services- Home

Advanced Academics - San Antonio ISD

Family & Student Support Services - SAISD

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

August 2025

July 2025

Title / URL	Issues
Educational Technology & Design - SAISDwww.saisd.net/page/edtech-home	9
San Antonio ISDwww.saisd.net/page/disws-home	6
Early Childhood Education - SAISDwww.saisd.net/page/ece-home	6
San Antonio ISDwww.saisd.net/page/SafetyHub	6
Family & Community Engagement - SAISDwww.saisd.net/page/face-home	6
Advancement Via Individual Determination (AVID) - SAISDwww.saisd.net/page/avid-home	3
SAISD Office of Access and Enrollment Services- Homewww.saisd.net/page/oaes-home	3
Advanced Academics - San Antonio ISDwww.saisd.net/page/aa-home	3
San Antonio ISDwww.saisd.net/	3
Family & Student Support Services - SAISDwww.saisd.net/page/fsss-home	3

Ensure lists are marked up correctly

San Antonio ISD

Where this issue has occurred