translateY()

Baseline 已广泛支持

此特性已相当成熟，可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来，各浏览器均已提供此特性。

translateY() CSS 函数在二维平面上垂直重新定位元素。它的结果是 <transform-function> 数据类型。

试一试

transform: translateY(0);

transform: translateY(42px);

transform: translateY(-2.1rem);

transform: translateY(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;
}

注意： translateY(ty) 等同于 translate(0, ty) 或 translate3d(0, ty, 0)。

语法

css

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

值

<length-percentage>: 该值是一个 <length> 或 <percentage>，表示平移向量 [0, ty] 的纵坐标（垂直，y 坐标）。在笛卡尔坐标系中，它表示沿 y 轴的位移。百分比值是相对于由 transform-box 属性定义的参考框的高度。

笛卡尔坐标，在 ℝ^2 上	齐次坐标，在 ℝℙ^2 上	笛卡尔坐标，在 ℝ^3 上	齐次坐标，在 ℝℙ^3 上
平移不是 ℝ^2 中的线性变换，无法使用笛卡尔坐标矩阵表示。	$\left( \begin{array}{ccc} 1 & 0 & 0 \\ 0 & 1 & t \\ 0 & 0 & 1 \end{array} \right)$	$\left( \begin{array}{ccc} 1 & 0 & 0 \\ 0 & 1 & t \\ 0 & 0 & 1 \end{array} \right)$	$\left( \begin{array}{cccc} 1 & 0 & 0 & 0 \\ 0 & 1 & 0 & t \\ 0 & 0 & 1 & 0 \\ 0 & 0 & 0 & 1 \end{array} \right)$
平移不是 ℝ^2 中的线性变换，无法使用笛卡尔坐标矩阵表示。	`[1 0 0 1 0 t]`

正式语法

<translateY()> = 
  translateY( <length-percentage> )  

<length-percentage> = 
  <length>      |
  <percentage>

示例

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: translateY(10px);
  background-color: pink;
}

结果

规范

规范
CSS 变换模块级别 1 # funcdef-transform-translatey

浏览器兼容性

另见

帮助改进 MDN

了解如何贡献

本页面最后修改于 ⁨2025 年 10 月 10 日⁩，由 MDN 贡献者修改。

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