Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources