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

CKTIS / CSS

aspect-ratio — proporção preferida entre largura e altura

`aspect-ratio` fornece uma relação largura/altura preferida quando pelo menos uma dimensão da caixa é automática.

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

Sintaxe

auto || <ratio>

aspect-ratio fornece uma relação largura/altura preferida quando pelo menos uma dimensão da caixa é automática.

Uma caixa 16 / 9 com width fixo e height auto resulta em 160x90. Com ambos explícitos mantém 160x70; a relação negativa -1 / 1 é suportada como false.

Sintaxe: auto || <ratio>.

A relação transfere um tamanho definido para o eixo dependente antes dos limites min/max. Um <ratio> isolado usa as dimensões da caixa escolhidas por box-sizing. Em contraste, auto e auto <ratio> usam sempre dimensões content-box para a regra da proporção natural/preferida: num replaced element, auto 1 / 1 escolhe a proporção natural quando disponível, senão a fornecida. O mínimo automático do conteúdo pode aumentar itens flex/grid, sendo min-width: 0 útil quando se pretende transbordo. A proporção não transforma uma caixa normal em elemento substituído nem afeta o tamanho preferido se width e height não forem auto. CSS Sizing Level 4 é um Editor’s Draft exploratório; testar dimensões intrínsecas e conteúdo substituído.

Exemplos

document.body.innerHTML =
  '<style>.box{display:block;width:160px;box-sizing:border-box}.derived{height:auto;aspect-ratio:16 / 9}.fixed{height:70px;aspect-ratio:16 / 9}</style>' +
  '<div class="box derived"></div><div class="box fixed"></div>';
await new Promise(requestAnimationFrame);
const size=selector=>{const box=document.querySelector(selector).getBoundingClientRect();return Math.round(box.width)+'x'+Math.round(box.height);};
console.log('auto-height='+size('.derived')+'; fixed-both='+size('.fixed')+'; computed='+getComputedStyle(document.querySelector('.derived')).aspectRatio+'; negative='+CSS.supports('aspect-ratio','-1 / 1'));

Resultado

auto-height=160x90; fixed-both=160x70; computed=16 / 9; negative=false

`aspect-ratio` fornece uma relação largura/altura preferida quando pelo menos uma dimensão da caixa é automática.

Fontes