KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / CSS

:modal — pseudoklasse voor de modale toestand

De pseudoklasse :modal selecteert elementen in een modale toestand, niet simpelweg zichtbare of geopende elementen. Je kunt er bijvoorbeeld een dialoogvenster mee opmaken dat met showModal() is geopend, en het onderscheiden van een venster dat met show() is geopend.

Versie: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Syntax

:modal

:modal is een pseudoklasse zonder argumenten die overeenkomt met een element in een toestand waarin interactie met elementen erbuiten is uitgesloten. De selector dialog:modal beperkt de selectie tot dialog-elementen. Een CSS-regel reageert alleen op deze toestand en schakelt de modaliteit niet zelf in.

In HTML komt de pseudoklasse overeen met dialog-elementen waarvan de interne modale toestand waar is, en met elementen waarvan de fullscreen-vlag is ingesteld. showModal() opent een dialoogvenster modaal; show() opent het niet-modaal. Alleen het attribuut open betekent dus niet dat :modal overeenkomt: dialog[open] selecteert zowel geopende modale als geopende niet-modale dialoogvensters.

Beschouw :modal niet als synoniem voor het actieve venster of als een selector die uitsluitend voor dialoogvensters bedoeld is. Meerdere elementen kunnen tegelijk overeenkomen met :modal, hoewel er maar één actief is en invoer kan ontvangen. Dat ook fullscreen-elementen worden geselecteerd, is een extra reden om dialog:modal te gebruiken wanneer een stijl alleen voor dialoogvensters bedoeld is.

Het voorbeeld legt matches(':modal') vast voor een gesloten dialoogvenster, na show() en na een klik op de knop die showModal() aanroept. De verwachte waarden zijn achtereenvolgens false, false en true; het modale dialoogvenster krijgt een groene rand. Controleer het voorbeeld lokaal in de doelbrowser.

Voorbeelden

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>:modal test</title>
<style>
  dialog { border: 3px solid gray; }
  dialog:modal { border-color: green; }
</style>
<button id="open" type="button">Open modal</button>
<dialog id="panel" aria-label="Modal test">
  <p>Modal dialog</p>
  <form method="dialog"><button>Close</button></form>
</dialog>
<pre id="result"></pre>
<script>
  const panel = document.querySelector('#panel');
  const result = document.querySelector('#result');
  const lines = [];
  function record(label) {
    lines.push(`${label}: ${panel.matches(':modal')}`);
    result.textContent = lines.join('\n');
  }
  record('closed');
  panel.show();
  record('show()');
  panel.close();
  document.querySelector('#open').addEventListener('click', () => {
    panel.showModal();
    record('showModal()');
  }, { once: true });
</script>
</html>

Resultaat

closed: false
show(): false
showModal(): true

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