Transforms

translate

用於平移元素的通用類別。

ClassStyles
translate-<number>
translate: calc(var(--spacing) * <number>) calc(var(--spacing) * <number>);
-translate-<number>
translate: calc(var(--spacing) * -<number>) calc(var(--spacing) * -<number>);
translate-<fraction>
translate: calc(<fraction> * 100%) calc(<fraction> * 100%);
-translate-<fraction>
translate: calc(<fraction> * -100%) calc(<fraction> * -100%);
translate-full
translate: 100% 100%;
-translate-full
translate: -100% -100%;
translate-px
translate: 1px 1px;
-translate-px
translate: -1px -1px;
translate-(<custom-property>)
translate: var(<custom-property>) var(<custom-property>);
translate-[<value>]
translate: <value> <value>;

範例(Examples)

使用間距比例(Using the spacing scale)

使用 translate-2-translate-4translate-<number> 通用類別來根據間距比例在兩軸上平移元素:

-translate-6

translate-2

translate-8

<img class="-translate-6 ..." src="/img/mountains.jpg" /><img class="translate-2 ..." src="/img/mountains.jpg" /><img class="translate-8 ..." src="/img/mountains.jpg" />

使用百分比(Using a percentage)

使用 translate-1/4-translate-fulltranslate-<fraction> 通用類別來按元素大小的百分比在兩軸上平移元素:

-translate-1/4

translate-1/6

translate-1/2

<img class="-translate-1/4 ..." src="/img/mountains.jpg" /><img class="translate-1/6 ..." src="/img/mountains.jpg" /><img class="translate-1/2 ..." src="/img/mountains.jpg" />

沿 X 軸平移(Translating on the x-axis)

使用 translate-x-4translate-x-1/4translate-x-<number>translate-x-<fraction> 通用類別來沿 X 軸平移元素:

-translate-x-4

translate-x-2

translate-x-1/2

<img class="-translate-x-4 ..." src="/img/mountains.jpg" /><img class="translate-x-2 ..." src="/img/mountains.jpg" /><img class="translate-x-1/2 ..." src="/img/mountains.jpg" />

沿 Y 軸平移(Translating on the y-axis)

使用 translate-y-6translate-y-1/3translate-y-<number>translate-y-<fraction> 通用類別來沿 Y 軸平移元素:

-translate-y-4

translate-y-2

translate-y-1/2

<img class="-translate-y-4 ..." src="/img/mountains.jpg" /><img class="translate-y-2 ..." src="/img/mountains.jpg" /><img class="translate-y-1/2 ..." src="/img/mountains.jpg" />

沿 Z 軸平移(Translating on the z-axis)

使用 translate-z-6-translate-z-12translate-z-<number> 通用類別來沿 Z 軸平移元素:

-translate-z-8

translate-z-4

translate-z-12

<div class="transform-3d">  <img class="-translate-z-8 rotate-x-50 rotate-z-45 ..." src="/img/mountains.jpg" />  <img class="translate-z-2 rotate-x-50 rotate-z-45 ..." src="/img/mountains.jpg" />  <img class="translate-z-1/2 rotate-x-50 rotate-z-45 ..." src="/img/mountains.jpg" /></div>

請注意,translate-z-<number> 通用類別需要在父元素上套用 transform-3d 通用類別。

使用自訂值(Using a custom value)

使用 translate-[<value>] 語法,根據完全自訂的值來設定 translation

<img class="translate-[3.142rad] ..." src="/img/mountains.jpg" />

對於 CSS 變數,你也可以使用 translate-(<custom-property>) 語法:

<img class="translate-(--my-translate) ..." src="/img/mountains.jpg" />

這只是 translate-[var(<custom-property>)] 的簡寫形式,會自動為你加上 var() 函式。

響應式設計(Responsive design)

translate 通用類別前面加上像 md: 這樣的中斷點變體,讓該通用類別只在中型螢幕尺寸及以上時套用:

<img class="translate-45 md:translate-60 ..." src="/img/mountains.jpg" />

變體文件中了解更多關於使用變體的資訊。

Copyright © 2026 Tailwind Labs Inc.·商標政策(Brand)