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

CKTIS / CSS

min() — um limite superior adaptável

Escolhe o menor valor compatível para limitar uma largura fluida por cima, sem confundir esse limite com um tamanho mínimo.

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

Sintaxe

min(value, ...)
width: min(100% - 20px, 300px);

min() devolve o menor resultado de um ou mais cálculos separados por vírgulas. A declaração width: min(100% - 20px, 300px) deixa 20 píxeis relativamente ao bloco que contém o elemento e limita a largura escolhida a 300 píxeis. Apesar do nome, impõe aqui um limite superior, não um mínimo.

As operações podem surgir diretamente num argumento sem um calc() adicional. Mantém espaços em torno da adição e da subtração e usa tipos compatíveis. Uma largura pode combinar comprimentos e percentagens, mas comparar 10px com 1s é inválido. A percentagem precisa de uma referência; o exemplo define a largura do bloco ascendente.

As restantes restrições continuam a aplicar-se depois da escolha do valor. Aqui, min-width pode aumentar a largura final acima do resultado calculado e ultrapassar um bloco ascendente estreito. O conteúdo, o espaçamento interno e o modelo de caixa também afetam o espaço ocupado. Para definir um mínimo e um máximo, escolhe uma expressão com ambos os limites em vez de confiar no nome da função.

Exemplos

const parent = document.createElement('div');
const child = document.createElement('div');
parent.append(child);
document.body.append(parent);
child.style.width = 'min(100% - 20px, 300px)';
for (const width of [600, 240, 80]) {
  parent.style.width = width + 'px';
  console.log(width + ':', getComputedStyle(child).width);
}
child.style.minWidth = '100px';
console.log('with min-width:', getComputedStyle(child).width);
console.log('mixed length/time:', CSS.supports('width', 'min(10px, 1s)'));
parent.remove();

Resultado

600: 300px
240: 220px
80: 60px
with min-width: 100px
mixed length/time: false

O navegador calcula 300, 220 e 60 píxeis para blocos ascendentes de 600, 240 e 80 píxeis. Acrescentar um mínimo de 100 píxeis muda o último resultado para 100. É uma medição real da disposição, não uma reprodução do cálculo CSS em JavaScript.

Fontes