Skip to content

Tailwind CSS 치트시트

빠른 UI 개발을 위한 유틸리티 우선 CSS 프레임워크.

01

시작하기

CDN으로 설치

CDN 스크립트는 Tailwind로 프로토타이핑하는 가장 빠른 방법입니다. 마크업을 스캔해 런타임에 유틸리티를 생성합니다. 운영 환경에서는 사용하지 않는 클래스를 제거하고 작은 CSS 번들을 배포하려면 PostCSS나 CLI 빌드를 권장합니다.

tailwind
<!-- Quick start: drop this in <head> -->
<script src="https://cdn.tailwindcss.com"></script>

<!-- Tailwind scans class names in your HTML and generates styles on the fly -->
<h1 class="text-3xl font-bold text-blue-600">Hello Tailwind</h1>

프로젝트 설정(CLI)

content 배열이 핵심입니다. Tailwind는 그 파일들에서 발견한 클래스만 생성합니다(트리 셰이킹). 경로를 빠뜨리는 것이 '내 클래스가 없다' 버그의 1위 원인입니다. 개발 중에는 --watch를 사용하세요.

tailwind
# Install Tailwind as a project dependency
npm install -D tailwindcss
npx tailwindcss init

# tailwind.config.js — tell Tailwind where your templates live
/** @type {import('tailwindcss').Config} */
module.exports = {
  content: ["./src/**/*.{html,js,jsx,ts,tsx}"],
  theme: { extend: {} },
  plugins: [],
};

# Build CSS
npx tailwindcss -i ./src/input.css -o ./dist/output.css --watch

입력 CSS 지시문

@tailwind 지시문은 Tailwind의 세 레이어를 순서대로 주입합니다: base(리셋), components, utilities. @layer는 사용자 CSS를 올바른 캐스케이드 레이어에 추가합니다. @apply는 유틸리티 스타일을 사용자 정의 규칙에 인라인합니다.

tailwind
/* src/input.css — the three layers Tailwind uses */
@tailwind base;      /* normalize/reset + base element styles */
@tailwind components; /* component classes you register */
@tailwind utilities;  /* the utility classes themselves */

/* Add custom CSS after the directives */
@layer base {
  h1 { @apply text-2xl; }
}

유틸리티 우선 사고 모델

Tailwind의 철학: 의미 있는 클래스 이름을 새로 만들기보다 작은 단일 목적 유틸리티 클래스를 조합해 UI를 만듭니다. CSS를 평탄하게 유지하고 죽은 코드를 피하며 공유 간격/색상 스케일로 디자인을 일관되게 만듭니다.

tailwind
<!-- Instead of naming custom classes, compose utilities -->
<button class="bg-blue-600 hover:bg-blue-700 text-white
               font-medium py-2 px-4 rounded-lg shadow
               transition-colors duration-200">
  Save
</button>

<!-- Equivalent to writing CSS: .btn { background, padding, radius... } -->
<!-- But each utility maps to a single, predictable declaration. -->

설정과 테마 확장

theme.extend는 Tailwind 기본값을 대체하지 않고 추가합니다. theme의 최상위에 키를 정의하면(extend가 아님) 해당 스케일을 완전히 대체합니다. brand-500 같은 사용자 정의 색은 bg-brand-500, text-brand-500, border-brand-500 등을 생성합니다.

tailwind
// tailwind.config.js
module.exports = {
  content: ["./src/**/*.{html,tsx}"],
  theme: {
    extend: {
      colors: {
        brand: { 500: "#06B6D4", 600: "#0891B2" },
      },
      fontFamily: {
        sans: ["Inter", "system-ui", "sans-serif"],
      },
      spacing: { 128: "32rem" },
    },
  },
  plugins: [],
};
02

색상

텍스트, 배경, 테두리 색

색상 유틸리티는 {property}-{color}-{shade} 패턴을 따릅니다. 음영은 50(가장 밝음)에서 950(가장 어두움)까지입니다. 흔한 속성: text-, bg-, border-, ring-, fill-, stroke-, from-/to-/via-(그라디언트).

tailwind
<p class="text-red-500">Red text</p>
<div class="bg-blue-100">Light blue background</div>
<span class="border border-gray-300">Gray border</span>
<button class="bg-emerald-500 hover:bg-emerald-600">Emerald</button>

불투명도 수정자

색상 유틸리티에 /{opacity}를 붙여 알파 채널을 설정합니다. 내부적으로 color-mix나 rgba를 사용하며 text, bg, border, ring 등에 동작합니다. 새 팔레트 항목을 정의하지 않고 색조를 조정하는 가장 깔끔한 방법입니다.

tailwind
<div class="bg-black/50">50% black overlay</div>
<p class="text-blue-600/75">75% opacity blue text</p>
<div class="border-gray-900/10">10% gray border</div>
<button class="bg-indigo-500 hover:bg-indigo-500/90">Slight fade</button>

그라디언트

bg-gradient-to-{direction}에 from-, via-, to- 색상 스톱을 사용하세요. 방향은 t(위), b, l, r, tr, tl, br, bl이 있습니다. 방사형/원뿔형 그라디언트(v3.3+)에는 bg-gradient-radial을 사용하세요(플러그인이나 임의 값 필요).

tailwind
<div class="bg-gradient-to-r from-purple-500 to-pink-500">
  Left to right gradient
</div>

<div class="bg-gradient-to-tr from-yellow-400 via-red-500 to-pink-600">
  Three-stop diagonal gradient
</div>

<div class="bg-gradient-to-b from-sky-400 to-sky-900">Vertical</div>

사용자 정의 및 임의 색상

대괄호의 임의 값을 쓰면 설정을 편집하지 않고 모든 CSS 색을 사용할 수 있어 일회성에 좋습니다. 반복 사용하는 색은 theme.extend.colors에 정의해 불투명도 수정자 지원과 일관된 이름을 얻으세요.

tailwind
<!-- Arbitrary hex/rgb value -->
<div class="bg-[#1da1f2]">Twitter blue</div>
<p class="text-[rgb(255,0,0)]">Red</p>

<!-- Custom color from your theme -->
<button class="bg-brand-600">My brand color</button>

<!-- Current color / transparent -->
<div class="bg-transparent border border-current">Transparent</div>

색상 팔레트 개요

Tailwind 팔레트는 포괄적인 'gray'를 네 가지 중립 계열로 대체합니다: slate(차가운 파랑), gray, zinc, neutral, stone(따뜻함). 프로젝트 전체에 하나를 선택해 중립 색을 일관되게 쓰세요. 각 색에는 11개 음영(50, 100, ..., 950)이 있습니다.

tailwind
<!-- Tailwind ships 22 color families, each 50-950 -->
<!-- slate gray zinc neutral stone red orange amber yellow -->
<!-- lime green emerald teal cyan sky blue indigo violet -->
<!-- purple fuchsia pink rose -->

<p class="text-slate-900">Primary text</p>
<p class="text-slate-500">Secondary text</p>
<p class="text-slate-400">Muted text</p>

<!-- Use slate/zinc/neutral/stone instead of plain gray -->
<!-- They have subtler blue/warm tones than old gray-*. -->
03

타이포그래피

글꼴 크기와 굵기

text-{size}는 rem 기반 스케일로 매핑됩니다(text-base = 1rem). font-{weight}는 100-900을 다룹니다. text-[42px] 같은 임의 값도 동작합니다. leading-*로 덮어쓰지 않으면 줄 높이가 글꼴 크기에 맞춰 자동 스케일됩니다.

tailwind
<p class="text-xs">12px</p>
<p class="text-sm">14px</p>
<p class="text-base">16px (default)</p>
<p class="text-lg">18px</p>
<p class="text-2xl">24px</p>
<p class="text-7xl">72px</p>

<p class="font-thin">100</p>
<p class="font-normal">400</p>
<p class="font-medium">500</p>
<p class="font-semibold">600</p>
<p class="font-bold">700</p>
<p class="font-black">900</p>

줄 높이와 자간

leading-*은 line-height를 설정합니다(숫자는 rem, 이름은 상대값). tracking-*은 letter-spacing을 설정합니다. uppercase + tracking-wider + text-xs를 조합하면 작은 대문자 스타일 라벨과 아이브로우를 만들 수 있습니다. 매우 흔한 Tailwind 관용구입니다.

tailwind
<p class="leading-none">Line height 1</p>
<p class="leading-tight">1.25</p>
<p class="leading-normal">1.5 (default)</p>
<p class="leading-loose">2</p>
<p class="leading-6">1.5rem fixed</p>

<p class="tracking-tight">-0.025em</p>
<p class="tracking-normal">0</p>
<p class="tracking-wide">0.025em</p>
<p class="tracking-widest">0.1em</p>

<!-- Uppercase + tracking for labels -->
<span class="uppercase tracking-wider text-xs font-bold">Label</span>

텍스트 정렬과 장식

text-{left,center,right,justify}는 인라인 콘텐츠를 정렬합니다. underline/line-through/no-underline은 text-decoration을 토글하고 decoration-{1-4}는 두께를, underline-offset-{n}은 위치를 설정합니다. hover:underline 패턴은 내비게이션 링크의 표준입니다.

tailwind
<p class="text-left">Left</p>
<p class="text-center">Center</p>
<p class="text-right">Right</p>
<p class="text-justify">Justified long paragraph...</p>

<a class="underline">Underlined</a>
<a class="line-through">Strikethrough</a>
<a class="no-underline hover:underline">Hover underline</a>

<a class="decoration-2 underline-offset-4">Thicker underline, offset</a>

글꼴 패밀리와 임의 글꼴

기본으로 세 가지 글꼴 스택이 제공됩니다: sans(시스템 UI), serif, mono. theme.extend.fontFamily에 더 추가하세요(예: display, body). 일회성 임의 글꼴에는 font-['Name']을 사용하세요. 실제 웹 글꼴을 CSS/HTML에서 @import하거나 <link>하는 것을 잊지 마세요.

tailwind
<p class="font-sans">Default sans-serif stack</p>
<p class="font-serif">Serif stack</p>
<p class="font-mono">Monospace</p>

<!-- Arbitrary font family -->
<p class="font-['Georgia']">Georgia</p>

<!-- After configuring theme.extend.fontFamily -->
<p class="font-display">Custom display font</p>

텍스트 오버플로와 말줄임

truncate = overflow-hidden text-ellipsis whitespace-nowrap(한 줄 + 말줄임표). line-clamp-{1-6}은 N줄로 제한합니다(-webkit-line-clamp 사용). 자유로운 줄바꿈에는 break-words나 break-all로 긴 단어의 분리를 제어하세요.

tailwind
<!-- Single-line ellipsis -->
<p class="truncate w-64">
  Very long text that will be cut off with an ellipsis at the end...
</p>

<!-- Clip without ellipsis -->
<p class="overflow-clip w-32">Long text clipped</p>

<!-- Multi-line clamp (2 lines) -->
<p class="line-clamp-2">
  Multi-line paragraph that gets clamped after two lines
  with an ellipsis, useful for card previews and previews.
</p>
04

간격

패딩과 마진

간격 유틸리티는 4px 기반 단일 스케일을 씁니다: 1 = 0.25rem = 4px. p*/m*는 모든 방향, px/py는 축 쌍, pt/pr/pb/pl 또는 mt/mr/mb/ml은 방향별입니다. mx-auto는 블록 요소를 수평 중앙 정렬합니다.

tailwind
<!-- p-* = padding, m-* = margin -->
<div class="p-4">16px all sides</div>
<div class="px-4 py-2">16px horizontal, 8px vertical</div>
<div class="pt-2 pr-4 pb-2 pl-4">Per side (top/right/bottom/left)</div>

<div class="m-8">32px margin all sides</div>
<div class="mx-auto">Center a block (auto L/R margin)</div>
<div class="mt-0 mb-4">No top margin, 16px bottom</div>

간격 스케일

하나의 스케일이 패딩, 마진, gap, 너비, 높이 등을 지배합니다. 이 일관성이 Tailwind의 강점입니다. 겹침과 오프셋 당김에는 음수 값(-mt-2)을 사용하세요. 임의 값 p-[13px]는 필요할 때 스케일을 벗어나지만 드물어야 합니다.

tailwind
<!-- The default scale (in px) -->
0 = 0px      1 = 4px     2 = 8px     3 = 12px    4 = 16px
5 = 20px     6 = 24px    8 = 32px    10 = 40px   12 = 48px
16 = 64px    20 = 80px   24 = 96px   32 = 128px  48 = 192px

<!-- Negative margins -->
<div class="-mt-4">Pulls up by 16px</div>
<div class="-ml-2">Pulls left by 8px</div>

<!-- Arbitrary values -->
<div class="p-[13px] mt-[7px]">Custom sizes</div>

자식 사이 간격

space-x-*/space-y-*는 형제 사이에(주변이 아님) 마진을 추가합니다. 세로 스택과 배지 행에 완벽합니다. 참고: space-x는 margin-left를 쓰므로 flex justify와 잘 결합되지 않습니다. flex에는 gap-* 유틸리티를 권장합니다(Flexbox 참고).

tailwind
<div class="space-y-4">
  <div>Item 1</div>
  <div>Item 2</div>
  <div>Item 3</div>
</div>
<!-- Adds 16px margin-top to every child except the first -->

<div class="space-x-2 flex">
  <span>A</span><span>B</span><span>C</span>
</div>
<!-- Adds 8px margin-left to every child except the first -->

너비와 높이

w-*/h-*는 간격 스케일과 분수(1/2, 1/3, 2/3, 1/4...), screen/full, 이름 있는 크기(max-width용 xs..7xl)를 사용합니다. max-w-{size}는 너비를 제한합니다. 읽기 좋은 줄 길이를 위해 페이지 콘텐츠를 max-w-md mx-auto로 감싸세요. w-fit/w-max는 고유 크기입니다.

tailwind
<div class="w-16 h-16">64x64 box</div>
<div class="w-1/2 h-full">50% width, full height</div>
<div class="w-screen h-screen">Full viewport</div>
<div class="w-96">24rem fixed</div>
<div class="max-w-md mx-auto">Capped width, centered</div>
<div class="min-h-screen">At least full viewport tall</div>

<!-- Modern: fit-content, intrinsic sizing -->
<div class="w-fit">Shrinks to content</div>

Flex와 Grid의 gap

gap-*은 flex/grid 자식을 띄우는 현대적 방법이며 이전 space-x/space-y 마진 방식을 대체합니다. 양 축에 gap을 설정하거나 gap-x/gap-y를 개별로 쓰세요. 패딩/마진과 같은 간격 스케일을 사용합니다.

tailwind
<div class="flex gap-4">
  <div>A</div><div>B</div><div>C</div>
</div>
<!-- 16px between flex children, no margin hacks needed -->

<div class="grid grid-cols-3 gap-2 gap-y-4">
  <div>1</div><div>2</div><div>3</div>
  <div>4</div><div>5</div><div>6</div>
</div>
<!-- gap = both axes; gap-x / gap-y for per-axis -->
05

Flexbox

기본 Flex 컨테이너

flex는 display:flex, inline-flex는 display:inline-flex를 설정합니다. flex-col은 주축을 세로로 바꾸며 gap과 결합하면 세로 스택을 만드는 가장 깔끔한 방법입니다. 기본 방향은 row(가로)입니다.

tailwind
<div class="flex">
  <div>A</div><div>B</div><div>C</div>
</div>

<div class="inline-flex gap-2">
  <span>Badge</span><span>Badge</span>
</div>

<!-- Vertical stack = flex-col (often cleaner than space-y) -->
<div class="flex flex-col gap-4">
  <div>Row 1</div>
  <div>Row 2</div>
</div>

Justify와 Align

justify-*는 주축(flex-row에서 가로), items-*는 교차축(flex-row에서 세로)을 제어합니다. 'flex justify-center items-center' 조합은 콘텐츠를 양방향으로 중앙 정렬하는 가장 많이 쓰이는 Tailwind 스니펫입니다.

tailwind
<div class="flex justify-start">   <!-- left   --></div>
<div class="flex justify-center">  <!-- center --></div>
<div class="flex justify-between"> <!-- spread --></div>
<div class="flex justify-around">  <!-- equal space around --></div>
<div class="flex justify-end">     <!-- right  --></div>

<!-- Cross axis (perpendicular to main) -->
<div class="flex items-center">     <!-- vertically center --></div>
<div class="flex items-start">      <!-- top align --></div>
<div class="flex items-end">        <!-- bottom align --></div>
<div class="flex items-stretch">    <!-- fill height --></div>

Flex Grow, Shrink, Basis

flex-1 = flex:1 1 0%(채우도록 성장, 축소 가능, 기준 0). flex-none = 성장/축소 안 함(고정). flex-grow-0 / flex-shrink-0은 성장/축소를 개별로 끕니다. basis-{n}은 성장 전 초기 크기를 설정합니다.

tailwind
<div class="flex">
  <div class="flex-1">Grows to fill</div>
  <div class="flex-none">Never shrinks (fixed)</div>
  <div class="flex-initial">Default size, can shrink</div>
</div>

<div class="flex">
  <div class="flex-grow-0 w-20">Fixed 80px</div>
  <div class="flex-grow basis-0">Takes remaining</div>
</div>

<!-- Responsive: sidebar collapses on mobile -->
<div class="flex flex-col md:flex-row">
  <aside class="md:w-64 md:flex-shrink-0">Sidebar</aside>
  <main class="flex-1">Main</main>
</div>

Flex Wrap과 Order

flex-wrap은 자식이 새 줄로 흐르게 합니다(기본 nowrap은 넘칩니다). order-{n}은 DOM을 바꾸지 않고 시각적 순서를 바꾸며 order-first/last는 단축입니다. 브레이크포인트마다 다른 시각 순서를 원하는 반응형 레이아웃에 유용합니다.

tailwind
<div class="flex flex-wrap gap-4">
  <div class="w-40">Card</div>
  <div class="w-40">Card</div>
  <div class="w-40">Card</div>
  <!-- Cards wrap to next line instead of overflowing -->
</div>

<div class="flex flex-wrap-reverse">Wrap backwards</div>
<div class="flex flex-nowrap">No wrapping (default)</div>

<!-- Reorder children -->
<div class="flex">
  <div class="order-last">First in DOM, last visually</div>
  <div class="order-first">Last in DOM, first visually</div>
  <div class="order-2">Custom order</div>
</div>

중앙 정렬 패턴

flex items-center justify-center는 표준 중앙 정렬 스니펫이며 어떤 콘텐츠 크기에도 동작합니다. 스티키 푸터 패턴(min-h-screen + flex-col + flex-1 main)은 콘텐츠가 적어도 푸터를 아래로 밀어냅니다.

tailwind
<!-- Center anything both axes (classic) -->
<div class="flex items-center justify-center h-screen">
  <div>Dead center</div>
</div>

<!-- Sticky footer pattern -->
<div class="flex flex-col min-h-screen">
  <header>Header</header>
  <main class="flex-1">Content grows</main>
  <footer>Footer</footer>
</div>

<!-- Space between with centered item -->
<div class="flex items-center justify-between">
  <button>Left</button>
  <h1 class="absolute left-1/2 -translate-x-1/2">Centered title</h1>
  <button>Right</button>
</div>
06

Grid

기본 Grid

grid는 display:grid를 설정합니다. grid-cols-{n}은 고정 열 수(1-12)를 정의합니다. auto-rows-fr은 모든 행을 같은 높이(각 1fr)로 만듭니다. gap-*은 flex처럼 트랙 간격을 조정합니다.

tailwind
<div class="grid grid-cols-3 gap-4">
  <div>1</div><div>2</div><div>3</div>
  <div>4</div><div>5</div><div>6</div>
</div>

<!-- Auto rows set the row height -->
<div class="grid grid-cols-2 auto-rows-fr gap-2">
  <div>Equal-height rows</div>
  <div>Equal-height rows</div>
</div>

<!-- Inline grid -->
<span class="inline-grid grid-cols-2 gap-1">...</span>

반응형 열

auto-fit + minmax 패턴은 강력한 반응형 기법입니다. 열이 최소 200px이고 행을 채우도록 늘어나며 자동으로 줄바꿈되므로 미디어 쿼리가 필요 없습니다. 더 세밀한 제어가 필요하면 명시적 반응형 grid-cols-*와 결합하세요.

tailwind
<div class="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4 gap-4">
  <!-- 1 column on mobile, 2 on small, 3 on large, 4 on xl -->
</div>

<!-- Auto-fit / minmax for card grids that wrap naturally -->
<div class="grid grid-cols-[repeat(auto-fit,minmax(200px,1fr))] gap-4">
  <div>Card</div><div>Card</div><div>Card</div>
</div>

열과 행 병합

col-span-{n} / row-span-{n}은 항목이 여러 트랙을 차지하게 합니다. col-start-{n} / col-end-{n}은 명시적 그리드 선에 항목을 배치합니다. 이를 결합하면 미디어 쿼리 없이 복잡한 잡지 스타일 레이아웃을 만들 수 있습니다.

tailwind
<div class="grid grid-cols-3 grid-rows-3 gap-2">
  <div class="col-span-2">Spans 2 cols</div>
  <div>1 col</div>
  <div class="row-span-2">Spans 2 rows</div>
  <div class="col-span-2 row-span-2">Big tile</div>
  <div>1 col</div>
  <div>1 col</div>
</div>

<!-- Explicit placement -->
<div class="col-start-2 col-end-4 row-start-1">
  Placed at column 2-4, row 1
</div>

임의 값으로 grid-template areas

대괄호 임의 값으로 어떤 grid-template 문법이든 지정할 수 있습니다. grid-cols-[200px_1fr_100px]는 사용자 정의 너비 트랙 세 개를 만듭니다(밑줄은 공백이 됨). 명명된 grid-template-areas는 내장 유틸리티가 아니므로 사용자 정의 클래스로 정의하거나 col/row span으로 레이아웃을 구성하세요.

tailwind
<div class="grid grid-cols-[200px_1fr] grid-rows-[auto_1fr_auto] gap-4
            min-h-screen">
  <aside class="row-span-3">Sidebar</aside>
  <header>Header</header>
  <main>Main</main>
  <footer>Footer</footer>
</div>

<!-- Named template areas need custom CSS or plugin: -->
<style>
  .app { grid-template-areas: "h h" "s m" "f f"; }
</style>

Gap과 정렬

justify-items-*/content-*는 항목이 셀 안에서, 트랙이 컨테이너 안에서 놓이는 방식을 제어합니다. place-items-center는 justify-items + items-content(양 축)의 단축입니다. place-content-center는 전체 그리드 블록을 중앙 정렬합니다.

tailwind
<div class="grid grid-cols-3 gap-4 gap-x-8 gap-y-2">
  <!-- 32px col gap, 8px row gap -->
</div>

<!-- Align whole grid tracks -->
<div class="grid grid-cols-2 justify-items-center">
  <div>Each item centered in its cell</div>
</div>

<div class="grid grid-cols-2 content-center h-64">
  <div>Vertically centers the rows</div>
</div>

<div class="grid grid-cols-2 place-items-center">
  <!-- Both axes at once -->
</div>
07

테두리

테두리 두께와 색

border는 모든 방향에 1px를, border-{2,4,8}은 두께를 설정합니다. border-{t,r,b,l,x,y}는 특정 방향을 대상으로 합니다. border-dashed/dotted/double은 스타일을 설정합니다. 항상 border-{color}와 함께 쓰세요. Tailwind의 기본 테두리 색은 gray-200입니다(v3에서 gray-300에서 변경).

tailwind
<div class="border">1px all sides</div>
<div class="border-2">2px</div>
<div class="border-4 border-red-500">4px red</div>

<div class="border-t border-b">Only top & bottom</div>
<div class="border-l-4 border-emerald-500">Left accent bar</div>
<div class="border-x border-gray-300">Left & right</div>

<div class="border border-dashed border-gray-400">Dashed</div>
<div class="border border-dotted">Dotted</div>
<div class="border border-double">Double</div>

테두리 반경

rounded-{none,sm,md,lg,xl,2xl,3xl,full}은 반경을 스케일합니다. rounded-full은 알약이나(너비 = 높이일 때) 완전한 원을 만듭니다. 모서리별: rounded-{tl,tr,bl,br}-{size}, 방향별: rounded-{t,b,l,r}-{size}. 아바타 원은 rounded-full + 같은 w/h를 씁니다.

tailwind
<div class="rounded">0.25rem</div>
<div class="rounded-md">0.375rem</div>
<div class="rounded-lg">0.5rem</div>
<div class="rounded-xl">0.75rem</div>
<div class="rounded-2xl">1rem</div>
<div class="rounded-full">Fully rounded (pill/circle)</div>

<div class="rounded-t-lg rounded-b-none">Top only</div>
<div class="rounded-l-full">Left side pill</div>
<div class="rounded-tr-2xl rounded-bl-2xl">Per-corner</div>

자식 사이 구분선

divide-{x,y}는 형제 사이에 테두리를 추가하므로 각 자식에 border-t를 스타일링하는 것보다 훨씬 깔끔합니다. divide-{color}와 divide-{width}로 사용자 정의하세요. 목록과 표에서 편안한 간격을 위해 자식에 py/px를 함께 쓰세요.

tailwind
<ul class="divide-y divide-gray-200">
  <li class="py-2">Item 1</li>
  <li class="py-2">Item 2</li>
  <li class="py-2">Item 3</li>
</ul>
<!-- Adds a 1px top border to each child except the first -->

<div class="flex divide-x divide-gray-300">
  <div class="px-4">Col 1</div>
  <div class="px-4">Col 2</div>
  <div class="px-4">Col 3</div>
</div>

Ring(외곽선 유사)

Ring은 box-shadow 기반 외곽선이라 테두리와 달리 레이아웃에 영향을 주지 않고 겹침도 깔끔합니다. ring-{n}은 두께, ring-{color}는 색, ring-offset-{n}은 요소와 링 사이 여백을 추가합니다. focus:ring 패턴은 표준 접근성 포커스 스타일입니다.

tailwind
<button class="ring-2 ring-blue-500 ring-offset-2">
  Ring with offset
</button>

<input class="ring-2 ring-red-500 focus:ring-2 focus:ring-blue-500" />

<button class="ring-1 ring-inset ring-gray-300">Inset ring</button>

<!-- Focus ring pattern (accessibility) -->
<button class="focus:outline-none focus:ring-2 focus:ring-blue-500 focus:ring-offset-2">
  Accessible focus
</button>

Outline

outline-*은 실제 CSS outline 속성을 사용합니다(테두리 박스 밖, 레이아웃 영향 없음). Tailwind에서는 레이어드 box-shadow인 ring을 선호합니다. 여러 ring을 쌓을 수 있고 ring-offset이 깔끔한 간격을 주기 때문입니다. CSS outline 동작이 명시적으로 필요할 때 outline을 사용하세요.

tailwind
<input class="outline-none" />  <!-- Remove default -->
<input class="outline outline-2 outline-blue-500" />
<input class="outline-dashed outline-1 outline-gray-400" />

<input class="focus:outline-none focus:ring-2 focus:ring-blue-500"
       type="text" />

<!-- Outline vs ring: outline is drawn outside border-box,
     ring is a box-shadow (can stack, has offset) -->
08

배경

배경색과 고정

bg-{color}는 background-color를 설정하고 /{opacity}는 알파입니다. bg-fixed는 시차 효과를 만듭니다(콘텐츠가 스크롤되는 동안 배경 고정). bg-clip-{padding,border,content}는 배경이 테두리/콘텐츠 아래로 얼마나 확장되는지 제어합니다.

tailwind
<div class="bg-blue-500">Solid color</div>
<div class="bg-blue-500/50">50% opacity</div>
<div class="bg-fixed">Parallax (fixed on scroll)</div>
<div class="bg-local">Scrolls with content</div>
<div class="bg-scroll">Default</div>

<!-- Clip: padding-box, border-box, content-box -->
<div class="bg-clip-padding border-4 border-dashed">Padding clip</div>
<div class="bg-clip-border">Border clip</div>

배경 이미지와 그라디언트

임의 URL 배경 이미지에는 bg-[url('/path/to/img.jpg')]를 사용하세요(URL을 따옴표로 감쌈). bg-cover는 종횡비를 유지하며 요소를 채우고 bg-contain은 이미지 전체를 맞춥니다. bg-{center,top,bottom,left,right}와 bg-{repeat,no-repeat,repeat-x,repeat-y}가 위치와 반복을 제어합니다.

tailwind
<div class="bg-gradient-to-r from-cyan-500 to-blue-500">
  Horizontal gradient
</div>

<!-- Image with arbitrary value -->
<div class="bg-[url('/hero.jpg')] bg-cover bg-center h-64">
  Hero with cover image
</div>

<!-- Repeat & position -->
<div class="bg-repeat-x bg-[url('/pattern.png')]">Repeat horizontally</div>
<div class="bg-no-repeat bg-top">No repeat, top aligned</div>

그라디언트 방향과 스톱

from-/via-/to-는 그라디언트 색상 스톱을, bg-gradient-to-{direction}은 각도를 설정합니다. to-br 같은 대각선 방향은 따뜻한 히어로 그라디언트에 흔합니다. 네이티브 방사형/원뿔형 그라디언트는 플러그인이나 임의 값이 필요합니다: bg-[radial-gradient(...)].

tailwind
<!-- Directions: to-t, to-b, to-l, to-r, to-tr, to-tl, to-br, to-bl -->
<div class="bg-gradient-to-br from-amber-400 to-orange-600">
  Bottom-right diagonal
</div>

<!-- Three-stop gradient -->
<div class="bg-gradient-to-r from-green-400 via-teal-500 to-blue-600">
  Multi-stop
</div>

<!-- Radial (Tailwind v3.3+) -->
<div class="bg-gradient-radial from-pink-400 to-purple-700">
  Radial (may need plugin)
</div>

배경 크기와 위치

히어로 이미지에는 bg-cover, 로고에는 bg-contain이 핵심 선택입니다. cover는 박스를 채우고(넘치는 부분 자름), contain은 전체 이미지를 맞춥니다(빈 공간 생길 수 있음). 표준 반응형 히어로 이미지에는 bg-cover + bg-center를 결합하세요.

tailwind
<div class="bg-cover bg-center h-48 bg-[url('/img.jpg')]">
  Cover: fills container, may crop
</div>

<div class="bg-contain bg-center h-48 bg-no-repeat bg-[url('/logo.png')]">
  Contain: fits entire image, may letterbox
</div>

<div class="bg-top-left bg-[url('/img.jpg')] bg-cover">Top-left anchor</div>
<div class="bg-[center_top]">Custom position</div>

배경 블렌드 모드

bg-blend-{mode}는 여러 배경 레이어(이미지 + 색)가 합성되는 방식을 제어합니다. multiply, screen, overlay, darken, lighten이 흔합니다. 텍스트 가독성을 위해 이미지를 어둡게 할 때는 위에 반투명 그라디언트 오버레이를 얹는 것이 더 깔끔합니다(오른쪽 예제).

tailwind
<div class="bg-blend-multiply bg-[url('/photo.jpg')] bg-blue-500">
  Multiplies image with blue overlay
</div>

<!-- Common overlay pattern: dark gradient over image -->
<div class="relative">
  <img src="/hero.jpg" class="w-full" />
  <div class="absolute inset-0 bg-gradient-to-t from-black/70 to-transparent">
    Overlay
  </div>
</div>
09

그림자

박스 그림자 스케일

그림자 스케일(sm, 기본, md, lg, xl, 2xl)은 앱 전체에 일관된 고도감을 줍니다. shadow-inner는 우물이나 눌린 상태에 유용한 내부 그림자를 만듭니다. 카드는 보통 shadow-md와 hover:shadow-lg로 떠오르는 효과를 냅니다.

tailwind
<div class="shadow-sm">Subtle</div>
<div class="shadow">Default</div>
<div class="shadow-md">Medium</div>
<div class="shadow-lg">Large</div>
<div class="shadow-xl">Extra large</div>
<div class="shadow-2xl">Huge</div>
<div class="shadow-none">No shadow</div>

<!-- Inner shadow -->
<div class="shadow-inner">Pressed-in look</div>

색상 그림자

shadow-{color}는 박스 그림자에 색을 입힙니다(같은 색상 팔레트 사용). /{opacity}와 결합하면 글로우 효과를 만듭니다. 색상 그림자는 버튼과 강조 요소를 더 생동감 있고 브랜드답게 만드는 빠른 방법입니다.

tailwind
<div class="shadow-lg shadow-blue-500/50">
  Blue tinted shadow
</div>

<div class="shadow-xl shadow-cyan-500/30">
  Cyan glow effect
</div>

<div class="shadow-md shadow-black/30">Darker default</div>

<button class="bg-emerald-500 shadow-lg shadow-emerald-500/50">
  Colored button shadow
</button>

호버 리프트 패턴

hover:shadow-{larger}와 transition-shadow의 결합은 표준 카드 호버 패턴입니다. hover:-translate-y-0.5와 active:translate-y-0을 함께 쓰면 버튼에 물리적 눌림 피드백을 줍니다. 작지만 만족스러운 상호작용 다듬기입니다.

tailwind
<div class="bg-white rounded-xl shadow-md hover:shadow-xl
            transition-shadow duration-300 p-6 cursor-pointer">
  Card with hover lift
</div>

<!-- Combined with slight translate for tactile feel -->
<button class="shadow-md hover:shadow-sm active:shadow-sm
               hover:-translate-y-0.5 active:translate-y-0
               transition-all">
  Tactile button
</button>

드롭 섀도(SVG/텍스트용)

drop-shadow는 CSS filter:drop-shadow()를 사용해 요소의 실제 모양을 따릅니다(투명 PNG와 SVG에 좋음). box-shadow는 박스에만 그림자를 줍니다. 텍스트의 drop-shadow-md는 text-shadow보다 부드러운 대안입니다.

tailwind
<h1 class="drop-shadow-md">Text with shadow</h1>

<svg class="drop-shadow-lg">
  <!-- SVG shape gets shadowed as a whole -->
</svg>

<!-- Combine with rotate for dramatic effects -->
<div class="rotate-3 drop-shadow-2xl">Tilted card</div>

<!-- Filter utilities affect the element as a whole image -->
<div class="blur-sm brightness-110">Image filters</div>

임의 및 레이어드 그림자

기본 스케일 밖의 그림자에는 임의 값 문법 shadow-[...]을 사용하세요. 진짜 고급스러운 복잡한 레이어드 그림자는 사용자 정의 CSS 클래스에 한 번 정의하는 것이 더 깔끔합니다. Tailwind의 단일 레이어 그림자로는 다층 깊이를 맞추기 어렵습니다.

tailwind
<div class="shadow-[0_8px_30px_rgb(0,0,0,0.12)]">
  Custom shadow via arbitrary value
</div>

<!-- Multiple layered shadows via custom CSS -->
<style>
  .card-shadow {
    box-shadow:
      0 1px 2px rgba(0,0,0,0.04),
      0 4px 8px rgba(0,0,0,0.06),
      0 12px 24px rgba(0,0,0,0.08);
  }
</style>
<div class="card-shadow">Layered elevation</div>
10

반응형 디자인

브레이크포인트

Tailwind는 모바일 우선입니다. 기본 스타일은 어디서나 적용되고 브레이크포인트 접두사는 min-width에서 적용됩니다. 순서가 중요하므로 가장 작은 것부터 큰 것 순으로 작성하세요(text-sm md:text-base lg:text-lg). 브레이크포인트는 일반적인 기기 너비와 일치하며 설정 가능합니다.

tailwind
<!-- Default = mobile first, then min-width overrides -->
<!-- sm: 640px, md: 768px, lg: 1024px, xl: 1280px, 2xl: 1536px -->

<div class="text-sm md:text-base lg:text-lg">
  Grows with viewport
</div>

<div class="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-4">
  Responsive grid
</div>

<!-- Hide on small screens, show on large -->
<div class="hidden md:block">Desktop only</div>
<div class="block md:hidden">Mobile only</div>

반응형 Flex/Grid

flex-col md:flex-row 패턴은 반응형 레이아웃의 중추입니다. 휴대폰에서는 세로로 쌓고 데스크톱에서는 나란히 배치합니다. 카드 그리드에는 반응형 grid-cols-*와 결합하세요. 항상 모바일 레이아웃을 먼저 디자인한 뒤 위로 확장하세요.

tailwind
<!-- Stack on mobile, row on desktop -->
<div class="flex flex-col md:flex-row gap-4">
  <aside class="md:w-64">Sidebar</aside>
  <main class="flex-1">Main</main>
</div>

<!-- 1 col mobile -> 2 col tablet -> 4 col desktop -->
<div class="grid grid-cols-1 sm:grid-cols-2 xl:grid-cols-4 gap-4">
  <div>Card</div>
</div>

<!-- Sidebar that hides on mobile -->
<aside class="hidden lg:block lg:w-1/4">Sidebar</aside>

컨테이너와 최대 너비

container는 각 브레이크포인트에서 반응형 max-width로 콘텐츠를 중앙 정렬합니다(중앙 정렬과 패딩은 직접 추가해야 함). 수동 패턴 'max-w-7xl mx-auto px-4 sm:px-6 lg:px-8'이 가장 흔한 페이지 래퍼입니다. 글은 읽기 좋은 줄 길이를 위해 max-w-2xl/3xl로 제한하세요.

tailwind
<div class="container mx-auto px-4">
  <!-- Centers content and caps width at each breakpoint -->
</div>

<!-- Or manually cap width -->
<div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8">
  Standard page wrapper
</div>

<article class="prose max-w-none lg:max-w-2xl mx-auto">
  Article with readable line length
</article>

브레이크포인트별 표시/숨김

hidden md:block / block md:hidden은 모바일과 데스크톱 사이에서 요소를 토글하는 표준 패턴입니다(예: 햄버거 메뉴 vs 전체 내비게이션). print:block은 인쇄할 때만 표시합니다. min-[1200px]: 같은 임의 브레이크포인트로 사용자 정의 너비를 대상으로 할 수 있습니다.

tailwind
<!-- Mobile-only nav -->
<nav class="block md:hidden">Mobile menu</nav>

<!-- Desktop-only nav -->
<nav class="hidden md:flex">Desktop menu</nav>

<!-- Hide print-only content -->
<div class="hidden print:block">Only shows when printing</div>

<!-- Custom breakpoint -->
<div class="min-[1200px]:flex">Custom MQ</div>

반응형 타이포그래피와 간격

시각적 계층을 위해 브레이크포인트마다 타이포그래피와 간격을 키우세요. 진정한 유동 타입에는 임의 값으로 clamp()를 사용하세요: text-[clamp(2rem,5vw,4rem)]. 제목이 최소와 최대 사이에서 뷰포트에 따라 부드럽게 커집니다.

tailwind
<h1 class="text-3xl sm:text-4xl md:text-5xl lg:text-6xl
         font-bold leading-tight">
  Fluid-ish heading
</h1>

<section class="px-4 sm:px-6 lg:px-12 py-8 md:py-12 lg:py-20">
  Scales padding with viewport
</section>

<!-- True fluid type with clamp via arbitrary value -->
<h1 class="text-[clamp(2rem,5vw,4rem)]">
  Smoothly scales with viewport
</h1>
11

다크 모드

다크 모드 활성화(class 전략)

기본적으로 Tailwind는 prefers-color-scheme(media)을 사용합니다. darkMode:'class'를 설정하면 부모(보통 <html>)에 'dark' 클래스를 추가해 다크 모드를 토글할 수 있습니다(테마 전환기에 필요). darkMode:'selector'(v3.4+)는 비슷하지만 사용자 정의 선택자를 지원합니다.

tailwind
// tailwind.config.js
module.exports = {
  darkMode: "class",  // default is "media" (prefers-color-scheme)
  // ...
};

<!-- Toggle by adding/removing "dark" on <html> -->
<html class="dark">
  <body class="bg-white dark:bg-gray-900 text-gray-900 dark:text-gray-100">
    Auto-styled in dark
  </body>
</html>

다크 변형

유틸리티 앞에 dark:를 붙이면 다크 모드에서만 적용됩니다. 라이트 스타일을 먼저 쓰고 dark:로 덮어쓰는 패턴입니다. 체계적으로 모든 bg-*, text-*, border-*에 dark:* 대응을 붙여 다크 모드에서 깨져 보이는 것이 없게 하세요.

tailwind
<div class="bg-white dark:bg-gray-800
            text-gray-900 dark:text-gray-100
            border-gray-200 dark:border-gray-700">
  Adapts to theme
</div>

<button class="bg-blue-600 dark:bg-blue-500
               hover:bg-blue-700 dark:hover:bg-blue-600">
  Themed button
</button>

테마 토글 스크립트

페이지 렌더링 전에 이 인라인 스크립트를 <head>에 넣어 잘못된 테마가 잠깐 보이는 현상(FOUC)을 막으세요. 먼저 localStorage를 확인하고 없으면 OS 설정으로 폴백합니다. 토글은 클래스를 뒤집고 선택을 저장합니다.

tailwind
// Check stored preference or system preference on load
if (localStorage.theme === 'dark' ||
    (!('theme' in localStorage) &&
     window.matchMedia('(prefers-color-scheme: dark)').matches)) {
  document.documentElement.classList.add('dark');
} else {
  document.documentElement.classList.remove('dark');
}

// Toggle button handler
function toggleTheme() {
  document.documentElement.classList.toggle('dark');
  localStorage.theme = document.documentElement.classList.contains('dark')
    ? 'dark' : 'light';
}

시스템 설정만 사용

수동 토글이 필요 없으면 darkMode:'media'(기본)가 JavaScript 없이 사용자의 OS 설정을 따릅니다. 더 단순하지만 설정을 덮어쓸 수 없습니다. OS 선택을 존중하는 것으로 충분한 콘텐츠 사이트에 사용하세요.

tailwind
// tailwind.config.js
module.exports = {
  darkMode: "media",  // follow prefers-color-scheme automatically
  // ...
};

<!-- dark: utilities apply when OS is in dark mode -->
<div class="bg-white dark:bg-gray-900">
  No toggle, just follows the OS
</div>

<!-- Force a specific theme by not using dark: at all
     (the dark styles simply never apply) -->

다크 모드 모범 사례

좋은 다크 모드는 단순 색 반전이 아닙니다. 배경에는 순수 검정이 아니라 진한 회색(gray-900)을, 텍스트에는 순수 흰색이 아니라 회백색(gray-100)을 쓰고, 이미지는 약간 어둡게 하며 그림자는 줄이거나 제거하세요. 채도 높은 브랜드 색은 다크 모드에서 밝게 해야 하는 경우가 많습니다(blue-600 -> blue-500).

tailwind
<!-- Don't just invert — lower contrast and saturation -->
<div class="bg-white dark:bg-gray-900     <!-- not black -->
            text-gray-900 dark:text-gray-100 <!-- not pure white -->
            shadow-lg dark:shadow-none">     <!-- shadows look off in dark -->

<!-- Dim images slightly in dark mode -->
<img class="dark:opacity-90 dark:brightness-90" src="/photo.jpg" />

<!-- Reduce border intensity -->
<div class="border-gray-200 dark:border-gray-800">...</div>
12

애니메이션과 전환

전환

transition-{property}는 애니메이션할 속성을, duration-{ms}는 시간을, ease-{in,out,in-out}은 타이밍 함수를 설정합니다. transition-colors가 가장 흔합니다(transition-all보다 저렴). hover:* 변경 전에 항상 transition을 추가하지 않으면 즉시 바뀝니다.

tailwind
<button class="bg-blue-500 hover:bg-blue-600
               transition-colors duration-200">
  Color transition
</button>

<div class="transition-all duration-300 ease-in-out
            hover:scale-105 hover:shadow-lg">
  Multi-property transition
</div>

<div class="transition-opacity duration-500 opacity-50 hover:opacity-100">
  Fade in on hover
</div>

전환 속성

성능을 위해 transition-all보다 구체적 전환(transition-colors, transition-transform)을 선호하세요. all은 모든 속성을 감시해 버벅임을 유발할 수 있습니다. duration-*은 75/100/150/200/300/500/700/1000ms입니다. UI 요소가 나타날 때 ease-out이 자연스럽습니다.

tailwind
<div class="transition-none">No animation</div>
<div class="transition-colors">bg/text/border-color</div>
<div class="transition-opacity">opacity only</div>
<div class="transition-shadow">box-shadow only</div>
<div class="transition-transform">scale/rotate/translate</div>
<div class="transition-all">Everything (heaviest)</div>

<!-- Duration & easing -->
<div class="duration-150">150ms</div>
<div class="duration-700">700ms</div>
<div class="ease-linear">Linear</div>
<div class="ease-in">Accelerate</div>
<div class="ease-out">Decelerate</div>

내장 애니메이션

Tailwind는 네 가지 키프레임 애니메이션을 제공합니다: spin(로더), ping(확장하는 알림 점), pulse(불투명도 페이드, 스켈레톤 로더에 완벽), bounce(경쾌함). 사용자 정의 애니메이션은 설정에 키프레임을 정의하고 animate-[name]으로 참조하세요.

tailwind
<div class="animate-spin">Spinning loader</div>
<div class="animate-ping">Pulsing ping (notifications)</div>
<div class="animate-pulse">Fading pulse (skeleton loaders)</div>
<div class="animate-bounce">Bouncing arrow</div>

<!-- Skeleton loader pattern -->
<div class="animate-pulse bg-gray-200 rounded h-4 w-3/4"></div>
<div class="animate-pulse bg-gray-200 rounded h-4 w-1/2 mt-2"></div>

변환

scale-, rotate-, translate-, skew-는 모두 합성되어 transition-transform으로 부드럽게 애니메이션됩니다. origin-{center,top,bottom-left,...}로 변환 원점을 바꾸세요. 카드 호버 장식(스케일 + 약간 회전 + 리프트)은 은은하게 유지하면 고급스럽습니다.

tailwind
<div class="hover:scale-110 transition-transform">Grow on hover</div>
<div class="hover:rotate-3">Tilt on hover</div>
<div class="hover:-translate-y-1">Lift on hover</div>
<div class="hover:skew-y-3">Skew on hover</div>

<!-- Combined -->
<div class="hover:scale-105 hover:-translate-y-1 hover:rotate-1
            transition-transform duration-300">
  Card flourish
</div>

<!-- Origin -->
<div class="origin-top-left rotate-12">Rotated from corner</div>

설정으로 사용자 정의 애니메이션

theme.extend에 사용자 정의 키프레임과 애니메이션 이름을 정의하세요. 애니메이션 값은 '{name} {duration} {timing} {iteration}' 단축입니다. 정의하면 animate-{name}이 일반 유틸리티가 됩니다. 키프레임은 CSS 번들에 포함되므로 작게 유지하세요.

tailwind
// tailwind.config.js
module.exports = {
  theme: {
    extend: {
      keyframes: {
        wiggle: {
          "0%, 100%": { transform: "rotate(-3deg)" },
          "50%":      { transform: "rotate(3deg)" },
        },
      },
      animation: {
        wiggle: "wiggle 1s ease-in-out infinite",
      },
    },
  },
};

// Usage
<div class="animate-wiggle">Wiggling</div>
13

폼

입력 필드

표준 입력 패턴: 전체 너비 w-full, 패딩, 테두리, 둥근 모서리, 기본 외곽선을 제거하는 포커스 링. focus:border-transparent는 네이티브 포커스 테두리를 숨기고 focus:ring-2는 명확한 접근성 포커스 표시를 그립니다. 명확성을 위해 disabled 상태도 항상 스타일링하세요.

tailwind
<input type="text"
       class="w-full px-3 py-2 border border-gray-300 rounded-md
              focus:outline-none focus:ring-2 focus:ring-blue-500
              focus:border-transparent
              placeholder-gray-400 text-gray-900"
       placeholder="Enter your name" />

<input type="email" disabled
       class="opacity-50 cursor-not-allowed" />

<textarea class="w-full rounded-md border-gray-300" rows="4"></textarea>

체크박스와 라디오

체크박스/라디오의 text-{color}는 선택 색을 설정합니다(내부적으로 accent-color 사용). focus:ring-*은 키보드 포커스 표시를 추가합니다. 사용자 정의 토글에는 숨겨진 체크박스와 peer-* 패턴으로 스타일을 구동하거나 @tailwindcss/forms 같은 플러그인을 사용하세요.

tailwind
<label class="flex items-center gap-2">
  <input type="checkbox" class="rounded border-gray-300
                                 text-blue-600 focus:ring-blue-500" />
  Accept terms
</label>

<label class="flex items-center gap-2">
  <input type="radio" name="plan"
         class="border-gray-300 text-blue-600 focus:ring-blue-500" />
  Free plan
</label>

<!-- Custom toggle switch -->
<button role="switch" aria-checked="false"
        class="relative w-11 h-6 rounded-full bg-gray-300
               peer-checked:bg-blue-600 transition-colors">
  <span class="absolute left-0.5 top-0.5 w-5 h-5 bg-white
               rounded-full transition-transform peer-checked:translate-x-5">
  </span>
</button>

Select와 옵션

네이티브 <select> 스타일링은 브라우저 간 제한적입니다. 완전한 제어가 필요하면 사용자 정의 드롭다운 컴포넌트나 Headless UI 같은 라이브러리를 사용하세요. @tailwindcss/forms 플러그인은 모든 폼 요소에 일관되고 테마 적용이 쉬운 기준선을 줍니다. 폼이 많은 앱에는 설치할 가치가 있습니다.

tailwind
<select class="w-full px-3 py-2 border border-gray-300 rounded-md
                bg-white text-gray-900 focus:ring-2 focus:ring-blue-500">
  <option value="">Choose...</option>
  <option value="us">United States</option>
  <option value="cn">China</option>
</select>

<!-- Multiple select -->
<select multiple class="h-32">
  <option>Tag 1</option>
  <option>Tag 2</option>
</select>

폼 레이아웃

space-y-4는 폼 행 간격을 주는 가장 깔끔한 방법이며 필드별 마진이 필요 없습니다. 각 입력에 <label class='block text-sm font-medium mb-1'>을 붙여 라벨 스타일을 일관되게 하세요. 데스크톱에서 읽기 좋은 폼 너비를 위해 max-w-md로 감싸세요.

tailwind
<form class="space-y-4 max-w-md">
  <div>
    <label class="block text-sm font-medium text-gray-700 mb-1">
      Email
    </label>
    <input type="email" class="w-full ..." />
  </div>
  <div>
    <label class="block text-sm font-medium text-gray-700 mb-1">
      Password
    </label>
    <input type="password" class="w-full ..." />
  </div>
  <button type="submit" class="w-full bg-blue-600 text-white py-2 rounded">
    Sign in
  </button>
</form>

버튼

버튼에는 hover뿐 아니라 active:(눌림), disabled:(상태), focus:(키보드) 변형이 필요합니다. active:bg-{darker}는 물리적 피드백을 줍니다. disabled:opacity-50 disabled:cursor-not-allowed는 표준 비활성 처리입니다. 버튼 변형 전체에서 일관된 높이(예: py-2)를 유지하세요.

tailwind
<button class="bg-blue-600 hover:bg-blue-700 active:bg-blue-800
               text-white font-medium py-2 px-4 rounded-md
               transition-colors focus:outline-none
               focus:ring-2 focus:ring-blue-500 focus:ring-offset-2">
  Primary
</button>

<button class="bg-white border border-gray-300 hover:bg-gray-50
               text-gray-700 py-2 px-4 rounded-md transition-colors">
  Secondary
</button>

<button class="text-blue-600 hover:text-blue-800 hover:underline">
  Ghost link button
</button>

<button class="bg-red-600 hover:bg-red-700 disabled:opacity-50
               disabled:cursor-not-allowed" disabled>
  Disabled
</button>
14

카드

기본 카드

표준 카드: rounded + shadow + overflow-hidden(이미지 모서리가 깔끔하게 잘리도록). 이미지의 object-cover는 왜곡을 막습니다. transition-shadow와 hover:shadow-lg가 떠오르는 효과를 줍니다. overflow-hidden은 위쪽 모서리를 둥글게 자르는 핵심입니다.

tailwind
<div class="max-w-sm rounded-xl shadow-md overflow-hidden
            bg-white hover:shadow-lg transition-shadow">
  <img class="w-full h-48 object-cover" src="/photo.jpg" alt="" />
  <div class="p-6">
    <h3 class="text-xl font-semibold mb-2">Card title</h3>
    <p class="text-gray-600">Card description goes here.</p>
    <button class="mt-4 text-blue-600 font-medium hover:underline">
      Learn more
    </button>
  </div>
</div>

카드 그리드

카드 그리드에는 auto-fill + minmax 패턴을 사용하세요. 카드가 최소 280px이고 채우도록 늘어나며 자동 줄바꿈되므로 미디어 쿼리가 필요 없습니다. 알려진 브레이크포인트에서 고정 열 수를 원하면 반응형 grid-cols-*가 더 단순합니다.

tailwind
<div class="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3
            gap-6">
  <div class="rounded-xl shadow p-6 bg-white">Card 1</div>
  <div class="rounded-xl shadow p-6 bg-white">Card 2</div>
  <div class="rounded-xl shadow p-6 bg-white">Card 3</div>
  <div class="rounded-xl shadow p-6 bg-white">Card 4</div>
</div>

<!-- Auto-fit grid for variable width -->
<div class="grid gap-6
            grid-cols-[repeat(auto-fill,minmax(280px,1fr))]">
  <!-- Cards naturally wrap based on viewport -->
</div>

대화형 카드(전체 클릭 가능)

카드 전체를 <a>로 감싸면 완전히 클릭 가능해집니다(별도 '더 보기' 버튼보다 나은 UX). group + group-hover 패턴은 부모가 호버될 때 자식 요소(제목 색, 화살표 위치)를 애니메이션할 수 있어 대화형 카드에 강력합니다.

tailwind
<a href="/post" class="group block max-w-sm rounded-xl
         shadow-md hover:shadow-xl transition-shadow bg-white">
  <div class="p-6">
    <h3 class="font-semibold group-hover:text-blue-600 transition-colors">
      Card title
    </h3>
    <p class="text-gray-600 mt-2">Description...</p>
    <span class="mt-4 inline-flex items-center text-blue-600">
      Read more
      <svg class="w-4 h-4 ml-1 group-hover:translate-x-1 transition-transform">
        <!-- arrow icon path -->
      </svg>
    </span>
  </div>
</a>

푸터가 있는 카드

카드에 flex flex-col을, 본문에 flex-1을 적용하면 카드 본문 길이가 달라도 푸터가 아래에 붙어 카드 행이 정렬됩니다. 푸터는 보통 은은한 배경과 위쪽 테두리로 메타데이터와 액션을 담습니다.

tailwind
<div class="max-w-sm rounded-xl shadow bg-white flex flex-col">
  <div class="p-6 flex-1">
    <h3 class="text-lg font-semibold">Title</h3>
    <p class="text-gray-600 mt-2">Body content...</p>
  </div>
  <div class="px-6 py-4 bg-gray-50 border-t border-gray-100
              flex justify-between items-center">
    <span class="text-sm text-gray-500">Aug 12, 2025</span>
    <button class="text-sm text-blue-600 hover:underline">Share</button>
  </div>
</div>

프로필/아바타 카드

아바타 + 이름 + 액션은 표준 행 카드 패턴입니다. flex items-center gap-4로 정렬하세요. 상태 점은 오른쪽 아래에 absolute로 배치하고 카드 배경과 같은 ring으로 점을 '잘라낸' 듯 보이게 하세요. 아바타는 rounded-full + 같은 w/h + object-cover를 사용합니다.

tailwind
<div class="flex items-center gap-4 p-4 rounded-xl shadow bg-white">
  <img src="/avatar.jpg"
       class="w-12 h-12 rounded-full object-cover" alt="" />
  <div class="flex-1">
    <p class="font-semibold">Alice Zhang</p>
    <p class="text-sm text-gray-500">Software Engineer</p>
  </div>
  <button class="text-blue-600 text-sm font-medium">Follow</button>
</div>

<!-- Status indicator -->
<div class="relative">
  <img class="w-10 h-10 rounded-full" src="/avatar.jpg" />
  <span class="absolute bottom-0 right-0 w-3 h-3
               bg-green-500 rounded-full ring-2 ring-white"></span>
</div>
16

레이아웃 패턴

위치

relative + absolute가 핵심입니다. 부모에 position:relative, 자식에 position:absolute를 설정해 정확히 배치하세요. inset-0 = top/right/bottom/left:0(부모를 채움). sticky top-0은 스티키 헤더에 필수이며 부모가 스크롤될 만큼 충분히 길어야 합니다.

tailwind
<div class="static">Default flow</div>
<div class="relative">
  <div class="absolute top-0 right-0">Top-right of parent</div>
</div>
<div class="fixed bottom-4 right-4">Stuck to viewport</div>
<div class="sticky top-0">Sticks when scrolling</div>

<!-- Inset shorthand for all sides -->
<div class="absolute inset-0">Fills parent</div>
<div class="absolute inset-x-0 bottom-0">Full width, at bottom</div>

Z-Index와 스태킹

Tailwind는 z-0/10/20/30/40/50과 z-auto를 제공합니다. 일관된 관례를 쓰세요: 0 = 기본, 10 = 드롭다운, 20 = 스티키, 30 = 모달, 40 = 오버레이, 50 = 토스트/툴팁. 모달은 높은 z-index와 뷰포트를 덮는 fixed inset-0이 모두 필요합니다.

tailwind
<div class="z-0">Base layer</div>
<div class="z-10">Dropdowns</div>
<div class="z-20">Sticky headers</div>
<div class="z-30">Modals</div>
<div class="z-40">Overlays</div>
<div class="z-50">Tooltips, toasts</div>

<!-- Combine with relative/absolute/fixed -->
<div class="fixed inset-0 z-50 bg-black/50">Modal overlay</div>

Display

block/inline-block/inline/hidden이 기본입니다. inline-block은 너비/높이가 필요하지만 인라인으로 놓여야 하는 요소에 유용합니다. hidden은 레이아웃에서 완전히 제거합니다(공간을 유지하는 opacity-0과 다름). 반응형 표시/숨김에는 브레이크포인트 접두사로 토글하세요.

tailwind
<div class="block">Full-width block</div>
<div class="inline-block">Inline with set width/height</div>
<div class="inline">Flows inline</div>
<div class="hidden">Removed from layout</div>
<div class="flex">Flex container</div>
<div class="grid">Grid container</div>

<!-- Toggle on breakpoint -->
<div class="hidden md:block">Hidden on mobile</div>
<div class="block md:hidden">Hidden on desktop</div>

<!-- Tables, contents, list-item also available -->

오버플로

overflow-hidden은 콘텐츠를 자릅니다(둥근 모서리로 자식을 자를 때도 사용). overflow-auto는 필요할 때만 스크롤바를 추가합니다. overflow-x-auto와 whitespace-nowrap은 내비 행과 코드 블록의 표준 가로 스크롤 패턴입니다.

tailwind
<div class="overflow-hidden">Clips overflow</div>
<div class="overflow-auto">Scrollbars if needed</div>
<div class="overflow-scroll">Always scrollable</div>
<div class="overflow-visible">Default, overflows</div>

<!-- Per-axis -->
<div class="overflow-x-auto whitespace-nowrap">Horizontal scroll</div>
<div class="overflow-y-auto h-64">Vertical scroll area</div>

<!-- Hide scrollbars while keeping scroll (Webkit) -->
<div class="overflow-x-auto scrollbar-hide">...</div>

Float와 Clear

레이아웃에서 float는 대부분 flexbox/grid로 대체되었지만 float-left + mr-4는 이미지 주변 텍스트 감싸기에 여전히 잘 동작합니다. 대부분의 이미지 크기 요구에는 크기가 지정된 img에 object-cover(채우고 자를 수 있음)나 object-contain(맞추고 레터박스 가능)을 쓰는 것이 현대적 접근입니다.

tailwind
<img class="float-left mr-4 rounded" src="/photo.jpg" />
<p>Text wraps around the floated image on the right...</p>
<p class="clear-both">After the float</p>

<!-- Floats are mostly legacy; prefer flex/grid for layout.
     Still useful for text wrapping around images. -->

<!-- Object fit for responsive images -->
<img class="w-full h-48 object-cover" src="/hero.jpg" />
<img class="w-24 h-24 object-contain" src="/logo.png" />
17

효과와 필터

배경 블러(글래스모피즘)

backdrop-blur-*는 요소 뒤의 배경을 흐리게 합니다(요소 자체가 아님). 반투명 배경(bg-white/30)과 결합하면 글래스모피즘 효과가 생깁니다. 모달, 콘텐츠 위 스티키 헤더, iOS 스타일 프로스트 패널에 완벽합니다.

tailwind
<div class="backdrop-blur-md bg-white/30 border border-white/20
            rounded-xl p-6 shadow-lg">
  Frosted glass card
</div>

<!-- Strengths -->
<div class="backdrop-blur-sm">Light blur</div>
<div class="backdrop-blur-md">Medium</div>
<div class="backdrop-blur-xl">Heavy</div>
<div class="backdrop-blur-2xl">Maximum</div>

<!-- Modal overlay with blur -->
<div class="fixed inset-0 bg-black/50 backdrop-blur-sm z-50">
  Overlay with frosted bg
</div>

이미지 필터

필터 유틸리티는 CSS filter 함수에 매핑됩니다: blur, brightness, contrast, grayscale, invert, sepia, saturate, hue-rotate. grayscale hover:grayscale-0 패턴은 팀 사진과 제품 이미지에 인기 있는 효과로 호버 시 색이 나타납니다.

tailwind
<img class="blur-sm" src="/photo.jpg" />
<img class="blur-md" src="/photo.jpg" />
<img class="brightness-110" src="/photo.jpg" />
<img class="contrast-125" src="/photo.jpg" />
<img class="grayscale" src="/photo.jpg" />
<img class="invert" src="/photo.jpg" />
<img class="sepia" src="/photo.jpg" />
<img class="saturate-150" src="/photo.jpg" />

<!-- Combined + hover -->
<img class="grayscale hover:grayscale-0 transition-all duration-500"
     src="/photo.jpg" />

Mix Blend Mode

mix-blend-mode는 요소가 뒤 배경과 블렌드되는 방식을 제어합니다. 이미지 위 흰 텍스트에 mix-blend-difference를 쓰면 배경 이미지와 무관하게 읽을 수 있는 고대비 효과가 생깁니다(히어로 섹션에 인기). 과하면 기믹처럼 보이므로 드물게 사용하세요.

tailwind
<div class="mix-blend-multiply">Multiplies with bg</div>
<div class="mix-blend-screen">Lightens</div>
<div class="mix-blend-overlay">Contrast blend</div>
<div class="mix-blend-difference">Inverts colors</div>

<!-- Text over image with blend -->
<div class="relative">
  <img src="/photo.jpg" />
  <h1 class="absolute inset-0 flex items-center justify-center
             text-white mix-blend-difference text-6xl font-bold">
    Overlay text
  </h1>
</div>

불투명도

opacity-{0,25,50,75,100}(그리고 5/10/20/.../95)은 요소 불투명도를 설정하며 요소와 자식 모두에 영향을 줍니다. 배경만 반투명하게 하려면 bg-{color}/{opacity}를 쓰세요. 텍스트는 완전 불투명하게 유지됩니다. opacity-0은 숨기되 레이아웃을 유지합니다(제거하는 hidden과 다름).

tailwind
<div class="opacity-100">Fully visible</div>
<div class="opacity-75">75%</div>
<div class="opacity-50">Half</div>
<div class="opacity-25">Mostly transparent</div>
<div class="opacity-0">Invisible (still takes space)</div>

<!-- Hover fade -->
<button class="opacity-100 hover:opacity-80 transition-opacity">
  Fades on hover
</button>

<!-- vs bg-black/50: opacity affects the whole element
     (including children), bg color/opacity only the background -->

커서와 사용자 선택

커서를 동작에 맞추세요: 클릭 가능하면 cursor-pointer, 비활성이면 cursor-not-allowed. select-none은 텍스트 선택을 막습니다(UI 크롬과 더블클릭이 잦은 버튼에 유용). textarea의 resize-none은 일관된 레이아웃을 원할 때 기본 크기 조절 핸들을 막습니다.

tailwind
<button class="cursor-pointer">Pointer on hover</button>
<div class="cursor-not-allowed opacity-50">Disabled</div>
<div class="cursor-move">Drag handle</div>
<div class="cursor-text">Text input area</div>

<!-- Selection -->
<p class="select-none">Cannot be selected</p>
<p class="select-text">Selectable text</p>
<p class="select-all">Selects all on click</p>

<!-- Resize handle -->
<textarea class="resize-none"></textarea>
<textarea class="resize-y"></textarea>
18

전환과 변환

변환 원점과 스케일

origin-*은 변환 원점을 설정합니다. scale-x-*/scale-y-*는 축별로 독립 스케일합니다. transform-gpu는 더 부드러운 애니메이션을 위해 GPU 가속(translate3d)을 강제합니다. 캐러셀처럼 변환이 많은 요소에서 버벅임이 보이면 사용하세요.

tailwind
<div class="origin-center scale-110">Center origin (default)</div>
<div class="origin-top-left scale-90">Top-left origin</div>
<div class="origin-bottom rotate-45">Bottom origin, rotated</div>

<!-- Combined transforms -->
<div class="transform-gpu hover:scale-105 hover:rotate-3
            transition-transform duration-300">
  GPU-accelerated flourish
</div>

<!-- Independent scale axes -->
<div class="hover:scale-x-110">Stretches horizontally</div>
<div class="hover:scale-y-90">Squishes vertically</div>

이동과 회전

translate-{x,y}-{n}은 간격 스케일로 요소를 이동합니다(또는 -translate-x-1/2로 50%). left-1/2 + -translate-x-1/2 패턴은 너비와 무관하게 절대 위치 요소를 완벽히 중앙 정렬하므로 툴팁과 모달에 유용합니다.

tailwind
<div class="translate-x-4">16px right</div>
<div class="-translate-x-4">16px left</div>
<div class="translate-y-2">8px down</div>
<div class="rotate-45">45deg clockwise</div>
<div class="-rotate-12">12deg counter-clockwise</div>
<div class="rotate-180">Flipped</div>

<!-- Centering trick: absolute + translate -->
<div class="absolute left-1/2 top-1/2
            -translate-x-1/2 -translate-y-1/2">
  Perfectly centered
</div>

기울이기와 3D 변환

Skew는 축을 따라 요소를 기울여 은은한 평행사변형 효과를 냅니다. 3D 변환(perspective, rotate-y, rotate-x, transform-style-3d)은 기본 Tailwind에서 테마 확장이 필요하지만 카드 뒤집기와 시차 효과를 가능하게 합니다. 대부분의 프로젝트는 2D 변환만 사용합니다.

tailwind
<div class="skew-x-12">Skewed horizontally</div>
<div class="skew-y-6">Skewed vertically</div>
<div class="-skew-x-6">Counter skew</div>

<!-- 3D (needs perspective on parent) -->
<div class="perspective-1000">
  <div class="rotate-y-12 transform-style-3d">Tilted in 3D</div>
</div>

<!-- Card flip pattern -->
<div class="preserve-3d group hover:rotate-y-180
            transition-transform duration-700">
  Flips on hover (needs config)
</div>

전환 지연과 타이밍

delay-{ms}는 전환 시작을 지연합니다. 자식별 지연과 결합하면 순차 등장(각 항목이 조금씩 늦게 시작)을 만들 수 있습니다. ease-out은 나타나는 것(감속하며 제자리로), ease-in은 사라지는 것(가속하며 멀어짐)에 자연스럽습니다.

tailwind
<div class="transition-colors duration-300 delay-150
            hover:bg-blue-500">
  Starts after 150ms
</div>

<!-- Stagger children via inline delay style -->
<div class="flex gap-2">
  <div class="transition-all delay-0 duration-500">A</div>
  <div class="transition-all delay-100 duration-500">B</div>
  <div class="transition-all delay-200 duration-500">C</div>
</div>

<!-- Easing -->
<div class="ease-in-out">Smooth</div>
<div class="ease-out">Decelerate (good for entrances)</div>
<div class="ease-in">Accelerate (good for exits)</div>

Hover vs Focus vs Active 상태

hover 외에도 focus(키보드 사용자)와 active(마우스 다운)를 항상 고려하세요. focus-visible:은 키보드 포커스일 때만(마우스 클릭 아님) 적용되며 포커스 링에 보통 원하는 동작입니다. group + group-hover:는 부모 호버로 자식 스타일을 구동하며 카드와 복잡한 호버에 필수입니다.

tailwind
<button class="bg-blue-500
               hover:bg-blue-600   <!-- mouse over -->
               focus:bg-blue-700   <!-- keyboard focus -->
               active:bg-blue-800  <!-- mouse down -->
               focus:outline-none focus:ring-2 focus:ring-blue-300
               transition-colors">
  All states styled
</button>

<!-- Group hover: style children when parent hovered -->
<div class="group">
  <button class="group-hover:scale-110 transition-transform">
    Scales when parent hovered
  </button>
</div>
19

크기

너비 스케일

w-*는 간격 스케일과 백분율 분수(1/2, 1/3, 2/3, 1/4, 3/4, 1/5, ..., 1/12)를 사용합니다. w-full = 100%, w-screen = 100vw, w-fit = 고유 너비, w-max = max-content. 반응형 콘텐츠가 읽기 좋은 너비로 제한되도록 w-full + max-w-{size}를 사용하세요.

tailwind
<div class="w-0">0</div>
<div class="w-px">1px</div>
<div class="w-1">0.25rem</div>
<div class="w-4">1rem (16px)</div>
<div class="w-16">4rem (64px)</div>
<div class="w-64">16rem</div>
<div class="w-96">24rem</div>

<!-- Fractions -->
<div class="w-1/2">50%</div>
<div class="w-1/3">33.33%</div>
<div class="w-2/3">66.67%</div>
<div class="w-full">100%</div>
<div class="w-screen">100vw</div>

높이와 뷰포트

h-screen = 100vh는 모바일 브라우저 주소창 문제가 있습니다. 모바일 친화적 전체 높이 레이아웃에는 h-dvh(동적 뷰포트 높이)를 권장하세요. 브라우저 크롬이 표시/숨김에 따라 조정됩니다. 스티키 푸터 레이아웃에는 min-h-screen이 표준입니다.

tailwind
<div class="h-8">2rem</div>
<div class="h-64">16rem</div>
<div class="h-full">100% of parent</div>
<div class="h-screen">100vh (full viewport)</div>

<!-- Modern viewport units (v3.4+) -->
<div class="h-dvh">Dynamic viewport height (mobile-friendly)</div>
<div class="h-svh">Small viewport height</div>
<div class="h-lvh">Large viewport height</div>

<!-- min/max -->
<div class="min-h-screen">At least viewport tall</div>
<div class="max-h-96 overflow-y-auto">Capped scroll area</div>

최소/최대 너비

max-w-{xs,sm,md,lg,xl,2xl,...,7xl}은 콘텐츠 너비에 이상적인 rem 기반 크기로 매핑됩니다. 페이지 콘텐츠를 max-w-7xl mx-auto로 감싸는 것이 표준입니다. min-w-0은 flexbox의 중요한 기법입니다. flex 자식이 고유 크기 아래로 축소되어 오버플로를 막게 합니다.

tailwind
<!-- Max-width is the key to readable content -->
<article class="max-w-2xl mx-auto">
  Caps article at ~42rem (readable line length)
</article>

<!-- Common max-widths -->
<div class="max-w-sm">384px</div>
<div class="max-w-md">28rem</div>
<div class="max-w-lg">32rem</div>
<div class="max-w-xl">36rem</div>
<div class="max-w-7xl">80rem</div>

<!-- min-width for inputs etc -->
<input class="min-w-0" />  <!-- prevent flex overflow -->
<div class="min-w-full">Always at least full width</div>

종횡비

aspect-{ratio}는 너비와 무관하게 고정 종횡비를 유지하므로 예전 padding-bottom 해킹보다 훨씬 깔끔합니다. aspect-video는 동영상 임베드의 표준입니다. 왜곡 없이 박스를 채우려면 object-cover와 결합하세요. aspect-[21/9] 같은 임의 비율도 동작합니다.

tailwind
<div class="aspect-square">1:1 square</div>
<div class="aspect-video">16:9 widescreen</div>
<div class="aspect-[4/3]">4:3</div>
<div class="aspect-[21/9]">Ultrawide</div>

<!-- Responsive video embed -->
<div class="aspect-video w-full">
  <iframe class="w-full h-full" src="..."></iframe>
</div>

<!-- Avatar / product image -->
<img class="aspect-square object-cover w-24" />

Object Fit과 위치

<img>(와 <video>)의 object-fit은 원본이 박스를 채우는 방식을 제어합니다: cover(채우고 자름), contain(맞추고 레터박스), fill(늘림), none(원본 크기). 자를 때 유지할 부분을 제어하려면 object-{position}과 결합하세요. 히어로 이미지의 기본은 object-cover + object-center입니다.

tailwind
<img class="w-full h-48 object-cover" src="/hero.jpg" />
<!-- Fills the box, may crop. Best for hero images. -->

<img class="w-full h-48 object-contain" src="/logo.png" />
<!-- Fits entire image, may letterbox. Best for logos. -->

<img class="w-full h-48 object-fill" src="/img.jpg" />
<!-- Stretches to fill (distorts). Rarely what you want. -->

<img class="w-full h-48 object-none" src="/img.jpg" />
<!-- Keeps original size, may overflow. -->

<!-- Position -->
<img class="object-cover object-top" src="/portrait.jpg" />
<img class="object-cover object-center" src="/photo.jpg" />
20

상호작용과 상태

Hover, Focus, Group

group은 요소를 상태 소스로 만들고 group-hover:*는 부모가 호버될 때 자식에 스타일을 적용합니다. 카드를 호버하면 이미지, 제목, 숨은 액션이 한 번에 반응해야 하는 카드에 중요합니다. 이름 있는 그룹(group/card)은 중첩을 허용합니다.

tailwind
<button class="hover:bg-blue-600">Hover state</button>
<input class="focus:ring-2 focus:ring-blue-500" />
<div class="active:scale-95">Press feedback</div>

<!-- group / group-hover: style children based on parent state -->
<div class="group">
  <img class="group-hover:scale-110 transition-transform" />
  <h3 class="group-hover:text-blue-600">Title</h3>
  <p class="opacity-0 group-hover:opacity-100">Revealed on hover</p>
</div>

Peer(형제 상태)

peer는 요소를 형제(기본적으로 이후 형제만)의 상태 소스로 표시합니다. peer-checked:*는 체크박스/라디오 상태에 따라 형제를 스타일링하므로 JavaScript 없이 CSS 전용 토글, 비밀번호 표시 버튼, 아코디언을 만들 수 있습니다.

tailwind
<!-- Style a sibling based on an input's state -->
<input type="checkbox" id="c" class="peer" />
<label for="c" class="peer-checked:text-blue-600">
  Styled when checkbox checked
</label>

<!-- Show/hide password -->
<input type="checkbox" id="show" class="peer hidden" />
<label for="show" class="peer-checked:hidden">Show</label>
<label for="show" class="hidden peer-checked:inline">Hide</label>

<!-- Toggle a panel -->
<input type="checkbox" class="peer hidden" />
<div class="hidden peer-checked:block">Toggleable panel</div>

Focus-Visible(키보드만)

포커스 링에는 focus: 대신 focus-visible:을 사용하세요. 키보드 사용자(링이 필요한 사람)에게만 표시하고 자체 시각 피드백이 있는 마우스 클릭에는 숨깁니다. 브라우저 기본 링을 억제하려면 focus:outline-none과 결합하세요.

tailwind
<button class="focus:outline-none
               focus-visible:ring-2 focus-visible:ring-blue-500">
  No ring on mouse click, ring on keyboard focus
</button>

<!-- Why focus-visible: -->
<!-- - focus: applies on BOTH mouse click and keyboard
     (annoying for mouse users)
   - focus-visible: only on keyboard navigation
     (the accessible choice for focus rings) -->

Placeholder와 파일 입력

placeholder-*는 자리 표시자 텍스트를 스타일링합니다. file:*은 <input type='file'> 내부의 의사 버튼을 스타일링합니다. 스타일링이 악명 높게 어려운 요소지만 Tailwind의 file: 변형이 다루기 쉽게 합니다. 위 패턴은 깔끔한 브랜드 파일 업로드 버튼을 만듭니다.

tailwind
<input class="placeholder-gray-400 placeholder-italic"
       placeholder="Type here..." />

<!-- Style the file input button -->
<input type="file"
       class="block w-full text-sm text-gray-500
              file:mr-4 file:py-2 file:px-4
              file:rounded-md file:border-0
              file:text-sm file:bg-blue-50
              file:text-blue-700
              hover:file:bg-blue-100" />

Marker와 Selection

marker:*는 목록 글머리/번호를 스타일링합니다. selection:*은 사용자가 텍스트를 선택할 때 하이라이트를 스타일링합니다. first-letter:*/first-line:*은 드롭 캡과 작은 대문자 첫 줄을 가능하게 합니다(편집 디자인에 유용). 이 모든 의사 요소에는 전용 Tailwind 변형이 있습니다.

tailwind
<ul class="marker:text-blue-500 list-disc pl-5">
  <li>Blue bullet</li>
  <li>Blue bullet</li>
</ul>

<!-- Style text selection -->
<p class="selection:bg-blue-200 selection:text-blue-900">
  Select this text to see a blue highlight.
</p>

<!-- Global selection (in CSS) -->
::selection { background: #bfdbfe; color: #1e3a8a; }

<!-- First-line / first-letter -->
<p class="first-letter:text-5xl first-letter:font-bold
          first-letter:float-left first-letter:mr-2
          first-line:uppercase first-line:tracking-wide">
  Drop cap paragraph.
</p>
21

임의 값과 사용자 정의

임의 값

대괄호를 쓰면 테마를 확장하지 않고 모든 CSS 값을 사용할 수 있어 일회성에 완벽합니다. 값의 밑줄은 공백이 됩니다(grid-cols-[200px_1fr]은 '200px 1fr'이 됨). 과도하게 쓰면 디자인이 불일치해지므로 반복 값에는 테마 확장을 선호하세요.

tailwind
<!-- Any CSS value in square brackets -->
<div class="w-[300px] h-[200px] bg-[#1da1f2]">
  Custom sizes and colors
</div>

<p class="text-[13px] leading-[1.6]">
  Custom typography
</p>

<div class="grid-cols-[200px_1fr_100px]">
  Custom grid template (underscores = spaces)
</div>

<div class="top-[117px]">
  Custom positioning
</div>

임의 속성

[property:value]는 임의 CSS 속성을 정의하며 Tailwind에 유틸리티가 없는 속성(mask-type, hyphens 등)에 유용합니다. [--var:value]는 CSS 변수를 설정해 p-[var(--tw)] 같은 임의 값에서 참조할 수 있습니다. 테마 적용에 강력합니다.

tailwind
<!-- Define an arbitrary CSS property -->
<div class="[mask-type:luminance]">
  Sets mask-type: luminance
</div>

<!-- Arbitrary property with Tailwind variable -->
<div class="[--scroll-offset:56px] top-[var(--scroll-offset)]">
  Custom CSS variable
</div>

<!-- CSS variables + arbitrary values are powerful together -->
<div class="[--tw:1rem] p-[var(--tw)]">
  Theme-driven custom value
</div>

임의 변형

임의 변형은 Tailwind의 변형 시스템을 확장합니다. min-[1200px]:는 사용자 정의 브레이크포인트, aria-*:는 ARIA 상태, odd:/even:은 줄무늬, has-[:checked]:는 관계형 스타일링입니다. has-* 변형(최근 CSS 기능)은 자식 상태에 따라 부모를 스타일링하는 데 특히 강력합니다.

tailwind
<!-- Arbitrary media query -->
<div class="min-[1200px]:flex">Custom breakpoint</div>

<!-- ARIA attribute variants -->
<button aria-pressed="true"
        class="aria-pressed:bg-blue-600">
  Toggle styled by ARIA state
</button>

<!-- nth-child -->
<li class="odd:bg-gray-50">Striped table row</li>
<li class="even:bg-white">Striped table row</li>

<!-- has: variant (Tailwind v3.4+) -->
<div class="has-[:checked]:bg-blue-50">
  Highlights when it contains a checked input
</div>

테마 확장

theme.extend는 기본값에 추가하고 theme.{key}는 대체합니다. DEFAULT를 쓰면 기본 이름(bg-brand)과 음영(bg-brand-dark)을 모두 사용할 수 있습니다. 사용자 정의 간격, 브레이크포인트, 반경 등을 추가하세요. 확장이 거의 항상 원하는 동작이며 색상 팔레트를 대체하면 Tailwind 기본값이 사라집니다.

tailwind
// tailwind.config.js
module.exports = {
  theme: {
    extend: {
      colors: {
        brand: { light: "#5eead4", DEFAULT: "#14b8a6", dark: "#0f766e" },
      },
      spacing: { 18: "4.5rem" },
      borderRadius: { xl: "1rem" },
      screens: { tall: { raw: "(min-height: 800px)" } },
    },
  },
};

<!-- Now you can use: -->
<div class="bg-brand text-brand-light p-18 rounded-xl">
  Custom themed utilities
</div>

플러그인과 @apply

플러그인은 새 유틸리티나 컴포넌트를 추가합니다(forms, typography, aspect-ratio는 공식). @apply는 Tailwind 유틸리티를 사용자 정의 CSS에 인라인하며 수십 곳에서 동일하게 쓰는 클래스가 있을 때 유용합니다. @apply를 과도하게 쓰지 마세요. 유틸리티 우선 접근이 보통 더 깔끔합니다.

tailwind
// tailwind.config.js — register a plugin
const forms = require("@tailwindcss/forms");
module.exports = { plugins: [forms] };

/* Use @apply to compose utilities into custom CSS */
@layer components {
  .btn-primary {
    @apply bg-blue-600 text-white font-medium py-2 px-4
           rounded-md hover:bg-blue-700 transition-colors;
  }
}

<!-- Then use the custom class -->
<button class="btn-primary">Save</button>
22

실전 패턴

모달/다이얼로그

모달 구조: fixed inset-0 오버레이(뷰포트 덮음), z-50(모든 것 위), 패널용 flex 중앙 정렬, 오버레이 위에 놓이도록 relative로 배치한 패널. backdrop-blur가 세련미를 더합니다. 접근성을 위해 항상 보이는 닫기 버튼과 ESC 닫기를 제공하세요.

tailwind
<div class="fixed inset-0 z-50 flex items-center justify-center">
  <!-- Overlay -->
  <div class="absolute inset-0 bg-black/50 backdrop-blur-sm"></div>
  <!-- Panel -->
  <div class="relative bg-white rounded-xl shadow-2xl
              w-full max-w-md mx-4 p-6">
    <h2 class="text-lg font-semibold mb-4">Modal title</h2>
    <p class="text-gray-600">Modal body content.</p>
    <div class="flex justify-end gap-2 mt-6">
      <button class="px-4 py-2 text-gray-600">Cancel</button>
      <button class="px-4 py-2 bg-blue-600 text-white rounded-md">OK</button>
    </div>
  </div>
</div>

토스트/알림

토스트는 모서리(관례상 오른쪽 아래)에 fixed로 붙고 너비가 제한되며 유형을 나타내는 색상 왼쪽 테두리를 가집니다(녹색=성공, 빨강=오류, 노랑=경고, 파랑=정보). JS 기반 애니메이션(translate-x 슬라이드 인)과 몇 초 후 자동 닫기를 결합하세요.

tailwind
<div class="fixed bottom-4 right-4 z-50 max-w-sm
            bg-white rounded-lg shadow-xl border-l-4 border-green-500
            flex items-center gap-3 p-4">
  <div class="text-green-500">
    <svg class="w-5 h-5"><!-- check icon --></svg>
  </div>
  <div class="flex-1">
    <p class="font-medium text-gray-900">Saved successfully</p>
    <p class="text-sm text-gray-500">Your changes are live.</p>
  </div>
  <button class="text-gray-400 hover:text-gray-600">×</button>
</div>

배지와 알약

배지는 inline-flex 알약(rounded-full)이나 라벨(rounded)입니다. 부드러운 파스텔 스타일에는 bg-{color}-100 + text-{color}-800을 사용하세요. 상태 표시에는 점(w-1.5 h-1.5 rounded-full)을 추가하세요. 배지 텍스트 스케일은 text-xs font-medium을 유지하세요.

tailwind
<span class="inline-flex items-center px-2.5 py-0.5
             rounded-full text-xs font-medium
             bg-green-100 text-green-800">
  Active
</span>

<span class="inline-flex items-center gap-1 px-2 py-0.5
             rounded-full text-xs font-medium
             bg-blue-100 text-blue-800">
  <span class="w-1.5 h-1.5 rounded-full bg-blue-500"></span>
  Online
</span>

<span class="inline-flex items-center px-2 py-0.5
             rounded text-xs font-medium
             bg-red-100 text-red-800">
  Deprecated
</span>

빈 상태

빈 상태에는 부드러운 원 안의 아이콘, 짧은 헤드라인, 보조 텍스트, 주요 CTA가 필요합니다. 모든 것을 중앙 정렬하고(text-center mx-auto) 넉넉한 py-12 패딩을 쓰며 색을 낮춰(gray-400/500 텍스트) CTA 버튼이 눈에 띄게 하세요. '데이터 없음'만 보여주지 마세요.

tailwind
<div class="text-center py-12 px-4">
  <div class="mx-auto w-16 h-16 rounded-full bg-gray-100
              flex items-center justify-center mb-4">
    <svg class="w-8 h-8 text-gray-400"><!-- icon --></svg>
  </div>
  <h3 class="text-lg font-medium text-gray-900">No items yet</h3>
  <p class="mt-1 text-sm text-gray-500">
    Get started by creating your first item.
  </p>
  <button class="mt-4 bg-blue-600 text-white px-4 py-2 rounded-md">
    New item
  </button>
</div>

로딩 스켈레톤

스켈레톤 로더는 실제 콘텐츠 모양의 회색 블록 컨테이너에 animate-pulse를 적용합니다. 데이터 도착 시 어색한 이동이 없도록 로드된 상태의 레이아웃과 비율을 맞추세요. rounded-full + w-10 h-10은 아바타를, 다양한 너비(w-3/4, w-1/2)는 텍스트 줄을 모방합니다.

tailwind
<div class="animate-pulse space-y-3">
  <div class="h-4 bg-gray-200 rounded w-3/4"></div>
  <div class="h-4 bg-gray-200 rounded w-1/2"></div>
  <div class="space-y-2">
    <div class="h-3 bg-gray-200 rounded"></div>
    <div class="h-3 bg-gray-200 rounded"></div>
  </div>
  <div class="flex gap-4">
    <div class="w-10 h-10 bg-gray-200 rounded-full"></div>
    <div class="flex-1 space-y-2 py-1">
      <div class="h-3 bg-gray-200 rounded"></div>
      <div class="h-3 bg-gray-200 rounded w-5/6"></div>
    </div>
  </div>
</div>

Was this helpful?

Learning path

Learn from scratch

Learn this language from the ground up with structured lessons.