CSS の transform-origin プロパティは、要素の変形における原点を設定します。
この対話型サンプルのソースファイルは GitHub リポジトリに格納されています。対話型サンプルプロジェクトに協力したい場合は、 https://github.com/mdn/interactive-examples をクローンしてプルリクエストを送信してください。
変形の原点とは、それを中心に変形が適用される点です。例えば、 rotate() 関数による変形の原点は、回転の中心です。 (このプロパティは最初にプロパティ値の反対に平行移動し、それから要素の変形を適用し、プロパティ値の分だけ平行移動する形でで適用されます。)
構文
/* 値１つの構文 */ transform-origin: 2px; transform-origin: bottom; /* x-offset | y-offset */ transform-origin: 3cm 2px; /* x-offset-keyword | y-offset */ transform-origin: left 2px; /* x-offset-keyword | y-offset-keyword */ transform-origin: right top; /* y-offset-keyword | x-offset-keyword */ transform-origin: top right; /* x-offset | y-offset | z-offset */ transform-origin: 2px 30% 10px; /* x-offset-keyword | y-offset | z-offset */ transform-origin: left 5px -3px; /* x-offset-keyword | y-offset-keyword | z-offset */ transform-origin: right bottom 2cm; /* y-offset-keyword | x-offset-keyword | z-offset */ transform-origin: bottom right 2cm; /* グローバル値 */ transform-origin: inherit; transform-origin: initial; transform-origin: unset;
transform-origin プロパティは、オフセットを表す１～３つの値を使用して指定することができます。明示的に定義されなかったオフセットは、それぞれの対応する初期値にリセットされます。
２つ以上の値が定義され、どちらもの値もキーワードでない場合、又は使われているキーワードが center だけであった場合、最初の値は水平方向のオフセットであり、二番目の値は垂直方向のオフセットです。
- 値１つの構文:
- 値は
<length>,<percentage>, 又はleft,center,right,top,bottomのうちの１つでなければなりません。
- 値は
- 値２つの構文:
- 一方の値は
<length>,<percentage>, 又はキーワードのleft,center,rightのうちの１つでなければなりません。 - もう一方の値は、
<length>,<percentage>, 又はキーワードのtop,center,bottomのうちの１つでなければなりません。
- 一方の値は
- 値３つの構文:
- １番目と２番目の値は、値２つの構文と同じです。
- ３番目の値は
<length>でなければなりません。これは常に Z オフセットを表します。
値
- x-offset
<length>または<percentage>の、ボックスの左端から変形の原点までの距離を示す値です。- offset-keyword
left,right,top,bottom,centerのいずれかのキーワードで、対応するオフセットを表します。- y-offset
<length>または<percentage>の、ボックスの右端から変形の原点までの距離を示す値です。- x-offset-keyword
left,right,centerのいずれかのキーワードで、ボックスの左端から変形の原点までの距離を示します。- y-offset-keyword
top,bottom,centerのいずれかのキーワードで、ボックスの上端から変形の原点までの距離を示します。- z-offset
<length>値 (<percentage>は無効です) で、ユーザーの目と z=0 原点の距離を示します。
キーワードは便利に速記ができ、次の <percentage> 値に相当します。
| キーワード | 値 |
|---|---|
left |
0% |
center |
50% |
right |
100% |
top |
0% |
bottom |
100% |
形式文法
[ <length-percentage> | left | center | right | top | bottom ] | [ [ <length-percentage> | left | center | right ] && [ <length-percentage> | top | center | bottom ] ] <length>?where
<length-percentage> = <length> | <percentage>
例
| コード | サンプル |
|---|---|
|
|
<div class="box1"> </div>
.box1 {
margin: 0.5em;
width: 3em;
height: 3em;
border: solid 1px;
background-color: palegreen;
transform: none;
-webkit-transform: none;
}
|
|
|
<div class="box2"> </div>
.box2 {
margin: 0.5em;
width: 3em;
height: 3em;
border: solid 1px;
background-color: palegreen;
transform: rotate(30deg);
-webkit-transform: rotate(30deg);
}
|
|
|
<div class="box3"> </div>
.box3 {
margin: 0.5em;
width: 3em;
height: 3em;
border: solid 1px;
background-color: palegreen;
transform-origin: 0 0;
-webkit-transform-origin: 0 0;
transform: rotate(30deg);
-webkit-transform: rotate(30deg);
}
|
|
|
<div class="box4"> </div>
.box4 {
margin: 0.5em;
width: 3em;
height: 3em;
border: solid 1px;
background-color: palegreen;
transform-origin: 100% 100%;
-webkit-transform-origin: 100% 100%;
transform: rotate(30deg);
-webkit-transform: rotate(30deg);
}
|
|
|
<div class="box5"> </div>
.box5 {
margin: 0.5em;
width: 3em;
height: 3em;
border: solid 1px;
background-color: palegreen;
transform-origin: -1em -3em;
-webkit-transform-origin: -1em -3em;
transform: rotate(30deg);
-webkit-transform: rotate(30deg);
}
|
|
|
<div class="box6"> </div>
.box6 {
margin: 0.5em;
width: 3em;
height: 3em;
border: solid 1px;
background-color: palegreen;
transform: scale(
|
|
|
<div class="box7"> </div>
.box7 {
margin: 0.5em;
width: 3em;
height: 3em;
border: solid 1px;
background-color: palegreen;
transform: scale(
|
|
|
<div class="box8"> </div>
.box8 {
margin: 0.5em;
width: 3em;
height: 3em;
border: solid 1px;
background-color: palegreen;
transform: scale(
|
|
|
<div class="box9"> </div>
.box9 {
margin: 0.5em;
width: 3em;
height: 3em;
border: solid 1px;
background-color: palegreen;
transform: skewX(50deg);
-webkit-transform: skewX(50deg);
transform-origin: 100% -30%;
-webkit-transform-origin: 100% -30%;
}
|
|
|
<div class="box10"> </div>
.box10 {
margin: 0.5em;
width: 3em;
height: 3em;
border: solid 1px;
background-color: palegreen;
transform: skewY(50deg);
-webkit-transform: skewY(50deg);
transform-origin: 100% -30%;
-webkit-transform-origin: 100% -30%;
}
|
仕様書
| 仕様書 | 状態 | 備考 |
|---|---|---|
| CSS Transforms Level 1 transform-origin の定義 |
草案 |
| 初期値 | 50% 50% 0 |
|---|---|
| 適用対象 | 変形可能要素 |
| 継承 | なし |
| パーセンテージ | bounding box のサイズ |
| メディア | 視覚 |
| 計算値 | length の場合は絶対的な値、さもなくばパーセンテージ |
| アニメーションの種類 | length, percentage, calc の単純なリスト |
| 正規順序 | One or two values, with length made absolute and keywords translated to percentages |
ブラウザーの対応
このページの互換性一覧表は構造化データから生成されています。データに協力したいのであれば、 https://github.com/mdn/browser-compat-data をチェックアウトしてプルリクエストを送信してください。
Update compatibility data on GitHub
| デスクトップ | モバイル | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 基本対応 | Chrome
完全対応
あり
| Edge
完全対応
12
| Firefox
完全対応
16
| IE
完全対応
10
| Opera
完全対応
12.1
| Safari
完全対応
3.1
| WebView Android ? | Chrome Android ? | Edge Mobile
完全対応
あり
| Firefox Android
完全対応
16
| Opera Android ? | Safari iOS ? | Samsung Internet Android ? |
| Three-value syntax | Chrome 完全対応 あり | Edge ? | Firefox 完全対応 10 | IE 完全対応 9 | Opera 未対応 なし | Safari 完全対応 あり | WebView Android ? | Chrome Android ? | Edge Mobile ? | Firefox Android ? | Opera Android 未対応 なし | Safari iOS ? | Samsung Internet Android ? |
| Support in SVG | Chrome 完全対応 あり | Edge ? | Firefox
完全対応
43
| IE 未対応 なし | Opera 完全対応 あり | Safari ? | WebView Android ? | Chrome Android ? | Edge Mobile ? | Firefox Android ? | Opera Android ? | Safari iOS ? | Samsung Internet Android ? |
凡例
- 完全対応
- 完全対応
- 未対応
- 未対応
- 実装状況不明
- 実装状況不明
- 実験的。動作が変更される可能性があります。
- 実験的。動作が変更される可能性があります。
- 実装ノートを参照してください。
- 実装ノートを参照してください。
- ユーザーが明示的にこの機能を有効にしなければなりません。
- ユーザーが明示的にこの機能を有効にしなければなりません。
- 使用するには、ベンダー接頭辞または異なる名前が必要です。
- 使用するには、ベンダー接頭辞または異なる名前が必要です。
関連情報
ドキュメントのタグと貢献者
タグ:
このページの貢献者:
mfuji09,
SphinxKnight,
fscholz,
Simplexible,
yyss,
Sebastianz,
Prinz_Rana,
ethertank,
sosleepy,
Level,
FredB
最終更新者:
mfuji09,
