@paer/accessibilitytool v0.0.1

Toegankelijkheidsmenu (A11y Menu) voor PAER Studio

Overzicht

Dit is het officiële toegankelijkheidsmenu van PAER Studio – een tool om websites van klanten toegankelijker te maken. Het menu is ontworpen om eenvoudig in elk project te worden geïntegreerd en ondersteunt toegankelijkheidsstandaarden (a11y) direct. Nieuwe functies en wijzigingen moeten voldoen aan de onderstaande standaarden en structuur.

Installeer en demonstreer de tool via de PAER Studio Component Library.

Standaarden & Conventies

• Gebruik Engels voor alle code (namen, commentaar, variabelen).
• De interface start in het Nederlands (NL) met een schakelaar naar Engels (ENG).
• Geen CSS-nesting — houd stijlen breed compatibel.
• Gebruik camelCase in alle code.
• Sluit aan bij PAER-waarden: progressive enhancement, toegankelijkheid, responsiviteit en performance.
• JavaScript moet minimaal zijn — functionaliteit moet zonder JS werken.
• Gebruik alleen native HTML/CSS inputs — geen JS-gestuurde custom controls.
• Componenten worden via een array geladen en in het menu gecategoriseerd op basis van gebruikersprofiel.
• Gebruik rem-eenheden in plaats van px.
• Gebruik CSS custom properties voor alle waarden.
• Gebruik TypeScript waar het duidelijkheid of veiligheid toevoegt — niet overdreven.

Toegankelijkheidseisen

• Volg toegankelijkheidsstandaarden: WCAG, ARIA, enz.
• Implementeer alle visuele en ARIA-staten: hover, focus, active, expanded, enz.
• Gebruik semantische HTML en correcte ARIA-rollen.
• Voorzie toegankelijke namen via props, met fallback-standaarden.
• Als ARIA-ID's nodig zijn, genereer ze indien niet meegegeven.
• Alle functies moeten volledig met het toetsenbord te bedienen zijn.
• Test met screenreaders zoals VoiceOver, NVDA en JAWS.

Technische Stack

• Framework: SvelteKit (Svelte 5)
• Taal: HTML,CSS,JavaScript,TypeScript
• Pakketbeheer: npm

Ontwikkelplan

1. Upgrade naar Svelte 5.
2. Omzetten naar een privé npm-pakket.
3. Volg de Svelte packaging guidelines.
4. Stel package.json in voor publicatie.
5. Test met npm run dev.
6. Publiceer naar npm (PAER-account vereist).
7. Installeer in de component library site.
8. Importeer het component en controleer.

Tool Logica & Ontwikkeling

• Progressive enhancement als uitgangspunt.
• Altijd responsief ontwerp.
• Directe DOM-interactie waar nodig.
• Sla gebruikersinstellingen op met cookies, cache of localStorage.
• Gebruik SSR voor JavaScript-functionaliteit.
• Gebruik popovers voor toggles en overlays.
• Het menu is een formulier (of gestylde div) met inputtypes: select, range, checkbox, radio.
• Elke a11y-functie is een eigen component.
• Gebruik client-side fallback voor serverlogica.
• Groepeer gerelateerde controls in categorieën in het menu.

Design & UI

• Hoofddesign: zwart-wit (voor sterk contrast).
• Gebruik PAER-huisstijlkleuren voor highlights en focus.
• UI-referenties voor inspiratie:
  • Uiverse Checkboxes
  • Storybook Showcase
  • Untitled UI Components
  • Tailwind UI Blocks
• Overweeg op termijn ondersteuning voor een browserextensie.

Voorbeelden van Toegankelijkheidsopties

• Tekstgrootte aanpassen (vergroten/verkleinen).
• Contrast aanpassen (licht/donker/hoog).
• Volledige toetsenbordondersteuning.
• Animaties/motion uitschakelen.
• Alle links markeren.
• Tekstafstand (line height) aanpassen.
• Muisaanwijzer highlighten.

Geplande Functies & Gebruikersopties

Talen

• Nederlands / Engels schakelaar (checkbox of switch)

Profielen

• Blind
• Dyslexie
• Slechthorend
• Alleen screenreader (toekomst)

Toegankelijkheidsfuncties

• Donkere / lichte modus
• Contrastregeling (slider)
• Tekstgrootte (slider)
• Animaties uitzetten
• Links zichtbaar maken
• Regelafstand aanpassen
• Muisaanwijzer highlighten

Installatie

1. Clone deze repository:

   git clone <repository-url>
   cd Accessibilitytool

2. Installeer afhankelijkheden:

   npm install

3. Start de ontwikkelserver:

   npm run dev

4. Open je browser en ga naar:

   http://localhost:5173

Voor productie en demonstratie: installeer en toon deze tool via de PAER Studio Component Library.

npm-pakket bijwerken

1. Verhoog het versienummer in package.json volgens semantische versiebeheer.
2. Build het pakket (indien nodig):

   npm run build

3. Log in bij npm (indien nog niet ingelogd):

   npm login

4. Publiceer het pakket naar npm:

   npm publish --access=public

   Let op: je hebt mogelijk de juiste rechten nodig voor het PAER Studio npm-account.

5. Installeer het bijgewerkte pakket in je doelproject:

   npm install <package-name>@latest

   Voor privé-pakketten of extra configuratie, zie de npm documentatie.

Testen

Testen (zoals Playwright) worden binnenkort toegevoegd. Instructies voor het uitvoeren van tests en test coverage volgen in een latere update.

Projectstructuur

Accessibilitytool/
  src/
    lib/
      components/
      stores/
    routes/
  static/
  e2e/  # (E2E-tests worden later toegevoegd)
  ...

• src/ – Broncode
• static/ – Statische bestanden
• e2e/ – End-to-end tests (nog niet opgezet)

Bronnen & Documentatie

• Svelte Packaging Guidelines
• UI-inspiratielinks hierboven

Doelgroep

Deze tool is bedoeld voor klanten van PAER Studio die de toegankelijkheid van hun website willen verbeteren en aan alle belangrijke toegankelijkheidsstandaarden willen voldoen.

Licentie

Nog geen licentie.