WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

sign(): Richtung ohne Betrag

Reduziere eine numerische Berechnung auf ihr Vorzeichen und verwende das einheitenlose Ergebnis als Faktor.

Version: CSS Modules

Syntax

transform: translateX(calc(sign(-8px) * 12px));

sign(A) wertet eine Berechnung aus und liefert -1 für einen negativen Wert, +1 für einen positiven und null für null. Das Ergebnis ist eine Zahl ohne Längen- oder Winkeleinheit, auch wenn das Argument eine Länge oder ein Winkel ist. Es beschreibt somit die Richtung statt der Größe: sign(-8px) ist -1, nicht -1px oder 8px. abs() dient einem anderen Zweck und erhält den Betrag des Arguments.

Das Vorzeichen wird erst nach der Auflösung des Arguments bestimmt. Ein positiver Prozentwert muss keine positive aufgelöste Länge ergeben: Bei background-position wird die Bezugsdifferenz negativ, wenn das Bild größer als der Positionierungsbereich ist. Die Spezifikation unterscheidet außerdem positive und negative null; NaN bleibt NaN. Eine dezimal ausgegebene null in diesem Beispiel prüft das Verhalten vorzeichenbehafteter null nicht.

Das Beispiel multipliziert jedes Vorzeichen mit 12px für eine horizontale Verschiebung. Die Argumente -8px, 0px und 8px ergeben Versätze von -12, 0 und 12 Pixeln; auch -3deg ergibt -12 Pixel, weil sein Vorzeichen einheitenlos ist. Der Browser verwirft width: sign(8px), da eine einheitenlose Zahl ungleich null keine Breite ist. Die gemessenen Transformationsmatrizen bestätigen die tatsächliche Auswertung.

Beispiele

const box=document.createElement('div');document.body.append(box);
const move=value=>{box.style.transform='translateX(calc(sign('+value+') * 12px))';return new DOMMatrixReadOnly(getComputedStyle(box).transform).m41.toFixed(0)};
const negative=move('-8px'),zero=move('0px'),positive=move('8px'),angle=move('-3deg');
console.log('negative='+negative+'; zero='+zero+'; positive='+positive+'; angle='+angle+'; bare-width='+CSS.supports('width','sign(8px)')+'; supported='+CSS.supports('transform','translateX(calc(sign(-8px) * 12px))'));

Ergebnis

negative=-12; zero=0; positive=12; angle=-12; bare-width=false; supported=true

Geprüft in Chromium 157.0.8103.51. Für Browser ohne diese Mathematikfunktion ist ein Fallback oder @supports erforderlich. Prozentauflösung und vorzeichenbehaftete null werden anhand der Spezifikation erläutert, nicht als hier ausgeführte Testfälle ausgegeben.

Quellen