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

CKTIS / HTML

oncommand — gérer l’événement command

L’attribut oncommand définit le code JavaScript à exécuter lors de la réception d’un événement command. Il se place sur l’élément qui reçoit la commande ; il ne sélectionne pas la cible et ne déclenche pas lui-même une commande.

Version : WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

oncommand="JavaScript statements"

oncommand est un attribut de contenu global de gestion d’événement pour l’événement command, disponible sur les éléments HTML. Sa valeur est le corps d’une fonction JavaScript, et non un nom de commande. Son équivalent DOM, element.oncommand, peut recevoir une fonction.

Dans le mécanisme de commande, un bouton utilise commandfor pour désigner l’élément cible et command pour définir l’action. Placez le gestionnaire oncommand sur la cible, pas nécessairement sur le bouton. Les noms de commandes personnalisées commencent par -- ; leur comportement est implémenté par le code de l’auteur.

Dans le gestionnaire, event.command contient la commande et event.source désigne l’élément à l’origine de l’action, sous réserve des règles de reciblage du Shadow DOM. this désigne l’élément qui gère l’événement. Dans l’exemple, le bouton envoie --report et le paragraphe remplace son texte par cette valeur.

L’exemple nécessite la prise en charge des fonctionnalités concernées par le navigateur ainsi que l’autorisation d’exécuter des scripts inline. Une Content Security Policy peut bloquer l’attribut de gestionnaire ; une application peut enregistrer à la place un gestionnaire avec addEventListener('command', handler) dans un script autorisé.

Exemples

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>oncommand example</title>
<button type="button" commandfor="target" command="--report">Run</button>
<p id="target" oncommand="if (event.command === '--report') this.textContent = event.command;">Ready</p>
</html>

Résultat

--report

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources