WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

round(): einen Wert an ein gewähltes Intervall anpassen

Wähle die Rundungsstrategie bewusst, insbesondere bei negativen Werten und genau mittigen Fällen.

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

Syntax

margin-left: round(nearest, -15px, 10px);

Die Funktion round() rundet einen Wert auf ein ganzzahliges Vielfaches eines Intervalls. Die Argumente müssen kompatible Typen haben: Längen lassen sich auf Längen runden, nicht auf Sekunden. Die Standardstrategie nearest wählt das nähere Vielfache; bei gleichem Abstand gewinnt die Richtung zur positiven Unendlichkeit. Weitere Strategien sind up zur positiven Unendlichkeit, down zur negativen Unendlichkeit und to-zero zur Null. Bei negativen Eingaben bedeuten up und down nicht einfach, den Betrag zu erhöhen oder zu verringern.

Bei einem Intervall von 10px wird -15px für nearest, up und to-zero zu -10px, für down jedoch zu -20px. Ein bereits passendes Vielfaches bleibt unverändert. Ein Intervall von null ergibt NaN; wähle deshalb ein sinnvolles Intervall ungleich null. Bei einer einheitenlosen Zahl darf das Intervall fehlen und ist dann 1; Dimensionen benötigen normalerweise ein ausdrückliches Intervall. Der aktuelle Entwurf definiert außerdem line-width für Längen mit besonderer Pixelausrichtung; diese neuere Strategie benötigt eine eigene Kompatibilitätsprüfung.

Das Beispiel misst berechnete Ränder für alle vier etablierten Strategien und beide Vorzeichen des mittigen Falls: Positive 15px werden zu 20px. Es erhält außerdem exakte -20px und verwirft die Mischung aus px und s. Chromium 157 liefert false für die getestete Syntax round(line-width, 1.3px). Diese Implementierungsgrenze macht die Entwurfsfunktion nicht ungültig und hindert die etablierten Strategien nicht am Funktionieren.

Beispiele

const box=document.createElement('div');document.body.append(box);
const read=value=>{box.style.marginLeft='0px';box.style.marginLeft=value;return getComputedStyle(box).marginLeft};
for(const mode of ['nearest','up','down','to-zero'])console.log(mode+'='+read('round('+mode+', -15px, 10px)'));
console.log('positive-tie='+read('round(15px, 10px)')+'; exact='+read('round(-20px, 10px)'));
console.log('mixed-types='+CSS.supports('margin-left','round(15px, 2s)')+'; line-width='+CSS.supports('border-width','round(line-width, 1.3px)'));

Ergebnis

nearest=-10px
up=-10px
down=-20px
to-zero=-10px
positive-tie=20px; exact=-20px
mixed-types=false; line-width=false

Die Ergebnisse zeigen: up bedeutet Richtung positive Unendlichkeit, nicht von null weg. Der separate line-width-Test ist ein Kompatibilitätsergebnis und keine ausgeführte Demonstration der Pixelausrichtung.

Quellen