Glisser

Vue.js 3 : Composition API, Options API et les pièges que je vois en formation

Vue.js 3 : Composition API, Options API et pièges fréquents

Écrit par : Thibault Chazottes

Vue.js 3 permet de découper une interface en composants, de gérer la réactivité proprement et de livrer des UX fluides, en SPA ou intégré progressivement dans des pages existantes.

Le piège classique : enchaîner des tutos isolés (v-for un jour, props le lendemain) sans jamais structurer une petite application de bout en bout.


L’erreur n°1 : choisir trop tôt Composition ou Options

En 2026, la Composition API (surtout avec <script setup>) est le standard pour du code neuf. Mais l’Options API n’a pas disparu : beaucoup de codebases et d’exemples l’utilisent encore.

Ce que je fais en formation : les deux. Pas pour diluer le message, pour que vous puissiez lire du code existant et écrire du code moderne. Ignorer l’Options API, c’est se fermer des portes en entretien ou en reprise de projet.


L’erreur n°2 : sauter les fondamentaux pour aller vers Router / Pinia

Vue Router et Pinia sont excellents, mais inutiles si les composants, les props, les computed et le cycle de vie ne sont pas clairs. J’ai vu trop de développeurs empiler des stores Pinia pour compenser une mauvaise découpe de composants.

Ordre qui fonctionne :

  1. structure d’un projet Vue et premier composant ;
  2. props, événements, communication parent / enfant ;
  3. data / ref, computed, methods / fonctions, cycle de vie ;
  4. directives (v-if, v-for, v-model…) ;
  5. Composition API en profondeur ;
  6. ensuite Router et Pinia.

Un exemple minimal de réactivité (Composition API)

<script setup>
import { ref, computed } from 'vue'

const quantity = ref(1) const unitPrice = 89

const total = computed(() => quantity.value * unitPrice) </script>

<template> <p>Total : {{ total }} €</p> <button @click="quantity++">Ajouter</button> </template>

Simple, et c’est déjà le cœur de Vue : état réactif + dérivés. Tant que ce schéma n’est pas instinctif, le reste (stores, guards, API Laravel) restera opaque.


Comment j’enseigne Vue.js 3

Même logique que pour Laravel : projets progressifs, doc officielle comme boussole, corrections détaillées. Six TP successifs valent mieux que cinquante snippets collés dans un CodeSandbox.

Points que je martèle :

  • découper tôt en composants (mais pas trop tôt, éviter le « over-engineering ») ;
  • comprendre pourquoi une valeur est réactive (ou ne l’est pas) ;
  • savoir expliquer la différence entre Options et Composition ;
  • viser du code maintenable, pas seulement « ça marche ».

Prérequis réalistes

  • bases HTML, CSS et JavaScript (variables, fonctions, modules ES6) ;
  • pas besoin de Router / Pinia au départ ;
  • idéal avant un projet Laravel + Vue.js.

Ressources gratuites

Pour un parcours vidéo structuré (Composition & Options API, exercices corrigés), le détail est ici : formation Vue.js 3.


Pour aller plus loin


Conclusion

Vue.js 3 avec la Composition API est la base avant Router, Pinia ou une intégration Laravel. Investir du temps sur les fondamentaux (composants, réactivité, structuration) vous fera gagner des semaines sur les projets suivants, bien plus que de sauter directement aux « briques avancées ».

Étiquettes :