Formations — 1 037 leçons en français

Accueil › Vue.js › L'Options API dans un projet existant

L'Options API dans un projet existant

La Composition APIintermediaire

L'Options API n'est pas dépréciée. Vue 3 la prend en charge entièrement, et un projet peut contenir les deux styles sans configuration particulière. La question posée en entretien n'est donc pas « faut-il tout réécrire », mais « comment vous vous y prenez dans un projet qui existe déjà ».

La réponse tient en trois points. On laisse les composants qui fonctionnent. On écrit en Composition API tout ce qui est nouveau. On convertit un fichier quand on doit déjà y intervenir sérieusement.

En TypeScript, un composant Options API s'enveloppe dans defineComponent pour que this soit typé :

import { defineComponent } from 'vue'

export default defineComponent({
  props: { titre: { type: String, required: true } },
  data() { return { ouvert: false } },
  methods: {
    basculer() { this.ouvert = !this.ouvert }  // this est typé
  }
})

Techniquement, setup() et les options peuvent coexister dans un même composant : setup() s'exécute en premier et ce qu'il renvoie devient accessible par this. L'inverse est faux — this n'est pas disponible dans setup(). On s'en sert comme d'une passerelle de transition, pas comme d'un style. Dans un fichier terminé, on choisit un seul des deux.

Les termes à connaître

Options API

Le style où un composant est un objet d'options — data, computed, methods, watch, crochets de cycle de vie — et où this désigne l'instance.

defineComponent

Une fonction de Vue qui enveloppe un objet de composant pour donner au compilateur TypeScript de quoi inférer les types. À l'exécution, elle renvoie l'objet presque tel quel.

Migration progressive

Le fait de convertir un projet composant par composant, au fil des modifications, plutôt qu'en une réécriture globale.

Mixin

Le mécanisme de réutilisation de l'Options API : un objet d'options fusionné dans le composant. Ses sources sont implicites et ses noms entrent en collision, ce que les composables évitent.

Cohabitation

Le fait qu'une même application contienne des composants des deux styles. Vue 3 les prend en charge ensemble, sans configuration.

Deux états séparés

Ce qu'on obtient en mettant des ref et un data() dans le même composant : deux réservoirs d'état qui ne communiquent que dans un sens.

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.