[#1801 gate] Toegankelijkheid onder echte screen reader

brenno commented

2026-08-29 12:37:37 +00:00

Owner

Context

Onderdeel van de acceptatiepoorten voor #1801 (IMAGE_CALLOUTS.md §9, §12).

Wat gevraagd wordt

§12 specificeert de accessibility-semantiek per oppervlak. aria-describedby op bullets is getest in DOM (marp_html_service_callouts_test.dart), maar de volledige semantiek moet onder een echte screen reader geverifieerd:

De description wordt één keer uitgesproken, met stable id.
Elke markering role="img" met accessible name = reference, description + target n of m.
Bullet <li> draagt aria-describedby naar de description.
Unrevealed groups zijn absent from the accessibility tree, niet alleen onzichtbaar.
Eén polite live region per slide kondigt elke reveal-stap aan + hoeveel markeringen meekomen.
Flutter mirror in Semantics.

Status

DOM-asserties bestaan voor aria-describedby; de overige semantiek (live region, unrevealed = absent, target-n-of-m announcement) is niet onder een echte screen reader geverifieerd.

Acceptatie

Verificatie onder echte screen reader (VoiceOver/NVDA) — documenteer resultaat
Live region bij reveal-stap getest
Unrevealed = absent from tree bevestigd
Flutter Semantics-mirror getest
Raster PDF/PPTX/ODP blijven "not structurally accessible" — statement staat, descriptions in alt waar slot bestaat

## Context Onderdeel van de acceptatiepoorten voor #1801 (IMAGE_CALLOUTS.md §9, §12). ## Wat gevraagd wordt §12 specificeert de accessibility-semantiek per oppervlak. `aria-describedby` op bullets is getest in DOM (`marp_html_service_callouts_test.dart`), maar de volledige semantiek moet onder een **echte screen reader** geverifieerd: 1. De description wordt één keer uitgesproken, met stable id. 2. Elke markering `role="img"` met accessible name = *reference, description* + *target n of m*. 3. Bullet `<li>` draagt `aria-describedby` naar de description. 4. **Unrevealed groups zijn absent from the accessibility tree**, niet alleen onzichtbaar. 5. Eén polite live region per slide kondigt elke reveal-stap aan + hoeveel markeringen meekomen. 6. Flutter mirror in `Semantics`. ## Status DOM-asserties bestaan voor `aria-describedby`; de overige semantiek (live region, unrevealed = absent, target-n-of-m announcement) is niet onder een echte screen reader geverifieerd. ## Acceptatie - [ ] Verificatie onder echte screen reader (VoiceOver/NVDA) — documenteer resultaat - [ ] Live region bij reveal-stap getest - [ ] Unrevealed = absent from tree bevestigd - [ ] Flutter Semantics-mirror getest - [ ] Raster PDF/PPTX/ODP blijven "not structurally accessible" — statement staat, descriptions in alt waar slot bestaat

brenno added the

enhancement

accepted

in-progress

labels

2026-08-29 12:37:37 +00:00

brenno commented

2026-08-29 13:36:54 +00:00

Author

Owner

Opgepakt. Tak: gate/1844-a11y-screenreader. Reikwijdte: lib/services/marp_html/marp_html_service_callouts.dart, lib/widgets/slides/previews/callout_overlay.dart, lib/widgets/slides/previews/bullets_image_preview.dart, test/callout_accessibility_test.dart, docs/design/IMAGE_CALLOUTS.md.

brenno referenced this issue from a commit

2026-08-29 15:12:35 +00:00

feat(a11y): beeldverwijzingen leesbaar zonder zicht (#1844)

brenno referenced this issue from a commit

2026-08-29 15:12:35 +00:00

fix(privacy): redigeer de beschrijving van een beeldverwijzing (#1844)

brenno referenced this issue from a commit

2026-08-29 15:12:35 +00:00

docs(callouts): §8 vertelt wat "scanbaar" tot #1844 wél en niet deed

brenno referenced this issue from a pull request that will close it,

2026-08-29 15:13:14 +00:00

a11y+privacy(callouts): toegankelijkheidspoort #1801 (#1844) #1851