CKTIS / CSS
round(): dopasowanie wartości do wybranego kroku
Wybierz sposób zaokrąglania świadomie, zwłaszcza dla wartości ujemnych i przypadków dokładnie pośrodku.
Wersja: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Składnia
margin-left: round(nearest, -15px, 10px);Funkcja round() zaokrągla wartość do całkowitej wielokrotności kroku. Argumenty muszą mieć zgodne typy: długości można zaokrąglać do długości, lecz nie do sekund. Domyślna strategia nearest wybiera bliższą wielokrotność; dokładny remis rozstrzyga w stronę dodatniej nieskończoności. Pozostałe strategie to up w stronę dodatniej nieskończoności, down w stronę ujemnej nieskończoności oraz to-zero w stronę zera. Dla wartości ujemnych up i down nie oznaczają po prostu zwiększania lub zmniejszania modułu.
Przy kroku 10px wartość -15px daje -10px dla nearest, up i to-zero, lecz -20px dla down. Wartość będąca już wielokrotnością pozostaje bez zmian. Zerowy krok daje NaN, dlatego wybierz sensowny krok niezerowy. Dla liczby bez jednostki można pominąć krok: wynosi wtedy 1; wielkości wymiarowe zwykle wymagają jawnego kroku. Obecny projekt określa też line-width dla długości ze specjalnym dopasowaniem do pikseli, lecz ta nowsza strategia wymaga osobnego sprawdzenia zgodności.
Przykład mierzy obliczone marginesy dla wszystkich czterech utrwalonych strategii i obu znaków przypadku pośrodku: dodatnie 15px daje 20px. Zachowuje też dokładne -20px i odrzuca połączenie px z s. Chromium 157 zwraca false dla sprawdzanej składni round(line-width, 1.3px). To ograniczenie implementacji nie unieważnia projektowanej funkcji i nie blokuje działania utrwalonych strategii.
Przykłady
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)'));Wynik
nearest=-10px up=-10px down=-20px to-zero=-10px positive-tie=20px; exact=-20px mixed-types=false; line-width=false
Wyniki pokazują, że up oznacza kierunek dodatniej nieskończoności, a nie oddalanie od zera. Osobna próba line-width bada zgodność, nie demonstruje wykonanego dopasowania do pikseli.