CKTIS / HTML
commandfor: cilj naredbe gumba
Povežite gumb s određenim elementom, ne CSS selektorom ili svim odgovarajućim čvorovima.
Verzija: HTML Living Standard
Sintaksa
<button type="button" command="--mark" commandfor="first">Mark</button>Atribut commandfor sadrži ID elementa kojem je upućena naredba gumba. Cilj mora biti u istom stablu. Pišite sam ID, ne CSS selektor s početnom ljestvicom. DOM svojstvo commandForElement izlaže povezani element ondje gdje je značajka podržana. Nedostajući ili nerazriješen cilj ne može primiti namjeravanu naredbu.
Atribut bira primatelja, a command određuje operaciju. Vlastita operacija proizvodi CommandEvent, čija naredba i izvor određuju zahtjev i pozivajući gumb. To vlastito ponašanje mora implementirati aplikacija. Koristite izričit tip gumba koji ne šalje obrazac i izbjegavajte duplicirane ID-ove, koji vezu čine nepouzdanom.
Scenarij ima dva moguća cilja, ali vlastiti zahtjev šalje samo prvome. Njegov obrađivač označi element i zapiše naziv naredbe te izvorni gumb; drugi se obrađivač ne koristi. Chromium 145 potvrđuje izvorno usmjeravanje. Nepodržan preglednik prijavljuje nedostatak značajke umjesto da glumi izvršenu operaciju.
Primjeri
<!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>Rezultat
target=first; command=--mark; source=send; second=false
Stvarni preglednik provjerava označeni cilj, niz naredbe, izvorni gumb i nepromijenjeni drugi cilj.