Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

mod() — modulo con il segno del divisore

Riporta un valore CSS in un intervallo ripetitivo e comprendi perché i valori negativi differiscono dall’operazione di resto.

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

Sintassi

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

mod(A, B) sposta A di un multiplo intero di B nell’intervallo tra zero e B, includendo zero ma escludendo B. Per argomenti finiti con divisore non nullo, un risultato non nullo ha il segno di B. mod() accetta tipi numerici compatibili, comprese le lunghezze; mescolare una lunghezza con un tempo non è valido.

mod(-18px, 5px) restituisce 2 pixel, mentre mod(18px, -5px) restituisce −2 pixel. La funzione correlata rem() conserva invece il segno del dividendo per un risultato non nullo. Il % di JavaScript calcola il resto: copiarne il risultato negativo in una logica di modulo CSS può quindi produrre una posizione o una fase errata.

Un divisore zero o un dividendo infinito produce NaN; la specifica prevede ulteriori regole per gli infiniti. Nella pratica mantieni gli ingressi finiti e il divisore diverso da zero. Un true restituito da CSS.supports() per una dichiarazione con divisore zero ne conferma solo la sintassi. I risultati negativi sono validi per le traslazioni, ma proprietà che li vietano possono nasconderli limitandone l’intervallo.

Esempi

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

Risultato

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

Il codice legge vere matrici di traslazione e stampa prima il modulo, poi il resto, per le quattro combinazioni di segni. Verifica separatamente dimensioni incompatibili e un divisore zero; quest’ultima dichiarazione non viene applicata all’elemento.

Fonti