CKTIS / HTML
command: deklaratívna akcia tlačidla
Vyvolajte natívne operácie dialógu a popoveru alebo odošlite vlastný príkaz.
Verzia: HTML Living Standard
Syntax
<button type="button" command="show-modal" commandfor="details">Open</button>Atribút command priraďuje tlačidlu akciu pre prvok určený ako cieľ príkazu. Vstavané hodnoty zahŕňajú show-modal, close a request-close pre dialógy aj zobrazenie, skrytie a prepnutie popoveru. Akcia musí byť pre cieľ platná. Chýbajúce alebo neznáme hodnoty sa nestávajú ľubovoľným JavaScriptom a nevykonávajú zdrojový text.
Názvy vlastných príkazov začínajú -- a odošlú udalosť pre kód aplikácie; nevytvárajú novú natívnu operáciu. Zrušená udalosť príkazu zabráni predvolenej akcii. Použite type="button", ak prvok nemá odosielať alebo resetovať formulár. Zakázané tlačidlo akciu nevyvolá a novšia podpora príkazov vyžaduje overenie dostupnosti.
Príklad používa dve natívne tlačidlá na otvorenie modálneho dialógu a jeho zatvorenie. Chromium 145 v podporovanej vetve vykoná obe akcie bez aplikačných obslúh. Samostatná náhradná vetva pri chýbajúcej DOM funkcii nainštaluje výslovné obsluhy. Overený výsledok platí pre tento prehliadač, nie pre každý vložený WebView či staršie jadro.
Príklady
<!doctype html><meta charset="utf-8">
<button id="open" type="button" command="show-modal" commandfor="details">Open</button>
<dialog id="details"><p>Details</p><button id="close" type="button" command="close" commandfor="details">Close</button></dialog>
<output id="result"></output><script>
const open = document.querySelector('#open'), details = document.querySelector('#details');
if ('command' in open && 'commandForElement' in open) {
open.click(); const opened = details.open && details.matches(':modal');
document.querySelector('#close').click();
document.querySelector('#result').textContent = 'opened=' + opened + '; closed=' + !details.open;
} else {
open.onclick = () => details.showModal();
document.querySelector('#close').onclick = () => details.close();
document.querySelector('#result').textContent = 'command unsupported; explicit handlers installed';
}
</script>Výsledok
opened=true; closed=true
V overenej vetve otvárajú a zatvárajú dialóg natívne príkazy; náhradné obsluhy sa neinštalujú.