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

CKTIS / CSS

flex-grow — distribuir o espaço livre

A propriedade flex-grow controla a participação de um elemento flex na distribuição do espaço livre positivo ao longo do eixo principal. Os fatores descrevem aumentos de tamanho, não as proporções das larguras finais.

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

Sintaxe

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

flex-grow define o fator de crescimento de um elemento flex. Aceita um número sem unidade maior ou igual a 0; percentagens e números negativos não são válidos. O valor inicial é 0 e a propriedade não é herdada.

O espaço livre positivo é distribuído em cada linha flex ao longo do eixo principal, de acordo com os fatores de crescimento. O valor 0 desativa este crescimento. Se a soma dos fatores for inferior a 1, pode ficar algum espaço por utilizar.

As proporções aplicam-se aos aumentos para além dos tamanhos de base, não aos tamanhos finais. O resultado também depende de flex-basis e das restrições mínimas e máximas. flex-shrink controla a redução. A propriedade abreviada flex permite definir estes componentes em conjunto e repõe os componentes omitidos.

No exemplo, o contentor tem 500px de largura e cada uma das duas bases mede 100px. Os 300px restantes são divididos na proporção 1:2: os elementos recebem mais 100px e 200px, respetivamente. As larguras esperadas são, portanto, 200px e 300px.

Exemplos

<!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>

Resultado

200, 300

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.

Fontes