CKTIS / CSS
round(): zaokrúhlenie hodnoty na zvolený krok
Vyberte spôsob zaokrúhľovania vedome, najmä pri záporných hodnotách a prípadoch presne uprostred.
Verzia: 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);Funkcia round() zaokrúhľuje hodnotu na celočíselný násobok kroku. Argumenty musia mať kompatibilné typy: dĺžky možno zaokrúhľovať na dĺžky, nie na sekundy. Predvolená stratégia nearest vyberá bližší násobok; pri presnej zhode vzdialeností rozhoduje smerom ku kladnému nekonečnu. Ďalšie stratégie sú up ku kladnému nekonečnu, down k zápornému nekonečnu a to-zero k nule. Pri záporných vstupoch up a down neznamenajú to isté ako zväčšovanie či zmenšovanie absolútnej hodnoty.
Pri kroku 10px sa -15px zmení na -10px pre nearest, up a to-zero, ale na -20px pre down. Hodnota, ktorá už je násobkom, zostáva nezmenená. Nulový krok dáva NaN, preto použite zmysluplný nenulový krok. Pri čísle bez jednotky možno krok vynechať a potom je 1; veličiny s jednotkami obvykle vyžadujú výslovný krok. Aktuálny návrh definuje aj line-width pre dĺžky so špeciálnym prispôsobením pixelom, táto novšia stratégia však vyžaduje samostatnú kontrolu kompatibility.
Príklad meria vypočítané okraje pre všetky štyri zavedené stratégie aj obe znamienka prípadu uprostred: kladných 15px dáva 20px. Zachová aj presných -20px a odmietne kombináciu px a s. Chromium 157 vracia false pre testovanú syntax round(line-width, 1.3px). Toto obmedzenie implementácie nezneplatňuje návrh a nebráni fungovaniu zavedených stratégií.
Prí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ýsledok
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á smer ku kladnému nekonečnu, nie od nuly. Samostatná skúška line-width zisťuje kompatibilitu, nedemonštruje vykonané prispôsobenie pixelom.