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.
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.