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

CKTIS / CSS

clamp() — limitação de um valor a um intervalo

`clamp()` escolhe o valor preferido, sem ficar abaixo do mínimo nem acima do máximo; todos os argumentos têm de possuir um tipo de cálculo coerente.

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

Sintaxe

clamp( [ <calc-sum> | none ], <calc-sum>, [ <calc-sum> | none ] )

clamp() escolhe o valor preferido, sem ficar abaixo do mínimo nem acima do máximo; todos os argumentos têm de possuir um tipo de cálculo coerente.

Num contentor de 400px, o exemplo mede os três ramos: clamp(100px, 10%, 200px) dá 100px, clamp(100px, 40%, 200px) dá 160px e clamp(100px, 80%, 200px) dá 200px. O limite clamp(200px, 150px, 100px) também dá 200px.

Gramática: clamp( [ <calc-sum> | none ], <calc-sum>, [ <calc-sum> | none ] ).

A semântica é max(MIN, min(VAL, MAX)), portanto o mínimo vence quando os limites estão invertidos, não o máximo. Cada limite pode ser none para remover a restrição desse lado. Cada argumento aceita uma expressão completa sem outro calc(), mas tipos incompatíveis invalidam toda a função.

Exemplos

const host=document.createElement('div');document.body.append(host);host.style.cssText='width:400px';const used=value=>{const box=document.createElement('div');host.append(box);box.style.cssText='height:1px;width:'+value;return Math.round(box.getBoundingClientRect().width)};const low=used('clamp(100px, 10%, 200px)'),preferred=used('clamp(100px, 40%, 200px)'),high=used('clamp(100px, 80%, 200px)'),inverted=used('clamp(200px, 150px, 100px)');if(low!==100||preferred!==160||high!==200||inverted!==200)throw new Error('clamp branch mismatch: '+[low,preferred,high,inverted]);console.log('min='+low+'; preferred='+preferred+'; max='+high+'; inverted='+inverted);

Resultado

min=100; preferred=160; max=200; inverted=200

`clamp()` escolhe o valor preferido, sem ficar abaixo do mínimo nem acima do máximo; todos os argumentos têm de possuir um tipo de cálculo coerente.

Fontes