Formations — 1 037 leçons en français

Accueil › Vue.js › Les états d'un chargement

Les états d'un chargement

Communiquer avec une APIintermediaire

Une requête réseau ne connaît pas deux situations mais au moins cinq : inactive, en cours, aboutie avec des données, aboutie sans aucune donnée, et en erreur. Un seul drapeau booléen les écrase.

// Fragile : trois situations se confondent quand chargement vaut false
const chargement = ref(false)
const articles = ref([])

Avec ce code, un template qui affiche « Aucun article » quand la liste est vide l'affiche aussi avant le premier appel, et encore après une erreur réseau. Le correctif tient dans une seule variable d'état.

type Etat = 'inactif' | 'chargement' | 'succes' | 'erreur'

const etat = ref<Etat>('inactif')
const articles = ref<Article[]>([])
const erreur = ref<string | null>(null)

async function charger() {
  etat.value = 'chargement'
  erreur.value = null
  try {
    const reponse = await fetch('/api/articles')
    if (!reponse.ok) throw new Error(`HTTP ${reponse.status}`)
    articles.value = await reponse.json()
    etat.value = 'succes'
  } catch (e) {
    erreur.value = e instanceof Error ? e.message : 'Erreur inconnue'
    etat.value = 'erreur'
  }
}

Le template se lit alors comme une liste de cas exclusifs, sans combinaison contradictoire possible. L'état vide se déduit du succès : etat === 'succes' && articles.length === 0. Certains préfèrent en faire un cinquième état nommé ; les deux approches se défendent, à condition de le traiter.

Les termes à connaître

État de chargement

La situation dans laquelle se trouve une requête à un instant donné : inactive, en cours, aboutie, en erreur. Un seul de ces états est vrai à la fois.

Drapeau booléen

Une ref vrai/faux comme chargement. Pratique pour un cas, insuffisant dès qu'il faut distinguer « pas encore demandé » de « demandé et vide ».

État vide

Une réponse aboutie qui ne contient aucun élément. Ce n'est ni une erreur ni un chargement, et cela mérite son propre affichage.

Machine à états

Une modélisation où l'on nomme les états possibles et les transitions autorisées entre eux. Les transitions non prévues sont simplement ignorées.

États impossibles

Des combinaisons de variables qui ne devraient jamais coexister, comme chargement vrai et erreur renseignée. Un état unique les rend inexprimables.

Squelette de chargement

Un gabarit gris affiché à la place du contenu pendant l'attente. Il remplace le texte « Chargement… » sans changer la logique d'état.

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.