Lzh on GitHub

translate

用于平移元素的工具。

快速参考

类名样式
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-fulltranslate: 100% 100%;
-translate-fulltranslate: -100% -100%;
translate-pxtranslate: 1px 1px;
-translate-pxtranslate: -1px -1px;
translate-(<custom-property>)translate: var(<custom-property>) var(<custom-property>);
translate-[<value>]translate: <value> <value>;
translate-x-<number>translate: calc(var(--spacing) * <number>) var(--tw-translate-y);
-translate-x-<number>translate: calc(var(--spacing) * -<number>) var(--tw-translate-y);
translate-x-<fraction>translate: calc(<fraction> * 100%) var(--tw-translate-y);
-translate-x-<fraction>translate: calc(<fraction> * -100%) var(--tw-translate-y);
translate-x-fulltranslate: 100% var(--tw-translate-y);
-translate-x-fulltranslate: -100% var(--tw-translate-y);
translate-x-pxtranslate: 1px var(--tw-translate-y);
-translate-x-pxtranslate: -1px var(--tw-translate-y);
translate-x-(<custom-property>)translate: var(<custom-property>) var(--tw-translate-y);
translate-x-[<value>]translate: <value> var(--tw-translate-y);
translate-y-<number>translate: var(--tw-translate-x) calc(var(--spacing) * <number>);
-translate-y-<number>translate: var(--tw-translate-x) calc(var(--spacing) * -<number>);
translate-y-<fraction>translate: var(--tw-translate-x) calc(<fraction> * 100%);
-translate-y-<fraction>translate: var(--tw-translate-x) calc(<fraction> * -100%);
translate-y-fulltranslate: var(--tw-translate-x) 100%;
-translate-y-fulltranslate: var(--tw-translate-x) -100%;
translate-y-pxtranslate: var(--tw-translate-x) 1px;
-translate-y-pxtranslate: var(--tw-translate-x) -1px;
translate-y-(<custom-property>)translate: var(--tw-translate-x) var(<custom-property>);
translate-y-[<value>]translate: var(--tw-translate-x) <value>;
translate-z-<number>translate: var(--tw-translate-x) var(--tw-translate-y) calc(var(--spacing) * <number>);
-translate-z-<number>translate: var(--tw-translate-x) var(--tw-translate-y) calc(var(--spacing) * -<number>);
translate-z-pxtranslate: var(--tw-translate-x) var(--tw-translate-y) 1px;
-translate-z-pxtranslate: var(--tw-translate-x) var(--tw-translate-y) -1px;
translate-z-(<custom-property>)translate: var(--tw-translate-x) var(--tw-translate-y) var(<custom-property>);
translate-z-[<value>]translate: var(--tw-translate-x) var(--tw-translate-y) <value>;
translate-nonetranslate: none;

示例

使用间距比例

使用 translate-<number> 工具(如 translate-2-translate-4)可以在两个轴上根据间距比例平移元素:

-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" />

使用百分比

使用 translate-<fraction> 工具(如 translate-1/4-translate-full)可以根据元素大小的百分比在两个轴上平移元素:

-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 轴平移

使用 translate-x-<number>translate-x-<fraction> 工具(如 translate-x-4translate-x-1/4)可以沿 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 轴平移

使用 translate-y-<number>translate-y-<fraction> 工具(如 translate-y-6translate-y-1/3)可以沿 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 轴平移

使用 translate-z-<number> 工具(如 translate-z-6-translate-z-12)可以沿 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 工具。

使用自定义值

使用 translate-[<value>] 语法可以根据完全自定义的值设置平移

<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() 函数。

响应式设计

translate 工具添加断点变体(如 md:)前缀,使其仅在中等及以上屏幕尺寸时应用:

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

变体文档 中了解更多关于使用变体的信息。