CKTIS / HTML
oncommand — das command-Ereignis behandeln
Das Attribut oncommand legt JavaScript fest, das ausgeführt wird, wenn ein command-Ereignis empfangen wird. Es gehört auf das Element, das den Befehl empfängt; es wählt weder das Ziel aus noch löst es selbst einen Befehl aus.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
oncommand="JavaScript statements"oncommand ist ein globales Event-Handler-Content-Attribut für das Ereignis command, das auf HTML-Elementen verfügbar ist. Sein Wert ist ein JavaScript-Funktionskörper, kein Befehlsname. Das DOM-Gegenstück element.oncommand kann eine Funktion zugewiesen werden.
Im Befehlsmechanismus verwendet ein Button commandfor, um das Zielelement anzugeben, und command, um die Aktion festzulegen. Platziere den oncommand-Handler auf dem Ziel, nicht unbedingt auf dem Button. Benutzerdefinierte Befehlsnamen beginnen mit --; ihr Verhalten wird durch den Code der Autorin oder des Autors implementiert.
Im Handler enthält event.command den Befehl, und event.source bezeichnet das auslösende Element, unter Berücksichtigung der Retargeting-Regeln des Shadow DOM. this verweist auf das Element, das das Ereignis behandelt. Im Beispiel sendet der Button --report, und der Absatz ersetzt seinen Text durch diesen Wert.
Das Beispiel setzt voraus, dass der Browser die entsprechenden Funktionen unterstützt und Inline-Skripte ausführen darf. Eine Content Security Policy kann das Handler-Attribut blockieren; eine Anwendung kann stattdessen in einem zulässigen Skript mit addEventListener('command', handler) einen Handler registrieren.
Beispiele
<!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>Ergebnis
--report
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.