KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

commandfor: de opdracht van een knop naar het doel leiden

Verbind één knop met een specifiek element, niet met een CSS-selector of alle overeenkomende knooppunten.

Versie: HTML Living Standard

Syntax

<button type="button" command="--mark" commandfor="first">Mark</button>

Het attribuut commandfor bevat de ID van het element waarop de opdracht van de knop is gericht. Het doel moet zich in dezelfde boom bevinden. Schrijf de ID zelf, geen CSS-selector met een hekje ervoor. De DOM-eigenschap commandForElement geeft het gekoppelde element terug waar de functie wordt ondersteund. Een ontbrekend of niet gevonden doel kan de bedoelde opdracht niet ontvangen.

Het attribuut kiest de ontvanger; command levert de bewerking. Een eigen bewerking maakt een CommandEvent waarvan opdracht en bron het verzoek en de aanroepende knop identificeren. Toepassingscode moet dat eigen gedrag implementeren. Gebruik expliciet een knoptype dat geen formulier verzendt en vermijd dubbele ID’s, die de bedoelde koppeling onbetrouwbaar maken.

De testopstelling heeft twee mogelijke doelen maar stuurt de eigen opdracht alleen naar het eerste. De listener daarvan markeert dat element en registreert de opdrachtnaam en bronknop; de tweede listener wordt niet gebruikt. Chromium 145 bevestigt de ingebouwde routering. Een browser zonder ondersteuning meldt de ontbrekende mogelijkheid in plaats van te doen alsof de bewerking is uitgevoerd.

Voorbeelden

<!doctype html><meta charset="utf-8">
<button id="send" type="button" command="--mark" commandfor="first">Mark</button>
<div id="first">First target</div><div id="second">Second target</div><output id="result"></output>
<script>
const send = document.querySelector('#send'); let second = false;
document.querySelector('#second').addEventListener('command', () => { second = true; });
document.querySelector('#first').addEventListener('command', event => {
  event.currentTarget.dataset.marked = 'yes';
  document.querySelector('#result').textContent = 'target=' + event.currentTarget.id + '; command=' + event.command + '; source=' + event.source.id + '; second=' + second;
});
if ('commandForElement' in send) send.click();
else document.querySelector('#result').textContent = 'commandfor unsupported; install an explicit event-routing fallback';
</script>

Resultaat

target=first; command=--mark; source=send; second=false

Het gemarkeerde doel, de opdrachttekst, de bronknop en het onaangeraakte tweede doel worden allemaal in de echte browser gecontroleerd.

Bronnen