Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

max-height — altura máxima

max-height limita a altura de um elemento, mas não o obriga a atingir esse valor. Saiba quando min-height tem prioridade, como box-sizing afeta o limite e como lidar com conteúdo que ultrapassa esse limite.

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

Sintaxe

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

max-height define um limite superior para a altura, não uma altura pretendida. O valor inicial, none, significa que não existe limite; a propriedade não é herdada. Se min-height ultrapassar esse limite, prevalece a restrição mínima.

Os comprimentos e as percentagens têm de ser não negativos. Uma percentagem refere-se à altura do bloco que contém o elemento; as alturas dependentes do conteúdo estão sujeitas a regras de disposição especiais. box-sizing determina se o limite mede a caixa de conteúdo ou a caixa que inclui o preenchimento e os contornos. A sintaxe apresentada provém da especificação e não garante que os navegadores suportem todas as palavras-chave.

max-height, por si só, não permite deslocar nem recortar conteúdo. Utilize overflow: auto para permitir a deslocação do conteúdo excedente. No exemplo, height: 160px é limitado por max-height: 80px; com box-sizing: border-box, esse limite inclui os contornos.

Exemplos

<!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>

Resultado

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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes