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

translate() 这个 CSS 函数在水平和/或垂直方向上重新定位元素。 其结果是 {{cssxref("<transform-function>")}} 类型。

该变换由二维向量构成。 它的坐标定义了元素在每个方向上移动了多少。

语法

/* Single <length-percentage> values */
transform: translate(200px);
transform: translate(50%);

/* Double <length-percentage> values */
transform: translate(100px, 200px);
transform: translate(100px, 50%);
transform: translate(30%, 200px);
transform: translate(30%, 50%);

值

单个 <length-percentage> 作为参数
该值是 {{cssxref("<length>")}} 或者 {{cssxref("<percentage>")}} 代表翻译向量的横坐标  (horizontal, x-coordinate) . 而向量的纵坐标 (vertical, y-coordinate) 会被默认为 0. 例如, translate(2) 等价于 translate(2, 0) 。 里面还可以填百分比值，百分比值是指 {{cssxref("transform-box")}} 属性定义的参考框的宽度。
参数是两个 <length-percentage> 构成
此值描述两个 {{cssxref("<length>")}} 或 {{cssxref("<percentage>")}} 值，分别代表翻译的横坐标  (x-coordinate)  和纵坐标  (y-coordinate)  向量。 百分比作为第一个值表示宽度，第二个部分表示由 {{cssxref("transform-box")}} 属性定义的参考框的高度。
Cartesian coordinates on ℝ2 Homogeneous coordinates on ℝℙ2 Cartesian coordinates on ℝ3 Homogeneous coordinates on ℝℙ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); /* Equal to: translateX(10px) or 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')}} Initial definition

浏览器兼容性

请参阅 <transform-function> 数据类型以获取兼容性信息。

See also