Formations — 1 037 leçons en français

Accueil › JavaScript › Afficher une liste de données

Afficher une liste de données

Manipuler la pageintermediaire

Le motif que vous écrirez le plus souvent : des données d'un côté, le rendu de l'autre.

let clients = [];       // la source de vérité

function afficher() {
  liste.replaceChildren();          // on efface

  if (clients.length === 0) {
    liste.append(messageVide());    // l'état vide
    return;
  }

  liste.append(...clients.map(ligne));
}

function ligne(c) {
  const li = document.createElement("li");
  li.textContent = `${c.nom} — ${c.ville}`;
  li.dataset.id = c.id;
  return li;
}

Pour ajouter un client, on ne touche pas au DOM :

clients.push({ id: 3, nom: "Zoé", ville: "Lyon" });
afficher();

Pourquoi c'est la bonne façon

Parce que trier, filtrer, compter ou envoyer au serveur devient trivial : toutes ces opérations portent sur un tableau JavaScript, pas sur du texte lu dans la page.

clients.filter(c => c.ville === "Lyon");    // ✅
// contre : lire chaque <li>, découper la chaîne, deviner…

Les trois états à prévoir

if (enChargement) return afficherSquelette();
if (erreur) return afficherErreur(erreur);
if (clients.length === 0) return afficherVide();
afficherListe(clients);

Chargement, erreur, vide. Ce sont les trois qu'on oublie, et les trois que l'utilisateur rencontre en premier le jour où le réseau est lent.

Les termes à connaître

Rendu

La transformation d'un état — un tableau d'objets — en éléments affichés. Tout le travail d'une interface tient dans cette opération, répétée.

Source de vérité

L'endroit unique où vit la donnée. Si c'est le DOM, toute lecture est une analyse de texte ; si c'est un tableau JavaScript, le DOM n'en est que le reflet.

Rendu complet

Tout effacer et tout réafficher à chaque changement. Simple, correct, et suffisant jusqu'à quelques centaines de lignes.

État vide

Ce qu'on affiche quand la liste ne contient rien. Une zone blanche ressemble à un bug ; une phrase explique.

Débit de rendu

Le coût d'un rendu complet. Il devient perceptible vers le millier d'éléments, et c'est à ce moment seulement qu'on envisage un rendu partiel.

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.