Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / CSS

mod() — módulo con el signo del divisor

Lleva un valor CSS a un intervalo repetitivo y entiende por qué los valores negativos difieren de la operación de resto.

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

Sintaxis

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

mod(A, B) desplaza A por un múltiplo entero de B hasta el intervalo entre cero y B, incluyendo cero pero excluyendo B. Con argumentos finitos y divisor no nulo, un resultado no nulo tiene el signo de B. mod() acepta tipos numéricos compatibles, incluidas longitudes; mezclar una longitud con un tiempo es inválido.

mod(-18px, 5px) produce 2 píxeles, mientras que mod(18px, -5px) produce −2 píxeles. La función relacionada rem() conserva el signo del dividendo para resultados no nulos. El % de JavaScript calcula un resto, por lo que trasladar su resultado negativo a una lógica de módulo CSS puede dar una posición o fase incorrecta.

Un divisor cero o un dividendo infinito produce NaN; la especificación contiene otras reglas para los infinitos. Mantén entradas finitas y un divisor distinto de cero en usos prácticos. Que CSS.supports() devuelva true para una declaración con divisor cero confirma el análisis sintáctico, no un resultado útil. Las traslaciones admiten valores negativos, pero las propiedades que los prohíben pueden ocultarlos al restringir su rango.

Ejemplos

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

El código lee matrices de traslación reales e imprime primero el módulo y después el resto para las cuatro combinaciones de signos. Comprueba aparte dimensiones incompatibles y un divisor cero; esta última declaración no se aplica al elemento.

Fuentes