1. 变换
  2. 平移

Quick reference

Class
Properties
translate-x-0transform: translateX(0px);
translate-y-0transform: translateY(0px);
translate-x-pxtransform: translateX(1px);
translate-y-pxtransform: translateY(1px);
translate-x-0.5transform: translateX(0.125rem);
translate-y-0.5transform: translateY(0.125rem);
translate-x-1transform: translateX(0.25rem);
translate-y-1transform: translateY(0.25rem);
translate-x-1.5transform: translateX(0.375rem);
translate-y-1.5transform: translateY(0.375rem);
translate-x-2transform: translateX(0.5rem);
translate-y-2transform: translateY(0.5rem);
translate-x-2.5transform: translateX(0.625rem);
translate-y-2.5transform: translateY(0.625rem);
translate-x-3transform: translateX(0.75rem);
translate-y-3transform: translateY(0.75rem);
translate-x-3.5transform: translateX(0.875rem);
translate-y-3.5transform: translateY(0.875rem);
translate-x-4transform: translateX(1rem);
translate-y-4transform: translateY(1rem);
translate-x-5transform: translateX(1.25rem);
translate-y-5transform: translateY(1.25rem);
translate-x-6transform: translateX(1.5rem);
translate-y-6transform: translateY(1.5rem);
translate-x-7transform: translateX(1.75rem);
translate-y-7transform: translateY(1.75rem);
translate-x-8transform: translateX(2rem);
translate-y-8transform: translateY(2rem);
translate-x-9transform: translateX(2.25rem);
translate-y-9transform: translateY(2.25rem);
translate-x-10transform: translateX(2.5rem);
translate-y-10transform: translateY(2.5rem);
translate-x-11transform: translateX(2.75rem);
translate-y-11transform: translateY(2.75rem);
translate-x-12transform: translateX(3rem);
translate-y-12transform: translateY(3rem);
translate-x-14transform: translateX(3.5rem);
translate-y-14transform: translateY(3.5rem);
translate-x-16transform: translateX(4rem);
translate-y-16transform: translateY(4rem);
translate-x-20transform: translateX(5rem);
translate-y-20transform: translateY(5rem);
translate-x-24transform: translateX(6rem);
translate-y-24transform: translateY(6rem);
translate-x-28transform: translateX(7rem);
translate-y-28transform: translateY(7rem);
translate-x-32transform: translateX(8rem);
translate-y-32transform: translateY(8rem);
translate-x-36transform: translateX(9rem);
translate-y-36transform: translateY(9rem);
translate-x-40transform: translateX(10rem);
translate-y-40transform: translateY(10rem);
translate-x-44transform: translateX(11rem);
translate-y-44transform: translateY(11rem);
translate-x-48transform: translateX(12rem);
translate-y-48transform: translateY(12rem);
translate-x-52transform: translateX(13rem);
translate-y-52transform: translateY(13rem);
translate-x-56transform: translateX(14rem);
translate-y-56transform: translateY(14rem);
translate-x-60transform: translateX(15rem);
translate-y-60transform: translateY(15rem);
translate-x-64transform: translateX(16rem);
translate-y-64transform: translateY(16rem);
translate-x-72transform: translateX(18rem);
translate-y-72transform: translateY(18rem);
translate-x-80transform: translateX(20rem);
translate-y-80transform: translateY(20rem);
translate-x-96transform: translateX(24rem);
translate-y-96transform: translateY(24rem);
translate-x-1/2transform: translateX(50%);
translate-x-1/3transform: translateX(33.333333%);
translate-x-2/3transform: translateX(66.666667%);
translate-x-1/4transform: translateX(25%);
translate-x-2/4transform: translateX(50%);
translate-x-3/4transform: translateX(75%);
translate-x-fulltransform: translateX(100%);
translate-y-1/2transform: translateY(50%);
translate-y-1/3transform: translateY(33.333333%);
translate-y-2/3transform: translateY(66.666667%);
translate-y-1/4transform: translateY(25%);
translate-y-2/4transform: translateY(50%);
translate-y-3/4transform: translateY(75%);
translate-y-fulltransform: translateY(100%);

基础用法

平移元素

使用 translate-x-*translate-y-* 实用程序来平移元素。

translate-y-6

-translate-y-6

translate-x-6

<img class="translate-y-6 ...">
<img class="-translate-y-6 ...">
<img class="translate-x-6 ...">

使用负值

要使用负的平移值,请在类名前加上破折号以将其转换为负值。

<img class="-translate-y-6 ...">

删除变换

To remove all of the transforms on an element at once, use the transform-none utility:

<div class="scale-75 translate-x-4 skew-y-3 md:transform-none">
  <!-- ... -->
</div>

This can be useful when you want to remove transforms conditionally, such as on hover or at a particular breakpoint.

硬件加速

If your transition performs better when rendered by the GPU instead of the CPU, you can force hardware acceleration by adding the transform-gpu utility:

<div class="translate-y-6 transform-gpu">
  <!-- ... -->
</div>

Use transform-cpu to force things back to the CPU if you need to undo this conditionally.


条件应用

悬停、聚焦和其他状态

Tailwind 允许您使用变体修饰符有条件地在不同状态下应用实用程序类。例如,使用 hover:translate-y-12 来仅 在 hover应用 translate-y-12.

<div class="hover:translate-y-12">
  <!-- ... -->
</div>

详细了解, 请参考 Hover, Focus, & Other States 文档.

断点和媒体查询

您还可以使用变体修饰符来定位媒体查询,例如响应式断点、暗模式、首选减少运动等。例如, 使用 md:translate-y-12 来应用 translate-y-12 程序,适用于中等屏幕尺寸及以上。

<div class="md:translate-y-12">
  <!-- ... -->
</div>

进一步了解,请参考 响应式设计, 暗黑模式 媒体查询.


使用自定义值

定制你的主题

默认情况下,Tailwind 提供与 default spacing scale 匹配的固定值 translate 实用程序,以及相对于元素大小的 50% 和 100% 变化。您可以通过在 tailwind.config.js 文件中编辑 theme.spacingtheme.extend.spacing 来自定义间距比例。

tailwind.config.js
module.exports = {
  theme: {
    extend: {
      spacing: {
        '4.25': '17rem',
      }
    }
  }
}

或者,您可以通过编辑 tailwind.config.js 文件中的 theme.translatetheme.extend.translate 来仅自定义平移比例。

tailwind.config.js
module.exports = {
  theme: {
    extend: {
      translate: {
        '4.25': '17rem',
      }
    }
  }
}

theme customization 文档中了解有关自定义默认主题的更多信息。

任意值

如果您需要使用一次性的 translate值,而该值没有必要包含在主题中,请使用方括号动态生成属性,使用任意值。

<div class="translate-y-[17rem]">
  <!-- ... -->
</div>

进一步了解,请参考 任意值 文档.