re:re:actable
Урок 023 минуты чтения

Tailwind в React: clsx, tailwind-merge и варианты через cva

На этой странице
Кратко

В React с Tailwind быстро возникают три задачи. Условные классы — склеивать строки по условиям удобно через clsx. Переопределение классов снаружи — если компонент задал px-4, а родитель передал px-2, оба класса окажутся в строке и победит тот, что объявлен позже в CSS, а не в className; tailwind-merge удаляет конфликтующие утилиты, и обычно его объединяют с clsx в функцию cn(). Варианты компонента (variant, size) — библиотека cva (class-variance-authority) описывает их декларативно и типизированно. Эта связка — основа shadcn/ui и многих дизайн-систем. Не собирай имена классов динамически (bg-${color}-500): Tailwind находит классы статическим анализом и пропустит такие строки.

Вопрос

Как организовать Tailwind-классы в React-компонентах: условные классы, переопределение снаружи и варианты?

Функция cn

// lib/cn.ts
import { clsx, type ClassValue } from 'clsx';
import { twMerge } from 'tailwind-merge';
 
export function cn(...inputs: ClassValue[]) {
  return twMerge(clsx(inputs));
}
cn('px-4 py-2', isActive && 'bg-indigo-600 text-white', { 'opacity-50': disabled });
// clsx: склеивает строки, отбрасывает false/undefined, понимает объекты и массивы
 
cn('px-4 py-2', 'px-2');
// twMerge: 'py-2 px-2' — конфликтующий px-4 удалён, побеждает последний

Варианты через cva

// components/ui/button.tsx
import { cva, type VariantProps } from 'class-variance-authority';
import { cn } from '@/lib/cn';
import type { ComponentPropsWithRef } from 'react';
 
const buttonVariants = cva(
  // базовые классы
  'inline-flex items-center justify-center gap-2 rounded-lg font-medium transition-colors ' +
    'focus-visible:outline-2 focus-visible:outline-offset-2 disabled:pointer-events-none disabled:opacity-50',
  {
    variants: {
      variant: {
        primary: 'bg-indigo-600 text-white hover:bg-indigo-700',
        secondary: 'bg-zinc-100 text-zinc-900 hover:bg-zinc-200',
        ghost: 'hover:bg-zinc-100',
        danger: 'bg-red-600 text-white hover:bg-red-700',
      },
      size: {
        sm: 'h-8 px-3 text-sm',
        md: 'h-10 px-4',
        lg: 'h-12 px-6 text-lg',
      },
    },
    compoundVariants: [{ variant: 'ghost', size: 'sm', class: 'px-2' }],
    defaultVariants: { variant: 'primary', size: 'md' },
  },
);
 
type ButtonProps = ComponentPropsWithRef<'button'> & VariantProps<typeof buttonVariants>;
 
export function Button({ className, variant, size, ref, ...props }: ButtonProps) {
  return <button ref={ref} className={cn(buttonVariants({ variant, size }), className)} {...props} />;
}
<Button>Купить</Button>
<Button variant="danger" size="sm">Удалить</Button>
<Button variant="ghost" className="w-full">Подробнее</Button>  // className дополняет/переопределяет
<Button variant="pink">…</Button>                               // ✗ TS: такого варианта нет

VariantProps выводит типы пропсов из описания вариантов — автокомплит и проверка бесплатно.

Нельзя: динамические имена классов

// ✗ Tailwind не увидит bg-red-500 и bg-green-500 в исходниках → стилей не будет
<span className={`bg-${color}-500`} />
 
// ✓ Полные имена классов в коде
const colorClasses = { red: 'bg-red-500', green: 'bg-green-500' } as const;
<span className={colorClasses[color]} />
 
// ✓ Или CSS-переменная для произвольного значения
<span className="bg-(--tag-color)" style={{ '--tag-color': tag.color } as React.CSSProperties} />

Состояния и доступность через варианты Tailwind

<button
  aria-pressed={isFavorite}
  className="rounded-full p-2 aria-pressed:bg-amber-100 aria-pressed:text-amber-700 focus-visible:ring-2"
>
  ★
</button>
 
<input className="border data-[invalid=true]:border-red-500 peer" data-invalid={Boolean(error)} />
<p className="hidden peer-data-[invalid=true]:block text-red-600">{error}</p>

Стили, привязанные к ARIA- и data-атрибутам, заставляют держать состояние в разметке — это полезно и для скринридеров, и для тестов.

Организация кода

  • Повторяющиеся наборы классов — в компоненты (<Button>, <Card>), а не в @apply.
  • Токены (цвета, радиусы, шрифты) — в теме (@theme в Tailwind 4), а не захардкоженные значения.
  • Prettier-плагин prettier-plugin-tailwindcss сортирует классы — меньше шума в диффах.
  • Тёмная тема — вариант dark: с настройкой по классу или атрибуту.

Мини-шпаргалка

clsx — условные классы
tailwind-merge — убирает конфликты (px-4 + px-2 → px-2)
cn = twMerge(clsx(...)) — стандарт де-факто
cva — variants, sizes, compoundVariants, defaultVariants + VariantProps
Не собирать классы из кусков строк
aria-*/data-* варианты для состояний

Документация

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам