Skip to content

Tailwind CSS Aide-mémoire

Framework CSS utility-first pour un développement d'interface rapide.

01

Premiers pas

Installation via CDN

Le script CDN est la façon la plus rapide de prototyper avec Tailwind. Il génère les utilitaires à l'exécution en scannant votre balisage. Pour la production, préférez la build PostCSS ou CLI pour purger les classes inutilisées et livrer un petit bundle 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>

Mise en place du projet (CLI)

Le tableau content est critique — Tailwind ne génère que les classes qu'il trouve dans ces fichiers (tree-shaking). Oublier un chemin est la cause n°1 des bugs « ma classe manque ». Utilisez --watch pendant le développement.

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

Directives du CSS d'entrée

Les directives @tailwind injectent les trois couches de Tailwind dans l'ordre : base (resets), components, utilities. @layer permet d'ajouter votre propre CSS dans la bonne couche de cascade. @apply inline les styles d'utilitaires dans une règle custom.

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; }
}

Modèle mental utility-first

La philosophie de Tailwind : bâtir des UI en composant de petites classes utilitaires mono-usage plutôt que d'inventer des noms de classes sémantiques. Cela garde le CSS plat, évite le code mort et rend les designs cohérents grâce à une échelle partagée d'espacement/couleurs.

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

Config et extension de thème

Utilisez theme.extend pour ajouter aux défauts de Tailwind sans les remplacer. Définir une clé au premier niveau de theme (pas extend) remplace entièrement cette échelle. Des couleurs custom comme brand-500 génèrent bg-brand-500, text-brand-500, border-brand-500, etc.

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

Couleurs

Couleurs de texte, fond et bordure

Les utilitaires de couleur suivent le motif {propriété}-{couleur}-{nuance}. Les nuances vont de 50 (la plus claire) à 950 (la plus sombre). Propriétés courantes : text-, bg-, border-, ring-, fill-, stroke-, from-/to-/via- (dégradés).

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>

Modificateurs d'opacité

Ajoutez /{opacité} à n'importe quel utilitaire de couleur pour régler son canal alpha. Sous le capot, cela utilise color-mix ou rgba et marche pour text, bg, border, ring, etc. La façon la plus propre de teinter sans définir de nouvelles entrées de palette.

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>

Dégradés

Utilisez bg-gradient-to-{direction} avec des stops de couleur from-, via- et to-. Les directions incluent t (haut), b, l, r, tr, tl, br, bl. Pour les dégradés radial/conique (v3.3+), utilisez bg-gradient-radial (exige un plugin ou une valeur arbitraire).

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>

Couleurs custom et arbitraires

Les valeurs arbitraires entre crochets permettent d'utiliser n'importe quelle couleur CSS sans éditer la config — parfait pour des usages uniques. Pour des couleurs utilisées de façon répétée, définissez-les dans theme.extend.colors pour bénéficier du support des modificateurs d'opacité et d'un nommage cohérent.

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>

Aperçu de la palette

La palette de Tailwind remplace le « gray » générique par quatre familles neutres : slate (bleu froid), gray, zinc, neutral et stone (chaud). Choisissez-en une pour tout le projet pour des neutres cohérents. Chaque couleur a 11 nuances (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

Typographie

Taille et graisse de police

text-{taille} mappe vers une échelle en rem (text-base = 1rem). font-{graisse} couvre 100-900. Les valeurs arbitraires comme text-[42px] marchent aussi. L'interligne s'adapte automatiquement à la taille de texte sauf surcharge avec 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>

Interligne et espacement des lettres

leading-* règle line-height (numérique = rem, nommé = relatif). tracking-* règle l'espacement des lettres. Associez uppercase + tracking-wider + text-xs pour des labels style petites capitales — un idiome Tailwind très courant.

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>

Alignement et décoration du texte

text-{left,center,right,justify} aligne le contenu en ligne. underline/line-through/no-underline basculent la décoration ; decoration-{1-4} règle l'épaisseur, underline-offset-{n} la position. Le motif hover:underline est le standard des liens de navigation.

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>

Familles de polices et polices arbitraires

Trois piles de polices fournies par défaut : sans (UI système), serif, mono. Ajoutez-en dans theme.extend.fontFamily (ex. display, body). Pour des polices arbitraires ponctuelles, utilisez font-['Nom']. Pensez à @import ou <link> la vraie police web dans votre 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>

Débordement et troncature du texte

truncate = overflow-hidden text-ellipsis whitespace-nowrap (une ligne + points de suspension). line-clamp-{1-6} bride à N lignes (utilise -webkit-line-clamp). Pour un flux libre, utilisez break-words ou break-all pour contrôler la coupure des mots longs.

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

Espacement

Padding et margin

Les utilitaires d'espacement utilisent une seule échelle basée sur 4px : 1 = 0.25rem = 4px. p* / m* pour tous les côtés, px/py pour les paires d'axes, pt/pr/pb/pl ou mt/mr/mb/ml par côté. mx-auto centre les éléments bloc horizontalement.

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>

L'échelle d'espacement

Une seule échelle gouverne padding, margin, gap, width, height et plus — cette cohérence est le superpouvoir de Tailwind. Utilisez des valeurs négatives (-mt-2) pour les chevauchements et tirages. Les valeurs arbitraires p-[13px] échappent à l'échelle au besoin mais devraient rester rares.

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>

Espacement entre enfants

space-x-* / space-y-* ajoutent une marge entre frères (pas autour) — parfait pour des piles verticales et des rangées de badges. Note : space-x utilise margin-left, donc il se marie mal avec flex justify ; pour flex, préférez l'utilitaire gap-* (voir 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 -->

Width et height

w-* / h-* utilisent l'échelle d'espacement plus des fractions (1/2, 1/3, 2/3, 1/4...), screen/ full, et des tailles nommées (xs..7xl pour max-width). max-w-{taille} plafonne la largeur — enveloppez le contenu de page dans max-w-md mx-auto pour des lignes lisibles. w-fit / w-max utilisent le dimensionnement intrinsèque.

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 pour flex et grid

gap-* est la façon moderne d'espacer les enfants flex/grid — remplace l'ancienne approche par marges space-x/space-y. Réglez gap pour les deux axes, ou gap-x/gap-y individuellement. Utilise la même échelle d'espacement que 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

Conteneur flex de base

flex règle display:flex ; inline-flex règle display:inline-flex. flex-col bascule l'axe principal en vertical — combiné à gap, c'est la façon la plus propre de bâtir des piles verticales. La direction par défaut est row (horizontale).

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 et align

justify-* contrôle l'axe principal (horizontal en flex-row) ; items-* l'axe transversal (vertical en flex-row). La combinaison « flex justify-center items-center » centre le contenu dans les deux sens — l'extrait Tailwind le plus utilisé pour centrer.

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 et basis

flex-1 = flex:1 1 0 % (croît pour remplir, peut rétrécir, basis 0). flex-none = ne croît ni ne rétrécit (fixe). flex-grow-0 / flex-shrink-0 désactivent croissance/rétrécissement individuellement. basis-{n} règle la taille initiale avant croissance.

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 et order

flex-wrap laisse les enfants couler vers de nouvelles lignes (défaut nowrap déborde). order-{n} réordonne visuellement les enfants sans changer le DOM — order-first/last sont des raccourcis. Utile pour des mises en page responsives où l'ordre visuel varie par breakpoint.

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>

Patterns de centrage

flex items-center justify-center est l'extrait de centrage canonique — marche pour toute taille de contenu. Le pattern de footer collant (min-h-screen + flex-col + flex-1 sur main) pousse le footer en bas même avec peu de contenu.

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 de base

grid règle display:grid. grid-cols-{n} définit un compte fixe de colonnes (1-12). auto-rows-fr rend chaque ligne de hauteur égale (1fr chacune). gap-* marche comme en flex pour espacer les pistes.

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>

Colonnes responsives

Le pattern auto-fit + minmax est une astuce responsive puissante : les colonnes font au moins 200px et s'étirent pour remplir la ligne, en se repliant automatiquement — sans media queries. Combinez avec des grid-cols-* responsives explicites pour plus de contrôle.

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>

Span de colonnes et lignes

col-span-{n} / row-span-{n} font couvrir à un élément plusieurs pistes. col-start-{n} / col-end-{n} placent les éléments sur des lignes de grille explicites. Ensemble, ils permettent des mises en page complexes façon magazine sans media queries.

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 via valeurs arbitraires

Les valeurs arbitraires entre crochets permettent toute syntaxe de grid-template : grid-cols-[200px_1fr_100px] crée trois pistes de largeurs custom (les underscores deviennent des espaces). Les grid-template-areas nommées ne sont pas un utilitaire intégré — définissez-les dans une classe custom ou utilisez la mise en page via spans col/row.

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 et alignement

justify-items-* / content-* contrôlent comment les éléments se posent dans leurs cellules et comment les pistes se posent dans le conteneur. place-items-center est le raccourci de justify-items + items-content (les deux axes). place-content-center centre tout le bloc de grille.

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

Bordures

Largeur et couleur de bordure

border règle 1px sur tous les côtés ; border-{2,4,8} l'épaisseur. border-{t,r,b,l,x,y} visent des côtés précis. border-dashed/dotted/double règlent le style. Associez toujours border-{couleur} — la couleur de bordure par défaut de Tailwind est gray-200 (changée de gray-300 en v3).

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>

Rayon de bordure

rounded-{none,sm,md,lg,xl,2xl,3xl,full} mettent à l'échelle le rayon ; rounded-full fait des pilules ou des cercles parfaits (quand width = height). Par coin : rounded-{tl,tr,bl,br}-{taille}, par côté : rounded-{t,b,l,r}-{taille}. Les cercles d'avatar utilisent rounded-full + w/h égaux.

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 entre enfants

divide-{x,y} ajoute des bordures entre frères — bien plus propre que styler chaque enfant avec border-t. divide-{couleur} et divide-{largeur} les personnalisent. Associez py/px aux enfants pour un espacement confortable dans listes et tables.

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 (façon outline)

Les rings sont des outlines basés sur box-shadow qui n'affectent pas la mise en page (contrairement aux bordures) et se superposent joliment. ring-{n} règle la largeur, ring-{couleur} la couleur, ring-offset-{n} ajoute de l'espace entre l'élément et le ring. Le pattern focus:ring est le style de focus accessible standard.

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-* utilise la vraie propriété CSS outline (hors de la boîte de bordure, sans impact de mise en page). Le ring est préféré dans Tailwind car c'est un box-shadow en couches — plusieurs rings peuvent s'empiler et ring-offset donne un espace propre. L'outline sert quand on a explicitement besoin du comportement outline CSS.

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

Fonds

Couleur et attachement du fond

bg-{couleur} règle background-color, avec /{opacité} pour l'alpha. bg-fixed crée un effet parallaxe (le fond reste en place pendant que le contenu défile). bg-clip-{padding,border,content} contrôle jusqu'où le fond s'étend sous bordures/contenu.

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>

Image et dégradé de fond

Utilisez bg-[url('/chemin/vers/img.jpg')] pour background-image avec des URLs arbitraires (quoter l'URL). bg-cover remplit l'élément en gardant le ratio ; bg-contain fait tenir toute l'image. bg-{center,top,bottom,left,right} et bg-{repeat,no-repeat,repeat-x,repeat-y} contrôlent le positionnement.

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>

Direction et stops du dégradé

from-/via-/to- règlent les stops de couleur du dégradé ; bg-gradient-to-{direction} l'angle. Les directions diagonales comme to-br sont courantes pour des dégradés de héros chaleureux. Les dégradés natifs radial/conique exigent un plugin ou une valeur arbitraire : 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>

Taille et position du fond

bg-cover vs bg-contain est le choix clé pour les images de héros et logos respectivement. Cover remplit la boîte (rogne le débordement) ; contain fait tenir toute l'image (peut laisser de l'espace vide). Combinez bg-cover + bg-center pour l'image de héros responsive standard.

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>

Modes de mélange du fond

bg-blend-{mode} contrôle comment plusieurs couches de fond (image + couleur) se compositent. multiply, screen, overlay, darken, lighten sont courants. Pour assombrir des images pour la lisibilité du texte, l'approche plus propre est un dégradé semi-transparent par-dessus (exemple de droite).

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

Ombres

Échelle de box shadow

L'échelle d'ombres (sm, défaut, md, lg, xl, 2xl) donne une élévation cohérente dans toute l'app. shadow-inner crée une ombre interne utile pour les puits et états enfoncés. Les cartes utilisent typiquement shadow-md avec hover:shadow-lg pour un effet de soulèvement.

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>

Ombres colorées

shadow-{couleur} teinte le box shadow avec une couleur (même palette). Combiné à /{opacité}, il crée des effets de halo. Les ombres colorées sont un moyen rapide de rendre boutons et accents plus vibrants et « de marque ».

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>

Pattern de soulèvement au survol

hover:shadow-{plus-grande} combiné à transition-shadow est le pattern standard de survol de carte. Accouplez-le à hover:-translate-y-0.5 et active:translate-y-0 pour un retour physique d'appui sur les boutons — une finition d'interaction petite mais satisfaisante.

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 (pour SVG/texte)

drop-shadow utilise filter:drop-shadow() CSS qui suit la vraie forme de l'élément (génial pour SVG et PNG avec transparence), contrairement à box-shadow qui n'ombre que la boîte. drop-shadow-md sur du texte est une alternative plus douce à 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>

Ombres arbitraires et en couches

Pour des ombres hors de l'échelle par défaut, utilisez la syntaxe de valeur arbitraire shadow-[...]. Pour des ombres en couches complexes (celles qui paraissent vraiment premium), il est plus propre de les définir une fois dans une classe CSS custom — les ombres mono-couche de Tailwind ne peuvent pas égaler cette profondeur.

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

Design responsive

Breakpoints

Tailwind est mobile-first : les styles de base s'appliquent partout, les préfixes de breakpoint au min-width. L'ordre compte — écrivez les classes du plus petit au plus grand (text-sm md:text-base lg:text-lg). Les breakpoints correspondent aux largeurs d'appareils courantes et sont configurables.

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 responsives

Le pattern flex-col md:flex-row est l'épine dorsale des mises en page responsives : empilé vertical sur mobile, côte à côte sur bureau. Accouplez-le à des grid-cols-* responsives pour les grilles de cartes. Concevez d'abord la mise en page mobile, puis améliorez vers le haut.

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>

Conteneur et largeur max

container centre le contenu avec des max-width responsives à chaque breakpoint (centrage + padding à ajouter manuellement). Le pattern manuel « max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 » est l'enveloppe de page la plus courante. Pour les articles, plafonnez à max-w-2xl/3xl pour des lignes lisibles.

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>

Montrer/cacher par breakpoint

hidden md:block / block md:hidden est le pattern canonique pour basculer des éléments entre mobile et bureau (ex. menu hamburger vs nav complète). print:block n'apparaît qu'à l'impression. Les breakpoints arbitraires comme min-[1200px]: permettent de viser des largeurs custom.

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>

Typographie et espacement responsives

Augmentez typographie et espacement à chaque breakpoint pour une hiérarchie visuelle. Pour une typo vraiment fluide, utilisez clamp() via valeur arbitraire : text-[clamp(2rem,5vw,4rem)] — le titre croît en douceur avec le viewport entre min et max.

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

Mode sombre

Activer le mode sombre (stratégie class)

Par défaut Tailwind utilise prefers-color-scheme (media). Régler darkMode:'class' permet de basculer le mode sombre en ajoutant la classe 'dark' à un parent (typiquement <html>) — nécessaire aux sélecteurs de thème. darkMode:'selector' (v3.4+) est similaire mais supporte des sélecteurs custom.

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>

Variantes sombres

Préfixez tout utilitaire de dark: pour ne l'appliquer qu'en mode sombre. Le pattern : écrire d'abord le style clair, puis les surcharges dark:. Soyez systématique : appariez chaque bg-*, text-*, border-* à un équivalent dark:* pour que rien ne paraisse cassé en mode sombre.

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>

Script de bascule de thème

Mettez ce script inline dans <head> avant le rendu de la page pour éviter un flash du mauvais thème (FOUC). Il vérifie d'abord localStorage, puis retombe sur la préférence de l'OS. La bascule ne fait que retourner la classe et persister le choix.

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';
}

Préférence système seulement

Si vous n'avez pas besoin de bascule manuelle, darkMode:'media' (le défaut) suit le réglage de l'OS de l'utilisateur sans aucun JavaScript. Plus simple, mais on perd la possibilité de surcharger la préférence. À utiliser pour les sites de contenu où respecter le choix de l'OS suffit.

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

Bonnes pratiques du mode sombre

Un bon mode sombre n'est pas qu'une inversion de couleurs : utilisez du gris sombre (gray-900) plutôt que du noir pur pour les fonds, du blanc cassé (gray-100) plutôt que du blanc pur pour le texte, assombrissez légèrement les images, et réduisez ou retirez les ombres. Les couleurs de marque saturées demandent souvent d'être éclaircies (blue-600 -> blue-500) en mode sombre.

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

Animations et transitions

Transitions

transition-{propriété} définit quelles propriétés s'animent ; duration-{ms} le temps ; ease-{in,out,in-out} la fonction de timing. transition-colors est le plus courant (moins cher que transition-all). Ajoutez toujours transition avant le changement hover:* sinon il saute.

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>

Propriétés de transition

Préférez des transitions spécifiques (transition-colors, transition-transform) à transition-all pour la performance — all surveille chaque propriété et peut causer des accrocs. duration-* utilise 75/100/150/200/300/500/700/1000ms. ease-out paraît naturel pour les éléments d'UI qui apparaissent.

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>

Animations intégrées

Tailwind livre quatre animations keyframe : spin (loader), ping (point de notification qui s'étend), pulse (fondu d'opacité — parfait pour les loaders squelettes), bounce (espiègle). Pour des animations custom, définissez les keyframes dans la config et référencez via animate-[nom].

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- se composent tous et s'animent en douceur avec transition-transform. Utilisez origin-{center,top,bottom-left,...} pour changer l'origine du transform. Les flourishes de survol de cartes (scale + légère rotation + soulèvement) paraissent premium quand ils restent subtils.

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>

Animations custom via la config

Définissez des keyframes et noms d'animation custom dans theme.extend. La valeur d'animation est un raccourci : '{nom} {durée} {timing} {itération}'. Une fois définie, animate-{nom} devient un utilitaire normal. Gardez les keyframes petits — ils partent dans votre bundle 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

Formulaires

Champs de saisie

Le pattern d'input standard : w-full pour la pleine largeur, padding, bordure, rounded, et un anneau de focus qui retire l'outline par défaut. focus:border-transparent cache la bordure de focus native ; focus:ring-2 dessine un indicateur de focus accessible net. Stylez toujours l'état désactivé pour la clarté.

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>

Checkboxes et radios

text-{couleur} sur checkboxes/radios règle la couleur cochée (utilise accent-color sous le capot). focus:ring-* ajoute l'indicateur de focus clavier. Pour des toggles custom, utilisez le pattern peer-* avec une checkbox cachée pour piloter le style, ou un plugin comme @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 et options

Le style natif de <select> est limité entre navigateurs ; pour un contrôle total, utilisez un composant dropdown custom ou une bibliothèque comme Headless UI. Le plugin @tailwindcss/forms donne à tous les éléments de formulaire une base cohérente et facilement thémable — à installer pour toute app riche en formulaires.

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>

Mise en page de formulaire

space-y-4 est la façon la plus propre d'espacer les lignes d'un formulaire — pas de marges par champ nécessaires. Accouplez chaque input à un <label class='block text-sm font-medium mb-1'> pour un style de label cohérent. Enveloppez dans max-w-md pour garder une largeur de formulaire lisible sur bureau.

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>

Boutons

Les boutons méritent des variantes active: (enfoncé), disabled: (état) et focus: (clavier) — pas seulement hover. active:bg-{plus-sombre} donne un retour physique. disabled:opacity-50 disabled:cursor-not-allowed est le traitement désactivé standard. Gardez une hauteur cohérente (ex. py-2) entre les variantes de bouton.

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

Cartes

Carte de base

La carte canonique : rounded + shadow + overflow-hidden (pour que les coins de l'image se rognent joliment). object-cover sur l'image prévient la déformation. hover:shadow-lg avec transition-shadow donne l'effet de soulèvement. overflow-hidden est clé pour les hauts d'images arrondis.

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>

Grille de cartes

Pour les grilles de cartes, utilisez le pattern auto-fill + minmax : les cartes font au moins 280px et s'étirent pour remplir, en se repliant automatiquement — sans media queries. Pour des comptes de colonnes fixes à des breakpoints connus, l'approche grid-cols-* responsive est plus simple à raisonner.

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>

Carte interactive (entièrement cliquable)

Envelopper toute la carte dans un <a> la rend entièrement cliquable (meilleure UX qu'un bouton « Lire la suite » séparé). Le pattern group + group-hover permet d'animer des éléments enfants (couleur du titre, position de la flèche) au survol du parent — puissant pour les cartes interactives.

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>

Carte avec footer

Utilisez flex flex-col sur la carte et flex-1 sur le corps pour que le footer reste en bas même quand les corps de cartes ont des longueurs différentes — garde une rangée de cartes alignée. Le footer porte typiquement métadonnées et actions avec un fond subtil et une bordure supérieure.

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>

Carte profil / avatar

Avatar + nom + action est le pattern standard de carte-ligne. Utilisez flex items-center gap-4 pour les aligner. Pour les points de statut, position absolue bas-droite avec un ring matchant le fond de la carte pour « découper » le point. Les avatars utilisent rounded-full + w/h égaux + 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

Patterns de mise en page

Position

relative + absolute est le cheval de bataille : position:relative sur un parent et position:absolute sur un enfant pour le placer précisément. inset-0 = top/right/bottom/left:0 (remplit le parent). sticky top-0 est essentiel pour les en-têtes collants — le parent doit être assez haut pour défiler.

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 et empilement

Tailwind fournit z-0/10/20/30/40/50 plus z-auto. Utilisez une convention cohérente : 0 = base, 10 = dropdowns, 20 = sticky, 30 = modales, 40 = overlays, 50 = toasts/tooltips. Les modales exigent à la fois un z-index élevé ET fixed inset-0 pour couvrir le viewport.

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 sont les bases. inline-block sert aux éléments ayant besoin de width/height mais devant rester en ligne. hidden retire de la mise en page entièrement (vs opacity-0 qui garde l'espace). Basculez avec des préfixes de breakpoint pour montrer/cacher de façon responsive.

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 rogne le contenu (sert aussi à faire clipper les enfants par les coins arrondis). overflow-auto ajoute des barres de défilement seulement si nécessaire ; overflow-x-auto avec whitespace-nowrap est le pattern standard de défilement horizontal pour les rangées de nav et blocs de code.

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 et clear

Les floats sont largement remplacés par flexbox/grid pour la mise en page, mais float-left + mr-4 marche encore bien pour l'habillage de texte autour des images. Pour la plupart des besoins de dimensionnement d'images, object-cover (remplit, peut rogner) ou object-contain (tient, peut letterboxer) sur un img dimensionné est l'approche moderne.

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

Effets et filtres

Backdrop blur (glassmorphism)

backdrop-blur-* floute ce qui est derrière l'élément (pas l'élément lui-même) — combiné à un fond translucide (bg-white/30) il crée l'effet glassmorphism. Parfait pour modales, en-têtes collants au-dessus du contenu et panneaux givrés style 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>

Filtres d'images

Les utilitaires de filtre mappent aux fonctions CSS filter : blur, brightness, contrast, grayscale, invert, sepia, saturate, hue-rotate. Le pattern grayscale hover:grayscale-0 est un effet populaire pour photos d'équipe et produits — la couleur apparaît au survol.

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 contrôle comment un élément se mélange à ce qui est derrière. mix-blend-difference sur du texte blanc au-dessus d'une image crée un effet à fort contraste lisible quel que soit l'image sous-jacente — populaire pour les sections héros. Avec parcimonie ; ça peut paraître gadget.

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>

Opacité

opacity-{0,25,50,75,100} (plus 5/10/20/.../95) règle l'opacité de l'élément — affecte l'élément ET ses enfants. Pour un simple fond translucide, utilisez bg-{couleur}/{opacité} à la place, qui garde le texte pleinement opaque. opacity-0 cache mais préserve la mise en page (vs hidden qui la retire).

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

Curseur et sélection utilisateur

Accordez toujours le curseur au comportement : cursor-pointer pour du cliquable, cursor-not-allowed pour du désactivé. select-none désactive la sélection de texte (utile pour l'habillage d'UI et les boutons sensibles au double-clic). resize-none sur les textareas prévient la poignée de redimensionnement par défaut quand on veut une mise en page cohérente.

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

Transitions et transforms

Origine et échelle de transform

origin-* règle le point d'origine du transform. scale-x-* / scale-y-* mettent à l'échelle indépendamment par axe. transform-gpu force l'accélération GPU (translate3d) pour des animations plus douces — à utiliser en cas d'accrocs sur des éléments riches en transforms comme les carrousels.

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

translate-{x,y}-{n} déplace l'élément avec l'échelle d'espacement (ou utilisez /2 pour 50 % via -translate-x-1/2). Le pattern left-1/2 + -translate-x-1/2 centre parfaitement un élément positionné en absolu quelle que soit sa largeur — utile pour tooltips et modales.

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 et transforms 3D

Skew incline un élément le long d'un axe — utile pour des effets subtils de parallélogramme. Les transforms 3D (perspective, rotate-y, rotate-x, transform-style-3d) exigent une extension de thème dans le Tailwind par défaut mais permettent effets de retournement de carte et parallaxe. La plupart des projets utilisent juste du 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>

Délai et timing de transition

delay-{ms} retarde le début d'une transition — combinez avec des délais par enfant pour créer des entrées décalées (chaque élément démarre un peu plus tard). ease-out paraît naturel pour ce qui apparaît (décélère en place), ease-in pour ce qui disparaît (accélère en s'éloignant).

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>

États hover vs focus vs active

Considérez toujours focus (utilisateurs clavier) et active (clic maintenu) en plus de hover. focus-visible: ne s'applique qu'au focus clavier (pas au clic souris) — généralement ce qu'on veut pour les anneaux de focus. group + group-hover: laisse le survol du parent piloter le style de l'enfant — essentiel pour les cartes et survols complexes.

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

Dimensionnement

Échelle de largeur

w-* utilise l'échelle d'espacement plus des fractions (1/2, 1/3, 2/3, 1/4, 3/4, 1/5, ..., 1/12) pour les pourcentages. w-full = 100 %, w-screen = 100vw, w-fit = largeur intrinsèque, w-max = max-content. Utilisez w-full + max-w-{taille} pour du contenu responsive plafonné à une largeur lisible.

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>

Height et viewport

h-screen = 100vh, qui pose des problèmes de barre d'adresse sur mobile. Préférez h-dvh (hauteur de viewport dynamique) pour des mises en page pleine hauteur compatibles mobile — il s'ajuste quand l'habillage du navigateur s'affiche/se cache. min-h-screen est le standard des mises en page à footer collant.

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>

Largeur min/max

max-w-{xs,sm,md,lg,xl,2xl,...,7xl} mappent à des tailles en rem idéales pour la largeur de contenu. Envelopper le contenu de page dans max-w-7xl mx-auto est standard. min-w-0 est une astuce flexbox critique — elle laisse les enfants flex rétrécir sous leur taille intrinsèque pour prévenir le débordement.

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>

Ratio d'aspect

aspect-{ratio} maintient un ratio fixe quelle que soit la largeur — bien plus propre que la vieille astuce padding-bottom. aspect-video est le standard des embeds vidéo. Combinez à object-cover pour remplir la boîte sans déformation. Les ratios arbitraires comme aspect-[21/9] marchent aussi.

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 et position

object-fit sur <img> (et <video>) contrôle comment la source remplit sa boîte : cover (remplit, rogne), contain (tient, letterboxe), fill (étire), none (taille d'origine). Accouplez à object-{position} pour contrôler quelle partie est gardée au rognage. object-cover + object-center est le défaut des images de héros.

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

Interactivité et états

Hover, focus et group

group transforme un élément en source d'état ; group-hover:* applique un style à un enfant au survol du parent. Crucial pour les cartes où le survol de la carte affecte image, titre et action cachée d'un coup. Les groupes nommés (group/card) permettent l'imbrication.

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 (état de frère)

peer marque un élément comme source d'état pour ses FRÈRES (seulement les frères suivants, par défaut). peer-checked:* permet de styler les frères selon l'état d'une checkbox/radio — alimente des toggles en pur CSS, boutons de révélation de mot de passe et accordéons sans 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 (clavier seulement)

Utilisez focus-visible: au lieu de focus: pour les anneaux de focus — il montre l'anneau seulement aux utilisateurs clavier (qui en ont besoin) et le cache aux clics souris (qui ont leur propre retour visuel). Accouplez à focus:outline-none pour supprimer l'anneau par défaut du navigateur.

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 et input fichier

placeholder-* style le texte du placeholder. file:* style le pseudo-bouton dans <input type='file'> — un élément notoirement difficile à styler, mais la variante file: de Tailwind le rend traitable. Le pattern ci-dessus donne un bouton d'upload propre et « de marque ».

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 et sélection

marker:* style les puces/nombres de listes. selection:* la surbrillance quand les utilisateurs sélectionnent du texte. first-letter:* / first-line:* permettent lettrines et premières lignes en petites capitales — utile pour les designs éditoriaux. Tous ces pseudo-éléments ont des variantes Tailwind dédiées.

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

Valeurs arbitraires et personnalisation

Valeurs arbitraires

Les crochets permettent toute valeur CSS sans étendre le thème — parfait pour des usages uniques. Les underscores dans les valeurs deviennent des espaces (grid-cols-[200px_1fr] devient '200px 1fr'). L'abus mène à un design incohérent ; préférez l'extension de thème pour les valeurs répétées.

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>

Propriétés arbitraires

[propriété:valeur] définit une propriété CSS arbitraire — utile pour les propriétés sans utilitaires Tailwind (mask-type, hyphens, etc.). [--var:valeur] règle une variable CSS ensuite référençable dans des valeurs arbitraires comme p-[var(--tw)]. Puissant pour le theming.

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>

Variantes arbitraires

Les variantes arbitraires étendent le système de variantes de Tailwind : min-[1200px]: pour des breakpoints custom, aria-*: pour les états ARIA, odd:/even: pour le zébrage, has-[:checked]: pour le stylage relationnel. La variante has-* (fonctionnalité CSS récente) est particulièrement puissante pour styler des parents selon l'état d'un enfant.

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>

Extension de thème

theme.extend ajoute aux défauts ; theme.{clé} les remplace. DEFAULT permet d'utiliser le nom de base (bg-brand) plus des nuances (bg-brand-dark). Ajoutez espacement, breakpoints, rayons, etc. custom. Étendre est presque toujours ce qu'on veut — remplacer la palette de couleurs retire les défauts de 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>

Plugins et @apply

Les plugins ajoutent des utilitaires ou composants (forms, typography, aspect-ratio sont officiels). @apply permet d'inliner des utilitaires Tailwind dans du CSS custom — utile quand une classe s'utilise identiquement en dizaines d'endroits. N'abusez pas de @apply ; l'approche utility-first est généralement plus propre.

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

Patterns du monde réel

Modale / dialogue

Anatomie d'une modale : overlay fixed inset-0 (couvre le viewport), z-50 (au-dessus de tout), centrage flex pour le panneau, et le panneau lui-même positionné en relatif pour siéger au-dessus de l'overlay. backdrop-blur ajoute de la finition. Fournissez toujours un bouton de fermeture visible et ESC-pour-fermer pour l'accessibilité.

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>

Toast / notification

Les toasts se fixent à un coin (bas-droite par convention), largeur plafonnée, avec une bordure gauche colorée indiquant le type (vert=succès, rouge=erreur, jaune=avertissement, bleu=info). Accouplez à une animation pilotée par JS (entrée glissée via translate-x) et auto-dismiss après quelques secondes.

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>

Badge et pilule

Les badges sont des pilules inline-flex (rounded-full) ou des labels (rounded). Utilisez bg-{couleur}-100 + text-{couleur}-800 pour le style pastel doux. Ajoutez un point (w-1.5 h-1.5 rounded-full) pour les indicateurs de statut. Gardez text-xs font-medium pour l'échelle de texte des badges.

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>

État vide

Les états vides exigent : une icône dans un cercle doux, un titre court, un texte de soutien et un CTA principal. Centrez tout (text-center mx-auto), utilisez un padding généreux py-12, et atténuez les couleurs (texte gray-400/500) pour que le bouton CTA attire l'œil. N'affichez pas seulement « Pas de données ».

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>

Squelette de chargement

Les loaders squelettes utilisent animate-pulse sur un conteneur de blocs gris façonnés comme le vrai contenu. Matchez la mise en page et les proportions de l'état chargé pour éviter un décalage brutal à l'arrivée des données. rounded-full + w-10 h-10 imite un avatar ; des largeurs variées (w-3/4, w-1/2) imitent des lignes de texte.

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.