KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / CSS

round(): een waarde afronden op een gekozen interval

Kies de afrondingsstrategie bewust, vooral bij negatieve waarden en gevallen precies halverwege.

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

De functie round() rondt een waarde af op een geheel veelvoud van een interval. Argumenten moeten compatibele typen hebben: lengtes kunnen op lengtes worden afgerond, niet op seconden. De standaardstrategie nearest kiest het dichtstbijzijnde veelvoud; bij een exacte gelijke afstand wint de richting naar positieve oneindigheid. Andere strategieën zijn up naar positieve oneindigheid, down naar negatieve oneindigheid en to-zero naar nul. Bij negatieve invoer betekenen up en down niet simpelweg het vergroten of verkleinen van de absolute waarde.

Met een interval van 10px wordt -15px gelijk aan -10px voor nearest, up en to-zero, maar -20px voor down. Een waarde die al een veelvoud is, blijft gelijk. Een nulinterval geeft NaN: kies daarom een zinvol interval dat niet nul is. Bij een getal zonder eenheid mag het interval ontbreken en wordt het 1; dimensies hebben normaal een expliciet interval nodig. Het huidige ontwerp definieert ook line-width voor lengtes met speciale pixeluitlijning, maar die nieuwere strategie vraagt om een eigen compatibiliteitscontrole.

Het voorbeeld meet berekende marges voor alle vier gevestigde strategieën en beide tekens van het geval halverwege: positieve 15px wordt 20px. Het behoudt ook exacte -20px en verwerpt de combinatie van px en s. Chromium 157 geeft false voor de geteste syntaxis round(line-width, 1.3px). Die implementatiebeperking maakt de ontwerpfunctie niet ongeldig en verhindert de werking van de gevestigde strategieën niet.

Voorbeelden

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

Resultaat

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

De resultaten tonen dat up naar positieve oneindigheid betekent, niet van nul af. De aparte line-width-proef is een compatibiliteitsresultaat, geen uitgevoerde demonstratie van pixeluitlijning.

Bronnen