[csswg-drafts] [css-lists-3] [css-values-5] Potential issue with `toggle()` and `ul` in css-lists-3 Appendix A (#13753)

sleepy-monax has just created a new issue for https://github.com/w3c/csswg-drafts:

== [css-lists-3] [css-values-5] Potential issue with `toggle()` and `ul` in css-lists-3 Appendix A ==
Hi,

While implementing the `toggle()` function in my web engine, I believe I found an error in [**Appendix A: Sample Style Sheet for HTML**](https://www.w3.org/TR/css-lists-3/#ua-stylesheet) of the `css-lists-3` specification.

The sample stylesheet suggests defining unordered lists as follows:
```css
ul { list-style-type: toggle(disc, circle, square); }
```

However, the initial value of `list-style-type` is `disc`. 

According to `css-values-5` regarding how [`toggle()`](https://www.w3.org/TR/css-values-5/#toggle-notation) is evaluated:
> "Then, compare the property’s inherited value with each Cn. For the earliest Cn that matches the inherited value, the computed value of toggle() is Cn+1."

**The Issue:**
Because the default inherited value is already `disc`, the `toggle()` function will match `disc` (C1) and immediately compute to the next value in the list, which is `circle` (C2). 

This results in a top-level `<ul>` incorrectly computing to `circle` instead of the expected `disc`.

Please view or discuss this issue at https://github.com/w3c/csswg-drafts/issues/13753 using your GitHub account


-- 
Sent via github-notify-ml as configured in https://github.com/w3c/github-notify-ml-config

Received on Wednesday, 1 April 2026 13:37:06 UTC