Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: add NL Design System Baseline #1826

Open
wants to merge 6 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from 4 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 35 additions & 0 deletions docs/baseline/2024-12.mdx
Original file line number Diff line number Diff line change
@@ -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
87 changes: 87 additions & 0 deletions docs/baseline/README.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,87 @@
---
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

<Paragraph lead>
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.
</Paragraph>

Met deze Baseline stellen we vast welke technologieën we ondersteunen. Deze gebruiken we vervolgens om mee te testen tijdens het ontwikkelen van de componenten en webpagina's.
Yolijn marked this conversation as resolved.
Show resolved Hide resolved
Yolijn marked this conversation as resolved.
Show resolved Hide resolved

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.
Robbert marked this conversation as resolved.
Show resolved Hide resolved

Uiteindelijk kun je de NL Design System Baseline noemen bij je onderzoeksrapport onder "basisniveau van toegankelijkheidsondersteuning".
Robbert marked this conversation as resolved.
Show resolved Hide resolved

## 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 "Baseline" heeft voor "<span lang="en">Widely available across major browsers</span>", dan kun mag je de feature gebruiken.

Features met de badge "<span lang="en">Newly available across major browsers</span>" 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 bijvoorbeeld goed ondersteund en daarom gebruiken we `display: grid`. Maar [CSS Subgrid](https://caniuse.com/css-subgrid) is eind 2024 nog gemarkeerd als "Baseline 2023" (<span lang="en">Newly available across major browsers</span>") en daarom gebruiken we CSS Subgrid nog niet.
Robbert marked this conversation as resolved.
Show resolved Hide resolved

## 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.
hidde marked this conversation as resolved.
Show resolved Hide resolved

- 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.

<SpotlightSection appearance="info">

## Voor wie is de Baseline bedoeld?

De Baseline is in eerste instantie bedoeld voor ontwikkelingen waarin het kernteam een rol speelt:

- Candidate en Hall of Fame componenten
- Voorbeeld-webpagina's
- Toegankelijkheidsonderzoeken naar de NL Design System website en voorbeeld-webpagina's

### 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.

</SpotlightSection>
9 changes: 9 additions & 0 deletions sidebarConfig.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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' }],
},
],
},
],
Expand Down
Loading