We want to hear from you!Take our 2021 Community Survey!
This site is no longer updated.Go to react.dev

Gérer les événements

These docs are old and won’t be updated. Go to react.dev for the new React docs.

These new documentation pages teach modern React and include live examples:

La gestion des événements pour les éléments React est très similaire à celle des éléments du DOM. Il y a tout de même quelques différences de syntaxe :

  • Les événements de React sont nommés en camelCase plutôt qu’en minuscules.
  • En JSX on passe une fonction comme gestionnaire d’événements plutôt qu’une chaîne de caractères.

Par exemple, le HTML suivant :

<button onclick="activateLasers()">
  Activer les lasers
</button>

est légèrement différent avec React:

<button onClick={activateLasers}>  Activer les lasers
</button>

Autre différence importante : en React, on ne peut pas renvoyer false pour empêcher le comportement par défaut. Vous devez appeler explicitement preventDefault. Par exemple, en HTML, pour annuler le comportement par défaut des liens qui consiste à ouvrir une nouvelle page, vous pourriez écrire :

<form onsubmit="console.log('You clicked submit.'); return false">
  <button type="submit">Submit</button>
</form>

En React, ça pourrait être :

function Form() {
  function handleSubmit(e) {
    e.preventDefault();    console.log('You clicked submit.');
  }

  return (
    <form onSubmit={handleSubmit}>
      <button type="submit">Submit</button>
    </form>
  );
}

Ici, e est un événement synthétique. React le définit en suivant les spécifications W3C, afin que vous n’ayez pas à vous préoccuper de la compatibilité entre les navigateurs. Les événements React ne fonctionnent pas tout à fait comme les événements natifs. Pour en apprendre davantage, consultez le guide de référence de SyntheticEvent.

Lorsque vous utilisez React, vous n’avez généralement pas besoin d’appeler la méthode addEventListener pour ajouter des écouteurs d’événements (event listeners, NdT) à un élément du DOM après que celui-ci est créé. À la place, on fournit l’écouteur lors du rendu initial de l’élément.

Lorsque vous définissez un composant en utilisant les classes ES6, il est d’usage que le gestionnaire d’événements soit une méthode de la classe. Par exemple, ce composant Toggle affiche un bouton qui permet à l’utilisateur de basculer l’état de “ON” à “OFF”.

class Toggle extends React.Component {
  constructor(props) {
    super(props);
    this.state = {isToggleOn: true};

    // Cette liaison est nécéssaire afin de permettre    // l'utilisation de `this` dans la fonction de rappel.    this.handleClick = this.handleClick.bind(this);  }

  handleClick() {    this.setState(prevState => ({      isToggleOn: !prevState.isToggleOn    }));  }
  render() {
    return (
      <button onClick={this.handleClick}>        {this.state.isToggleOn ? 'ON' : 'OFF'}
      </button>
    );
  }
}

Essayer dans CodePen

En JSX, vous devez être prudent·e avec l’utilisation de this dans les fonctions de rappel. En JavaScript, les méthodes de classes ne sont pas liées par défaut. Si vous oubliez de lier this.handleClick et l’utilisez dans onClick, this sera undefined quand la fonction sera appelée.

Ce n’est pas un comportement spécifique à React, ça fait partie du fonctionnement normal des fonctions en JavaScript. En général, si vous faites référence à une méthode sans l’appeler avec (), comme dans onClick={this.handleClick}, vous devriez lier cette méthode.

Si vous ne souhaitez pas utiliser bind, vous avez deux alternatives possibles. Si vous avez l’habitude d’utiliser la syntaxe des champs de classes, qui est encore expérimentale, vous pourriez l’utiliser pour lier les fonctions de rappel :

class LoggingButton extends React.Component {
  // This syntax ensures `this` is bound within handleClick.  handleClick = () => {    console.log('this vaut :', this);  };  render() {
    return (
      <button onClick={this.handleClick}>
        Clique ici
      </button>
    );
  }
}

Cette syntaxe est activée par défaut dans Create React App.

Si vous n’utilisez pas la syntaxe des champs de classe, vous pouvez utiliser les fonctions fléchées pour les fonctions de rappel.

class LoggingButton extends React.Component {
  handleClick() {
    console.log('this vaut :', this);
  }

  render() {
    // Cette syntaxe nous assure que `this` est bien lié dans la méthode handleClick    return (      <button onClick={() => this.handleClick()}>        Clique ici
      </button>
    );
  }
}

Cette syntaxe n’est toutefois pas sans défauts, car elle crée une nouvelle fonction de rappel à chaque affichage de LoggingButton. Dans la plupart des cas ce n’est pas gênant. Néanmoins, si cette fonction était passée comme prop à des composants plus bas dans l’arbre, ces composants risqueraient de faire des ré-affichages superflus. Nous recommandons donc, en règle générale, de lier ces méthodes dans le constructeur ou d’utiliser un champ de classe afin d’éviter ce genre de problèmes de performances.

Passer des arguments à un gestionnaire d’événements

Au sein d’une boucle, il est courant de vouloir passer un argument supplémentaire à un gestionnaire d’événements. Par exemple, si id représente la ligne sélectionnée, on peut faire au choix :

<button onClick={(e) => this.deleteRow(id, e)}>Supprimer la ligne</button>
<button onClick={this.deleteRow.bind(this, id)}>Supprimer la ligne</button>

Les lignes précédentes sont équivalentes et utilisent respectivement les fonctions fléchées et Function.prototype.bind.

Dans les deux cas, l’argument e represente l’événement React qui sera passé en second argument après l’ID. Avec une fonction fléchée, nous devons passer l’argument explicitement, alors qu’avec bind tous les arguments sont automatiquement transmis.

Avez-vous trouvé cette page utile ?Modifier cette page