WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen