Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / CSS

round(): zaokrouhlení hodnoty na zvolený krok

Zvolte způsob zaokrouhlení vědomě, zejména u záporných hodnot a případů přesně uprostřed.

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

Syntaxe

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

Funkce round() zaokrouhluje hodnotu na celočíselný násobek kroku. Argumenty musí mít slučitelné typy: délky lze zaokrouhlovat na délky, nikoli na sekundy. Výchozí strategie nearest vybere bližší násobek; při přesné shodě vzdáleností rozhoduje směrem ke kladnému nekonečnu. Další strategie jsou up ke kladnému nekonečnu, down k zápornému nekonečnu a to-zero k nule. U záporných vstupů nejsou up a down totéž co zvětšování či zmenšování absolutní hodnoty.

Při kroku 10px se -15px změní na -10px pro nearest, up a to-zero, ale na -20px pro down. Hodnota, která už je násobkem, zůstává beze změny. Nulový krok dává NaN, proto používejte smysluplný nenulový krok. U čísla bez jednotky lze krok vynechat a pak má hodnotu 1; veličiny s jednotkami obvykle vyžadují výslovný krok. Současný návrh definuje také line-width pro délky se zvláštním přizpůsobením pixelům, tuto novější strategii však musíte ověřit samostatně.

Příklad měří vypočtené okraje pro všechny čtyři zavedené strategie a obě znaménka případu uprostřed: kladných 15px dává 20px. Zachová také přesných -20px a odmítne kombinaci px a s. Chromium 157 vrací false pro testovanou syntaxi round(line-width, 1.3px). Toto omezení implementace neznamená neplatnost návrhu ani nebrání fungování zavedených strategií.

Příklady

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

Výsledek

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

Výsledky ukazují, že up znamená ke kladnému nekonečnu, nikoli od nuly. Samostatná zkouška line-width zjišťuje kompatibilitu, nedemonstruje provedené přizpůsobení pixelům.

Zdroje