CKTIS / HTML
command: deklarativno dejanje gumba
Sprožite vgrajena dejanja dialoga ali popovera oziroma pošljite lastni ukaz.
Različica: HTML Living Standard
Sintaksa
<button type="button" command="show-modal" commandfor="details">Open</button>Atribut command gumbu dodeli dejanje za element, naveden kot cilj ukaza. Vgrajene vrednosti vključujejo show-modal, close in request-close za dialoge ter prikaz, skrivanje in preklop popovera. Dejanje mora biti za cilj veljavno. Manjkajoča ali neznana vrednost ne postane poljuben JavaScript in ne izvaja izvornega besedila.
Lastni ukazi se začnejo z -- ter pošljejo dogodek kodi aplikacije; ne ustvarijo nove vgrajene operacije. Preklican dogodek ukaza prepreči privzeto dejanje. Uporabite type="button", če kontrolnik ne sme pošiljati ali ponastavljati obrazca. Onemogočen gumb dejanja ne sproži, novejša podpora ukazov pa zahteva zaznavanje zmogljivosti.
Primer z dvema vgrajenima gumboma odpre modalni dialog in ga zapre. Chromium 145 v podprti veji obe dejanji izvede brez obravnav aplikacije. Ločena nadomestna veja namesti izrecne obravnave, ko zmogljivost DOM manjka. Preverjeni rezultat velja za ta brskalnik, ne vsak vdelani WebView ali starejši pogon.
Primeri
<!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>Rezultat
opened=true; closed=true
V preverjeni veji dialog odpirajo in zapirajo vgrajeni ukazi; nadomestne obravnave niso nameščene.