「及時」模式:全新世代的 Tailwind CSS
Tailwind CSS on GitHub

Translate

Utilities for translating elements with transform.

Default class reference

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

Usage

Translate an element by first enabling transforms with the transform utility, then specifying the translate direction and distance using the translate-x-{amount} and translate-y-{amount} utilities.

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

Responsive

To control the translation of an element at a specific breakpoint, add a {screen}: prefix to any existing translate utility. For example, use md:translate-x-8 to apply the translate-x-8 utility at only medium screen sizes and above.

<img class="transform translate-x-2 md:translate-x-8 ...">

For more information about Tailwind’s responsive design features, check out the Responsive Design documentation.

Customizing

Translate scale

By default, Tailwind provides fixed value translate utilities that match our spacing scale, as well as 50% and 100% variations for translating relative to the element’s size.

You can customize the global spacing scale in the theme.spacing or theme.extend.spacing sections of your tailwind.config.js file:

  // tailwind.config.js
  module.exports = {
    theme: {
      extend: {
        spacing: {
+         '72': '18rem',
+         '84': '21rem',
+         '96': '24rem',
        }
      }
    }
  }

To customize the translate scale separately, use the theme.translate section of your tailwind.config.js file.

  // tailwind.config.js
  module.exports = {
    theme: {
      extend: {
        translate: {
+         '1/7': '14.2857143%',
+         '2/7': '28.5714286%',
+         '3/7': '42.8571429%',
+         '4/7': '57.1428571%',
+         '5/7': '71.4285714%',
+         '6/7': '85.7142857%',
        }
      }
    }
  }

Learn more about customizing the default theme in the theme customization documentation.

Variants

默認情況下, 只有 響應式、hover 和 focus 的 translate 變化模式 (variants) 會產生。

tailwind.config.jsvariants 區塊中變更 translate 屬性來決定有哪些變化模式會生成。

舉個例子來說,這個設定將會生成 響應式 和 active 的變化模式。

  // tailwind.config.js
  module.exports = {
    variants: {
      extend: {
        // ...
+       translate: ['responsive', 'active'],
      }
    }
  }

Disabling

如果你不打算在專案中使用 translate 功能,可以在你的設定檔裡的 corePlugins 屬性中將 translate 設定為 false 來停用功能:

  // tailwind.config.js
  module.exports = {
    corePlugins: {
      // ...
+     translate: false,
    }
  }