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%);

Basic usage

엘리먼트 이동하기

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

음수 값 사용하기

음수 translate 값을 사용하려면 클래스 이름 앞에 대시(-)를 붙여 음수 값으로 변환합니다.

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

변환 제거하기

엘리먼트에 적용된 모든 변환(transform)을 한 번에 제거하려면 transform-none 유틸리티를 사용하세요:

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

이 기능은 호버(hover) 상태나 특정 브레이크포인트에서 조건부로 변환을 제거하고 싶을 때 유용합니다.

하드웨어 가속

CPU 대신 GPU에서 렌더링할 때 트랜지션 성능이 더 좋다면, transform-gpu 유틸리티를 추가하여 하드웨어 가속을 강제할 수 있습니다:

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

이 설정을 조건적으로 되돌려야 한다면 transform-cpu를 사용하여 CPU로 강제로 돌릴 수 있습니다.


Applying conditionally

호버, 포커스 및 기타 상태

Tailwind는 상태에 따라 유틸리티 클래스를 조건부로 적용할 수 있게 해줍니다. 예를 들어, hover:translate-y-12 를 사용하면 translate-y-12 유틸리티를 hover 상태에서만 적용할 수 있습니다.

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

사용 가능한 모든 상태 수정자 목록은 호버, 포커스, & 기타 상태 문서를 참고하세요.

브레이크포인트와 미디어 쿼리

여러분은 반응형 브레이크포인트, 다크 모드, prefers-reduced-motion 등과 같은 미디어 쿼리를 타겟팅하기 위해 변형 수식어를 사용할 수 있습니다. 예를 들어, md:translate-y-12를 사용하면 중간 화면 크기 이상에서만 translate-y-12 유틸리티를 적용할 수 있습니다.

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

더 자세히 알아보려면 반응형 디자인, 다크 모드, 그리고 다른 미디어 쿼리 수식어에 대한 문서를 확인하세요.


Using custom values

테마 커스터마이징

기본적으로 Tailwind는 기본 간격 스케일과 일치하는 고정 값 translate 유틸리티를 제공하며, 엘리먼트 크기에 상대적인 50% 및 100% 변형도 제공합니다. tailwind.config.js 파일에서 theme.spacing 또는 theme.extend.spacing을 수정하여 간격 스케일을 커스터마이징할 수 있습니다.

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

또는 tailwind.config.js 파일에서 theme.translate 또는 theme.extend.translate를 수정하여 translate 스케일만 커스터마이징할 수도 있습니다.

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

기본 테마 커스터마이징에 대해 더 알아보려면 테마 커스터마이징 문서를 참고하세요.

임의 값

테마에 포함시키기 어려운 translate 값을 일회성으로 사용해야 한다면, 대괄호를 사용해 임의의 값으로 속성을 즉석에서 생성할 수 있습니다.

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

임의 값 지원에 대해 더 알아보려면 임의 값 문서를 참고하세요.