CKTIS / HTML
commandfor: cilj ukaza gumba
Povežite gumb s točno določenim elementom, ne izbirnikom CSS ali vsemi ujemajočimi se vozlišči.
Različica: HTML Living Standard
Sintaksa
<button type="button" command="--mark" commandfor="first">Mark</button>Atribut commandfor vsebuje ID elementa, ki je cilj ukaza gumba. Cilj mora biti v istem drevesu. Zapišite sam ID, ne izbirnika CSS z začetnim višajem. Lastnost DOM commandForElement izpostavi povezani element, kjer je funkcija podprta. Manjkajoč ali nerazrešen cilj ne more sprejeti predvidenega ukaza.
Atribut izbere prejemnika, command pa poda operacijo. Lastna operacija ustvari CommandEvent, katerega ukaz in vir označujeta zahtevo ter izvorni gumb. Lastno vedenje mora izvesti koda aplikacije. Uporabite izrecen tip gumba brez pošiljanja obrazca in se izogibajte podvojenim ID-jem, ki naredijo povezavo nezanesljivo.
Scenarij ima dva možna cilja, vendar lastno zahtevo pošlje le prvemu. Njegova obravnava označi element in zapiše ime ukaza ter izvorni gumb; druga obravnava ostane neuporabljena. Chromium 145 potrdi vgrajeno usmerjanje. Nepodprt brskalnik sporoči manjkajočo funkcijo, namesto da bi se pretvarjal, da je operacija uspela.
Primeri
<!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
Pravi brskalnik preveri označeni cilj, niz ukaza, izvorni gumb in nespremenjeni drugi cilj.