Tailwind CSS avec Node.js et directives CSS

DéfinitionPourquoi 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éthodeMise en place rapide avec Node.js

Une fois Node.js installé, exécutez ces commandes à la racine du projet :

1
npm init -y
2
npm install tailwindcss @tailwindcss/cli

Créez un fichier source src/input.css et importez Tailwind :

1
@import "tailwindcss";

Lancez ensuite la compilation en mode surveillance (--watch) :

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

1
<!-- À supprimer : <script src="https://cdn.jsdelivr.net/npm/@tailwindcss/browser@4"></script> -->
2
<link rel="stylesheet" href="dist/output.css">

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

1
@import url('https://fonts.googleapis.com/css2?family=Poppins:wght@400;700&display=swap');
2
@import "tailwindcss";
3
4
@theme {
5
  --color-marque: #e11d48;
6
  --font-titre: "Poppins", sans-serif;
7
}

Les classes text-marque, bg-marque et font-titre deviennent immédiatement utilisables dans le HTML :

1
<h1 class="font-titre text-marque text-2xl font-bold">Mon site</h1>

ExempleCré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.).

1
@utility ombre-nette {
2
  box-shadow: 4px 4px 0px #000000;
3
}
1
<!-- L'ombre apparaît uniquement au survol de la souris -->
2
<button class="border border-black px-4 py-2 hover:ombre-nette">
3
  Survolez-moi
4
</button>
5
6
<!-- L'ombre s'affiche uniquement à partir de l'écran md (768 px) -->
7
<div class="border border-black p-4 md:ombre-nette">
8
  Carte avec ombre sur ordinateur
9
</div>

ExempleStructurer 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
/* 1. Style par défaut des balises HTML */
2
@layer base {
3
  h2 {
4
    @apply text-xl font-bold text-gray-800;
5
  }
6
}
7
8
/* 2. Classes de composants réutilisables */
9
@layer components {
10
  .btn {
11
    @apply px-4 py-2 rounded bg-blue-600 text-white font-semibold;
12
  }
13
}
1
<!-- Applique automatiquement le style de @layer base -->
2
<h2>Titre par défaut</h2>
3
4
<!-- Surchargé ponctuellement par une classe utilitaire -->
5
<h2 class="text-red-600">Titre en rouge</h2>
6
7
<!-- Applique le composant .btn défini dans @layer components -->
8
<button class="btn">Valider</button>
9
10
<!-- Grâce à @layer, une classe utilitaire peut modifier le composant -->
11
<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 avec hover: ou md:.

  • @layer et @apply : organisent les styles globaux (base) et factorisent les composants (components).

QCM 1 : Intérêt de Node.js par rapport au CDN

QCM 2 : Les directives @theme et @utility

QCM 3 : Organisation avec @layer et @apply