Formations — 1 037 leçons en français

Accueil › Vue.js › Émettre des événements

Émettre des événements

Composants et propsdebutant

Les données descendent par les props, les intentions remontent par les événements. Un composant déclare ce qu'il peut émettre avec defineEmits.

<!-- Recherche.vue -->
<script setup lang="ts">
const emit = defineEmits<{
  rechercher: [texte: string]
  reinitialiser: []
}>()

const texte = ref('')
</script>

<template>
  <input v-model="texte" />
  <button @click="emit('rechercher', texte)">Chercher</button>
  <button @click="emit('reinitialiser')">Effacer</button>
</template>

Le parent écoute avec @, et reçoit directement les arguments de l'émission.

<Recherche @rechercher="lancer" @reinitialiser="vider" />

Ce chemin de retour est ce qui rend le flux unidirectionnel praticable : l'enfant ne modifie pas la donnée du parent, il lui signale ce qui vient de se passer. Le parent reste seul à décider s'il change quelque chose.

Quand l'événement sert uniquement à mettre à jour une valeur que le parent vient de passer, la paire prop + événement a un raccourci :

<script setup lang="ts">
const texte = defineModel<string>()
</script>
<template>
  <input v-model="texte" />
</template>

Le parent écrit alors <Champ v-model="recherche" />.

Les termes à connaître

`defineEmits`

La macro qui déclare les événements qu'un composant peut émettre et renvoie la fonction d'émission. Comme defineProps, elle disparaît à la compilation.

Événement personnalisé

Un message que l'enfant envoie vers le haut. Le parent l'écoute avec @nom. C'est le chemin de retour du flux unidirectionnel.

Signature d'émission

Le type qui décrit les arguments de chaque événement. Il transforme une faute de frappe sur un nom ou un argument en erreur de compilation.

`v-model`

Un raccourci pour une prop plus l'événement qui demande sa mise à jour. Côté composant, il se déclare avec defineModel().

`defineModel`

La macro qui déclare une liaison bidirectionnelle : elle renvoie un ref dont l'écriture émet l'événement de mise à jour au parent.

Nom en kebab-case

La forme à utiliser dans les templates (@mise-a-jour). Vue fait la correspondance avec le camelCase du code.

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.