Formations — 1 037 leçons en français

Accueil › Vue.js › v-on et les modificateurs

v-on et les modificateurs

Template et directivesdebutant

v-on attache un écouteur d'événement. Sa forme courte est l'arobase, et c'est elle qu'on écrit en pratique.

<script setup>
import { ref } from 'vue'

const compteur = ref(0)

function reinitialiser(event) {
  console.log(event.type)   // « click »
  compteur.value = 0
}
</script>

<template>
  <button @click="compteur++">J'ai cliqué {{ compteur }} fois</button>
  <button v-on:click="reinitialiser">Remettre à zéro</button>
</template>

Deux formes de gestionnaire cohabitent. Le gestionnaire méthode, écrit sans parenthèses, reçoit l'événement natif en premier argument. Le gestionnaire en ligne est une expression exécutée au déclenchement ; pour y accéder à l'événement, on utilise la variable spéciale $event, ou une fonction fléchée.

<button @click="supprimer(produit.id, $event)">Supprimer</button>
<button @click="(e) => supprimer(produit.id, e)">Supprimer</button>

À cela s'ajoutent les modificateurs : des suffixes pointés qui évitent d'écrire à la main ce qu'on écrirait dans tous les gestionnaires.

<form @submit.prevent="envoyer">…</form>
<div @click.self="fermer">…</div>
<input @keyup.enter="valider">

.prevent appelle preventDefault(), .stop appelle stopPropagation(), .self n'exécute le gestionnaire que si l'élément est lui-même la cible, .once détache l'écouteur après un déclenchement. Ils se chaînent — et leur ordre change le résultat.

Les termes à connaître

v-on

La directive qui attache un écouteur d'événement. Forme courte : l'arobase, comme dans l'écriture @click.

Gestionnaire méthode

@click="valider" : Vue appelle la fonction et lui passe l'événement natif en premier argument.

Gestionnaire en ligne

@click="compteur++" : une expression exécutée telle quelle. L'événement y est disponible sous le nom $event.

Modificateur

Un suffixe pointé qui modifie le comportement de l'écouteur, par exemple .prevent ou .once. Ils se chaînent, et l'ordre compte.

.self

N'exécute le gestionnaire que si la cible de l'événement est l'élément lui-même, pas un descendant.

Modificateur de touche

@keyup.enter : le gestionnaire ne s'exécute que pour la touche nommée. Le nom s'écrit en kebab-case, comme page-down.

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.