Skip to content

Tailwind CSS Шпаргалка

CSS-фреймворк, где интерфейс собирается из утилитарных классов, для быстрой разработки UI.

01

Начало работы

Установка через CDN

CDN-скрипт — самый быстрый способ прототипировать с Tailwind. Он генерирует утилиты в рантайме, сканируя разметку. Для продакшена предпочитайте сборку через PostCSS или CLI, чтобы выбросить неиспользуемые классы и отдать крошечный CSS-бандл.

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 генерирует только классы, которые находит в этих файлах (tree-shaking). Забытый путь — причина номер один ошибок «мой класс пропал». Используйте --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: строить интерфейсы, комбинируя маленькие одноцелевые утилитарные классы, а не придумывая семантические имена классов. Так 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 заменяет общий «серый» четырьмя нейтральными семействами: 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 для меток в стиле small-caps — очень частая идиома 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']. Не забудьте @import или <link> на сам веб-шрифт в CSS/HTML.

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

Отступы

Padding и margin

Утилиты отступов используют одну шкалу на основе 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>

Шкала отступов

Одна шкала управляет padding, margin, gap, width, height и другим — эта согласованность и есть суперсила 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-* добавляют margin между соседями (не вокруг) — идеально для вертикальных стеков и рядов бейджей. Учтите: 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, а также именованные размеры (xs..7xl для max-width). 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>

Gap для flex и grid

gap-* — современный способ задать промежутки между детьми flex/grid, заменяет старый подход с margin space-x/space-y. Задавайте gap для обеих осей или gap-x/gap-y отдельно. Использует ту же шкалу отступов, что padding/margin.

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% (растягиваться, может сжиматься, basis 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 spans.

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 центрирует весь grid-блок.

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 (похож на outline)

Rings — контуры на основе box-shadow, которые не влияют на раскладку (в отличие от border) и красиво перекрываются. 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 (вне border box, без влияния на раскладку). В Tailwind предпочитают ring, потому что это слоистый box-shadow: несколько колец складываются, а ring-offset даёт чистый зазор. Outline полезен, когда нужно именно поведение CSS 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>

Фоновое изображение и градиент

Используйте bg-[url('/path/to/img.jpg')] для background-image с произвольными URL (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 часты для тёплых hero-градиентов. Нативные радиальные и конические градиенты требуют плагина или произвольного значения: 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 — ключевой выбор для hero-изображений и логотипов соответственно. Cover заполняет блок (обрезая излишек); contain вписывает изображение целиком (может оставить пустое место). Комбинируйте bg-cover + bg-center для стандартного адаптивного hero-изображения.

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

Тени

Шкала box shadow

Шкала теней (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>

Drop shadow (для SVG и текста)

drop-shadow использует CSS filter:drop-shadow(), который следует фактической форме элемента (отлично для SVG и PNG с прозрачностью), в отличие от 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 mobile-first: базовые стили действуют везде, префиксы брейкпоинтов применяются начиная с 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

container центрирует содержимое с адаптивными max-width на каждом брейкпоинте (центрирование и padding нужно добавлять вручную). Ручной паттерн '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 — канонический паттерн переключения элементов между мобильным и десктопом (например, гамбургер-меню против полного меню). 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' позволяет переключать тёмный режим, добавляя класс 'dark' родителю (обычно <html>) — нужно для переключателей темы. 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>

Скрипт переключения темы

Поместите этот inline-скрипт в <head> до рендера страницы, чтобы избежать вспышки неправильной темы (FOUC). Он сначала проверяет localStorage, затем откатывается к предпочтению ОС. Переключатель просто меняет класс и сохраняет выбор.

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. Проще, но вы теряете возможность переопределить предпочтение. Используйте для контентных сайтов, где достаточно уважать выбор ОС.

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), а не чистый чёрный для фонов, off-white (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). Всегда добавляйте transition до изменения hover:*, иначе будет резкий скачок.

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-colors, transition-transform) вместо transition-all ради производительности: all следит за каждым свойством и может вызывать рывки. duration-* использует 75/100/150/200/300/500/700/1000 мс. 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 поставляет четыре keyframe-анимации: spin (лоадер), ping (расходящаяся точка уведомления), pulse (затухание прозрачности — идеально для скелетон-лоадеров), bounce (игривая). Для своих анимаций определите keyframes в конфиге и ссылайтесь через 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>

Transform

scale-, rotate-, translate-, skew- складываются и плавно анимируются с transition-transform. Используйте origin-{center,top,bottom-left,...} для смены точки трансформации. Эффекты наведения на карточках (scale + лёгкий поворот + подъём) ощущаются премиально, если держать их сдержанными.

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>

Свои анимации через конфиг

Определяйте свои keyframes и имена анимаций в theme.extend. Значение animation — сокращение: '{name} {duration} {timing} {iteration}'. После определения animate-{name} становится обычной утилитой. Держите keyframes небольшими — они попадают в ваш 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

Формы

Поля ввода

Стандартный паттерн input: w-full на всю ширину, padding, border, rounded и focus-ring, убирающий стандартный outline. 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 — самый чистый способ задать промежутки между строками формы, без margin у каждого поля. Каждому input — <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>

Кнопки

Кнопкам нужны варианты active: (нажатие), disabled: (состояние) и focus: (клавиатура), а не только hover. active:bg-{darker} даёт физическую обратную связь. disabled:opacity-50 disabled:cursor-not-allowed — стандартная обработка disabled. Держите одинаковую высоту (например, 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 на изображении предотвращает искажение. hover:shadow-lg с transition-shadow даёт эффект подъёма. 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. Для точек статуса используйте position 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

Паттерны раскладки

Position

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 = sticky, 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 полезен для элементов, которым нужны width/height, но которые должны стоять в строке. 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

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 всё ещё хорошо работает для обтекания текстом изображений. Для большинства задач с изображениями современный подход — object-cover (заполняет, может обрезать) или object-contain (вписывает, может оставить поля) на img с заданными размерами.

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 (глассморфизм)

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 на белом тексте поверх изображения даёт высококонтрастный эффект, читаемый независимо от изображения под ним, — популярно для hero-секций. Используйте умеренно; может выглядеть как трюк.

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 для disabled. select-none отключает выделение текста (полезно для элементов интерфейса и кнопок, склонных к двойному клику). resize-none у textarea убирает стандартный маркер изменения размера, когда нужна стабильная раскладка.

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

Переходы и трансформации

Transform origin и scale

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 и rotate

translate-{x,y}-{n} сдвигает элемент по шкале отступов (или /2 для 50% через -translate-x-1/2). Паттерн 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>

Skew и 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, focus и active

Всегда учитывайте focus (клавиатурные пользователи) и active (нажатие мыши) помимо hover. focus-visible: применяется только при фокусе с клавиатуры (не при клике мышью) — обычно это и нужно для колец фокуса. group + group-hover: позволяет наведению на родителя управлять стилями детей — необходимо для карточек и сложных 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>

Min/max width

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 и позиция

object-fit у <img> (и <video>) управляет тем, как источник заполняет блок: cover (заполняет, обрезает), contain (вписывает, поля), fill (растягивает), none (исходный размер). Сочетайте с object-{position}, чтобы управлять тем, какая часть сохраняется при обрезке. object-cover + object-center — стандарт для hero-изображений.

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:* позволяет стилизовать соседей по состоянию чекбокса или радио — так работают чисто CSS переключатели, кнопки показа пароля и аккордеоны без JavaScript.

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-visible: вместо focus: для колец фокуса — оно показывает кольцо только клавиатурным пользователям (которым оно нужно) и скрывает при кликах мышью (у которых своя визуальная обратная связь). Сочетайте с 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 и file input

placeholder-* стилизует текст-заглушку. file:* стилизует псевдокнопку внутри <input type='file'> — печально известный сложный для стилизации элемент, но вариант file: в Tailwind делает это выполнимым. Паттерн выше даёт чистую брендовую кнопку загрузки файла.

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-центрирование панели и сама панель с position 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>

Тост и уведомление

Тосты фиксируются в углу (обычно правый нижний), имеют ограниченную ширину и цветную левую границу, указывающую тип (зелёный — успех, красный — ошибка, жёлтый — предупреждение, синий — информация). Сочетайте с 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), используйте щедрый padding py-12 и приглушайте цвета (text 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.