CKTIS / HTML
oncommand — het command-event afhandelen
Het oncommand-attribuut geeft JavaScript op dat wordt uitgevoerd wanneer een command-event wordt ontvangen. Het hoort op het element dat de opdracht ontvangt; het selecteert niet het doel en start zelf geen opdracht.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
oncommand="JavaScript statements"oncommand is een globaal contentattribuut voor eventafhandeling van het command-event, beschikbaar op HTML-elementen. De waarde is de body van een JavaScript-functie, geen opdrachtnaam. Aan de DOM-tegenhanger element.oncommand kan een functie worden toegewezen.
In het opdrachtmechanisme gebruikt een knop commandfor om het doelelement aan te wijzen en command om de actie op te geven. Plaats de oncommand-handler op het doel, niet per se op de knop. Aangepaste opdrachtnamen beginnen met --; de code van de auteur bepaalt het gedrag ervan.
In de handler bevat event.command de opdracht en verwijst event.source naar het element dat de actie heeft gestart, met inachtneming van de retargetingregels van de Shadow DOM. this verwijst naar het element dat het event afhandelt. In het voorbeeld verstuurt de knop --report en vervangt de alinea de tekst door die waarde.
Voor het voorbeeld moet de browser de relevante functies ondersteunen en moeten inline scripts zijn toegestaan. Een Content Security Policy kan het handlerattribuut blokkeren; een toepassing kan in plaats daarvan met addEventListener('command', handler) een handler registreren in een toegestaan script.
Voorbeelden
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>oncommand example</title>
<button type="button" commandfor="target" command="--report">Run</button>
<p id="target" oncommand="if (event.command === '--report') this.textContent = event.command;">Ready</p>
</html>Resultaat
--report
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.