Formations — 1 037 leçons en français

Accueil › Vue.js › L'anatomie d'un composant mono-fichier

L'anatomie d'un composant mono-fichier

Démarrer avec Vuedebutant

Un composant Vue tient dans un seul fichier, et ce fichier a trois blocs.

<script setup lang="ts">
import { ref, computed } from 'vue'

const props = defineProps<{ nom: string }>()
const compteur = ref(0)
const message = computed(() => `${props.nom} a cliqué ${compteur.value} fois`)
</script>

<template>
  <section class="carte">
    <h2>{{ props.nom }}</h2>
    <button @click="compteur++">Compter</button>
    <p>{{ message }}</p>
  </section>
</template>

<style scoped>
.carte { border: 1px solid #ddd; padding: 1rem; }
</style>

<template> contient le balisage. C'est du HTML valide, enrichi d'interpolations {{ }} et de directives v-. Il y en a au plus un.

<script setup> contient la logique. Son contenu s'exécute une fois par instance, avant le premier rendu, et tout ce qui y est déclaré au niveau supérieur est directement visible du template : variables, fonctions, composants importés. Aucun return à écrire.

<style> contient le style. Avec l'attribut scoped, il ne s'applique qu'aux éléments de ce composant. Sans lui, il est global, donc il affecte toute l'application.

L'ordre des blocs est libre et sans incidence. La convention de l'outillage officiel est script, template, style.

Les termes à connaître

SFC

« Single-File Component » : un fichier .vue qui réunit le balisage, la logique et le style d'un composant. Compilé par @vitejs/plugin-vue en un module JavaScript.

Bloc `<template>`

Le balisage du composant, écrit en HTML valide enrichi de directives. Au plus un par fichier.

`<script setup>`

Le bloc de logique en Composition API. Son contenu s'exécute une fois par instance de composant, et tout ce qui y est déclaré au niveau supérieur est visible du template.

`<style scoped>`

Un style limité au composant. Le compilateur ajoute un attribut unique aux éléments et l'intègre aux sélecteurs.

Bloc personnalisé

Un bloc dont le nom n'est ni template, ni script, ni style — par exemple <i18n>. Ignoré tant qu'aucun outil ne le traite.

defineProps

La macro de compilation qui déclare les propriétés reçues du parent. Elle n'est pas importée : le compilateur la traite dans <script setup>.

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.