Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

max-height — hauteur maximale

max-height limite la hauteur d’un élément sans l’obliger à atteindre cette hauteur. Découvrez quand min-height est prioritaire, comment box-sizing influe sur la limite et comment gérer le contenu qui déborde.

Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Syntaxe

max-height: none | <length-percentage [0,∞]> | min-content | max-content | fit-content(<length-percentage [0,∞]>);

max-height définit une limite supérieure de hauteur, et non une hauteur cible. Sa valeur initiale, none, signifie qu’il n’y a aucune limite ; la propriété n’est pas héritée. Si min-height dépasse cette limite, la contrainte minimale est prioritaire.

Les longueurs et les pourcentages doivent être non négatifs. Un pourcentage se rapporte à la hauteur du bloc conteneur ; les hauteurs dépendant du contenu suivent des règles de mise en page particulières. box-sizing détermine si la limite porte sur la boîte de contenu ou sur la boîte incluant le remplissage et les bordures. La syntaxe présentée vient de la spécification et ne garantit pas que chaque mot-clé soit pris en charge par les navigateurs.

max-height seul ne permet ni le défilement ni le rognage du contenu. Utilisez overflow: auto pour rendre le contenu qui déborde défilable. Dans l’exemple, height: 160px est limité par max-height: 80px ; avec box-sizing: border-box, cette limite inclut les bordures.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Capping the height of a scrollable panel</title>
  <style>
    #panel {
      box-sizing: border-box;
      width: 12rem;
      height: 160px;
      max-height: 80px;
      overflow: auto;
      border: 2px solid;
    }
    .content { height: 140px; background: lightblue; }
  </style>
</head>
<body>
  <h1 id="panel-heading">Scrollable panel</h1>
  <div id="panel" role="region" aria-labelledby="panel-heading" tabindex="0">
    <div class="content">This content is taller than the panel.</div>
  </div>
  <script>
    const panel = document.getElementById('panel');
    console.log(`Panel border-box height: ${panel.getBoundingClientRect().height}px`);
    panel.scrollTop = 1;
    console.log(`Can scroll vertically: ${panel.scrollHeight > panel.clientHeight && panel.scrollTop > 0}`);
    panel.scrollTop = 0;
  </script>
</body>
</html>

Résultat

Panel border-box height: 80px
Can scroll vertically: true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources