Passer au contenu principal
Utilisez le composant Color pour présenter des palettes de couleurs dans votre documentation. Les couleurs peuvent être affichées dans une grille compacte ou organisées dans un tableau avec des lignes nommées.

​
Variante compacte

Affichez les couleurs dans une grille simple, avec leurs noms et leurs valeurs.

blue-500

#3B82F6

blue-600

#2563EB

blue-700

#1D4ED8

blue-800

#1E40AF

Compact example
<Color variant="compact">
  <Color.Item name="blue-500" value="#3B82F6" />
  <Color.Item name="blue-600" value="#2563EB" />
  <Color.Item name="blue-700" value="#1D4ED8" />
  <Color.Item name="blue-800" value="#1E40AF" />
</Color>

​
Variante en tableau

Organisez les couleurs en lignes avec des libellés pour la documentation de votre système de design.

Primaire

Secondaire

Table example
<Color variant="table">
  <Color.Row title="Primaire">
    <Color.Item name="primary-500" value="#3B82F6" />
    <Color.Item name="primary-600" value="#2563EB" />
    <Color.Item name="primary-700" value="#1D4ED8" />
  </Color.Row>
  <Color.Row title="Secondaire">
    <Color.Item name="secondary-500" value="#8B5CF6" />
    <Color.Item name="secondary-600" value="#7C3AED" />
  </Color.Row>
</Color>

​
Formats de couleur

Le composant prend en charge tous les formats de couleur CSS, y compris hex, rgb, rgba, hsl et oklch.

hex

#FF5733

rgb

rgb(51, 255, 87)

rgba

rgba(51, 87, 255, 0.7)

hsl

hsl(180, 70%, 55%)

oklch

oklch(70% 0.2 145)

Color formats example
<Color variant="compact">
  <Color.Item name="hex" value="#FF5733" />
  <Color.Item name="rgb" value="rgb(51, 255, 87)" />
  <Color.Item name="rgba" value="rgba(51, 87, 255, 0.7)" />
  <Color.Item name="hsl" value="hsl(180, 70%, 55%)" />
  <Color.Item name="oklch" value="oklch(70% 0.2 145)" />
</Color>

​
Couleurs adaptées au thème

Définissez des couleurs distinctes pour les modes clair et sombre à l’aide d’un objet avec les propriétés light et dark.

bg-primary

bg-secondary

text-primary

Theme-aware example
<Color variant="compact">
  <Color.Item name="bg-primary" value={{ light: "#FFFFFF", dark: "#000000" }} />
  <Color.Item name="bg-secondary" value={{ light: "#F9FAFB", dark: "#0A0A0A" }} />
  <Color.Item name="text-primary" value={{ light: "#111827", dark: "#F9FAFB" }} />
</Color>

​
Propriétés

​
Couleur

​
variant
string
required
Style d’affichage de la palette de couleurs. Options : compact ou table.
​
children
Color.Item | Color.Row
required
Éléments ou lignes de couleur à afficher.

​
Color.Row

​
title
string
Libellé de la ligne de couleurs.
​
children
Color.Item
required
Éléments de couleur à afficher dans cette ligne.

​
Color.Item

​
name
string
Nom ou label de la couleur.
​
value
string | { light: string, dark: string }
required
Valeur de la couleur dans n’importe quel format CSS, ou bien un objet contenant des valeurs distinctes pour les modes light et dark.