WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

clamp() — Begrenzung eines Werts auf einen Bereich

`clamp()` wählt den bevorzugten Wert, jedoch nicht kleiner als das Minimum und nicht größer als das Maximum; alle Argumente brauchen einen konsistenten Berechnungstyp.

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

Syntax

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

clamp() wählt den bevorzugten Wert, jedoch nicht kleiner als das Minimum und nicht größer als das Maximum; alle Argumente brauchen einen konsistenten Berechnungstyp.

In einem 400px breiten Container misst das Beispiel alle drei Zweige: clamp(100px, 10%, 200px) ergibt 100px, clamp(100px, 40%, 200px) ergibt 160px, und clamp(100px, 80%, 200px) ergibt 200px. Der Grenzfall clamp(200px, 150px, 100px) ergibt ebenfalls 200px.

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

Die Semantik lautet max(MIN, min(VAL, MAX)); bei vertauschten Grenzen gewinnt daher das Minimum und nicht das Maximum. Jede Grenze darf none sein, um die Begrenzung auf dieser Seite aufzuheben. Jedes Argument erlaubt einen vollständigen Ausdruck ohne zusätzliches calc(), unvereinbare Typen machen jedoch die ganze Funktion ungültig.

Beispiele

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

Ergebnis

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

`clamp()` wählt den bevorzugten Wert, jedoch nicht kleiner als das Minimum und nicht größer als das Maximum; alle Argumente brauchen einen konsistenten Berechnungstyp.

Quellen