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
.preventou.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, commepage-down.
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.