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.