Importer un site Tailwind dans Figma en gardant l'échelle d'espacement
De Tailwind à Figma sans perdre l'échelle d'espacement : lisez l'unité de base, convertissez les rem en px et recréez les paliers en variables numériques Figma.
Introduction
Quand vous importez un site Tailwind dans Figma, les valeurs d'espacement arrivent sous forme de nombres simples, mais l'échelle qui les sous-tend n'arrive pas. Pour la conserver, notez l'unité de base du site, convertissez les rem en px une seule fois et recréez les paliers en variables numériques Figma. Ce tutoriel suit cet ordre. Il vous faut le CSS du site sous les yeux et un fichier Figma contenant la page importée, par exemple une page apportée avec UnHTML.
L'objectif reste modeste. Les calques Figma portent des valeurs numériques de padding et de gap, pas des noms de classe comme p-4. Une importation lit la page rendue : le nombre est là, le nom a disparu. Les étapes ci-dessous rendent les noms.
Comment Tailwind v4 construit son échelle d'espacement
Une variable, de nombreux utilitaires
En octobre 2026, la documentation de Tailwind v4 indique --spacing: 0.25rem parmi ses variables de thème par défaut. Chaque palier d'espacement est un multiple de cette unique valeur. La référence du padding montre la forme compilée : p-<number> devient padding: calc(var(--spacing) * <number>). Ainsi, p-4 vaut 4 fois 0.25rem, soit 1rem.
C'est pour cela que l'échelle paraît régulière. Le palier 1 vaut 0.25rem, le palier 2 vaut 0.5rem, et chaque saut entre deux paliers a la même taille.
Quels utilitaires la partagent
L'espace de noms --spacing-* couvre plus que le padding. La documentation du thème le décrit comme la source des utilitaires d'espacement et de taille comme px-4 et max-h-16. La largeur, la hauteur, la marge et le gap puisent dans les mêmes paliers. Quand vous lisez un frame importé, un gap de 64px et une hauteur de 64px peuvent venir du même palier 16.
Les sites qui changent la base
Un site peut redéfinir l'unité de base dans @theme. La documentation de Tailwind donne des exemples comme --spacing: 4px et --spacing: 1px. Si un site fixe une autre base, tous les paliers changent avec elle, et l'hypothèse des 4px ne tient plus. Ne convertissez pas les valeurs importées avant d'avoir vérifié le thème source.
rem contre px : ce que signifient les nombres après l'importation
Tailwind écrit son échelle en rem. MDN définit rem comme relatif au font-size de l'élément racine, en général html. MDN précise aussi que 16px est une valeur par défaut courante des navigateurs, mais que les préférences de l'utilisateur peuvent la modifier. Figma travaille en px : la conversion a donc lieu quelque part entre le navigateur et votre fichier.
Avec une racine de 16px, les paliers courants donnent ceci :
| Palier Tailwind | Valeur en rem | Valeur en px |
|---|---|---|
| 1 | 0.25rem | 4px |
| 2 | 0.5rem | 8px |
| 3 | 0.75rem | 12px |
| 4 | 1rem | 16px |
| 6 | 1.5rem | 24px |
| 8 | 2rem | 32px |
| 16 | 4rem | 64px |
Si le site définit html { font-size: 62.5%; } ou toute autre taille de racine, ce tableau est faux pour ce site. Ouvrez le CSS, repérez la taille de police racine et refaites la multiplication. Un seul nombre décide si tous les paddings du fichier se lisent correctement.
À l'inverse, si le site n'a jamais touché à la taille de la racine, la valeur par défaut du navigateur s'applique et le tableau reste valable tel quel. Encore faut-il l'avoir vérifié avant de s'y fier. Une hypothèse non vérifiée se propage dans chaque variable que vous créerez ensuite.
Vérifier le thème source avant d'importer
Faites-le avant de toucher à Figma. Cinq minutes ici évitent une journée de variables fausses.
- Ouvrez la feuille de style principale du site, ou le source de son fichier d'entrée Tailwind.
- Cherchez
@theme. Notez chaque ligne--spacingou--spacing-*avec sa valeur. - Cherchez un
font-sizeracine surhtmlou:root. - Notez l'unité de base en px. Pour le thème par défaut avec une racine de 16px, ce sont 4px.
- Notez les tokens nommés, comme un
--spacing-18personnalisé, avec leur valeur en px.
Un site sur une version plus ancienne de Tailwind garde son échelle ailleurs, le plus souvent dans un fichier de configuration. Ne devinez pas la version que vous avez sous les yeux. Lisez le CSS réel et fiez-vous aux nombres qu'il contient.
Transformer l'échelle en collection de variables Figma
Les variables Figma sont le bon endroit pour une échelle d'espacement. Le guide Figma sur les variables explique que les variables vivent dans des collections et que les modes permettent à une variable d'avoir plusieurs valeurs. Une collection d'espacement peut commencer avec un seul mode et en gagner d'autres plus tard, par exemple une densité compacte et une densité aérée.
Voici la séquence :
- Créez une collection nommée Spacing.
- Ajoutez des variables numériques nommées d'après le palier :
space/1,space/2,space/4, et ainsi de suite. - Saisissez chaque valeur depuis votre tableau :
space/1vaut 4,space/4vaut 16,space/16vaut 64. - Ajoutez les tokens personnalisés trouvés dans le thème, chacun avec sa valeur en px.
- Sélectionnez les frames importés et appliquez les variables au padding et au gap de l'auto layout.
Pour associer une valeur importée à un palier, divisez la valeur en px par votre unité de base. Un padding de 24px divisé par 4 donne le palier 6. Un gap de 20px divisé par 4 donne le palier 5, qui n'est pas dans le tableau mais reste sur l'échelle.
Si vous préférez ne pas saisir les nombres, une voie tierce existe. Le plugin communautaire CSS Variables indique prendre en charge les longueurs en px, in, cm, mm, pt, pc et rem, et il convertit les rem avec une base de 16px. Ce n'est pas une fonction native de Figma, et il ignore les variables qui ne sont ni des couleurs ni des longueurs. Essayez-le d'abord sur un petit fichier et vérifiez que la collection apparaît vraiment. Pour voir comment les variables rendent une page adaptable, consultez rendre une page importée responsive avec les variables Figma.
Un exemple concret : lire une carte
Imaginons que vous importiez une page de tarifs et sélectionniez une carte. Figma affiche 24px de padding sur les quatre côtés, un gap de 16px entre le titre et le texte, et un gap de 32px entre la carte et la suivante.
Avec une base de 4px, le calcul est court. Le padding de 24px correspond au palier 6 (24 divisé par 4). Le gap de 16px correspond au palier 4. Le gap de 32px entre les cartes correspond au palier 8. En termes Tailwind, cette carte était probablement écrite p-6, avec gap-4 à l'intérieur et gap-8 autour, même si l'importation ne peut pas vous donner les classes d'origine, seulement les valeurs.
Liez-les maintenant. Sélectionnez la carte, ouvrez les champs de padding du panneau auto layout et associez space/6. Associez space/4 au gap interne et space/8 au gap externe. Recommencez avec la carte suivante et vous retrouverez les mêmes trois nombres. Cette répétition, c'est l'échelle qui se montre, et c'est le contrôle le plus rapide pour confirmer que votre unité de base est la bonne. Un padding de 28px correspond au palier 7, alors qu'un gap de 18px ne tombe sur aucun palier entier : ces écarts vous montrent où l'échelle s'applique vraiment. Si les nombres ne se répètent pas, ou donnent des fractions bizarres, retournez à l'étape du thème et cherchez un --spacing surchargé ou une taille de police racine inhabituelle.
Gérer les valeurs hors échelle
Tous les nombres ne tomberont pas sur un palier. Les classes utilitaires acceptent des valeurs arbitraires comme p-[13px], et certains composants portent des tailles fixes qui n'ont jamais suivi l'échelle. Traitez-les comme des constats, pas comme des erreurs.
Ne les arrondissez pas en silence. Ramener un padding de 13px à 12px modifie la mise en page d'un pixel et masque le fait que l'auteur d'origine est sorti du système. Gardez la valeur d'origine, marquez le frame et décidez plus tard si le design doit adopter un palier ou conserver l'exception.
Consultez aussi le rapport d'importation pour repérer tout ce qui a basculé sur une solution de repli, comme une position absolue là où vous attendiez de l'auto layout. Une importation est fidèle et modifiable, pas un clone exact au pixel : quelques valeurs demanderont donc un contrôle manuel. Corrigez-les dans le fichier plutôt que de supposer que l'échelle s'applique partout. Ajoutez enfin une courte note près de la collection indiquant l'unité de base retenue et la date de vérification du thème.
Conclusion
Garder une échelle d'espacement Tailwind dans Figma tient en trois gestes. Lisez l'unité de base et la taille de police racine dans le CSS réel. Convertissez les rem en px une seule fois, avec un tableau en lequel vous avez confiance. Recréez ensuite les paliers sous forme de collection de variables numériques et appliquez-la au padding et au gap. L'importation fournit les nombres ; les variables fournissent les noms. Pour aller plus loin, construire un système de design à partir d'un site importé couvre la couche suivante : styles, composants et transmission.