Les composants tirent leurs couleurs, leur rayon et leur densité de jetons de design. Suivez le thème du système, forcez le clair ou le sombre, puis ajustez les jetons par des propriétés CSS personnalisées. Chaque exemple de code suit le format choisi en haut de page.
Un jeton de design est une propriété CSS personnalisée que les composants lisent au lieu d’une valeur écrite en dur. Redéfinir un jeton change tous les composants qui s’en servent, sans toucher à leur code.
tokens.css.--pack-bg.Note
Cette page ne cite que les noms de jetons décrits au catalogue et n’écrit aucune valeur. Dans les exemples, [votre valeur] marque l’endroit où placer la vôtre.
Un attribut, posé sur la racine ou sur une zone.
Par défaut, les jetons suivent le thème du système. Pour forcer un thème, posez data-theme="light" ou data-theme="dark" sur la racine du document.
Le même attribut vaut pour un sous-arbre : seuls les composants qu’il contient changent de thème.
<!-- Thème du système par défaut ; ici, sombre forcé -->
<html lang="fr-CA" data-theme="dark"><section data-theme="dark">
<bythium-button variant="primary">
Enregistrer
</bythium-button>
</section>Provisoire
Les composants d’enveloppe comme OButton et les paquets @unisson/<framework> portent un nom provisoire. Les balises natives gardent leur nom bythium-<nom>.
Le même bouton, sans aucun changement d’attribut, rendu dans une scène claire puis dans une scène sombre. Chaque scène a sa propre bascule : elle ne change pas le thème de la page.
<bythium-button variant="primary">
Enregistrer
</bythium-button>Déclarez le jeton sur :root pour toute la page, après la feuille tokens.css du pack. L’exemple redéfinit --pack-bg.
:root {
--pack-bg: [votre valeur];
}Un jeton redéfini une seule fois vaut pour les deux thèmes. Pour les distinguer, ciblez data-theme.
[data-theme="light"] {
--pack-bg: [votre valeur claire];
}
[data-theme="dark"] {
--pack-bg: [votre valeur sombre];
}Pour ne toucher qu’une zone, déclarez le jeton sur son conteneur plutôt que sur :root : les composants hors de la zone gardent la valeur du pack.
Relisez la page en clair puis en sombre : une valeur lisible dans un thème ne l’est pas toujours dans l’autre.
Note
Les valeurs par thème ne s’appliquent que là où data-theme est posé. Quand la page suit le thème du système sans cet attribut, ce sont les valeurs du pack qui s’affichent.
Le composant bythium-theme-toggle propose le thème clair, sombre ou celui du système. Avec apply, il pose data-theme sur la cible ; avec storage-key, il garde le choix.
<bythium-theme-toggle
mode="segmented"
label="Thème"
target="html"
apply
storage-key="unisson-theme">
</bythium-theme-toggle>Page de maquette, contenu cible.Proposer une modification