Formations — 1 037 leçons en français

Accueil › React › L'objet événement

L'objet événement

Événements et champs contrôlésdebutant

React passe au gestionnaire un objet événement conforme au standard du DOM.

function Recherche({ onChercher }) {
  const [terme, setTerme] = useState("");

  function gererSoumission(e) {
    e.preventDefault();          // sinon la page recharge
    onChercher(terme);
  }

  return (
    <form onSubmit={gererSoumission}>
      <input value={terme} onChange={(e) => setTerme(e.target.value)} />
    </form>
  );
}

Deux usages couvrent l'essentiel du quotidien :

return false ne fait rien

function gererSoumission(e) {
  envoyer();
  return false;        // ❌ ignoré
}

En HTML en ligne, return false annulait l'action par défaut. React ne regarde pas la valeur rendue par un gestionnaire. Seul e.preventDefault() agit.

target n'est pas currentTarget

<div onClick={(e) => {
  e.target;         // l'élément réellement cliqué, peut-être un <span>
  e.currentTarget;  // le <div> qui porte le gestionnaire
}}>

Enfin, l'objet est utilisable normalement : les versions de React antérieures à la 17 recyclaient leurs événements, ce qui obligeait à appeler e.persist() pour le lire plus tard. Ce recyclage a été supprimé en React 17.

Les termes à connaître

Événement de synthèse

L'objet que React passe au gestionnaire. Il enveloppe l'événement natif et expose la même interface que le standard du DOM : target, preventDefault, stopPropagation.

e.target

L'élément d'où l'événement part : celui sur lequel l'utilisateur a réellement agi. Dans une arborescence, ce peut être un descendant de l'élément qui écoute.

e.currentTarget

L'élément auquel le gestionnaire en cours est attaché. C'est celui qu'on veut lire quand on cherche « mon » élément, pas celui qui a été cliqué.

e.preventDefault()

Annule l'action par défaut du navigateur : la soumission d'un formulaire, la navigation d'un lien, la coche d'une case.

e.stopPropagation()

Empêche l'événement de continuer à remonter vers les ancêtres. N'annule pas l'action par défaut : les deux sont indépendants.

e.nativeEvent

L'événement natif du navigateur, accessible depuis l'événement de synthèse quand on a besoin d'une propriété que React n'expose pas.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.