Formations — 1 037 leçons en français

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 fonction setup(), et expose au template tout ce qui est déclaré au niveau supérieur.

Macro de compilation

Un appel comme defineProps ou defineEmits que 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> — name ou inheritAttrs par 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 avec setup() ou l'Options API.

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.