KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

aria-modal — semantiek van modale dialogen

Het attribuut aria-modal vertelt ondersteunende technologieën of een weergegeven element modaal is, wat betekent dat interactie beperkt is tot de inhoud ervan. Het blokkeert de achtergrond niet en beheert de focus niet zelf: de verklaring moet overeenkomen met het werkelijke gedrag van de interface.

Versie: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

aria-modal="true" | aria-modal="false"

aria-modal is een WAI-ARIA-eigenschap in HTML die aangeeft of een weergegeven element modaal is. De waarde true geeft modaliteit aan; false is de standaardwaarde. Deze eigenschap gebruikt de tekstwaarden true en false en volgt niet de syntaxis van HTML-booleaanse attributen: schrijf de attribuutnaam niet zonder waarde. De eigenschap wordt ondersteund op de rollen dialog en alertdialog, niet algemeen op willekeurige elementen.

aria-modal="true" geeft semantiek door aan ondersteunende technologieën, die de navigatie mogelijk beperken tot de inhoud van de dialoog. Het opent geen dialoog, blokkeert geen klikken op de achtergrond en verplaatst of houdt de focus niet vast. Stel deze waarde alleen in wanneer de interface daadwerkelijk voorkomt dat iedereen interactie heeft met inhoud buiten de dialoog en de achtergrond visueel wordt gedimd of afgedekt.

Verplaats bij het openen de focus naar de dialoog en houd de volgorde van Tab en Shift+Tab daarbinnen. Zorg voor een sluitknop in de dialoog en ondersteun Escape; herstel bij het sluiten doorgaans de focus naar het element dat de dialoog heeft geopend. Geef de dialoog een toegankelijke naam, bijvoorbeeld via aria-labelledby dat verwijst naar de zichtbare kop. Alle bedieningselementen die nodig zijn om de dialoog te gebruiken, moeten afstammelingen ervan zijn.

Het voorbeeld gebruikt een native dialoog die met showModal() wordt geopend, in plaats van het modale gedrag handmatig na te bootsen. In dit geval is aria-modal="true" overbodig, omdat native modaliteit al aan ondersteunende technologieën wordt doorgegeven; het blijft staan om de syntaxis te laten zien. Alleen het attribuut toevoegen aan een gewone container zorgt niet voor dit gedrag. Controleer de toetsenbordbediening en de semantiek in de toegankelijkheidsboom afzonderlijk.

Voorbeelden

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>aria-modal example</title>
<style>
  dialog::backdrop { background: rgb(0 0 0 / 50%); }
</style>
<button id="open" type="button">Open dialog</button>
<dialog id="notice" aria-modal="true" aria-labelledby="heading">
  <h2 id="heading">Notice</h2>
  <p>This dialog blocks interaction with the page.</p>
  <button id="close" type="button" autofocus>Close</button>
</dialog>
<script>
  const opener = document.getElementById('open');
  const notice = document.getElementById('notice');
  const closer = document.getElementById('close');
  opener.addEventListener('click', () => notice.showModal());
  closer.addEventListener('click', () => notice.close());
  notice.addEventListener('close', () => opener.focus());
</script>
</html>

Resultaat

Initially, only Open dialog is visible. Activating it opens Notice, dims the background, and focuses Close. Background controls cannot be activated while the dialog is open. Close or Escape dismisses the dialog and returns focus to Open dialog.

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen