translateX()

基线广泛可用

自 2015年7月起，此特性已在主流浏览器中得到支持，可在大多数设备和浏览器版本中正常使用。

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

尝试一下

transform: translateX(0);

transform: translateX(42px);

transform: translateX(-2.1rem);

transform: translateX(3ch);

<section id="default-example">
  <img
    class="transition-all"
    id="static-element"
    src="/shared-assets/images/examples/firefox-logo.svg"
    width="200" />
  <img
    class="transition-all"
    id="example-element"
    src="/shared-assets/images/examples/firefox-logo.svg"
    width="200" />
</section>

#static-element {
  opacity: 0.4;
  position: absolute;
}

#example-element {
  position: absolute;
}

备注：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;
}

结果

规范

规范
CSS Transforms Module Level 1 # funcdef-transform-translatex

浏览器兼容性

参见

帮助改进 MDN

了解如何参与贡献

此页面最后更新于 2025年11月10日，由 MDN 贡献者更新。

在 GitHub 上查看此页面 • 报告此内容的问题