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 :
e.target.value— ce que l'utilisateur vient de saisir ;e.preventDefault()— annuler l'action du navigateur, en premier lieu la soumission d'un formulaire qui recharge la page.
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.
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.