translateX()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨2015年7月⁩.

translateX() 函数表示在二维平面上水平方向移动元素。其结果的数据类型是<transform-function>。

备注： translateX(tx)等同于 translate(tx, 0) 或者 translate3d(tx, 0, 0)。

语法

css

translateX(t)

参数

t: 代表了向量平移的横坐标长度<length>。

ℝ²空间中的笛卡尔坐标在ℝℙ²上的投影坐标在ℝ³上的笛卡尔坐标在ℝℙ³上的投影坐标

ℝ²空间中的笛卡尔坐标	在ℝℙ²上的投影坐标	在ℝ³上的笛卡尔坐标	在ℝℙ³上的投影坐标
在ℝ²空间中的平移并非线性变化，因此不能表示为笛卡尔坐标矩阵。	$(\begin{matrix} 1 & 0 & t \end{matrix})$ $(\begin{matrix} 0 & 1 & 0 \end{matrix})$ $(\begin{matrix} 0 & 0 & 1 \end{matrix})$	$(\begin{matrix} 1 & 0 & t \end{matrix})$ $(\begin{matrix} 0 & 1 & 0 \end{matrix})$ $(\begin{matrix} 0 & 0 & 1 \end{matrix})$	$(\begin{matrix} 1 & 0 & 0 & t \end{matrix})$ $(\begin{matrix} 0 & 1 & 0 & 0 \end{matrix})$ $(\begin{matrix} 0 & 0 & 1 & 0 \end{matrix})$ $(\begin{matrix} 0 & 0 & 0 & 1 \end{matrix})$
`[1 0 0 1 t 0]`

在ℝ²空间中的平移并非线性变化，因此不能表示为笛卡尔坐标矩阵。

$(\begin{matrix} 1 & 0 & t \end{matrix})$

$(\begin{matrix} 0 & 1 & 0 \end{matrix})$

$(\begin{matrix} 0 & 0 & 1 \end{matrix})$

$(\begin{matrix} 1 & 0 & t \end{matrix})$

$(\begin{matrix} 0 & 1 & 0 \end{matrix})$

$(\begin{matrix} 0 & 0 & 1 \end{matrix})$

$(\begin{matrix} 1 & 0 & 0 & t \end{matrix})$

$(\begin{matrix} 0 & 1 & 0 & 0 \end{matrix})$

$(\begin{matrix} 0 & 0 & 1 & 0 \end{matrix})$

$(\begin{matrix} 0 & 0 & 0 & 1 \end{matrix})$

[1 0 0 1 t 0]

示例

HTML

html

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

CSS

css

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

.moved {
  transform: translateX(10px); /* 等同于 translate(10px) */
  background-color: pink;
}

结果

规范

Specification
CSS Transforms Module Level 1 # funcdef-transform-translatex

浏览器兼容性

参见

Help improve MDN

Learn how to contribute

This page was last modified on ⁨2025年7月15日⁩ by MDN contributors.

View this page on GitHub • Report a problem with this content