大网数据广告活动
Web 标准与前端开发

translate()

· 52CE 我爱测

**`translate()`** 这个 CSS 函数在水平和/或垂直方向上重新定位元素。其结果是 <transform-function> 类型。

translate() 这个 CSS 函数在水平和/或垂直方向上重新定位元素。其结果是 <transform-function> 类型。

CSS Demo: translate()

transform: translate(0);
transform: translate(42px, 18px);
transform: translate(-2.1rem, -2ex);
transform: translate(3ch, 3mm);
<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;
}

该变换由二维向量构成。它的坐标定义了元素在每个方向上移动了多少。

语法

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

/* Double <length-percentage> values */
transform: translate(100px, 200px);
transform: translate(100px, 50%);
transform: translate(30%, 200px);
transform: translate(30%, 50%);

值

  • 单个 <length-percentage> 作为参数
    • : 该值是 <length> 或者 <percentage> 代表翻译向量的横坐标 (horizontal, x-coordinate) . 而向量的纵坐标 (vertical, y-coordinate) 会被默认为 0. 例如,translate(2) 等价于 translate(2, 0) 。里面还可以填百分比值,百分比值是指 transform-box 属性定义的参考框的宽度。
  • 参数是两个 <length-percentage> 构成
    • : 此值描述两个 <length> 或 <percentage> 值,分别代表翻译的横坐标 (x-coordinate) 和纵坐标 (y-coordinate) 向量。百分比作为第一个值表示宽度,第二个部分表示由 transform-box 属性定义的参考框的高度。

<table class="standard-table"> <thead> <tr> <th scope="col">Cartesian coordinates on ℝ<sup>2</sup></th> <th scope="col">Homogeneous coordinates on ℝℙ<sup>2</sup></th> <th scope="col">Cartesian coordinates on ℝ<sup>3</sup></th> <th scope="col">Homogeneous coordinates on ℝℙ<sup>3</sup></th> </tr> </thead> <tbody> <tr> <td colspan="1" rowspan="2"> <p>平移不是 ℝ<sup>2</sup> 中的线性变换,因此不能使用矩阵来表示。</p> </td> <td> <math ><mfenced ><mtable ><mtr>1<mtd>0</mtd><mtd>tx</mtd></mtr ><mtr>0<mtd>1</mtd><mtd>ty</mtd></mtr ><mtr><mtd>0</mtd><mtd>0</mtd><mtd>1</mtd></mtr></mtable ></mfenced ></math > </td> <td colspan="1" rowspan="2"> <math ><mfenced ><mtable ><mtr>1<mtd>0</mtd><mtd>tx</mtd></mtr ><mtr>0<mtd>1</mtd><mtd>ty</mtd></mtr ><mtr><mtd>0</mtd><mtd>0</mtd><mtd>1</mtd></mtr></mtable ></mfenced ></math > </td> <td colspan="1" rowspan="2"> <math ><mfenced ><mtable ><mtr>1<mtd>0</mtd><mtd>0</mtd><mtd>tx</mtd></mtr ><mtr>0<mtd>1</mtd><mtd>0</mtd><mtd>ty</mtd></mtr ><mtr><mtd>0</mtd><mtd>0</mtd><mtd>1</mtd><mtd>0</mtd></mtr ><mtr ><mtd>0</mtd><mtd>0</mtd><mtd>0</mtd><mtd>1</mtd></mtr ></mtable ></mfenced ></math > </td> </tr> <tr> <td><code>[1 0 0 1 tx ty]</code></td> </tr> </tbody> </table>

形式语法

translate(&lt;length-percentage&gt;, &lt;length-percentage&gt;?)

示例

使用单个轴平移

HTML

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

CSS

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

.moved {
  transform: translate(
    10px
  ); /* Equal to: translateX(10px) or translate(10px, 0) */
  background-color: pink;
}

结果

使用单个轴平移

y 轴和 x 轴都平移

HTML

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

CSS

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

.moved {
  transform: translate(10px, 10px);
  background-color: pink;
}

结果

y 轴和 x 轴都平移

规范

浏览器兼容性

参见

  • transform
  • <transform-function>

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。