FormLayout should work properly with screenreaders
Open
Nobody has claimed this yet.
enhancement
- Dominant language
- Java
- Stars
- 1.8k
- Forks
- 717
- Avg merge
- 2d 6h
- Merged PRs (30d)
- 3
Description
Originally by jm-andrena
Currently, FormLayout uses an HTML table for rendering its content. Screenreaders also read this table information resulting in "confusion" of visually impaired users because the table semantics is wrong here.
Instead, use
elements and CSS positioning or style attributes as it is already done for other layout types.Imported from https://dev.vaadin.com/ issue #9183
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start at FormLayout's rendering entry point and compare it with the other layout types that already use div elements and CSS positioning. Done means the layout no longer exposes incorrect table semantics to screenreaders while preserving its existing visual arrangement.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- java
- Domain
- accessibility
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100