CKTIS / HTML
commandfor: cieľ príkazu tlačidla
Spojte tlačidlo s konkrétnym prvkom, nie s CSS selektorom alebo všetkými zhodnými uzlami.
Verzia: HTML Living Standard
Syntax
<button type="button" command="--mark" commandfor="first">Mark</button>Atribút commandfor obsahuje ID prvku, na ktorý mieri príkaz tlačidla. Cieľ musí patriť do rovnakého stromu. Zapíšte samotné ID, nie CSS selektor s úvodnou mriežkou. DOM vlastnosť commandForElement sprístupňuje priradený prvok tam, kde je funkcia podporovaná. Chýbajúci alebo nenájdený cieľ nemôže zamýšľaný príkaz prijať.
Atribút vyberá príjemcu, kým command poskytuje operáciu. Vlastná operácia vytvorí CommandEvent, ktorého príkaz a zdroj označujú požiadavku a vyvolávajúce tlačidlo. Vlastné správanie musí implementovať aplikácia. Použite výslovný typ tlačidla bez odosielania a vyhýbajte sa duplicitným ID, ktoré robia zamýšľané spojenie nespoľahlivým.
Scenár má dva možné ciele, ale vlastnú požiadavku posiela iba prvému. Jeho obsluha označí prvok a zapíše názov príkazu aj zdrojové tlačidlo; druhá obsluha sa nepoužije. Chromium 145 potvrdzuje natívne smerovanie. Nepodporujúci prehliadač oznámi chýbajúcu funkciu namiesto predstierania vykonanej operácie.
Príklady
<!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>Výsledok
target=first; command=--mark; source=send; second=false
Skutočný prehliadač kontroluje označený cieľ, reťazec príkazu, zdrojové tlačidlo aj nezmenený druhý cieľ.