HOWTO · HTML

Rendre le tableau HTML défilable

Faites défiler un long tableau HTML dans un conteneur à hauteur fixe grâce au débordement CSS. Choisissez le défilement vertical et horizontal tout en conservant le balisage de tableau natif et l’accès au clavier.

Sur cette page

Pour éviter qu’un long tableau HTML n’étire la page, placez le tableau sémantique dans un conteneur dont la hauteur est limitée et définissez overflow-y: auto. Le conteneur défile verticalement lorsque son contenu dépasse cette limite, tandis que le tableau conserve sa structure habituelle en lignes et en colonnes.

Rendre un tableau HTML défilable verticalement avec CSS

Cette page complète utilise un conteneur de 200 pixels de haut et un tableau natif avec une en-tête et un corps. Les lignes rendent le contenu plus haut que le conteneur, ce qui permet de faire défiler le tableau dans sa zone.

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Scrollable table</title>
  <style>
    .table-scroll {
      max-height: 200px;
      overflow-y: auto;
      border: 1px solid #ccc;
    }

    table {
      width: 100%;
      border-collapse: collapse;
    }

    th, td {
      padding: 8px;
      border: 1px solid #ddd;
      text-align: left;
    }
  </style>
</head>
<body>
  <div class="table-scroll" role="region" aria-label="Employee directory" tabindex="0">
    <table>
      <thead>
        <tr><th scope="col">Name</th><th scope="col">Age</th><th scope="col">Country</th></tr>
      </thead>
      <tbody>
        <tr><td>John Doe</td><td>30</td><td>USA</td></tr>
        <tr><td>Jane Smith</td><td>25</td><td>Canada</td></tr>
        <tr><td>Sam Wilson</td><td>28</td><td>UK</td></tr>
        <tr><td>Emily Johnson</td><td>35</td><td>Australia</td></tr>
        <tr><td>Michael Brown</td><td>40</td><td>Germany</td></tr>
        <tr><td>Linda Davis</td><td>22</td><td>France</td></tr>
        <tr><td>James Garcia</td><td>29</td><td>Spain</td></tr>
        <tr><td>Patricia Martinez</td><td>31</td><td>Mexico</td></tr>
        <tr><td>Robert Wilson</td><td>38</td><td>Italy</td></tr>
        <tr><td>Jessica Lee</td><td>27</td><td>Netherlands</td></tr>
      </tbody>
    </table>
  </div>
</body>
</html>

max-height limite la hauteur du conteneur, tandis que overflow-y détermine son comportement lorsque le tableau est plus haut. tabindex="0" permet d’atteindre la zone au clavier : placez-y le focus et utilisez les touches fléchées pour vérifier qu’elle défile. Le libellé de la zone fournit un contexte aux technologies d’assistance. Conservez <table>, <thead>, <tbody> et les cellules d’en-tête afin que les navigateurs et les technologies d’assistance préservent les relations propres au tableau.

Choisir auto ou scroll pour le débordement vertical

Utilisez overflow-y: auto pour afficher une barre de défilement lorsque le contenu dépasse le conteneur. Aucune barre n’est réservée lorsque toutes les lignes tiennent dans l’espace disponible. overflow-y: scroll demande un mécanisme de défilement même si le contenu tient actuellement dans le conteneur, mais l’apparence de la barre dépend du système d’exploitation et du navigateur. Dans les deux cas, appliquez la règle de débordement au conteneur, et non aux lignes. Une hauteur ou une hauteur maximale est nécessaire pour fixer la limite verticale ; sans cela, le conteneur peut grandir avec le tableau et le défilement vertical interne devient inutile.

Pour copier rapidement la règle du conteneur, exécutez ce petit exemple JavaScript. Il affiche les déclarations CSS utilisées ci-dessus ; adaptez la hauteur à l’espace visible.

const rule = [
  ".table-scroll {",
  "  max-height: 200px;",
  "  overflow-y: auto;",
  "}"
].join("\n");
console.log(rule);
.table-scroll {
  max-height: 200px;
  overflow-y: auto;
}

Préserver la sémantique du tableau et l’accès au clavier

Pour des données tabulaires, utilisez de véritables éléments de tableau au lieu de les remplacer par des cellules CSS Grid génériques. Grid convient aux mises en page, mais un ensemble d’éléments div n’expose pas automatiquement les relations entre les en-têtes et les cellules d’un tableau de données. Dans l’exemple, le conteneur défilable est désigné comme une région et ajouté à l’ordre de tabulation. Vérifiez son fonctionnement au clavier : tabulez jusqu’à la région libellée, faites-la défiler avec les touches fléchées, puis continuez à tabuler. N’ajoutez pas de rôle de tableau ARIA au balisage natif : celui-ci fournit déjà cette sémantique.

Ajouter le défilement horizontal et le style Bootstrap

Si les colonnes dépassent l’espace disponible, ajoutez overflow-x: auto à .table-scroll ; le conteneur pourra alors défiler horizontalement comme verticalement. Gardez une largeur suffisante pour les colonnes au lieu de réduire le texte au point de le rendre illisible. Essayez la page dans la fenêtre étroite où le tableau sera utilisé et vérifiez que toutes les colonnes restent accessibles.

Si le projet charge déjà Bootstrap, vous pouvez appliquer au même tableau sémantique des classes telles que table et table-bordered. Ces classes modifient la présentation ; le conteneur à hauteur limitée et ses règles CSS de débordement assurent toujours le défilement. Cette approche explicite le comportement de défilement et permet de conserver un balisage de tableau utile avec ou sans Bootstrap.