CKTIS / CSS
mod() — un modulo du signe du diviseur
Ramenez une valeur CSS dans un intervalle répétitif et comprenez pourquoi les valeurs négatives diffèrent d’un simple reste de division.
Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntaxe
mod(A, B)
transform: translateX(mod(-18px, 5px));mod(A, B) décale A d’un multiple entier de B vers l’intervalle entre zéro et B, zéro inclus et B exclu. Pour des arguments finis et un diviseur non nul, un résultat non nul a le signe de B. mod() accepte des types numériques compatibles, notamment les longueurs ; mélanger longueur et durée est invalide.
mod(-18px, 5px) donne 2 pixels, tandis que mod(18px, -5px) donne −2 pixels. La fonction apparentée rem() conserve au contraire le signe du dividende pour un résultat non nul. Le % de JavaScript calcule un reste : reprendre son résultat négatif dans une logique de modulo CSS peut donc produire une position ou une phase incorrecte.
Un diviseur nul ou un dividende infini produit NaN ; la spécification prévoit d’autres règles pour les infinis. Gardez les entrées finies et le diviseur non nul en pratique. Si CSS.supports() renvoie true pour une déclaration à diviseur nul, seule son analyse syntaxique est confirmée. Les déplacements acceptent les résultats négatifs, mais certaines propriétés peuvent les masquer en limitant leur plage de valeurs.
Exemples
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();Résultat
18,5: 3 3 -18,5: 2 -3 18,-5: -2 3 -18,-5: -3 -3 mixed types: false zero divisor parses: true
Le code lit de véritables matrices de déplacement et affiche le modulo puis le reste pour les quatre combinaisons de signes. Il vérifie séparément les dimensions incompatibles et un diviseur nul ; cette dernière déclaration n’est pas appliquée à l’élément.