vuejs / vitepress

Vite & Vue powered static site generator.
https://vitepress.dev
MIT License
11.48k stars 1.86k forks source link

outline nav does not has duplicative assistive tech-exclusive text [#3800] #3803

Closed olets closed 2 weeks ago

olets commented 4 weeks ago

Fixes #3800

Before

After

The outline has one navigation element. Its label is the configurable heading displayed visually.

Testing

  1. On a Vitepress site using the released version, on any page with an outline, use a screen reader or other assistive tech to read the outline. Confirm that the nested navigation adds no value, that the labelled nav's label is distinct from what is displayed visually, and that the divergent assistive tech experience adds no value.

On this branch,

  1. Run axe DevTools on a page with an outline. Confirm that there is no regression error in the outline
  2. Use a screen reader or other assistive tech to read the outline. Confirm that the single nav is labelled by the visually displayed heading, and that the assistive tech experience of the outline is closer to the visual experience than it was.