Formations — 1 037 leçons en français

Accueil › Vue.js › Organiser un composant par préoccupation

Organiser un composant par préoccupation

La Composition APIintermediaire

L'Options API range le code par type : les données avec les données, les valeurs calculées ensemble, les méthodes ensemble. Tant qu'un composant ne fait qu'une chose, cet ordre convient. Dès qu'il en fait trois, chacune se retrouve découpée en quatre morceaux rangés à quatre endroits.

La Composition API range le code par préoccupation : une fonctionnalité, avec son état, ses dérivés, ses observateurs et ses crochets, en un seul bloc.

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

// --- Recherche ---
const requete = ref('')
const requeteNettoyee = computed(() => requete.value.trim().toLowerCase())
watch(requeteNettoyee, lancerRecherche)

// --- Pagination ---
const page = ref(1)
const debut = computed(() => (page.value - 1) * 20)
onMounted(() => { page.value = Number(localStorage.getItem('page')) || 1 })
</script>

Supprimer la pagination, ici, c'est supprimer un bloc contigu. Avec l'Options API, c'est retirer une ligne de data, une de computed, une de methods et une partie de mounted — en espérant n'avoir rien oublié.

Le bénéfice est de lecture et de maintenance. Il ne se voit pas sur un composant de trente lignes. Il devient décisif quand le fichier dépasse l'écran, et c'est exactement le moment où personne n'a envie de le réorganiser.

Les termes à connaître

Préoccupation

Une fonctionnalité du composant prise dans son entier : son état, ses valeurs dérivées, ses observateurs et ses crochets de cycle de vie.

Fragmentation

Le fait qu'une même fonctionnalité soit dispersée dans plusieurs options — data, computed, watch, methods — et qu'on doive sauter entre elles pour la lire.

Composable

Une fonction qui utilise les API de la Composition API et renvoie de l'état réactif. Par convention son nom commence par use.

Colocalisation

Le fait de garder ensemble, dans le fichier, les lignes qui changent ensemble. C'est le critère de découpage visé par la Composition API.

Extraction

Le déplacement d'un bloc cohérent du composant vers un composable, sans rien réécrire : le code est déjà groupé.

Ordre de lecture

L'ordre dans lequel les blocs d'un composant apparaissent. Avec la Composition API, il est choisi par l'auteur et non imposé par la liste des options.

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.