translate3d() CSS function repositions an element in 3D space. Its result is a <transform-function> data type.

The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.

This transformation is characterized by a three-dimensional vector. Its coordinates define how much the element moves in each direction.

句法

translate3d(tx, ty, tz)
					

tx
<length> or <percentage> representing the abscissa of the translating vector.
ty
<length> or <percentage> representing the ordinate of the translating vector.
tz
<length> representing the z component of the translating vector. It can't be a <percentage> value; in that case the property containing the transform is considered invalid.
Cartesian coordinates on ℝ 2 Homogeneous coordinates on ℝℙ 2 Cartesian coordinates on ℝ 3 Homogeneous coordinates on ℝℙ 3

This transformation applies to the 3D space and can't be represented on the plane.

A translation is not a linear transformation in ℝ 3 and can't be represented using a Cartesian-coordinate matrix. 1 0 0 tx 0 1 0 ty 0 0 1 tz 0 0 0 1

范例

Using a single axis translation

HTML

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

CSS

div {
  width: 60px;
  height: 60px;
  background-color: skyblue;
}
.moved {
  /* Equivalent to perspective(500px) translateX(10px) */
  transform: perspective(500px) translate3d(10px, 0, 0px);
  background-color: pink;
}
					

结果

Combining z-axis and x-axis translation

HTML

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

CSS

div {
  width: 60px;
  height: 60px;
  background-color: skyblue;
}
.moved {
  transform: perspective(500px) translate3d(10px, 0, 100px);
  background-color: pink;
}
					

结果

规范

规范 状态 注释
CSS Transforms Level 2
The definition of 'translate3d()' in that specification.
编者草案 初始定义

浏览器兼容性

Please see the <transform-function> data type for compatibility info.

另请参阅

元数据

  • 最后修改:
  1. CSS
  2. CSS 参考