CKTIS / CSS
mod() — Modulo mit dem Vorzeichen des Divisors
Führe einen CSS-Wert in ein wiederkehrendes Intervall zurück und verstehe die Abweichung zur Restberechnung bei negativen Werten.
Version: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntax
mod(A, B)
transform: translateX(mod(-18px, 5px));mod(A, B) verschiebt A um ein ganzzahliges Vielfaches von B in das Intervall zwischen null und B, einschließlich null, aber ohne B. Bei endlichen Argumenten und einem Divisor ungleich null hat ein von null verschiedenes Ergebnis das Vorzeichen von B. mod() akzeptiert kompatible numerische Typen einschließlich Längen; eine Länge mit einer Zeit zu mischen ist ungültig.
mod(-18px, 5px) ergibt 2 Pixel, mod(18px, -5px) dagegen −2 Pixel. Die verwandte Funktion rem() behält bei einem Ergebnis ungleich null das Vorzeichen des Dividenden. JavaScripts % berechnet einen Rest; wer dessen Ergebnis für negative Werte auf CSS-Modulo überträgt, kann eine falsche Position oder Phase erhalten.
Ein Divisor von null oder ein unendlicher Dividend ergibt NaN; für Unendlichkeiten enthält die Spezifikation weitere Regeln. Halte praktische Eingaben endlich und den Divisor ungleich null. Meldet CSS.supports() für eine Deklaration mit Nulldivisor true, bestätigt das nur ihre Syntax. Negative Ergebnisse sind bei Verschiebungen gültig; Eigenschaften mit nichtnegativem Wertebereich können sie durch Bereichsbeschränkung verbergen.
Beispiele
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();Ergebnis
18,5: 3 3 -18,5: 2 -3 18,-5: -2 3 -18,-5: -3 -3 mixed types: false zero divisor parses: true
Der Code liest echte Verschiebungsmatrizen und gibt für alle vier Vorzeichenkombinationen zuerst Modulo, dann den Rest aus. Unvereinbare Dimensionen und ein Nulldivisor werden getrennt geprüft; die Deklaration mit Nulldivisor wird nicht auf das Element angewandt.