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.
<!-- 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.
# 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 --watchDirectives 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.
/* 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.
<!-- 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.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: [],
};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).
<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.
<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).
<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.
<!-- 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 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-*. -->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-*.
<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.
<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.
<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.
<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.
<!-- 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>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.
<!-- 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.
<!-- 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).
<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.
<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.
<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 -->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).
<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.
<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.
<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.
<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.
<!-- 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>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.
<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.
<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.
<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.
<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.
<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>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).
<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.
<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.
<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.
<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.
<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) -->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.
<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.
<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(...)].
<!-- 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.
<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).
<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>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.
<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 ».
<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.
<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.
<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.
<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>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.
<!-- 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.
<!-- 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.
<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.
<!-- 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.
<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>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.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.
<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.
// 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.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.
<!-- 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>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.
<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.
<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].
<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.
<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.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>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é.
<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.
<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.
<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.
<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.
<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>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.
<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.
<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.
<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.
<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.
<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>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.
<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.
<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.
<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.
<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.
<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" />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.
<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.
<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.
<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).
<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.
<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>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.
<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.
<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.
<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).
<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.
<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>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.
<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.
<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.
<!-- 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.
<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.
<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" />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.
<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.
<!-- 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.
<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 ».
<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.
<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>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.
<!-- 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.
<!-- 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.
<!-- 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.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.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>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é.
<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.
<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.
<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 ».
<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.
<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>Snippets Tailwind CSS associés
Copy-paste ready code for common tasks.
Utility Classes
Compose a button and card from atomic utilities.
Responsive Design
Apply per-breakpoint utilities with sm:, md:, and lg: prefixes.
Hover & Focus States
Style interactive states and group-hover with variant prefixes.
Flexbox & Grid
Center, distribute, and grid layouts with utilities.
Colors
Use the default palette, opacity modifiers, and gradients.
Spacing
Apply padding, margin, gap, and width/height from one scale.
Custom Configuration
Extend the theme with custom colors, fonts, and animations.
Dark Mode
Toggle themes with the dark: variant and class strategy.
Was this helpful?