Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

aspect-ratio — rapport largeur-hauteur préféré pour le dimensionnement automatique

`aspect-ratio` fournit un rapport largeur/hauteur préféré lorsque l’une au moins des dimensions de la boîte est automatique.

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

Syntaxe

auto || <ratio>

aspect-ratio fournit un rapport largeur/hauteur préféré lorsque l’une au moins des dimensions de la boîte est automatique.

Une boîte 16 / 9 avec width fixe et height à auto devient 160x90. Si les deux dimensions sont explicites, elle reste 160x70; le rapport négatif -1 / 1 est pris en charge comme false.

Syntaxe: auto || <ratio>.

Le rapport transfère une taille définie vers l’axe dépendant avant les limites min/max. Un <ratio> seul utilise les dimensions de boîte choisies par box-sizing. En revanche, auto et auto <ratio> emploient toujours les dimensions content-box pour la règle du rapport naturel/préféré : sur un replaced element, auto 1 / 1 choisit le rapport naturel s’il existe, sinon le rapport fourni. Le minimum automatique lié au contenu peut agrandir un élément flex/grid; min-width: 0 est parfois nécessaire pour permettre le débordement. Le rapport ne transforme pas une boîte normale en élément remplacé et n’agit pas si width et height sont tous deux non auto. CSS Sizing Level 4 est un Editor’s Draft exploratoire: tester les tailles intrinsèques et le contenu remplacé.

Exemples

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

Résultat

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

`aspect-ratio` fournit un rapport largeur/hauteur préféré lorsque l’une au moins des dimensions de la boîte est automatique.

Sources