translate3d()

Baseline 已广泛支持

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

translate3d() CSS 函数在 3D 空间中重新定位元素。其结果是一个 <transform-function> 数据类型。

试一试

transform: translate3d(0, 0, 0);

transform: translate3d(42px, -62px, -135px);

transform: translate3d(-2.7rem, 0, 1rem);

transform: translate3d(5ch, 0.4in, 5em);

<section class="default-example" id="default-example">
  <div class="transition-all" id="example-element">
    <div class="face front">1</div>
    <div class="face back">2</div>
    <div class="face right">3</div>
    <div class="face left">4</div>
    <div class="face top">5</div>
    <div class="face bottom">6</div>
  </div>
</section>

#default-example {
  background: linear-gradient(skyblue, khaki);
  perspective: 800px;
  perspective-origin: 150% 150%;
}

#example-element {
  width: 100px;
  height: 100px;
  perspective: 550px;
  transform-style: preserve-3d;
}

.face {
  display: flex;
  align-items: center;
  justify-content: center;
  width: 100%;
  height: 100%;
  position: absolute;
  backface-visibility: inherit;
  font-size: 60px;
  color: white;
}

.front {
  background: rgb(90 90 90 / 0.7);
  transform: translateZ(50px);
}

.back {
  background: rgb(0 210 0 / 0.7);
  transform: rotateY(180deg) translateZ(50px);
}

.right {
  background: rgb(210 0 0 / 0.7);
  transform: rotateY(90deg) translateZ(50px);
}

.left {
  background: rgb(0 0 210 / 0.7);
  transform: rotateY(-90deg) translateZ(50px);
}

.top {
  background: rgb(210 210 0 / 0.7);
  transform: rotateX(90deg) translateZ(50px);
}

.bottom {
  background: rgb(210 0 210 / 0.7);
  transform: rotateX(-90deg) translateZ(50px);
}

此变换由三维向量 [tx, ty, tz] 表征。其坐标定义了元素在每个方向上移动的量。

语法

css

translate3d(tx, ty, tz)

值

tx: 是 <length> 或 <percentage>，表示平移向量 [tx, ty, tz] 的横坐标（水平，x 分量）。
ty: 是 <length> 或 <percentage>，表示平移向量 [tx, ty, tz] 的纵坐标（垂直，y 分量）。
tz: 是 <length>，表示平移向量的 z 分量。它不能是 <percentage> 值；在这种情况下，包含该转换的属性被认为是无效的 [tx, ty, tz]。

笛卡尔坐标，在 ℝ^2 上	齐次坐标，在 ℝℙ^2 上	笛卡尔坐标，在 ℝ^3 上	齐次坐标，在 ℝℙ^3 上
此变换适用于 3D 空间，无法在平面上表示。		平移不是 ℝ^3 中的线性变换，不能用笛卡尔坐标矩阵表示。	$\left( \begin{array}{cccc} 1 & 0 & 0 & tx \\ 0 & 1 & 0 & ty \\ 0 & 0 & 1 & tz \\ 0 & 0 & 0 & 1 \end{array} \right)$

正式语法

<translate3d()> = 
  translate3d( <length-percentage> , <length-percentage> , <length> )  

<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 {
  /* Equivalent to perspective(500px) translateX(10px) */
  transform: perspective(500px) translate3d(10px, 0, 0px);
  background-color: pink;
}

结果

结合 z 轴和 x 轴平移

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: perspective(500px) translate3d(10px, 0, 100px);
  background-color: pink;
}

结果

规范

规范
CSS 变换模块级别 2 # funcdef-translate3d

浏览器兼容性

另见

帮助改进 MDN

了解如何贡献

此页面最后由 MDN 贡献者于 2025 年 10 月 10 日修改。

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