diff --git a/docs/baseline/2024-12.mdx b/docs/baseline/2024-12.mdx new file mode 100644 index 0000000000..9050828630 --- /dev/null +++ b/docs/baseline/2024-12.mdx @@ -0,0 +1,35 @@ +--- +title: Baseline december 2024 +hide_title: true +hide_table_of_contents: false +sidebar_label: Baseline december 2024 +pagination_label: Baseline december 2024 +description: De softwareversies waarmee we in december 2024 voor NL Design System testen voor Baseline support. +slug: /baseline/2024-12 +keywords: + - Accessibility Support Baseline + - Baseline + - browser support + - browserversie +--- + +{/* @license CC0-1.0 */} + +# NL Design System Baseline: december 2024 + +## Software om mee te testen + +De laatste versies van software op 15 december 2024 zijn: + +- [Chrome 131](https://chromereleases.googleblog.com/2024/12/stable-channel-update-for-desktop_10.html) of [Edge 132](https://learn.microsoft.com/en-us/deployedge/microsoft-edge-relnote-beta-channel#version-1320295711-november-22-2024) +- Chrome 131 of Edge 132 met [de screenreader JAWS 2025](https://support.freedomscientific.com/Downloads/JAWS/JAWSWhatsNew?version=2025) op [Windows 11](https://www.microsoft.com/en-us/software-download/windows11) +- Chrome 131 of Edge 132 met [de screenreader NVDA 2024.4.1](https://www.nvaccess.org) op Windows 11 +- [Chrome 131 op Android](https://chromereleases.googleblog.com/2024/12/chrome-for-android-update.html) +- Chrome 131 op Android met [de screenreader Talkback](https://support.google.com/accessibility/android/answer/6007100?hl%3Den) +- Chrome 131 op Windows 11 of [macOS 15 Sequoia](https://www.apple.com/newsroom/2024/09/macos-sequoia-is-available-today/) +- [Firefox 133](https://www.mozilla.org/en-US/firefox/133.0/releasenotes/) +- Firefox 133 met de screenreader NVDA 2024.4.1 op Windows 11 +- Safari 18 op [iOS 18](https://www.apple.com/ios/ios-18/) +- Safari 18 op iOS 18 met de screenreader VoiceOver +- Safari 18 op macOS 15 +- Safari 18 op macOS 15 met de screenreader VoiceOver diff --git a/docs/baseline/README.mdx b/docs/baseline/README.mdx new file mode 100644 index 0000000000..f20eeff5be --- /dev/null +++ b/docs/baseline/README.mdx @@ -0,0 +1,104 @@ +--- +title: Baseline +hide_title: true +hide_table_of_contents: false +sidebar_label: Baseline +sidebar_position: 5 +pagination_label: Baseline +description: In de NL Design System Baseline wordt beschreven welke besturingssytemen, browsers en hulpapparatuur worden ondersteund. +keywords: + - Accessibility Support Baseline + - Baseline + - browser support + - browserversie + - Can I Use + - WCAG +--- + +import { Paragraph, SpotlightSection } from "@utrecht/component-library-react/dist/css-module"; + +{/* @license CC0-1.0 */} + +# NL Design System Baseline + + + Wij maken technologie voor gebruikers, daarom bepalen we hier welke browsers en hulpmiddelen zoveel gebruikt worden + dat je moet zorgen dat het er goed mee werkt. + + +Met deze Baseline stellen we vast welke technologieën NL Design System ondersteunt. Het kernteam gebruikt de Baseline om mee te testen tijdens het ontwikkelen van de Candidate en Hall of Fame componenten en webpagina's. + +We raden gebruik van de Baseline voor ontwikkelingen met NL Design System aan, maar het kernteam stelt deze niet verplicht voor Community bijdragen. Organisaties kunnen kiezen deze Baseline bij opdrachten of aanbestedingen wel verplicht te maken. + +Als je een developer of tester bent, dan kun je de NL Design System Baseline gebruiken om vooraf te beslissen welke techonologie je gebruikt, en achteraf gebruiken om een testplan mee uit te voeren. + +## Technologie met brede ondersteuning + +De populaire website [Can I Use](https://www.caniuse.com/) biedt een gebruiksvriendelijk overzicht of de browserondersteuning voldoende is. Als een feature de Data Badge heeft met "Widely available across major browsers", dan kun mag je de feature gebruiken. + +Features met de Data Badge "Newly available across major browsers" moet je alleen gebruiken als je ook een goed werkend alternatief biedt met Baseline ondersteuning. + +We gebruiken Can I Use omdat ze een goed systeem hebben. Op basis van [statistieken in de RUM Archive](https://rumarchive.com/insights/#ua-marketshare) wordt bepaald welke browserversies wereldwijd veel gebruikt worden. Per technologie is bekend in welke browserversie de ondersteuning begint. Met de gecombineerde informatie kun je weten of browserondersteuning voldoende in browsersversies die tussen 30 maanden geleden en nu zijn gepubliceerd. Dit is wat Can I Use doet. + +Bijvoorbeeld: [CSS Grid Layout](https://caniuse.com/css-grid) wordt goed ondersteund en daarom gebruiken we `display: grid`. Maar [CSS Subgrid](https://caniuse.com/css-subgrid) is eind 2024 nog gemarkeerd als "Newly available across major browsers" en daarom gebruiken we CSS Subgrid nog niet. + +## Software om mee te testen + +De volgende combinaties van software moet je mee testen voor functionaliteit en WCAG 2.2 successcriteria. Gebruik de laatste versie van alle software. + +- Chrome met [de screenreader JAWS](https://www.freedomscientific.com/products/software/jaws/) op Windows +- Chrome met [de screenreader NVDA](https://www.nvaccess.org) op Windows +- Chrome op Android +- Chrome op Android met [de screenreader Talkback](https://support.google.com/accessibility/android/answer/6007100?hl%3Den) +- Chrome op Windows of macOS +- Firefox +- Firefox met de screenreader NVDA op Windows +- Safari op iOS +- Safari op [iOS met de screenreader VoiceOver](https://support.apple.com/en-gb/guide/iphone/iph3e2e415f/ios) +- Safari op macOS +- Safari op [macOS met de screenreader VoiceOver](https://support.apple.com/en-gb/guide/voiceover/welcome/mac) + +Als bepaalde functionaliteit niet blijkt te werken in oudere softwareversies die minder oud zijn dan 30 maanden, overweeg dan wel om het probleem op te lossen en te testen in specifieke oudere softwareversies. + +## Testen voor toegankelijkheid + +Om vast te kunnen stellen of iets toegankelijk is en voldoet volgens WCAG, mag je zelf kiezen welke technologie je ondersteunt: de [Accessibility Support Baseline](https://www.w3.org/TR/WCAG-EM/#step1c). Voor NL Design System is dat vastgelegd op deze pagina. + +Het toegankelijkheidsdoel van NL Design System is WCAG 2.2 Niveau AA. Daarmee voldoen we aan de wettelijke eis voor WCAG 2.1, plus enkele nieuwe successcriteria. + +Als je een [WCAG-EM toegankelijkheidsonderzoek doet](https://www.w3.org/TR/WCAG-EM/), test dan met elke combinatie van software in lijst. + +Je kunt de NL Design System Baseline noemen bij je onderzoeksrapport onder "basisniveau van toegankelijkheidsondersteuning". Je kunt verwijzen naar de Baseline momentopname onder ["bij het onderzoek gebruikte browsers en softwareprogramma's"](https://www.digitoegankelijk.nl/toegankelijkheidsverklaring/controle). + +## Momentopname + +Technologie verandert elke maand, dus de preciese betekenis van de Baseline verandert. Op de NL Design System website publiceren we periodiek een momentopname van welke softwareversies op dat moment worden bedoeld met de Baseline. De eerste in de serie is de [Baseline december 2024](/baseline/2024-12). + +Maak duidelijke afspraken welke versie van de Baseline je kiest als doel. Er zijn heel veel opties denkbaar, bijvoorbeeld: + +- Spreek voor een toegankelijkheidsonderzoek af dat de meest recente versies van alle software wordt gebruikt. +- Spreek bij het aanbesteden van software af dat de meest recente Baseline momentname geldt die beschikbaar is bij aanvang van de werkzaamheden. + + + +## Voor wie is de Baseline bedoeld? + +De Baseline is in eerste instantie bedoeld voor ontwikkelingen waarin het kernteam een rol speelt: + +- Candidate componenten +- Voorbeeld-webpagina's +- Toegankelijkheidsonderzoeken naar de NL Design System website en voorbeeld-webpagina's + +## Hall of Fame + +Voor Hall of Fame componenten vragen we nog feedback aan stakeholders zoals belangenorganisaties, testers en ontwikkelaars in de Community. Welke software en welke softwareversies zijn belangrijk om op te nemen in de Baseline? + +[Deel je inzichten met het kernteam](/colofon), dat waarderen wij enorm! + +### Community + +De baseline is **niet verplicht** voor Community componenten en als je met NL Design System werkt. + +Organisaties kunnen natuurlijk wel vrijwillig de NL Design System Baseline vereisen bij het aanbesteden van nieuwe ontwikkelingen en bij toegankelijkheidsonderzoeken, als ze een op zoek zijn naar een goede Accessibility Support Baseline. + + diff --git a/sidebarConfig.ts b/sidebarConfig.ts index f90155d29f..810fb3bbbc 100644 --- a/sidebarConfig.ts +++ b/sidebarConfig.ts @@ -98,6 +98,15 @@ const sidebars: SidebarsConfig = { // }, { type: 'doc', id: 'handboek/leverancier/introductie' }, { type: 'doc', id: 'handboek/manager/introductie' }, + { + type: 'category', + label: 'Baseline', + link: { + type: 'doc', + id: 'baseline/README', + }, + items: [{ type: 'autogenerated', dirName: 'baseline' }], + }, ], }, ],