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

CKTIS / CSS

max-width — largura máxima

max-width limita a largura física de um elemento, em vez de a definir incondicionalmente. Quando as restrições de tamanho entram em conflito, min-width tem prioridade.

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

Sintaxe

max-width: none;
max-width: 320px;
max-width: 100%;
/* Common forms, not the complete grammar. */

max-width especifica a largura física máxima. O valor inicial none significa que não se aplica esse limite; a propriedade não é herdada.

Os valores comuns são comprimentos não negativos e percentagens. As percentagens referem-se à largura do bloco contentor. max-width limita width, mas, em caso de conflito, prevalece min-width.

Para valores quantitativos, como comprimentos e percentagens, com box-sizing: content-box o limite aplica-se à largura do conteúdo; com border-box, inclui também o espaçamento interior e os contornos. box-sizing não altera a forma como são interpretadas as palavras-chave de dimensionamento intrínseco, como min-content. Por si só, a propriedade max-width não recorta o conteúdo que transborda.

No exemplo, width: 100% dá inicialmente 400px, enquanto max-width: 240px limita a largura da caixa de borda a 240px.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>max-width</title>
<style>
  .container { width: 400px; }
  .box {
    box-sizing: border-box;
    width: 100%;
    max-width: 240px;
    padding: 10px;
    border: 2px solid;
  }
</style>
<div class="container">
  <div class="box">max-width</div>
</div>
<pre id="result"></pre>
<script>
  const box = document.querySelector('.box');
  document.querySelector('#result').textContent =
    `width: ${box.getBoundingClientRect().width}px`;
</script>

Resultado

width: 240px

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