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.