sign()

Baseline 2025

Newly available

Since ⁨June 2025⁩, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Die sign() CSS-Funktion enthält eine Berechnung und gibt -1 zurück, wenn der numerische Wert des Arguments negativ ist, +1, wenn der numerische Wert des Arguments positiv ist, 0⁺, wenn der numerische Wert des Arguments 0⁺ ist, und 0⁻, wenn der numerische Wert des Arguments 0⁻ ist.

Hinweis: Während abs() den absoluten Wert des Arguments zurückgibt, gibt sign() das Vorzeichen des Arguments zurück.

Syntax

css

/* property: sign( expression ) */
top: sign(20vh - 100px);

Parameter

Die Funktion sign(x) akzeptiert nur einen Wert als ihren Parameter.

x: Eine Berechnung, die sich zu einer Zahl auflöst.

Rückgabewert

Eine Zahl, die das Vorzeichen von A darstellt:

Wenn x positiv ist, wird 1 zurückgegeben.
Wenn x negativ ist, wird -1 zurückgegeben.
Wenn x positive Null ist, wird 0 zurückgegeben.
Wenn x negative Null ist, wird -0 zurückgegeben.
Andernfalls wird NaN zurückgegeben.

Formale Syntax

<sign()> = 
  sign( <calc-sum> )  

<calc-sum> = 
  <calc-product> [ [ '+' | '-' ] <calc-product> ]*  

<calc-product> = 
  <calc-value> [ [ '*' | / ] <calc-value> ]*  

<calc-value> = 
  <number>        |
  <dimension>     |
  <percentage>    |
  <calc-keyword>  |
  ( <calc-sum> )  

<calc-keyword> = 
  e          |
  pi         |
  infinity   |
  -infinity  |
  NaN

Beispiele

Hintergrundbildposition

Zum Beispiel werden bei background-position positive Prozentsätze zu einem negativen Längenwert aufgelöst und umgekehrt, wenn das Hintergrundbild größer ist als der Hintergrundbereich. Daher könnte sign(10%) je nach Auflösung des Prozentsatzes 1 oder -1 zurückgeben! (Oder sogar 0, wenn es gegen eine Länge von null aufgelöst wird.)

css

div {
  background-position: sign(10%);
}

Positionsrichtung

Ein weiterer Anwendungsfall ist die Steuerung der position des Elements. Entweder ein positiver oder ein negativer Wert.

css

div {
  position: absolute;
  top: calc(100px * sign(var(--value)));
}

Spezifikationen

Specification
CSS Values and Units Module Level 4 # sign-funcs

Browser-Kompatibilität

Siehe auch

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden