CKTIS / HTML
command: декларативно действие на бутон
Извикайте вградени операции на диалог или popover, или изпратете собствена команда.
Версия: HTML Living Standard
Синтаксис
<button type="button" command="show-modal" commandfor="details">Open</button>Атрибутът command дава на бутон действие за елемента, определен като цел на командата. Вградените стойности включват show-modal, close и request-close за диалози, както и показване, скриване и превключване на popover. Действието трябва да е валидно за целта. Липсващи или неразпознати стойности не стават произволен JavaScript и не изпълняват изходен текст.
Имената на собствени команди започват с -- и изпращат събитие за обработка от приложението; не създават нова вградена операция. Отменено събитие на команда предотвратява подразбиращото се действие. Използвайте type="button", когато контролата не трябва да изпраща или нулира формуляр. Забранен бутон не задейства операцията, а новата поддръжка изисква проверка на възможностите.
Примерът използва два вградени бутона за отваряне на модален диалог и затварянето му. Chromium 145 извършва и двете действия без приложни обработчици в поддържания клон. Отделен резервен клон добавя изрични обработчици при липса на DOM възможността. Провереният резултат важи за този браузър, не за всеки вграден WebView или по-стар двигател.
Примери
<!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>Резултат
opened=true; closed=true
В проверения клон диалогът се отваря и затваря от вградени команди; резервните обработчици не са инсталирани.