Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

aspect-ratio — preferowana proporcja szerokości do wysokości

`aspect-ratio` podaje preferowany stosunek szerokości do wysokości używany, gdy co najmniej jeden wymiar pudełka jest automatyczny.

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

Składnia

auto || <ratio>

aspect-ratio podaje preferowany stosunek szerokości do wysokości używany, gdy co najmniej jeden wymiar pudełka jest automatyczny.

Pudełko 16 / 9 ze stałym width i auto dla height otrzymuje 160x90. Gdy oba wymiary są jawne, ta sama proporcja pozostawia 160x70; ujemne -1 / 1 ma obsługę false.

Składnia: auto || <ratio>.

Proporcja przenosi rozmiar określony na oś zależną przed ograniczeniami min/max. Samotne <ratio> używa wymiarów pudełka wybranego przez box-sizing. Natomiast auto oraz auto <ratio> zawsze stosują wymiary content-box dla reguły proporcji naturalnej/preferowanej: dla replaced element zapis auto 1 / 1 wybiera proporcję naturalną, jeśli istnieje, a w przeciwnym razie podaną. Automatyczne minimum treści może powiększyć element flex/grid, więc przy zamierzonym przepełnieniu przydaje się min-width: 0. Preferowana proporcja nie zmienia zwykłego pudełka w element zastępowany i nie wpływa na preferowany rozmiar, gdy oba width i height nie są auto. CSS Sizing Level 4 jest eksploracyjnym Editor’s Draft; testuj rozmiary wewnętrzne i treści zastępowane.

Przykłady

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'));

Wynik

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

`aspect-ratio` podaje preferowany stosunek szerokości do wysokości używany, gdy co najmniej jeden wymiar pudełka jest automatyczny.

Źródła