HTMLElement : évènement command
Baseline
2025
Newly available
Depuis December 2025, cette fonctionnalité fonctionne sur les appareils et les versions de navigateur les plus récents. Elle peut ne pas fonctionner sur les appareils ou navigateurs plus anciens.
L'évènement command de l'interface HTMLElement est déclenché sur un élément contrôlé via un button disposant de valeurs valides pour commandForElement et command, chaque fois que le bouton est actionné (par exemple lorsqu'il est cliqué).
Syntaxe
On utilisera le nom de l'évènement dans des méthodes telles que addEventListener(), ou on définira une propriété gestionnaire d'évènements.
addEventListener("command", (event) => { })
oncommand = (event) => { }
Type d'évènement
Un objet CommandEvent. Hérite de l'objet Event.
Exemples
Exemple simple
const fenetreContextuelle = document.getElementById("mafenetre");
// …
fenetreContextuelle.addEventListener("command", (event) => {
if (event.command === "show-popover") {
console.log("La fenêtre contextuelle est sur le point d'être affichée");
}
});
Transmission et annulation d'évènements
Il convient de noter que les évènements command se déclenchent sur l'élément invoqué. Si le bouton est cliqué, il déclenche d'abord un évènement click qui, s'il est annulé, empêche ensuite le déclenchement de l'évènement command et l'exécution du comportement par défaut.
Outre l'annulation de l'évènement click sur le bouton, il est aussi possible d'annuler l'évènement command.
Par exemple :
button.addEventListener("click", (event) => {
event.preventDefault(); // l'évènement `command` ne sera jamais déclenché
});
element.addEventListener("command", (event) => {
event.preventDefault(); // l'évènement `command` se déclenche mais le comportement par défaut est annulé
});
Spécifications
| Specification |
|---|
| HTML # event-command |
Compatibilité des navigateurs
Voir aussi
- L'API Invoker Commands
- La propriété
HTMLButtonElement.command - La propriété
HTMLButtonElement.commandForElement