--- title: translate() slug: Web/CSS/transform-function/translate() tags: - CSS - CSS Function - CSS Transforms - Function - Reference translation_of: Web/CSS/transform-function/translate() ---
{{CSSRef}}

translate() は CSS の関数は、要素を水平方向や垂直方向で再配置します。結果は {{cssxref("<transform-function>")}} データ型になります。

この変換は、二次元ベクトルであることが特徴です。それぞれの方向にどれだけ要素が動くかの座標を定義します。

構文

/* 単一の <length-percentage> 値 */
transform: translate(200px);
transform: translate(50%);

/* 二つの <length-percentage> 値 */
transform: translate(100px, 200px);
transform: translate(100px, 50%);
transform: translate(30%, 200px);
transform: translate(30%, 50%);

値

単一の <length-percentage> values
この値は {{cssxref("<length>")}} または {{cssxref("<percentage>")}} で、変換ベクトルの横軸 (水平方向、X 座標) を表します。変換ベクトルの縦軸 (垂直方向、Y 座標) は 0 に設定されます。例えば、 translate(2) は translate(2, 0) と等価です。パーセント値の場合は、 {{cssxref("transform-box")}} で定義される参照ボックスの幅からの相対値です。
二つの <length-percentage> 値
この値は2つの {{cssxref("<length>")}} または {{cssxref("<percentage>")}} 値で、変換ベクトルの横軸 (水平方向、X 座標) と縦軸 (垂直方向、Y 座標) を表します。1つ目にパーセント値が使用された場合は、 {{cssxref("transform-box")}} で定義された参照ボックスの幅からの相対値で、2つ目にパーセント値が使用された場合は、高さからの相対値です。
ℝ2 のデカルト座標 ℝℙ2 の同次座標 ℝ3 のデカルト座標 ℝℙ3 の同次座標

ℝ2 では線形変換ではないので、デカルト座標の行列で表すことはできない。

 10tx01ty001 10tx01ty001 100tx010ty00100001
[1 0 0 1 tx ty]

形式文法

translate({{cssxref("<length-percentage>")}} , {{cssxref("<length-percentage>")}}?)

例

単一軸を使用した変形

HTML

<div>Static</div>
<div class="moved">Moved</div>
<div>Static</div>

CSS

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

.moved {
  transform: translate(10px); /* translateX(10px) または translate(10px, 0) と同じ */
  background-color: pink;
}

結果

{{EmbedLiveSample("Using_a_single-axis_translation", 250, 250)}}

Y 軸と X 軸の変換の組み合わせ

HTML

<div>Static</div>
<div class="moved">Moved</div>
<div>Static</div>

CSS

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

.moved {
  transform: translate(10px, 10px);
  background-color: pink;
}

結果

{{EmbedLiveSample("Combining_y-axis_and_x-axis_translation", 250, 250)}}

仕様書

仕様書 状態 備考
{{SpecName('CSS3 Transforms', '#funcdef-transform-translate', 'translate()')}} {{Spec2('CSS3 Transforms')}} 初回定義

ブラウザーの互換性

<transform-function> データ型の互換性情報をご覧ください。

関連情報