Denise Savoie | Royal Roads University

Anna Maria Tremonti | Royal Roads University

Home | Royal Roads University

Noranit Setabutr | Royal Roads University

Michael Harcourt | Royal Roads University

Transfer Credit | Royal Roads University

Helen Hughes | Royal Roads University

Janet Baird | Royal Roads University

Isabel Lloyd | Royal Roads University

Stephen Lewis | Royal Roads University

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 2024

May 2024

Royal Roads University

Title / URL	Issues
Denise Savoie \| Royal Roads Universitywww.royalroads.ca/denise-savoie	44
Anna Maria Tremonti \| Royal Roads Universitywww.royalroads.ca/anna-maria-tremonti	44
Home \| Royal Roads Universitywww.royalroads.ca/	44
Noranit Setabutr \| Royal Roads Universitywww.royalroads.ca/noranit-setabutr	44
Michael Harcourt \| Royal Roads Universitywww.royalroads.ca/michael-harcourt	44
Transfer Credit \| Royal Roads Universitywww.royalroads.ca/transfer-credit	44
Helen Hughes \| Royal Roads Universitywww.royalroads.ca/helen-hughes-0	44
Janet Baird \| Royal Roads Universitywww.royalroads.ca/janet-baird	44
Isabel Lloyd \| Royal Roads Universitywww.royalroads.ca/isabel-lloyd	44
Stephen Lewis \| Royal Roads Universitywww.royalroads.ca/stephen-lewis	44

Ensure lists are marked up correctly

Royal Roads University

Where this issue has occurred