Vrules voor
applicaties.
Bekijk kleur en compositie in gebruik ↗
Ontwerpregels voor de zes onderzochte applicaties, met voorbeelden die je kunt uitproberen en aanpassen voor je eigen project.
Versie 2.4.0 · 12 oktober 2026 · HTML, CSS, JavaScript, tokens en ontwerpregels
Wat de voorbeelden laten zien
Je kunt in de voorbeelden onder meer locaties vergelijken en een afspraak afronden met verplicht bewijs. De ontwerpregels beschrijven ook wat er gebeurt als opslaan mislukt of gegevens ontbreken.
De broncode en publieke schermen zijn onderzocht. De ingelogde productieprocessen zijn niet doorlopen. De voorbeelden zijn fictief en veranderen niets in de zes applicaties.
Kleur en compositie
Het volledige Vrules-palet hoort ook in digitale producten. Een product is niet af zodra het een donkere bovenbalk, oranje knop en verder grijze panelen heeft. Gebruik de kleurvlakken en typografische hiërarchie uit papers en presentaties om inhoud te ordenen. Compacte afstanden uit density.md blijven gelden.
Wat we overnemen uit andere media
| Bron | Vertaling naar web en app | Begrenzing |
|---|---|---|
| Donkere paperopening | Compact contrasterend samenvattingsvlak of redactionele opening | Geen grote hero boven dagelijkse bediening |
| Getinte tabellen en vergelijkingsdia's | Eén kleurfamilie voor een analysegebied, met zachte ondergrond en donkere koppen | Tabelbody en invoervelden blijven goed leesbaar |
| Infographic met inhoudelijke kleurcodering | Herkenbare kleuren voor benoemde categorieën, fasen of reeksen | Altijd labels; categorie is geen status |
| Presentatiedia met hoofdgetal | Hoofdgetal 32–44 px, eenheid en toelichting erbij; ondersteunende cijfers kleiner | Niet ieder cijfer even groot, geen decoratieve KPI-tegels |
| Redactionele pagina met beeld en zijstuk | Breder hoofdonderdeel met smalle contextkolom, of beeld met compacte lijst | DOM-volgorde blijft logisch; mobiel onder elkaar |
Kleurrollen
Gebruik expression.families in tokens.json. Deze bevatten aparte licht- en donkerparen. expression.css levert dezelfde waarden voor .vr-app en .vr-web.
| Familie | Gebruik in inhoud | Voorbeeld |
|---|---|---|
| Petrol | Proces, werkcontext en begeleiding | Werksamenvatting, route of uitleg bij een opdracht |
| Blauw | Analyse, vergelijking en gegevens | Vergelijkingsgebied, tabelkop of hoofdgetal |
| Aubergine | Leren, reflectie en verdieping | Oefensituatie, lesintro of redactioneel kader |
| Oranje | Merk, primaire actie en incidenteel warm inhoudsvlak | Besluit dat aandacht verdient; knop behoudt donkere tekst |
Kies per scherm een leidende familie en zo nodig een tweede voor een duidelijk ander inhoudstype. Dit is geen verplicht aantal kleuren: een eenvoudig formulier mag neutraal blijven. Een inhoudsvlak mag volledig getint of donker zijn. Gebruik geen losse gekleurde zijlijnen, accentstrepen of inset-schaduwen. Navigatieselectie blijft neutraal; kleur in de inhoud hoeft niet in iedere knop terug te komen.
Kleurfamilies zijn onafhankelijk van status. Een petrol lesblok is niet automatisch afgerond; een aubergine project is geen waarschuwing. Voor fouten, succes en geselecteerde elementen blijven de bestaande semantische tokens en tekstlabels verplicht. Binnen een gekleurd vlak blijven invoervelden, knoppen en statuslabels hun eigen leesbare kleuren houden. Geen kleuren stapelen via overerving.
CSS aansluiten
Laad eerst de bestaande fonts en application-tokens.css, daarna de basiscomponenten en als laatste expression.css. Gebruik .vr-app op een applicatie of .vr-web op de container van een website. De website behoudt zijn eigen basistypografie en componenten; expression.css voegt alleen de beschreven bouwstenen toe. Kies licht, donker of automatisch op dezelfde container. Gebruik data-palette op een inhoudsblok binnen die container. Geneste kleurvlakken worden niet aanbevolen.
Herbruikbare vormen
vr-surfacemetdata-palette="petrol|blue|aubergine|orange": zacht getint inhoudsgebied met 16 px padding. Voor context die echt bij elkaar hoort.vr-surface vr-strongmet dezelfde familie: contrasterend inhoudsgebied. Kies dit voor één prioriteit of korte samenvatting, niet voor alle kaarten.vr-ink: donkere redactionele opening, met lichte tekst. Titel 32 px in apps; websites mogen hun bestaande grotere titel gebruiken.vr-tone-title: titel in de accenttoon van de omliggende kleurfamilie. Gewone leestekst blijft in de goedgekeurde tekstkleur.vr-metric-value: hoofdgetal in Source Sans 3 Bold, 32–44 px. Metadata 14 px, interface 16 px, lange uitleg 18 px.vr-editorial-grid: hoofdkolom en smallere contextkolom (2:1), op mobiel één kolom. Kies een gelijk raster wanneer vergelijken dat vraagt.
Gebruik een statuscomponent altijd met zijn statusnaam en eigen achtergrond. Gebruik voor links binnen een sterk vlak onderstreepte tekst in de lokale tekstkleur; actieknoppen behouden de normale knoptokens. Verbind kleur met de inhoud, niet met de toevallige positie van een kaart.
Toepassen per product
Een tracker kan een petrol samenvatting combineren met een neutrale bewerkbare tabel. Een dashboard gebruikt blauw voor analyse, een groter hoofdgetal en compacte bronvermelding. Een leeromgeving kan aubergine gebruiken rond de oefensituatie en de feitelijke bediening neutraal houden. Een reiswebsite gebruikt echte fotografie en petrol voor routecontext. Een redactionele website wisselt een donkere opening af met leesbare witte inhoud en een getint zijstuk. Pas een bestaande projectidentiteit alleen aan wanneer de opdracht dat toestaat.
Controle
Beoordeel het hele scherm: helpt de kleur om inhoud te onderscheiden, is er een duidelijk zwaartepunt en blijft de hoofdtaak snel bereikbaar? Geen decoratieve opvulling, verplichte drietallen, extra kaartlagen of meer witruimte om het rijker te laten lijken. Controleer alle tekst-/achtergrondparen in beide thema's (gewone tekst minimaal 4,5:1), toetsenbordfocus op elk vlak, mobiele volgorde en overloop. Controleer ook dat fout- en statuskleuren niet door een inhoudsthema worden overschreven.
Ontwerpregels
Vrules 2.3 bevat regels voor werkschermen, zoals een afsprakenoverzicht, een locatievergelijking en een formulier. Het bestaande logo, de kleuren en lettertypen blijven in gebruik.
Bepaal wat de gebruiker moet doen
Leg vóór vormgeving vast: wie gebruikt dit, welke beslissing of handeling staat centraal, welke informatie is nodig, wat kan misgaan, en wanneer is het werk werkelijk opgeslagen? Gebruik bestaande routes, domeinregels en componentbibliotheken. Een nieuwe stijl is geen reden om een werkende backend te vervangen.
Kies het toepassingsprofiel in application-profiles.md. Volg application-components.md voor gedrag, application-quality.md voor acceptatie en migration.md voor invoering. De HTML/CSS/JS in werkplaats/ is een bewerkbare referentie met fictieve gegevens. Het is geen productiebackend of complete componentlibrary voor ieder framework.
Lees ook expression.md voor rijke kleurtoepassing, typografische rollen en compositie. De compacte opmaak blijft de basis.
Identiteit en compositie
- Het originele V-logo, Barlow en Source Sans 3 blijven de Vrules-basis. In Vrules-modus: donker merkvlak, rustige lichte of donkere werkruimte, oranje primaire actie, petrol voor ondersteunende informatie. Geen grote decoratieve hero boven een werkscherm.
- Een bestaand project behoudt zijn identiteit tenzij herbranding gevraagd is. Gebruik dan dezelfde gedragsregels met een expliciete projectmapping van semantische tokens. Behoud bijvoorbeeld De Borne als afzender en onderscheid Nederlands elftal-oranje van algemene waarschuwingen in DeWKPool.
- Navigatie, paginatitel, belangrijkste actie, filters, werkgebied en detail vormen de vaste hiërarchie. Maximaal één dominante actie per taakgebied. Verberg secundaire handelingen niet uitsluitend achter onbenoemde iconen.
- Gebruik tabellen voor vergelijking tussen dezelfde attributen, kaarten voor afzonderlijke objecten, een bord voor werkfasen, een tijdlijn voor gebeurtenissen, een kaart voor locatievragen. Het redactionele verbod op decoratieve kaartenroosters is geen verbod op functionele applicatiekaarten.
- Gebruik echte reisfoto’s met herkomst waar beeld helpt kiezen. Geen verzonnen locaties of decoratieve landkaarten. In een datatabel is witruimte vaak zinvoller dan illustratie.
Selectie en bovenkopjes
Geen decoratieve gekleurde zijranden, accentstrepen of inset-schaduwen aan kaarten, invoerblokken, callouts, tabs of actieve navigatie, ongeacht de kleur. Gebruik rustige vlakvulling, tekstgewicht en neutrale scheidingslijnen. Behoud zichtbare toetsenbordfocus, veldranden bij validatiefouten en betekenisvolle statuslabels.
Bovenkopjes zijn alleen toegestaan wanneer ze informatie toevoegen die nodig is om de inhoud te begrijpen, zoals een organisatie, project, land of periode. Schrap labels als “WERKRUIMTE” en “AFSPRAKEN & OPVOLGING” boven een duidelijk afsprakenoverzicht. Herhaal niet de geselecteerde navigatie of paginatitel als bovenkop. Geen automatische hoofdletters, extra letterspatiëring of standaard eyebrow bij ieder blok.
Een geselecteerde navigatieknop krijgt een neutraal achtergrondvlak en zwaardere tekst. De lijst-/bordkeuze gebruikt hetzelfde principe. Een formulier heeft gewone veldranden; er loopt geen oranje lijn langs het hele invoerblok.
Controleer het scherm zonder bovenkopjes: blijft de betekenis gelijk, dan kunnen ze weg. Een projectnaam in een detailvenster en het land bij een locatie blijven staan als ze helpen het object te herkennen.
Typografie en dichtheid
| Rol | Maat / regelhoogte | Gebruik |
|---|---|---|
| Paginakop | Barlow 32 px / 1,15 | Eén h1 per werkruimte; mobiel 28 px |
| Sectiekop | Barlow 24 px / 1,25 | Taakgebieden en detailpanelen |
| Interface en formulier | Source Sans 3 16 px / 1,5 | Standaard, ook op mobiel |
| Tabel en metadata | Source Sans 3 14 px / 1,5 | Labels blijven leesbaar; geen 10 px statuskoppen |
| Lange uitleg | Source Sans 3 18 px / 1,65 | Maximaal 68ch, buiten compacte tabelcellen |
| Cijfers | Source Sans 3, tabular-nums | Decimalen uitlijnen, eenheid zichtbaar |
Compacte rijen van minimaal 44 px zijn standaard op desktop met precieze aanwijzer. Comfortabele rijen van 56 px zijn optioneel en blijven de basis op touch. Rijhoogte groeit mee met tekst en bediening; verklein geen letters. Panelen hebben 16 px padding, tussen blokken 16 px en tussen gerelateerde velden 8–12 px. Vermijd dubbele witruimte door gestapelde padding en margins. Touchdoelen standaard 44 × 44 px. Dit is onze ontwerpregel; WCAG 2.2 AA kent een minimum van 24 × 24 CSS-pixels met uitzonderingen.
Raster, lagen en responsiviteit
Appwerkruimte maximaal 1440 px. Sidebar 240 px, detailpaneel maximaal 608 px. Buitenmarges 24 px, mobiel 16 px; gebruik de bestaande 4/8/12/16/24/32/48/64/96-schaal. Besturing 3 px radius, informatiepanelen recht. Schaduw alleen bij echte lagen zoals een modaal paneel.
Onder 960 px wordt de navigatie een zichtbare horizontale of inklapbare lijst; ze blijft bereikbaar zonder hover. Onder 640 px komen filters onder elkaar en detailpanelen over de volle breedte. Een tabel krijgt een benoemde horizontaal scrollbare regio; verberg nooit stilzwijgend kritieke kolommen. Een mobiel bord wordt een verticale lijst van fasen. De visuele volgorde volgt de DOM. Test lange Nederlandse labels en 200% tekst.
Kleuren voor acties en statussen
../tokens.json is de bron. application-tokens.css bevat de gegenereerde, tot .vr-app beperkte waarden. Merk-oranje is voor merk en primaire acties. Navigatieselectie gebruikt een neutraal vlak; risico krijgt een benoemde status. Gebruik op #FF873E donkere tekst (#0C1013): het contrast is 7,99:1. Witte tekst haalt 2,39:1 en voldoet hier niet aan de WCAG-contrastnorm, ook niet voor grote tekst. Success/petrol, warning/oker, error/rood en info/blauw hebben steeds een tekstlabel en zo nodig een symbool. De exacte domeinstatus blijft leidend: ‘Geboekt’ is iets anders dan ‘Afgerond’ of ‘Geslaagd’.
Licht/donker/automatisch zijn expliciete keuzes. Gebruik uitsluitend semantische variabelen voor ondergrond, tekst, rand, bediening, selectie, focus en status. Scheidingsranden mogen subtiel zijn; de omtrek van een invoerveld moet voldoende herkenbaar blijven. Selectie gebruikt rustige vlakvulling en tekstgewicht, met de juiste geselecteerde toestand voor hulptechnologie. Gebruik geen accentlijn of inset-schaduw als selectiemarkering. Focus heeft een 3 px contrasterende ring met 3 px afstand.
Betrouwbare gegevens
Iedere kernwaarde heeft definitie, eenheid, periode en zo nodig bron en actualiteit. Ontbrekend is ‘Niet beschikbaar’, nul is 0, een raming heet ‘Raming’. Vergelijk alleen vergelijkbare periodes en populaties. Zelfinschatting en kennistoets zijn verschillende meetinstrumenten; hun verschil is geen bewezen leerwinst. Toon certificaten uitsluitend volgens de werkelijke uitgiftevoorwaarden.
Tijdstippen krijgen de relevante tijdzone; relatieve tijd mag naast een exact tijdstip. Deadlines, rechten en geldige statusovergangen worden op de server afgedwongen. UI-uitschakeling is slechts toelichting. Privégegevens worden niet publiek gemaakt door een layoutwijziging.
Rustige beweging
Overgangen 120–180 ms en alleen waar ze toestand verklaren. Respecteer reduced-motion. Geen verplichte confetti, tellers die eerst vanaf nul animeren of geluid bij iedere stap. Geluid vraagt een bewuste keuze. Een tijdslimiet vraagt een functionele reden en waar mogelijk pauze of verlenging.
Grenzen van deze release
De startset demonstreert patronen voor zes producten. Voor productie blijven integratie met opslag, rechten, validatie, synchronisatie, echte brongegevens en projectspecifieke tests nodig. De zes oorspronkelijke applicaties zijn door deze release niet gewijzigd. De bestaande Word- en LinkedIn-sjablonen blijven geldig; hun mediumregels veranderen niet.
Wat de zes projecten nodig hebben
Onderzoek: 8 oktober 2026. Broncode en publieke desktop-/mobielpagina’s bekeken. Geen ingelogde productiehandelingen uitgevoerd. De commitankers staan in research.json. Dit is een ontwerp- en implementatieanalyse, geen volledige beveiligings-, toegankelijkheids- of gebruikerstest.
Commitment Tracker — werk en verantwoording
Bron: Vrulesnl/commitment-tracker, public/index.html, public/style.css, public/app.js, docs/TECHNISCH-PLAN.md. Publiek: loginpagina. De bestaande sidebar, overzichtscijfers, filters, tabel/bord en detaildialoog vormen een bruikbare functionele basis. Veel compacte metadata en tabeltekst vragen om een consequente 14/16 px hiërarchie.
Toevoegen: comfortabele en compacte dichtheid, eenduidige afspraakkaart, detail met afspraak/bron/bewijs/historie, aandacht met concrete reden, concept- en conflictpatroon. Maak persoon, project, richting en deadline scanbaar. Ontvangen en uitgaande afspraken moeten visueel onderscheidbaar zijn zonder afhankelijkheid van kleur.
Bewaren: verplichte onderdelen kunnen afronden blokkeren; bewijs bij afronden; versieconflicten niet overschrijven; spraak/AI-kandidaten eerst laten beoordelen. Een decoratief groen vinkje mag deze regels niet passeren.
Pilot: overzicht met filter → detail bewerken → bewijs toevoegen → afronden. Acceptatie: toetsenbord door hele taak, fout behoudt invoer, bordovergang kent dezelfde regels als formulier, mobiel dezelfde functies.
Bergbasis / Reisplanning — zoeken, kiezen en plannen
Bron: Vrulesnl/bergbasis, AGENTS.md, app/globals.css, componenten voor locatiezoeker, bronnen/provenance, status, mini-map, formulierbescherming en mobiele navigatie. Publiek: vakantie.vrules.nl. Er zijn al patronen voor bronherkomst, echte coördinaten en bescherming van invoer; hergebruik die.
Toevoegen: kaart/lijst-pariteit, vast filtergebied, locatiekaart met feitelijke kenmerken en echte fotoherkomst, vergelijking van 2–4 kandidaten, reis-/stopdetail, leesbare bronnen en onzekerheid. Maak ‘onderzoeken’, ‘shortlist’, ‘geselecteerd’, ‘geboekt’ en ‘bezocht’ afzonderlijke begrippen.
Bewaren: maximaal één geselecteerde/geboekte kandidaat per stop; bezocht is historie; publieke seizoensinformatie versus privé exacte reisdata; onbekende coördinaten geven geen pin. Vergelijkselectie boekt niets en verandert geen kandidaatstatus.
Pilot: locaties filteren → 2–4 vergelijken → kandidaat bij stop bekijken. Acceptatie: geen dataverlies bij navigatie, onvolledige brongegevens zichtbaar, op telefoon vergelijken zonder kritieke criteria kwijt te raken.
DigitalNext — gestructureerd leren
Bron: Vrulesnl/aigeletterdheid, frontend/src/pages/{Dashboard,Lesson,SelfScan,Toets,Voortgang,Certificaten}.tsx, data/learning.ts. Publiek: digitalnext.vrules.nl. De dashboardroute heeft thema’s, modules, zelfscans, toetsen en certificaten. Les- en toetscomponenten hebben al feedback en voortgang.
Toevoegen: vaste lesbreedte, rustige stapnavigatie, hervatstatus, vraag/antwoord/feedbackcomponent, toegankelijke voortgang, certificaatvoorwaarden en tekstalternatief bij grafieken. Scheid zelfinschatting van aangetoonde toetskennis.
Concrete aandacht: Toets.tsx berekent een verschil tussen toets en zelfscan. Noem zo’n verschil niet automatisch leerwinst: de meetmethoden verschillen. Controleer bij migratie ook welke voortgang lokaal of accountgebonden wordt bewaard en zeg dat expliciet tegen gebruikers.
Bewaren: inhoud en echte bronverwijzingen, onderscheid oefening/toets/zelfscan, werkelijke slaaggrens en certificaatvoorwaarden. Geen certificaat uitgeven omdat een demonstratievraag goed is.
Pilot: hervatten → les → oefenvraag → feedback → voortgang. Acceptatie: vorige stap bewaart antwoord, voortgang noemt de juiste scope, sound/reduced-motion gerespecteerd, grafiek ook tekstueel leesbaar.
Scoredock — bestuurlijke informatie en beheer
Bron: Vrulesnl/AI-OKR, components/AppShell.tsx, Layout.tsx, UIStatePanel.tsx, LicensesOverviewSection.tsx, project-/contract-/OKRcomponenten en permissieservices. Publiek: scoredock.app. De vier modules delen organisatiecontext, rechten, dashboards, signalen en bewerking. Dat vraagt een samenhangende app-shell en vergelijkbare detailstructuren.
Toevoegen: contextwissel organisatie/module/periode; tabel- en rapportageregels; KPI’s met bron, actualiteit, periode en eenheid; objecthiërarchie en breadcrumbs; rollen/alleen-lezen; importvoorvertoning en foutregels; consistente signalen.
Concrete aandacht: UIStatePanel.tsx bevat 10 px statuskoppen. LicensesOverviewSection.tsx gebruikt bij sommige formatters Number(value || 0); bij migratie per gegevensveld controleren of afwezig werkelijk nul mag betekenen. Dit is een codebevinding, geen bewering dat ieder live scherm verkeerde cijfers toont.
Bewaren: organisatie- en objectrechten, thema/doel/subdoel/resultaat-hiërarchie, periodebetekenis, contracttermijnen, licentie-eenheden. Houd productie- en demogegevens gescheiden. Respecteer de bestaande staging→main releaseprocedure bij latere implementatie.
Pilot: periode kiezen → signalen filteren → detail met bron bekijken → bewerken als rol dat toestaat. Acceptatie: nul en ontbrekend verschillen, tabellen sorteren getallen correct, rechten servergetest, opgeslagen wijzigingen krijgen bevestiging.
TalentTakeOver — workshop en ontdekking
Bron: Vrulesnl/talent-takeover, gedeelde tto-ui.css, quiz-, groeps-, workshop- en docentpagina’s. Publiek: talent.vrules.nl. Het project heeft een eigen De Borne-afzender, groepvarianten en een energieke vormgeving. Behoud bij een herontwerp de schoolafzender en stem tekst en bediening af op de leeftijdsgroep.
Toevoegen: workshopstappen, grote begrijpelijke antwoordkeuzes, vriendelijke foutfeedback met uitleg, duidelijke leerling-/docentcontext, rustiger bewegingsregels en instelbare tijd waar mogelijk. Pas taal en informatiedichtheid aan de groep aan, niet alleen de kleur.
Bewaren: school/projectafzender en groepsinhoud; quizspel is geen formeel certificaat. Een bestaande 45-seconden-timer vraagt een bewuste productkeuze over pauzeren/verlengen; verwijder spelregels niet stilzwijgend.
Pilot: groep/activiteit → opdracht → keuze → uitleg/herproberen. Acceptatie: toetsenbord en aanraking gelijkwaardig, feedback niet alleen kleur, geen geluid zonder keuze, geen leesbare leerlinggegevens publiek.
DeWKPool — voorspellen en volgen
Bron: Vrulesnl/dewkpool, werkelijk geserveerde api/public/, onder meer voorspellingen.html, stand.html, en bestaande claude/skills/dewkpool-design/. Publiek: dewkpool.nl. Er bestaat al een projectspecifiek designsystem: gebruik het als migratiebron. Let op de dubbele frontendstructuur; wijzigingen in de verkeerde map worden niet live.
Toevoegen: uniforme wedstrijdrij, score-invoer, deadline en vergrendeling, opslag-/offlinefeedback, ranglijst met gelijke standen, actuele versus voorlopige uitslag, consistente navigatie en subpoolcontext. Oranje voor Nederland blijft een productbetekenis, niet iedere kaart krijgt het.
Bewaren: puntentelling, tiebreaks, deadlines en slot op servertijd, privacy van voorspellingen, eigen rangmarkering. Een leeg scoreveld is niet automatisch 0–0; een opgeslagen voorspelling is niet de echte uitslag.
Pilot: wedstrijd kiezen → voorspelling bewaren → vergrendelde toestand → stand bekijken. Acceptatie: geldige 0–0, ongeldige negatieve/decimale invoer afgewezen, geen lokale kloktruc om na deadline te schrijven, herstel zonder dubbele mutatie.
Prioriteit
- Gedeelde basis en gedrag: app-shell, leesbaarheid, statusbetekenis, formulier/detail, fout- en conceptbehoud.
- Per product één verticale pilot zoals hierboven, met echte gegevens en rechten in de eigen testomgeving.
- Brede uitrol: overige schermen, geavanceerde imports/kaarten/bulkacties en regressietests.
Test bij iedere omzetting of gebruikers hun werk kunnen afmaken met echte gegevens. De voorbeelden in deze release zijn nog niet gekoppeld aan de opslag en toegangsrechten van de zes applicaties.
Gedrag per component
Een component is pas af wanneer inhoud, bediening, alle relevante toestanden en herstel zijn beschreven. Gebruik native HTML waar mogelijk; maak geen ARIA-grid van een gewone tabel.
| Component | Anatomie en gedrag | Randgevallen en acceptatie |
|---|---|---|
| App-shell | Project/organisatie, hoofdnavigatie, actieve route, h1, taakactie. Routes zijn links; lokale weergavewissels zijn knoppen. | Geen decoratieve accentlijn of inset-schaduw voor de actieve route. Gebruik neutrale vlakvulling, tekstgewicht en aria-current of aria-pressed waar van toepassing. Geen bovenkop die alleen de actieve route herhaalt. Geen dubbele actieve routes. Organisatiewissel benoemt scope en bewaakt onopgeslagen werk. Mobiel blijft dezelfde taak bereikbaar. |
| Zoek- en filterbalk | Zichtbaar label, zoekveld, relevante filters, resultaataantal, wisactie. | Nul resultaten verschilt van een lege database. Filters blijven bij terugkeer behouden. Kies URL-query voor deelbare filters; geen privézoektekst in publieke URL’s. |
| Gegevenstabel | Caption, echte th/td, scope, eenheden in kop, benoemde rijacties. Sorteerknop met aria-sort op th. | Null ≠ 0; geen klikbare hele rij zonder aparte link/knop. Sorteer numeriek/datumgetrouw. Paginering of virtualisatie alleen waar aantallen het vragen; aangekondigd bereik en behouden selectie. |
| Bulkselectie | Checkbox per rij en ‘selecteer deze pagina’, aantal geselecteerd, expliciete actie. | Selectie buiten filter of pagina moet benoemd worden. Geen stilzwijgende selectie van alle records. Bulkmutatie kent serverrechten en gedeeltelijke fouten. |
| Bord | Gelabelde fasen, aantal, compacte objectkaart, eigenaar en relevante deadline. | Verplaatsen kan via toetsenbordbesturing/selectie, niet uitsluitend slepen. Server controleert overgang. Op telefoon fasen onder elkaar. |
| Formulier | Permanent label, uitleg vóór invoer waar nodig, veldfout via aria-describedby, aria-invalid. | Toon fouten na submit of zinvol veldmoment, behoud alle invoer, focus eerste fout. Gebruik foutoverzicht bij veel fouten. Opslaan = pas succes na bevestigde opslag. Voorkom dubbel verzenden. |
| Detailpaneel / modal | Titel, sluitknop, logische volgorde, inhoud, taakacties. Native dialog met showModal in referentie. | Focus naar zinvol begin, binnen modal, Escape sluit via conceptbewaking, focus terug naar opener. Achtergrond inert. Bij onopgeslagen invoer: doorgaan met bewerken of expliciet verwerpen. |
| Tabs / stappen | Tabs alleen voor panelen binnen één object, volgens APG met pijltjestoetsen. Stappen tonen huidige stap en totaal. | Geen tabs gebruiken als onvolledige imitatie van routing. Vorige stap bewaart antwoorden. Verplichte invoer voorkomt onbedoeld overslaan. |
| Status en melding | Kort label + verklaring + mogelijke vervolgactie. Inline bij het betrokken object. | Kleur is aanvullend. role=status voor niet-dringende feedback, role=alert voor urgente fouten. Geen hele werkruimte als live region. Toast nooit enige plek van belangrijke foutinformatie. |
| Voortgang | Benoemde progress/max-waarden, tekst ‘3 van 8’, volgende stap. | Onderscheid gelezen, afgerond, getoetst en geslaagd. Onbekende duur geen schijnnauwkeurige percentagebalk. |
| Vergelijking | 2–4 gekozen objecten, dezelfde criteria/eenheden/bronkwaliteit, verwijder per object. | Vijfde selectie geeft verklaring. Selectie verandert geen boekingsstatus. Mobiel scrollregio met blijvende attribuutnamen of gestapelde vergelijkbare blokken. |
| Kaart/lijst | Werkelijke coördinaten, legenda, equivalent bereikbare lijst, geselecteerd object gedeeld. | Geen coördinaten? Geen gefingeerde pin. Verberg adres/reisdata volgens privacyregels. Map-provider en attributie blijven zichtbaar. |
| Kalender / tijdlijn | Datum, tijdzone, eigenaar/gebeurtenis en bron. Dag/maandnav heeft duidelijke namen. | Exacte deadlines niet alleen ‘morgen’. Zomertijd/grensgevallen testen. Datumvelden mogen native zijn; bereik heeft begin/eindvalidatie. |
| Grafiek / KPI | Naam, eenheid, periode, schaal, legenda, vergelijking en datatabel. | Nulbasis bij balken tenzij duidelijk gemotiveerd; ontbrekende waarden niet interpoleren zonder uitleg. Teken/patroon naast kleur. Geen ‘groei’ uit onvergelijkbare metingen. |
| Leerroutine / quiz | Eén vraag of beperkte taak, permanente antwoordlabels, expliciete controle, inhoudelijke feedback. | Geen schaamtecopy. Herproberen en hervatten volgens productregels. Timer waar mogelijk verstelbaar. Leraar-/leerlingrechten worden technisch geborgd. |
| Score-invoer / ranglijst | Deelnemerslabels, niet-negatieve gehele scores, opslagstatus, deadline/slot. | Invoer 0–0 is geldig; ontbrekend niet 0–0. Vergrendeling op servertijd. Gelijke punten volgens vastgelegde tie-break, nooit willekeurige rang suggereren. |
| Import / bronbewijs | Bestandsvereisten, inspectie, mapping, voorvertoning, rijgebonden fouten, bevestiging. | Onbekend formaat verandert geen records. Formules/tekst blijven data; AI-extractie blijft voorstel tot review. Toon herkomst en bewerkingsgeschiedenis. |
Toestanden, voor ieder asynchroon werkgebied
- Laden: benoem wat laadt; aria-busy op het betrokken gebied. Skeletons alleen met stabiele geometrie. Geen verzonnen nulwaarden tijdens laden.
- Leeg: leg uit wat hier verschijnt en geef een passende eerste actie.
- Geen zoekresultaten: behoud zoekterm/filters; bied wissen aan.
- Opslaan: duidelijke voortgang, dubbele submit voorkomen, invoer bewaren.
- Opgeslagen: bevestiging met juiste scope en waar relevant tijdstip.
- Fout: feitelijke oorzaak voor zover bekend, bewaarde invoer, herstelactie. Geen blinde automatische herhaling van mutaties.
- Offline / verouderd: laatste succesvolle synchronisatie, welke handelingen beschikbaar zijn; geen offline-opslag beloven zonder implementatie.
- Conflict: toon lokale en nieuwe serverversie of bied opnieuw laden met conceptbehoud; nooit stil overschrijven.
- Geen toegang / alleen lezen: uitleg en legitieme vervolgroute; geen gevoelige inhoud lekken. Verbergen van knoppen vervangt geen serverautorisatie.
- Uitgeschakeld: reden nabij besturing, geen onleesbare tekst. Read-only blijft leesbaar/selecteerbaar en is geen foutstatus.
Referentie versus productie
De werkplaats implementeert native dialog/focus, conceptbewaking, validatie, zoeken, statusfilter, tabel/bord, sorteren, vergelijking, voortgang, quizfeedback en scorevergrendeling als lokale voorbeelden. Navigatie wisselt zes demonstraties. Herladen reset de voorbeelden. Native confirm voor verwerpen is een functionele referentie; een product mag een gelijkwaardig toegankelijk bevestigingsvenster gebruiken. Conflict en offline zijn zichtbaar gekozen simulaties; koppel in productie echte foutcodes en retry-semantiek.
Niet als complete code geleverd: backendautorisatie, datagridvirtualisatie, bulkmutaties, kaartprovider, bestandsimport, betalings- of boekingsflow. Gebruik het contract en de bestaande projectimplementatie; presenteer documentatie niet als geteste productiefunctionaliteit.
Controle voor publicatie
Voor iedere gewijzigde werkstroom
- Voer de hoofdtaak uit met realistische lange tekst, lege waarden, nulwaarden en foutieve invoer. Controleer opgeslagen resultaat, niet alleen de klik.
- Test laden, leeg, geen resultaten, fout, succes, alleen-lezen en de relevante conflict/offlinevariant. Er is altijd een concrete volgende stap; een fout wist geen invoer.
- Doorloop met toetsenbord: logische focusvolgorde, zichtbare focus, geen verborgen element in tabvolgorde, Escape en focusherstel bij dialogen. Native controls behouden hun normale bediening.
- Controleer 320, 390, 768, 1440 px, plus 200% tekstvergroting. Geen pagina-overflow, afgekapt label of verborgen primaire actie. Een tabel mag in een benoemde regio scrollen. Controleer softwaretoetsenbord en sticky elementen op een echte telefoon bij productacceptatie.
- Controleer licht, donker en OS-voorkeur; reduced-motion; kleurcontrast van tekst en noodzakelijke bediening. Streef naar WCAG 2.2 AA. Een paar automatische checks bewijst geen volledige conformiteit.
- Controleer namen/rollen/waarden met accessibility tree en bij productacceptatie een screenreader. Test ook lange vertalingen, datumnotatie, tijdzones en numerieke sortering.
- Controleer backendrechten, deadlines, dubbele submits, versieconflicten en herladen. Referentie-JavaScript is geen autorisatie- of opslaglaag.
- Leg routes, apparaten, testresultaten, beperkingen en screenshots vast. Publiceer alleen met de actuele autorisatie en het eigen releaseproces van het project.
Maatstaven
De gebruiker kan de huidige context aanwijzen, de eerstvolgende taak vinden, een status verklaren en een fout zelfstandig herstellen. Meet bij een productpilot taakvoltooiing, mislukte invoer, herstel en ervaren duidelijkheid. Leg eerst een nulmeting vast; verzin geen verbeterpercentages. Houd renderwerk licht: geen zware decoratieve video, onnodige fonts of extra framework voor een statische tabel.
Referenties
- WCAG 2.2: minimale doelgrootte. Vrules kiest 44 px als eigen touchstandaard.
- Focus mag niet volledig bedekt zijn.
- WAI-ARIA modal dialog.
- WAI-ARIA tabs.
Releasecontroles voor deze startset staan in QUALITY.md. Productacceptatie in de zes apps volgt bij hun eigen migratie.
Controle op decoratie
Inspecteer navigatie, lijst-/bordkeuzes, formulieren en meldingen in de render én CSS. Geen gekleurde zijlijn, pseudo-element of inset-schaduw als accent. Controleer focus apart met Tab; de focusring moet zichtbaar blijven. Controleer foutmeldingen met ongeldige invoer; veldrand en tekst blijven herkenbaar. Lees bovenkop en titel samen: verwijder de bovenkop als deze geen extra context geeft. Hoofdletters of letterspatiëring zijn geen reden om een redundant label te behouden.
Dichtheid
- Compact is de standaard op desktop; comfortabele modus blijft beschikbaar.
- Eerste echte inhoud en bediening staan dichtbij de paginakop. Geen lege hero of vaste lege paneelhoogte.
- Paneelpadding en gridgap 16 px; geen dubbele margins tussen groepen.
- Tekst blijft 16 px, metadata 14 px en touchdoelen minimaal 44 px. Meerregelige inhoud groeit mee.
- Controleer 1440 × 900, 390 × 844 en 200% tekst op overloop en leesbaarheid.
Visuele rijkdom
- Kleur ondersteunt benoemde inhoud; de interface gebruikt meer van de huisstijl dan alleen oranje knoppen wanneer de inhoud daar aanleiding toe geeft.
- Inhoudstinten overschrijven geen statuslabels, invoervelden of knopcontrast.
- Hoofdgetal, toelichting en metadata hebben verschillende typografische rollen.
- Zachte en sterke vlakken zijn gecontroleerd in licht en donker; gewone tekst haalt minimaal 4,5:1 contrast.
Toepassen in een bestaande applicatie
Werk per verticale taak
- Lees repository-instructies, routes, bestaande tokens, componenten en releaseafspraken. Kies Vrules-identiteit of een expliciet overeengekomen projectvariant.
- Maak een inventaris van schermen, toestanden en domeinregels. Gebruik het profiel als start, controleer de huidige bron; het onderzoek van 8 oktober 2026 is een momentopname.
- Introduceer de semantische applicatietokens in een afgebakende root. Map bestaande componenten naar deze waarden. Gebruik geen globale reset die de publieke site onbedoeld wijzigt.
- Bouw één werkstroom van overzicht tot bevestigde handeling. Begin bij Commitment Tracker met overzicht/detail/afronden; zie de andere pilots in de profielen.
- Koppel echte data en backendfouten. Laat de app bestaande auth, rechten, opslag en statusovergangen gebruiken. Demo-opslag in geheugen mag nooit stilzwijgend in productie overblijven.
- Voer de kwaliteitsmatrix uit, laat doelgroepgebruikers de taak proberen, corrigeer en breid daarna uit. Publiceer via het projectproces en bewaar een terugvalversie.
Overdracht aan ontwikkeling
Lever broncode, tokenmapping, component-/toestandenlijst, domeinregels, screenshots, uitgevoerde checks en open punten. Benoem welke data fictief is en welke endpoints nog gekoppeld moeten worden. Behandel ontwerp en backendcontract als twee expliciete onderdelen.
De startset is gewone HTML, CSS en JavaScript, zonder installatie. In React/Next vertaal je de markup en lokale state naar bestaande componenten en hooks; behoud semantiek en toetsenbordgedrag. Hergebruik Base UI/shadcn waar al aanwezig. Voor vanilla apps kan scoped CSS rechtstreeks worden opgenomen. De referentie mag niet als losse iframe boven de echte applicatie worden geplakt.
Versiebeheer
2.3.0 is een additieve minorrelease. Merklogo en kernfonts blijven gelijk. De bestaande Office-sjablonen blijven gelden. Publiceer wijzigingen aan gedeelde tokens met impactlijst; werk CSS, skill, plugin en downloads vanuit dezelfde bron bij. Een verandering in statusbetekenis vraagt een migratienotitie, ook wanneer de kleur hetzelfde blijft.
De skill gebruiken
De applicatieregels en startset zitten ook in de vernieuwde skill. Gebruik dezelfde aanroep in een omgeving waarin de skill beschikbaar is:
sk-vrules: ontwerp deze applicatie met Vrules 2.4. Begin bij de hoofdtaak, behoud de bestaande werking en werk overzicht, detail en foutafhandeling uit. Controleer desktop, mobiel en toetsenbordbediening.
Installatie en gebruik · Onderzochte bronversies · Uitgevoerde controles