Toegankelijkheid: HTML-export mist documentstructuur (landmarks/titel, WCAG 1.3.1/2.4.1) #1250

New issue

Closed

opened 2026-08-04 23:08:59 +00:00 by brenno · 0 comments

brenno commented

2026-08-04 23:08:59 +00:00

Owner

Toegankelijkheid — HTML-export heeft geen documentstructuur (landmarks/titel)

De HTML-export schrijft per dia een <section class="slide"> (goed) en role="img"/aria-label voor ontbrekende of geredigeerde media (goed). Maar er is geen documentstructuur eromheen:

geen <main> of andere landmarks;
geen <h1> met de decktitel boven de secties;
geen lang op afwijkende content (zie #1249 voor het root-lang-probleem).

Voor een schermlezer is het document één platte rij secties zonder ingang — je moet het hele deck linear doorlopen om te weten wat het is of waar je bent. docs/ACCESSIBILITY.md zegt zelf dat de HTML-export "not audited for accessibility" is; dit is het concrete gat dat die audit dan zou vinden.

Waarom het ertoe doet

WCAG 2.1 SC 1.3.1 (Info en relaties) en 2.4.1 (Blokken omzeilen) op AA-niveau. Landmarks en een documenttitel zijn het minimum waarmee een schermlezer-gebruiker het document kan begrijpen en navigeren. De HTML-export is de aanbevolen route voor wie moet lezen in plaats van kijken — dus de plek waar dit ertoe doet.

Voorstel

Eén <h1> met de decktitel vóór de eerste <section>.
Een <main>-wrapper rond de secties.
Optioneel: <section aria-label="Dia N: <titel>"> per dia, zodat de schermlezer per dia navigeert op naam in plaats van op nummer alleen.

Kleine wijziging in marp_html_service.dart rond de <section>-opbouw. Hoort samen met #1249 (de lang-kwestie) bekeken te worden, omdat beide de HTML-export-structuur raken.

Scope

Raakt een publieke belofte (de export als toegankelijke route) — bewaker-blik gewenst.

## Toegankelijkheid — HTML-export heeft geen documentstructuur (landmarks/titel) De HTML-export schrijft per dia een `<section class="slide">` (goed) en `role="img"`/`aria-label` voor ontbrekende of geredigeerde media (goed). Maar er is geen documentstructuur eromheen: - geen `<main>` of andere landmarks; - geen `<h1>` met de decktitel boven de secties; - geen `lang` op afwijkende content (zie #1249 voor het root-`lang`-probleem). Voor een schermlezer is het document één platte rij secties zonder ingang — je moet het hele deck linear doorlopen om te weten wat het is of waar je bent. `docs/ACCESSIBILITY.md` zegt zelf dat de HTML-export *"not audited for accessibility"* is; dit is het concrete gat dat die audit dan zou vinden. ### Waarom het ertoe doet WCAG 2.1 SC 1.3.1 (Info en relaties) en 2.4.1 (Blokken omzeilen) op AA-niveau. Landmarks en een documenttitel zijn het minimum waarmee een schermlezer-gebruiker het document kan begrijpen en navigeren. De HTML-export is de aanbevolen route voor wie moet lezen in plaats van kijken — dus de plek waar dit ertoe doet. ### Voorstel - Eén `<h1>` met de decktitel vóór de eerste `<section>`. - Een `<main>`-wrapper rond de secties. - Optioneel: `<section aria-label="Dia N: <titel>">` per dia, zodat de schermlezer per dia navigeert op naam in plaats van op nummer alleen. Kleine wijziging in `marp_html_service.dart` rond de `<section>`-opbouw. Hoort samen met #1249 (de `lang`-kwestie) bekeken te worden, omdat beide de HTML-export-structuur raken. ### Scope Raakt een publieke belofte (de export als toegankelijke route) — `bewaker`-blik gewenst.

brenno added the

bug

label

2026-08-04 23:08:59 +00:00

brenno referenced this issue from a commit

2026-08-05 09:11:07 +00:00

feat(a11y): <main>-landmark en visueel-verborgen <h1> in HTML-export (#1250)

brenno referenced this issue from a commit

2026-08-05 09:11:07 +00:00

test(a11y): landmarks en documenttitel in HTML-export (#1250)

brenno referenced this issue from a commit

2026-08-05 09:11:07 +00:00