Thèmes et CSS
Dans x4js, l’apparence ne se décide pas dans le code : elle est dans le CSS. Chaque composant apporte sa structure et son comportement, et la feuille de style fait le reste.
Une classe par composant
Section intitulée « Une classe par composant »Chaque composant porte une classe à son nom, et celles de ses classes de base.
| Composant | Classes portées par l’élément |
|---|---|
Button |
x4button, x4 |
VBox |
x4vbox, x4box, x4 |
MainView, qui étend VBox |
mainview, x4vbox, x4box, x4 |
Une classe peut déclarer son préfixe : avec static classPrefix = "app"; dans MainView, l’élément porte appmainview au lieu de mainview.
Vous ciblez donc un composant, fourni ou à vous, sans rien déclarer. La propriété cls ajoute vos propres classes quand il faut distinguer deux éléments du même type.
.mainview { padding: 12px; gap: 8px;
.x4button { min-width: 90px; }}Trois niveaux de variables
Section intitulée « Trois niveaux de variables »Les couleurs ne sont pas écrites en dur dans les composants. Elles passent par des variables CSS, organisées en trois niveaux :
| Niveau | Exemples | Rôle |
|---|---|---|
| Échelle primaire | --color-primary-a0 … --color-primary-a100 |
De a0, le fond, à a100, le texte, en passant par la couleur de base. Les gris sont des mélanges de a0 et a100. |
| Variables de sens | --accent-background, --border, --text-primary, --background-primary |
Ce qu’une couleur signifie dans l’interface. |
| Variables de composant | --button-background, --listbox-border, --chart-color-1 |
Le réglage fin d’un composant. |
Chaque niveau s’appuie sur le précédent. Selon ce que vous voulez changer, vous intervenez au bon niveau.
Changer la couleur de toute l’application
Section intitulée « Changer la couleur de toute l’application »Redéfinissez l’échelle primaire, une fois par thème. Tous les composants suivent.
:root { --color-primary-a40: #3d8fbd; --color-primary-a50: #126e9e; --color-primary-a60: #0e5a80; // … les autres nuances de l'échelle}Changer un rôle
Section intitulée « Changer un rôle »:root { --border: #cfdae0; --accent-background: #126e9e;}Régler un composant
Section intitulée « Régler un composant ».x4button { --button-background: #002a40; --button-color: white;}La liste des variables de chaque composant figure dans la référence de l’API, sur la page de sa classe.
Thème clair, thème sombre
Section intitulée « Thème clair, thème sombre »Un thème est un jeu de valeurs pour ces variables, activé par une classe sur <html>. x4js en fournit deux : le thème clair, par défaut, et un thème sombre.
import { Application } from 'x4js';
Application.setTheme( "dark" ); // pose la classe x4theme-dark sur <html>Application.setTheme( "" ); // revient au thème clairApplication.getTheme( ) donne le nom du thème courant ("" pour le thème clair).
Pour un thème à vous, redéfinissez l’échelle, et si besoin les variables de sens, sous html.x4theme-<nom>, puis activez-le par son nom :
html.x4theme-pink { --color-primary-a0: #fff5f8; // … a5 à a90 … --color-primary-a100: #3a1020;}Application.setTheme( "pink" );Pour un thème sombre, l’échelle va du foncé (a0) au clair (a100) : les gris suivent d’eux-mêmes. Ajoutez color-scheme: dark dans le même bloc, pour que les parties natives (listes de choix, barres de défilement) suivent aussi.
Il n’y a pas d’objet « thème » à manipuler en TypeScript : n’en créez pas un pour dupliquer ce que le CSS fait déjà.
La police
Section intitulée « La police »La police et sa taille sont deux variables, --font-name et --font-size (14px par défaut), posées sur :root. Pour changer la taille du texte, changez --font-size, pas la taille de police de <html> : les composants suivent --font-size.
:root { --font-size: 13px;}Depuis le code
Section intitulée « Depuis le code »Il arrive qu’une valeur dépende des données : une couleur choisie par l’utilisateur, une largeur calculée. Un composant peut alors lire ou écrire une variable CSS.
panel.setStyleVariable( "--panel-accent", color );
const height = panel.getStyleVariable( "--row-height" );Trois règles
Section intitulée « Trois règles »- Pas de cosmétique dans le code. Couleurs, marges et polices vont dans la feuille de style.
- Pas de bagarre avec le CSS. Si vous avez besoin de marges négatives ou de
!important, cherchez l’erreur dans le CSS. - Le CSS habille, il ne retire pas un comportement. Pour enlever le bouton de fermeture d’un dialogue, on règle le composant par ses propriétés (
closable: false), on ne le masque pas en CSS.