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

CKTIS / CSS

width — largura preferencial de um elemento

A propriedade width especifica a largura física preferencial da caixa de um elemento. Aceita, entre outros valores, comprimentos, percentagens e auto; o tamanho final também depende do modelo de caixa, das restrições e da disposição.

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

Sintaxe

/* Selected values from CSS Box Sizing Levels 3 and 4; not the full grammar. */
width: auto | <length-percentage [0,∞]> | min-content | max-content | fit-content | fit-content(<length-percentage [0,∞]>) | stretch | contain;
/* CSS-wide keywords are also accepted. */

width define a largura preferencial no eixo físico, independentemente da direção da escrita. O valor inicial é auto e a propriedade não é herdada. Não se aplica a elementos inline não substituídos.

Os comprimentos e as percentagens têm de ser não negativos. Uma percentagem refere-se à largura do bloco contentor, que não corresponde necessariamente à largura do elemento pai. auto deixa o cálculo a cargo das regras de disposição e não significa simplesmente 100%.

Com box-sizing: content-box, a largura corresponde ao conteúdo; com box-sizing: border-box, inclui também o preenchimento e as bordas, mas não as margens. min-width e max-width limitam o resultado, e o algoritmo de disposição pode alterar o tamanho final.

min-content e max-content referem-se a tamanhos determinados pelo conteúdo. fit-content tem em conta o espaço disponível, enquanto fit-content() aceita um limite explícito. stretch preenche o espaço disponível usando a caixa de margem. A sintaxe descreve a especificação, não garante que todos os valores sejam suportados no navegador de destino.

Exemplos

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

Resultado

width
200px

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