KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

command: een knop een declaratieve actie geven

Roep ingebouwde dialoog- of popoveracties aan of verstuur een eigen opdracht.

Versie: HTML Living Standard

Syntax

<button type="button" command="show-modal" commandfor="details">Open</button>

Het attribuut command geeft een knop een actie voor het element dat als opdrachtdoel is aangewezen. Ingebouwde waarden zijn onder meer show-modal, close en request-close voor dialogen, plus acties om popovers te tonen, verbergen of wisselen. De actie moet geldig zijn voor het doel. Ontbrekende of onbekende waarden worden geen willekeurige JavaScript en voeren geen brontekst uit.

Eigen opdrachtnamen beginnen met -- en versturen een gebeurtenis die toepassingscode moet afhandelen; ze verzinnen geen ingebouwde bewerking. Een geannuleerde opdrachtgebeurtenis verhindert de standaardactie. Gebruik type="button" als het veld geen formulier moet verzenden of resetten. Een uitgeschakelde knop roept de actie niet aan en deze nieuwere opdrachtondersteuning vraagt om controles van de mogelijkheden.

Het voorbeeld gebruikt twee ingebouwde knoppen om een modale dialoog te tonen en te sluiten. Chromium 145 voert beide acties uit zonder toepassingshandlers in de ondersteunde tak. Een apart terugvalpad installeert expliciete handlers wanneer de DOM-mogelijkheid ontbreekt. Het geteste resultaat betreft deze browser, niet elke ingebedde WebView of oudere engine.

Voorbeelden

<!doctype html><meta charset="utf-8">
<button id="open" type="button" command="show-modal" commandfor="details">Open</button>
<dialog id="details"><p>Details</p><button id="close" type="button" command="close" commandfor="details">Close</button></dialog>
<output id="result"></output><script>
const open = document.querySelector('#open'), details = document.querySelector('#details');
if ('command' in open && 'commandForElement' in open) {
  open.click(); const opened = details.open && details.matches(':modal');
  document.querySelector('#close').click();
  document.querySelector('#result').textContent = 'opened=' + opened + '; closed=' + !details.open;
} else {
  open.onclick = () => details.showModal();
  document.querySelector('#close').onclick = () => details.close();
  document.querySelector('#result').textContent = 'command unsupported; explicit handlers installed';
}
</script>

Resultaat

opened=true; closed=true

In de geverifieerde tak openen en sluiten ingebouwde opdrachten de dialoog; de terugvalhandlers worden niet geïnstalleerd.

Bronnen