CKTIS / HTML
commandfor: indirizzare il comando del pulsante alla destinazione
Collega un pulsante a un elemento preciso, non a un selettore CSS o a tutti i nodi corrispondenti.
Versione: HTML Living Standard
Sintassi
<button type="button" command="--mark" commandfor="first">Mark</button>L’attributo commandfor contiene l’ID dell’elemento destinatario del comando del pulsante. La destinazione deve appartenere allo stesso albero. Scrivi l’ID, non un selettore CSS con un cancelletto iniziale. La proprietà DOM commandForElement espone l’elemento associato quando la funzionalità è supportata. Una destinazione assente o non risolta non può ricevere il comando previsto.
L’attributo sceglie un destinatario; command fornisce l’operazione. Un’operazione personalizzata produce un CommandEvent il cui comando e la cui origine identificano la richiesta e il pulsante invocante. Il codice applicativo deve implementare quel comportamento personalizzato. Usa un tipo di pulsante esplicitamente non destinato all’invio ed evita ID duplicati, che rendono inaffidabile l’associazione voluta.
L’ambiente di prova contiene due possibili destinazioni, ma invia la richiesta personalizzata solo alla prima. Il suo listener contrassegna l’elemento e registra il nome del comando e il pulsante di origine; il secondo listener resta inutilizzato. Chromium 145 verifica l’instradamento nativo. Un browser non compatibile segnala la capacità mancante invece di fingere che l’operazione sia avvenuta.
Esempi
<!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>Risultato
target=first; command=--mark; source=send; second=false
La destinazione contrassegnata, la stringa del comando, il pulsante di origine e la seconda destinazione intatta sono verificati nel browser reale.