CKTIS / HTML
command : donner une action déclarative à un bouton
Invoquez des actions natives de dialogue ou de popover, ou émettez une commande personnalisée.
Version : HTML Living Standard
Syntaxe
<button type="button" command="show-modal" commandfor="details">Open</button>L’attribut command donne au bouton une action pour l’élément désigné comme cible de commande. Les valeurs intégrées comprennent show-modal, close et request-close pour les dialogues, ainsi que les actions d’affichage, de masquage et de bascule des popovers. L’action doit être valide pour sa cible. Une valeur absente ou inconnue ne devient pas du JavaScript arbitraire et n’exécute pas de texte source.
Les noms de commandes personnalisées commencent par -- et émettent un événement que le code applicatif doit traiter ; ils n’inventent pas une opération native. Annuler l’événement de commande empêche son action par défaut. Utilisez type="button" si le contrôle ne doit ni envoyer ni réinitialiser un formulaire. Un bouton désactivé n’invoque pas l’action, et cette prise en charge récente nécessite des vérifications de capacité.
L’exemple utilise deux boutons natifs pour afficher un dialogue modal et le fermer. Chromium 145 exécute les deux actions sans gestionnaires applicatifs dans la branche prise en charge. Un repli séparé installe des gestionnaires explicites si la capacité DOM manque. Le résultat testé concerne ce navigateur, pas toutes les WebView intégrées ni les anciens moteurs.
Exemples
<!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>Résultat
opened=true; closed=true
Dans la branche vérifiée, des commandes natives ouvrent et ferment le dialogue ; les gestionnaires de repli ne sont pas installés.