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ùthisdé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
refet undata()dans le même composant : deux réservoirs d'état qui ne communiquent que dans un sens.
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.