WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

commandfor: den Befehl eines Buttons an sein Ziel leiten

Verbinde einen Button mit einem bestimmten Element, nicht mit einem CSS-Selektor oder allen passenden Knoten.

Version: HTML Living Standard

Syntax

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

Das Attribut commandfor enthält die ID des Elements, an das der Befehl eines Buttons gerichtet ist. Das Ziel muss im selben Baum liegen. Schreibe die ID selbst, keinen CSS-Selektor mit führendem Doppelkreuz. Die DOM-Eigenschaft commandForElement stellt das zugehörige Element bereit, sofern die Funktion unterstützt wird. Ein fehlendes oder nicht auflösbares Ziel kann den vorgesehenen Befehl nicht empfangen.

Das Attribut wählt einen Empfänger; command liefert die Operation. Eine eigene Operation erzeugt ein CommandEvent, dessen Befehls- und Quellangaben die Anforderung und den auslösenden Button identifizieren. Der Anwendungscode muss dieses eigene Verhalten implementieren. Verwende einen ausdrücklich nicht absendenden Buttontyp und vermeide doppelte IDs, die die beabsichtigte Zuordnung unzuverlässig machen.

Die Testkonfiguration hat zwei mögliche Ziele, sendet die eigene Anforderung aber nur an das erste. Dessen Listener markiert das Element und erfasst Befehlsname sowie Quellbutton; der zweite Listener bleibt unbenutzt. Chromium 145 bestätigt die native Weiterleitung. Ein Browser ohne Unterstützung meldet die fehlende Fähigkeit, statt eine ausgeführte Operation vorzutäuschen.

Beispiele

<!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>

Ergebnis

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

Das markierte Ziel, die Befehlszeichenfolge, der Quellbutton und das unveränderte zweite Ziel werden im echten Browser geprüft.

Quellen