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

CKTIS / CSS

flex-grow — répartir l’espace libre

La propriété flex-grow détermine la participation d’un élément flex à la répartition de l’espace libre positif le long de l’axe principal. Ses facteurs décrivent des augmentations de taille, et non les proportions des largeurs finales.

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

Syntaxe

flex-grow: <number [0,∞]>;

flex-grow définit le facteur de croissance d’un élément flex. Il accepte un nombre sans unité supérieur ou égal à 0 ; les pourcentages et les nombres négatifs ne sont pas valides. Sa valeur initiale est 0 et la propriété n’est pas héritée.

L’espace libre positif est réparti dans chaque ligne flex le long de l’axe principal, selon les facteurs de croissance. La valeur 0 désactive cette croissance. Si la somme des facteurs est inférieure à 1, une partie de l’espace peut rester inutilisée.

Les proportions s’appliquent aux augmentations au-delà des tailles de base, et non aux tailles finales. Le résultat dépend aussi de flex-basis et des contraintes de taille minimale et maximale. flex-shrink contrôle la réduction. La propriété raccourcie flex définit ces composants ensemble et réinitialise ceux qui sont omis.

Dans l’exemple, le conteneur mesure 500px de large et les deux bases sont de 100px chacune. Les 300px restants sont répartis selon un rapport de 1:2 : les éléments gagnent respectivement 100px et 200px. Leurs largeurs attendues sont donc 200px et 300px.

Exemples

<!doctype html>
<meta charset="utf-8">
<title>flex-grow</title>
<style>
  .row { display: flex; width: 500px; }
  .item { flex-basis: 100px; flex-shrink: 0; min-width: 0; }
  #a { flex-grow: 1; background: lightblue; }
  #b { flex-grow: 2; background: lightgreen; }
</style>
<div class="row">
  <div class="item" id="a">A</div>
  <div class="item" id="b">B</div>
</div>
<pre id="result"></pre>
<script>
  const widths = ['a', 'b'].map(id =>
    document.getElementById(id).getBoundingClientRect().width
  );
  document.getElementById('result').textContent = widths.join(', ');
</script>

Résultat

200, 300

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources