rotate3d()
==========

**`rotate3d()`** は CSS の関数は、要素を 3D 空間内の固定した軸を中心に、形を崩さずに回転させる座標変換を定義します。結果は `<transform-function>` データ型になります。

試してみましょう
--------

3D 空間では、回転には三次元の自由度があり、これらが一緒になって単一の回転軸を表します。回転軸は [x, y, z] ベクトルによって定義され、 (`transform-origin` プロパティで定義される) 原点を通過します。もし、指定値として、ベクトルが*正規化*されていない場合 (すなわち、3 つの座標の 2 乗の合計が 1 ではない場合)、ユーザーエージェントが内部的に正規化します。正規化できないベクトル、例えば null ベクトル [0, 0, 0] では、回転が無視されますが、 CSS プロパティ全体を無効化はしません。

**メモ:** 2D 平面での回転とは異なり、 3D での回転はふつう交換可能ではありません。言い換えれば、回転の順番が結果に影響を与えます。

構文
--

`rotate3d()` で行う回転の量は、3 つの `<number>` および 1 つの `<angle>` で指定します。 `<number>` は回転軸を表すベクトルの X, Y, Z 座標を表します。 `<angle>` は回転角を表します。正の数の場合、回転方向は時計回りで、負の数の場合、回転方向は反時計回りになります。


```css
rotate3d(x, y, z, a)
```

### 値

`x`

`<number>` で、回転軸を表すベクトルの X 座標を表し、 0 から 1 までの値を取ります。

`y`

`<number>` で、回転軸を表すベクトルの Y 座標を表し、 0 から 1 までの値を取ります。

`z`

`<number>` で、回転軸を表すベクトルの Z 座標を表し、 0 から 1 までの値を取ります。

`a`

`<angle>` で、回転する角度を表します。正の数の角度は時計回りの回転を、負の数の角度は反時計回りの回転を表します。



|  |  |
| --- | --- |
| 直交座標系 (ℝ^2) | この座標変換は 3D 空間に適用され、平面で表すことはできません。 |
| 同次座標系 (ℝℙ^2) |
| 直交座標系 (ℝ^3) | 

(

1
+
(
1
−
cos
(
a
)
)
(

x
2

−
1
)

z
⋅
sin
(
a
)
+
x
y
(
1
−
cos
(
a
)
)

−
y
⋅
sin
(
a
)
+
x
z
(
1
−
cos
(
a
)
)

−
z
⋅
sin
(
a
)
+
x
y
(
1
−
cos
(
a
)
)

1
+
(
1
−
cos
(
a
)
)
(

y
2

−
1
)

x
⋅
sin
(
a
)
+
y
z
(
1
−
cos
(
a
)
)

y
⋅
sin
(
a
)
+
x
z
(
1
−
cos
(
a
)
)

−
x
⋅
sin
(
a
)
+
y
z
(
1
−
cos
(
a
)
)

1
+
(
1
−
cos
(
a
)
)
(

z
2

−
1
)

)

\begin{pmatrix}1 + (1 - \cos(a))(x^2 - 1) & z\cdot \sin(a) + xy(1 - \cos(a)) & -y\cdot \sin(a) + xz(1 - \cos(a))\\-z\cdot \sin(a) + xy(1 - \cos(a)) & 1 + (1 - \cos(a))(y^2 - 1) & x\cdot \sin(a) + yz(1 - \cos(a))\\y\cdot \sin(a) + xz(1 - \cos(a)) & -x\cdot \sin(a) + yz(1 - \cos(a)) & 1 + (1 - \cos(a))(z^2 - 1)\end{pmatrix}

 |
| 同次座標系 (ℝℙ^3) | 

(

1
+
(
1
−
cos
(
a
)
)
(

x
2

−
1
)

z
⋅
sin
(
a
)
+
x
y
(
1
−
cos
(
a
)
)

−
y
⋅
sin
(
a
)
+
x
z
(
1
−
cos
(
a
)
)

0

−
z
⋅
sin
(
a
)
+
x
y
(
1
−
cos
(
a
)
)

1
+
(
1
−
cos
(
a
)
)
(

y
2

−
1
)

x
⋅
sin
(
a
)
+
y
z
(
1
−
cos
(
a
)
)

0

y
⋅
sin
(
a
)
+
x
z
(
1
−
cos
(
a
)
)

−
x
⋅
sin
(
a
)
+
y
z
(
1
−
cos
(
a
)
)

1
+
(
1
−
cos
(
a
)
)
(

z
2

−
1
)

0

0

0

0

1

)

\begin{pmatrix}1 + (1 - \cos(a))(x^2 - 1) & z\cdot \sin(a) + xy(1 - \cos(a)) & -y\cdot \sin(a) + xz(1 - \cos(a)) & 0\\-z\cdot \sin(a) + xy(1 - \cos(a)) & 1 + (1 - \cos(a))(y^2 - 1) & x\cdot \sin(a) + yz(1 - \cos(a)) & 0\\y\cdot \sin(a) + xz(1 - \cos(a)) & -x\cdot \sin(a) + yz(1 - \cos(a)) & 1 + (1 - \cos(a))(z^2 - 1) & 0\\0 & 0 & 0 & 1\end{pmatrix}

 |

例
-

### Y 軸に沿って回転

#### HTML


```html
<div>Normal</div>
<div class="rotated">Rotated</div>
```


#### CSS


```css
body {
  perspective: 800px;
}

div {
  width: 80px;
  height: 80px;
  background-color: skyblue;
}

.rotated {
  transform: rotate3d(0, 1, 0, 60deg);
  background-color: pink;
}
```


#### 結果

### 独自の軸に沿って回転

#### HTML


```html
<div>Normal</div>
<div class="rotated">Rotated</div>
```


#### CSS


```css
body {
  perspective: 800px;
}

div {
  width: 80px;
  height: 80px;
  background-color: skyblue;
}

.rotated {
  transform: rotate3d(1, 2, -1, 192deg);
  background-color: pink;
}
```


#### 結果

仕様書
---

| Specification |
| --- |
| CSS Transforms Module Level 2 # funcdef-rotate3d |

ブラウザーの互換性
---------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

関連情報
----

* `transform` プロパティ
* `rotate` プロパティ
* `<transform-function>`