Tailwind CSS avec Node.js et directives CSS
Définition : Pourquoi utiliser Node.js plutôt que le CDN ?
La version CDN est idéale pour apprendre, mais elle compile le CSS directement dans le navigateur à chaque chargement de page.
Passer à Node.js permet de compiler le CSS à l'avance et apporte trois avantages majeurs :
Performance : Tailwind analyse vos fichiers HTML et génère un fichier CSS très léger contenant uniquement les classes utilisées ;
Personnalisation : accès aux directives CSS avancées de Tailwind v4 (
@theme,@utility,@layer,@apply) ;Production : aucune dépendance à un script externe lors de la mise en ligne.
Méthode : Mise en place rapide avec Node.js
Une fois Node.js installé, exécutez ces commandes à la racine du projet :
npm init -y
npm install tailwindcss @tailwindcss/cliCréez un fichier source src/input.css et importez Tailwind :
@import "tailwindcss";
Lancez ensuite la compilation en mode surveillance (--watch) :
npx @tailwindcss/cli -i src/input.css -o dist/output.css --watch
Dans le <head> du HTML, remplacez le script CDN par la feuille de style générée :
<!-- À supprimer : <script src="https://cdn.jsdelivr.net/npm/@tailwindcss/browser@4"></script> --><link rel="stylesheet" href="dist/output.css">
Exemple : Personnaliser le thème avec @theme
Avec Tailwind v4, la configuration du design system se fait directement en CSS grâce à @theme. Chaque variable déclarée génère automatiquement de nouvelles classes utilitaires.
Pour intégrer des polices externes, sélectionnez-les sur Google Fonts, copiez le lien @import (via Get embed code) et placez-le tout en haut de src/input.css :
@import url('https://fonts.googleapis.com/css2?family=Poppins:wght@400;700&display=swap');
@import "tailwindcss";
@theme {--color-marque: #e11d48;
--font-titre: "Poppins", sans-serif;
}
Les classes text-marque, bg-marque et font-titre deviennent immédiatement utilisables dans le HTML :
<h1 class="font-titre text-marque text-2xl font-bold">Mon site</h1>
Exemple : Créer des utilitaires avec @utility
Contrairement à une classe CSS classique, une classe déclarée avec @utility est reconnue par Tailwind. Elle peut donc être combinée avec tous ses préfixes (hover:, md:, etc.).
@utility ombre-nette {
box-shadow: 4px 4px 0px #000000;
}
<!-- L'ombre apparaît uniquement au survol de la souris --><button class="border border-black px-4 py-2 hover:ombre-nette">
Survolez-moi
</button>
<!-- L'ombre s'affiche uniquement à partir de l'écran md (768 px) --><div class="border border-black p-4 md:ombre-nette">
Carte avec ombre sur ordinateur
</div>
Exemple : Structurer ses règles avec @layer et @apply
Tailwind organise le CSS en trois couches prioritaires : base, puis components, puis utilities. Placer vos règles dans ces couches garantit que les classes utilitaires pourront toujours les surcharger dans le HTML :
@layer base: définit l'apparence par défaut des balises HTML (h2,a,body...) ;@layer components: regroupe des classes de composants réutilisables (.btn,.card...) grâce à@apply.
/* 1. Style par défaut des balises HTML */@layer base {
h2 {@apply text-xl font-bold text-gray-800;
}
}
/* 2. Classes de composants réutilisables */@layer components {
.btn {@apply px-4 py-2 rounded bg-blue-600 text-white font-semibold;
}
}
<!-- Applique automatiquement le style de @layer base --><h2>Titre par défaut</h2>
<!-- Surchargé ponctuellement par une classe utilitaire --><h2 class="text-red-600">Titre en rouge</h2>
<!-- Applique le composant .btn défini dans @layer components --><button class="btn">Valider</button>
<!-- Grâce à @layer, une classe utilitaire peut modifier le composant --><button class="btn bg-red-600">Supprimer</button>
Remarque : À retenir
Node.js + CLI : génère un fichier CSS optimisé pour la production et active le préprocesseur Tailwind v4.
@theme: définit les variables du design system (couleurs, polices Google Fonts...) qui créent automatiquement de nouvelles classes.@utility: ajoute des classes utilitaires personnalisées compatibles avechover:oumd:.@layeret@apply: organisent les styles globaux (base) et factorisent les composants (components).