Aller au contenu
x4x4x4js2.3.29

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.

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;
}
}

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.

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
}
:root {
--border: #cfdae0;
--accent-background: #126e9e;
}
.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.

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 clair

Application.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 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;
}

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" );
  1. Pas de cosmétique dans le code. Couleurs, marges et polices vont dans la feuille de style.
  2. Pas de bagarre avec le CSS. Si vous avez besoin de marges négatives ou de !important, cherchez l’erreur dans le CSS.
  3. 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.