Skip to content

Verbeter tekstalternatieven en leesvolgorde - #173

Open
robbertbos wants to merge 9 commits into
mainfrom
fix/tekstalternatieven-en-volgorde
Open

robbertbos wants to merge 9 commits into
mainfrom
fix/tekstalternatieven-en-volgorde

Conversation

@robbertbos

@robbertbos robbertbos commented Sep 19, 2026 •

Copy link
Copy Markdown
Member

Bevindingen uit de schermlezertoets op WCAG 1.1 (NVDA, JAWS, VoiceOver).

  • Logo en hero-foto krijgen een lege alt; ze zijn decoratief.
  • De downloadknop bij een diagram staat na het diagram en heeft verborgen tekst als naam in plaats van aria-label plus title.
  • De placeholder van het zoekveld is "Zoeken", zonder drie losse punten.
  • Diagrammen: accTitle is de alt, accDescr volgt als verborgen tekst direct na het diagram, zodat een schermlezer hem regel voor regel kan teruglezen in plaats van als één lange naam. Bij de notificatiedienst wordt de desc een beschrijving (aria-describedby) in plaats van een deel van de naam.
  • In de PDF-export komt de diagrambeschrijving achter de alt, want Chrome neemt verborgen tekst niet op in een PDF.
  • De sitetitel is ook op de homepage een link, zodat de tab-volgorde overal gelijk begint.
  • De rechterkolom (inhoudsopgave, downloads, relevante links) staat in de broncode direct na de h1 in plaats van na de hele tekst. Op breed scherm verandert er niets; op een smal scherm staan de downloads nu boven de tekst.
  • Nieuwe shortcode emoji met aria-label of aria-hidden=true; een kale emoji blijft de standaard. Beschreven in de skills content-review, new-weekly en a11y-review.
  • De eigen a11y-controle eist nu een diagrambeschrijving, en laat de koppen van de rechterkolom buiten de koppenvolgorde, anders maskeren die een sprong van h1 naar h3.

Gemeten onderweg:

  • aria-describedby naar een dichtgeklapte <details> levert in Chrome geen beschrijving op; naar een hidden-element wel. Een beschrijving blijft wel één string die je niet kunt teruglezen, vandaar verborgen tekst.
  • Verborgen tekst (visually-hidden) komt niet in een PDF: Chrome tagt alleen wat getekend wordt. Een test legt de PDF-alt vast.
  • Op breed scherm is de rechterkolom pixelgelijk aan main: positie, meelopen bij scrollen en de plek van de tekst.
  • Tests, CSP, koppen en alt-teksten, pa11y (85/85), htmltest en PDF/UA (37 PDF's) slagen. Elke commit bouwt en haalt de tests op zichzelf.

Twee dingen die hierbuiten vallen en apart opgepakt worden: in de ODF staat een diagram als Mermaid-broncode in plaats van als afbeelding, en het info-icoon van een callout komt ongetagd in de PDF. Beide bestaan al op main en vallen nu niet op, omdat geen enkele pagina met een diagram of zo'n callout downloads aanbiedt.

Moet vóór #136 gemerged worden: de correctie bij 1.4.13 in het rapport verwijst naar deze wijziging.

@robbertbos robbertbos added the preview Rol een preview-omgeving uit op ZAD label Sep 19, 2026
@github-actions

Copy link
Copy Markdown

🚀 Preview Deployment — web

Your changes have been deployed to a preview environment:

URL: https://web-pr-173-mzs-3ik.rig.prd1.gn2.quattro.rijksapps.nl

📱 Scan to open on mobile
 ▄▄▄▄▄ █▀ █▀▀▄▀▀▄██▄ ▄▄▄▀█ ▄▄▄▄▄ 
 █   █ █▀ ▄ ████▄▀▄██▄▀ ▀█ █   █ 
 █▄▄▄█ █▀█ █▄ ▀▀▄██▄ ▀█▄▄█ █▄▄▄█ 
▄▄▄▄▄▄▄█▄█▄█ ▀▄█ █ █ ▀ ▀ █▄▄▄▄▄▄▄
 ▄  ▄▀▄▄▄ ▄█▄█▄██▄█▀ ▀▄ ▄ ▀ █▄▀ ▀
 ▀▀  ▀▄ ▄ ▀ ▄█▀▄▄▄ █▄▀ █▀▀██▀▄▀▄█
 █▄█▀ ▄ ▄▄▀▄▀▀▀▄  ▀▀ ██ ▄▀▀ ▄▄█▀▀
 ▄█▄█▀▄██  █▀ ▄ █▄█▀▀▀▄▀▀ ▀ ▄█▀▄█
  ▄▄▄▄▄█  ▀█▄█▄▄    █▀ ▀▀▀▀█▄▀█ ▀
█▄ █ ▀▄▄▀▄█ ▄█▀ █▄▀▀█ ███▀▀ █▄▀▄█
▀ █▄ ▄▄▀ █▀▄▀▀▀▄ ▄█▀▄▀   █▀█▄▀█ ▀
 █▄   ▄▀ ███▀ ▄ ▄▄ ▀▀▀█▀▀ ▄█▀ ▀▄█
▄█▄██▄▄█▀ ██▄█▄▄▀ ▀ ▀▀▄▀ ▄▄▄  ▀█ 
 ▄▄▄▄▄ █▄ █ ▄█▀▄▄█▄▀  ▄  █▄█  ▀▄█
 █   █ █ ▀▄▄▀▀▀▄  ▀▀▀▀▀█▄ ▄  ▀▀  
 █▄▄▄█ █ █▄█▀ ▄▄▄▄ ▀▀ ▀▀█▀  ▀  ██
▄▄▄▄▄▄▄█▄███▄█▄██▄█▄███▄▄▄█▄███▄█

This deployment will be automatically cleaned up when the PR is closed.

Beide zijn decoratief: de sitenaam staat er al als tekst naast.
De knop komt nu na het diagram in de leesvolgorde. Een verborgen
tekst vervangt aria-label en title; die laatste gaf een tooltip.
Drie losse punten kan een schermlezer voorlezen als "punt punt punt";
een weglatingsteken (U+2026) is één teken en klinkt als een pauze.
Mermaid-diagrammen krijgen accTitle als alt; accDescr volgt als
verborgen tekst direct na het diagram, zodat een schermlezer hem regel
voor regel kan teruglezen. Bij de notificatiedienst wordt de desc een
beschrijving via aria-describedby in plaats van een deel van de naam.
Op de homepage ontbrak de link, waardoor de tab-volgorde daar anders
begon dan op de rest van de site. Op home draagt hij aria-current.
Toetsenbord en schermlezer bereikten de inhoudsopgave, downloads en
relevante links pas na de hele tekst, terwijl ze rechtsboven staan.
Op een smal scherm staan de downloads daardoor nu boven de tekst.
Een kale emoji blijft de standaard. Met aria-label of aria-hidden=true
wijk je af van de naam die een schermlezer voorleest. De skills
content-review, new-weekly en a11y-review beschrijven wanneer.
Chrome neemt verborgen tekst niet op in een PDF. De export plakt de
beschrijving daarom achter de alt van de figuur.
De alt draagt nu de korte accTitle, dus een ontbrekende accDescr viel
niet meer op; een nieuwe controle eist de verborgen beschrijving. De
koppen van de rechterkolom staan tussen de h1 en de tekst en
maskeerden een sprong in de koppen; die tellen niet meer mee.

This branch was successfully deployed

1 active deployment
pr-173 — e9c80007 Deployed Sep 23, 2026 by robbertbos via deploy-preview #821
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

preview Rol een preview-omgeving uit op ZAD

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant