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
refvrai/faux commechargement. 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
chargementvrai eterreurrenseigné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.
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.