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>。

尝试一下

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; }

结果

规范

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

浏览器兼容性

参见

Help improve MDN

Learn how to contribute

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

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