Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

mod() — módulo com o sinal do divisor

Coloca um valor CSS num intervalo repetitivo e percebe por que razão os valores negativos diferem do cálculo do resto.

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

Sintaxe

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

mod(A, B) desloca A por um múltiplo inteiro de B até ao intervalo entre zero e B, incluindo zero mas excluindo B. Para argumentos finitos com divisor não nulo, um resultado não nulo tem o sinal de B. mod() aceita tipos numéricos compatíveis, incluindo comprimentos; misturar um comprimento com um tempo é inválido.

mod(-18px, 5px) devolve 2 píxeis, enquanto mod(18px, -5px) devolve −2 píxeis. A função relacionada rem() conserva o sinal do dividendo num resultado não nulo. O % de JavaScript calcula um resto: transpor o seu resultado negativo para uma lógica de módulo CSS pode produzir uma posição ou fase errada.

Um divisor zero ou um dividendo infinito produz NaN; a especificação tem outras regras para infinitos. Na prática, mantém as entradas finitas e o divisor diferente de zero. Se CSS.supports() devolver true para uma declaração com divisor zero, apenas confirma a análise sintática. Os deslocamentos aceitam resultados negativos, mas propriedades que os proíbem podem ocultá-los ao restringir o intervalo de valores.

Exemplos

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

Resultado

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

O código lê matrizes de deslocamento reais e apresenta primeiro o módulo e depois o resto para as quatro combinações de sinais. Verifica separadamente dimensões incompatíveis e um divisor zero; esta última declaração não é aplicada ao elemento.

Fontes