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
refdont 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.
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.