sign()

構文

/* プロパティ: sign( 式 ) */
top: sign(20vh - 100px);

引数

sign(x) 関数は、引数として 1 つの値のみを取ります。

x

数値に解決される計算式。

返値

A の符号を表す数値です。

• x が正の数であれば、 1 を返します。
• x が負の数であれば、 -1 を返します。
• x が正のゼロであれば、 0 を返します。
• x が負のゼロであれば、 -0 を返します。
• それ以外の場合は NaN を返します。

形式文法

<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        

例

背景画像の位置

例えば、 background-position では、背景画像が背景領域よりも大きい場合、正のパーセント値は負の長さに、負のパーセント値は正の長さに変換されます。したがって、 sign(10%) は、パーセント値の変換方法に応じて 1 または -1 を返すことになります。（長さが 0 の場合、0 を返すこともあります。）

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

位置指定方向

もう 1 つの用途は、要素の position を制御することです。値は正または負のいずれかです。

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

仕様書

ブラウザーの互換性

関連情報

• abs()