Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

mod() — modulo ze znakiem dzielnika

Sprowadź wartość CSS do powtarzalnego przedziału i zrozum, dlaczego liczby ujemne dają inne wyniki niż reszta z dzielenia.

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

Składnia

mod(A, B)
transform: translateX(mod(-18px, 5px));

mod(A, B) przesuwa A o całkowitą wielokrotność B do przedziału między zerem a B, obejmującego zero, lecz bez B. Dla skończonych argumentów i niezerowego dzielnika niezerowy wynik ma znak B. mod() przyjmuje zgodne typy liczbowe, w tym długości; łączenie długości z czasem jest niepoprawne.

mod(-18px, 5px) daje 2 piksele, natomiast mod(18px, -5px) daje −2 piksele. Pokrewne rem() zachowuje znak dzielnej, jeśli wynik jest niezerowy. Operator % w JavaScript oblicza resztę, więc przeniesienie jego wyniku dla liczb ujemnych do logiki modulo w CSS może dać błędną pozycję lub fazę.

Zerowy dzielnik albo nieskończona dzielna daje NaN; specyfikacja zawiera dodatkowe reguły dla nieskończoności. W praktyce utrzymuj dane skończone, a dzielnik niezerowy. Wynik true z CSS.supports() dla deklaracji z dzielnikiem zero potwierdza parsowanie, nie użyteczny rezultat. Ujemne wyniki są poprawne dla przesunięć, lecz właściwości zabraniające wartości ujemnych mogą je ukryć przez ograniczenie zakresu.

Przykłady

const box = document.createElement('div');
document.body.append(box);
function offset(expression) {
  box.style.transform = 'translateX(' + expression + ')';
  return new DOMMatrix(getComputedStyle(box).transform).m41;
}
for (const [a, b] of [[18,5],[-18,5],[18,-5],[-18,-5]]) {
  console.log(a + ',' + b + ':',
    offset('mod(' + a + 'px,' + b + 'px)'),
    offset('rem(' + a + 'px,' + b + 'px)'));
}
console.log('mixed types:', CSS.supports('width', 'mod(18px,5s)'));
console.log('zero divisor parses:', CSS.supports('width', 'mod(18px,0px)'));
box.remove();

Wynik

18,5: 3 3
-18,5: 2 -3
18,-5: -2 3
-18,-5: -3 -3
mixed types: false
zero divisor parses: true

Widoczny kod odczytuje rzeczywiste macierze przesunięcia i wypisuje modulo, a potem resztę dla czterech kombinacji znaków. Oddzielnie sprawdza niezgodne wymiary oraz zerowy dzielnik; deklaracja z zerowym dzielnikiem nie jest nakładana na element.

Źródła