Accueil › Vue.js › Ce que change script setup
Ce que change script setup
La Composition APIintermediaire
<script setup> est du sucre de compilation sur la Composition API. Le bloc
est transformé par le compilateur en fonction setup(), et tout ce qui est
déclaré à son niveau supérieur devient accessible au template.
<script setup>
import { ref } from 'vue'
import FormatPrix from './FormatPrix.vue'
const prix = ref(19.9)
function appliquerRemise() { prix.value *= 0.9 }
</script>
<template>
<FormatPrix :valeur="prix" />
<button @click="appliquerRemise">Remise</button>
</template>
Trois conséquences immédiates. Il n'y a pas de return : la liste des
choses exposées, c'est la liste des déclarations. Les composants importés
s'utilisent directement, sans option components. Et le code s'exécute
une fois par instance, à la création, avant le premier rendu.
Les props et les événements passent par des macros :
<script setup>
const props = defineProps({ titre: String })
const emit = defineEmits(['fermer'])
</script>
defineProps et defineEmits ne sont pas des fonctions importées. Le
compilateur les reconnaît, les remplace, et elles n'existent plus à
l'exécution. Elles doivent donc être appelées au niveau supérieur du bloc.
Dernier point, souvent découvert trop tard : un composant <script setup> est
fermé. Un parent qui tient une référence vers lui ne voit rien de son
intérieur, sauf ce qu'on déclare explicitement avec defineExpose.
Les termes à connaître
- script setup
Un attribut posé sur la balise
<script>d'un composant monofichier. Le compilateur transforme le contenu du bloc en fonctionsetup(), et expose au template tout ce qui est déclaré au niveau supérieur.- Macro de compilation
Un appel comme
definePropsoudefineEmitsque le compilateur reconnaît et remplace. Il n'existe plus à l'exécution, ne s'importe pas et ne peut pas être appelé ailleurs qu'au niveau supérieur du bloc.- Liaison de premier niveau
Toute déclaration écrite directement dans le bloc — variable, fonction, classe, import. C'est l'unité d'exposition au template.
- defineExpose
La macro qui rouvre un composant
<script setup>en déclarant ce qu'un parent peut lire à travers une ref de template.- defineOptions
La macro qui permet de déclarer, depuis
<script setup>, des options de composant sans second bloc<script>—nameouinheritAttrspar exemple. Disponible depuis Vue 3.3.- Composant fermé par défaut
Le fait qu'un composant écrit avec
<script setup>n'expose rien de son intérieur à son parent, contrairement à un composant écrit avecsetup()ou l'Options API.
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.