facebook / facebook/docusaurus
Headings are read twice by VoiceOver
- Dominant language
- TypeScript
- Stars
- 66.2k
- Forks
- 10k
- Avg merge
- 1d 3h
- Merged PRs (30d)
- 52
Description
### Have you read the Contributing Guidelines on issues?
- [X] I have read the [Contributing Guidelines on issues](https://github.com/facebook/docusaurus/blob/main/CONTRIBUTING.md#issues).
### Prerequisites
- [X] I'm using the latest version of Docusaurus.
- [ ] I have tried the `npm run clear` or `yarn clear` command.
- [ ] I have tried `rm -rf node_modules yarn.lock package-lock.json` and re-installing packages.
- [ ] I have tried creating a repro with https://new.docusaurus.io.
- [ ] I have read the console error message carefully (if applicable).
### Description
On macOS, the VoiceOver screen reader reads all headings twice, which is very annoying.
Here's a recording using Safari + VoiceOver:
https://github.com/facebook/docusaurus/assets/69485/062a9caa-ea9f-4fca-943e-bace83c92015
And here's a recording using Chrome + VoiceOver:
https://github.com/facebook/docusaurus/assets/69485/881a38bc-89a4-42e6-b374-0d589c6b5004
### Reproducible demo
_No response_
### Steps to reproduce
1. Go to https://docusaurus.io/docs
2. Activate VoiceOver with `Cmd + F5`
3. Press ` + A` (usually Ctrl + Alt + A)
### Expected behavior
I'd expect each heading to only be read once.
### Actual behavior
Each heading is read twice.
### Your environment
Official Docusaurus website.
### Self-service
- [ ] I'd be willing to fix this bug myself.
Contributor guide
Assessment
This issue has not been assessed yet.