Cargando

Cargando...

Aller au contenu
CubicLauncherDocs

Référence des tokens de thème

Liste complète des variables CSS qu'un thème CubicLauncher peut remplacer, avec leur rôle, leur valeur par défaut et les noms d'icônes disponibles.

Cette page est la référence technique du système de thèmes. Chaque token est une variable CSS : il se déclare dans Definition.toml (dans la section correspondante ou dans [tokens]) et le launcher l'applique à l'interface.

Pour le flux de travail complet, consultez Créer un thème.

Ordre de résolutionmodifier

Les valeurs sont appliquées dans cet ordre ; la dernière l'emporte :

  1. Valeurs par défaut du launcher (:root).
  2. Variables du thème (Meta.toml + Definition.toml).
  3. Image d'arrière-plan et polices du thème.
  4. Inject.css, dans la couche cubic.theme ou sans couche selon [inject].layer.
  5. Layout.css, toujours sans couche et en dernier.

Les styles globaux du launcher vivent dans la couche cubic ; les styles de chaque composant n'utilisent pas de couche. C'est pourquoi Inject.css peut remplacer sans problème les variables et les styles globaux, mais pour l'emporter sur un composant, il faut layer = "unlayered".

Comment déclarer un tokenmodifier

toml
[colors]
accent = "#97C459"          # --accent

[text]
primary = "#E0ECD4"         # --text-primary

[tokens]
"--bg-image-blur" = "12px"  # variable littérale

Les valeurs sont copiées telles quelles dans le CSS. Un token numérique sans unité (par exemple "12") produit une valeur invalide pour le navigateur et la déclaration est ignorée.

Surfaces et arrière-plansmodifier

TokenContrôlePar défaut
--bg-mainArrière-plan de base de la fenêtre#0a0a0a
--bg-sidebarArrière-plan de la barre latérale#111113
--bg-cardArrière-plan des cartes et des panneaux#111113
--bg-inputArrière-plan des champs de texte#0a0a0a
--bg-item-activeArrière-plan de l'élément sélectionné#18181a
--bg-overlayVoile sur l'interfacergba(0, 0, 0, 0.7)
--bg-surfaceAlias de --bg-item-activevar(--bg-item-active)
--bg-sidebar-gradientDégradé de la barre latéralelinear-gradient(180deg, …)
--bg-card-gradientDégradé des carteslinear-gradient(135deg, …)
--surface-rgbTriplet de base des surfaces translucides255, 255, 255
--surface-hoverSurface au survolrgba(var(--surface-rgb), 0.06)
--surface-activeSurface presséergba(var(--surface-rgb), 0.08)
--surface-selectedSurface sélectionnéergba(var(--surface-rgb), 0.03)
--surface-cardRemplissage des cartesrgba(var(--surface-rgb), 0.03)
--surface-inputRemplissage des champsrgba(var(--surface-rgb), 0.03)
--surface-subtleSurface à peine visiblergba(var(--surface-rgb), 0.02)
--surface-raisedSurface surélevéergba(var(--surface-rgb), 0.04)
--surface-dropdownArrière-plan des menus déroulantsvar(--bg-card)
--toast-bgArrière-plan des notificationscolor-mix(…)
--toast-borderBordure des notificationsrgba(var(--surface-rgb), 0.06)

Textemodifier

TokenContrôlePar défaut
--text-primaryTexte principal#f4f4f5
--text-secondaryTexte secondaire#a1a1aa
--text-mutedTexte désactivé#71717a
--text-tertiaryTexte auxiliaire#71717a

Accentmodifier

TokenContrôlePar défaut
--accentCouleur de marque#ffffff
--accent-rgbL'accent sous la forme R, G, B255, 255, 255
--accent-hoverAccent au survol#f4f4f5
--accent-textTexte sur l'accent#0a0a0a
--accent-primaryAlias de --accentvar(--accent)
Gardez le triplet synchronisé

--accent-rgb n'est pas calculé automatiquement. Si vous modifiez --accent et oubliez --accent-rgb, les lueurs, bordures et arrière-plans qui utilisent rgba(var(--accent-rgb), α) conservent l'ancienne couleur.

Bordures et rayonsmodifier

TokenContrôlePar défaut
--border-colorCouleur des borduresrgba(var(--surface-rgb), 0.06)
--borderAlias de --border-colorvar(--border-color)
--border-widthÉpaisseur de bordure1px
--border-hoverBordure au survolrgba(var(--surface-rgb), 0.1)
--border-focusBordure de focusrgba(var(--surface-rgb), 0.3)
--border-radiusRayon global4px
--border-radius-smPetit rayon3px
--border-radius-lgGrand rayoncalc(var(--border-radius) * 2)
--border-radius-pillRayon de pilule999px

Ombresmodifier

TokenContrôlePar défaut
--shadow-smOmbre subtile0 1px 3px rgba(0, 0, 0, 0.5)
--shadow-mdOmbre moyenne0 4px 12px rgba(0, 0, 0, 0.5)
--shadow-lgGrande ombre0 8px 28px rgba(0, 0, 0, 0.6)
--shadow-insetOmbre intérieureinset 0 1px 2px rgba(0, 0, 0, 0.2)
--shadow-floatingÉléments flottantsvar(--shadow-lg)
--shadow-imageImagesvar(--shadow-md)
--shadow-indicatorIndicateursvar(--shadow-sm)
--shadow-drawer-leftTiroir gauche-8px 0 32px rgba(0, 0, 0, 0.6)
--shadow-drawer-rightTiroir droit8px 0 32px rgba(0, 0, 0, 0.6)
--shadow-drawer-topTiroir supérieur0 -8px 32px rgba(0, 0, 0, 0.6)
--shadow-drawer-bottomTiroir inférieur0 8px 32px rgba(0, 0, 0, 0.6)

Typographiemodifier

TokenContrôlePar défaut
--font-familyTypographie de l'interface"Cantarell", system-ui, sans-serif
--font-family-monoTypographie monospaceui-monospace, …
--font-size-baseTaille de base14px
--font-size-smPetite taille0.8rem
--font-size-lgGrande taille1.2rem
--font-size-controlTexte des contrôles0.85rem
--font-size-labelÉtiquettes0.65rem
--font-weight-normalGraisse normale400
--font-weight-mediumGraisse moyenne600
--font-weight-boldGraisse en gras700
--line-heightInterligne1.5

Espacement, contrôles et mouvementmodifier

TokenContrôlePar défaut
--space-xsEspace extra-petit4px
--space-smPetit espace8px
--space-mdEspace moyen12px
--space-lgGrand espace16px
--space-xlEspace extra-grand24px
--control-paddingRemplissage des contrôles10px 12px
--button-paddingRemplissage des boutons8px 16px
--icon-scaleÉchelle globale des icônes1
--transition-fastTransition rapide0.15s
--transition-normalTransition normale0.2s

Barre latérale et listesmodifier

TokenContrôlePar défaut
--sidebar-widthLargeur de la barre latérale260px
--sidebar-compact-widthLargeur en mode compact70px
--sidebar-row-heightHauteur de ligne52px
--sidebar-compact-row-heightHauteur de ligne compacte50px
--sidebar-row-gapEspacement entre les lignes8px
--version-row-heightHauteur de ligne de version78px
--resource-row-heightHauteur de ligne de ressource130px
--resource-row-gapEspacement entre les ressources6px
--resource-card-paddingRemplissage de la carte de ressource14px 16px
--resource-icon-sizeTaille de l'icône de ressource56px

Marché du contenumodifier

TokenContrôlePar défaut
--market-row-heightHauteur de ligne224px
--market-grid-gapEspacement de la grille12px
--market-card-min-widthLargeur minimale de carte280px
--market-grid-paddingRemplissage de la grille8px
--market-card-paddingRemplissage de carte14px
--market-icon-sizeTaille d'icône48px
--market-item-gapEspacement entre les éléments10px
--market-title-sizeTaille du titre0.9rem
--market-description-sizeTaille de la description0.75rem
--market-button-paddingRemplissage du bouton5px 12px
--market-installed-row-heightHauteur de ligne installée84px
--market-installed-row-gapEspacement des éléments installés6px
--market-installed-icon-sizeIcône d'élément installé40px
--market-installed-paddingRemplissage de l'élément installé8px 12px
--market-detail-icon-sizeIcône dans le détail80px
--market-detail-sidebar-widthBarre latérale du détail270px
--market-page-paddingRemplissage de la page24px
--market-page-padding-compactRemplissage en fenêtre étroite14px

Le marché dérive ses couleurs du thème au moyen d'alias. Pas besoin de les redéfinir : si vous changez --accent et --bg-card, le marché les suit.

AliasDérivé de
--market-card-bg, --market-panel-bg, --market-input-bg--bg-card, --bg-sidebar, --bg-input
--market-accent, --market-accent-hover, --market-accent-text--accent, --accent-hover, --accent-text
--market-border, --market-border-hover, --market-card-radius--border, --border-radius
--market-success, --market-error, --market-warning, --market-info--color-success, --color-error, --color-warning, --color-info
--market-text-secondary--text-secondary

États et couleurs sémantiquesmodifier

TokenContrôlePar défaut
--color-successSuccès#22c55e
--color-success-rgbSuccès sous la forme R, G, B34, 197, 94
--color-errorErreur#ef4444
--color-error-rgbErreur sous la forme R, G, B239, 68, 68
--color-warningAvertissement#eab308
--color-warning-rgbAvertissement sous la forme R, G, B234, 179, 8
--color-infoInformation#60a5fa
--color-info-rgbInformation sous la forme R, G, B96, 165, 250
--color-on-successTexte sur succès#fff
--color-on-errorTexte sur erreur#fff
--color-on-warningTexte sur avertissement#fff
--color-on-infoTexte sur information#fff
--color-status-startingInstance en cours de démarragevar(--color-info)
--color-status-startedInstance démarréevar(--color-success)
--errorAlias d'erreurvar(--color-error)
--warningAlias d'avertissementvar(--color-warning)
--glow-errorLueur d'erreur0 0 12px rgba(…)
--glow-successLueur de succès0 0 12px rgba(…)

Téléchargementsmodifier

TokenContrôlePar défaut
--download-libraryBibliothèques#4ade80
--download-assetAssets#60a5fa
--download-nativeNatifs#f59e0b
--download-clientClient#a78bfa
--download-verifyingVérification#f472b6
--download-genericGénérique#94a3b8
--download-processingTraitement#fb923c
--download-jreJava#22d3ee

Console et logsmodifier

TokenContrôlePar défaut
--log-traceNiveau tracevar(--text-muted)
--log-debugNiveau debugvar(--text-muted)
--log-infoNiveau infovar(--text-primary)
--log-messageMessages de Minecraftvar(--text-primary)
--log-warnNiveau warnvar(--color-warning)
--log-errorNiveau errorvar(--color-error)
--log-fatalNiveau fatalvar(--color-error)
--log-launcherMessages du launchervar(--text-primary)
--log-stderrSortie d'erreurvar(--color-error)
--log-unknownNiveau inconnuvar(--text-tertiary)
--log-font-sizeTaille de police0.75rem
--log-line-heightInterlignevar(--line-height)
--log-line-paddingRemplissage de ligne2px 14px
--log-line-min-heightHauteur minimale de ligne22px

Barre de défilementmodifier

TokenContrôlePar défaut
--scrollbar-thumbPoucergba(var(--surface-rgb), 0.12)
--scrollbar-thumb-hoverPouce au survolvar(--text-secondary)
--scrollbar-trackRailvar(--bg-main)
--scrollbar-sizeÉpaisseur6px
--scrollbar-radiusRayon10px

Image d'arrière-planmodifier

TokenContrôlePar défaut
--bg-image-blurFlou (avec unité)8px
--bg-image-opacityOpacité (0–1)0.3
--bg-image-sizeCadragecover
--bg-image-positionPositioncenter
--bg-image-brightnessLuminosité0.4

[background] écrit automatiquement ces variables. image_blur, image_opacity, mode, position et brightness sont des nombres ou des chaînes sans unité ; le launcher n'ajoute px qu'au flou. Si vous préférez un contrôle total, déclarez la variable dans [tokens] avec l'unité incluse.

Flous d'arrière-plan (backdrop)modifier

Ils se déclarent dans [backdrop] sous forme de nombres et le launcher ajoute px.

TokenContrôlePar défaut
--backdrop-blur-overlayVoile superposé4px
--backdrop-blur-modalFenêtres modales4px
--backdrop-blur-dropdownMenus déroulants4px
--backdrop-blur-panelPanneaux2px
--backdrop-blur-floatÉléments flottants4px
--backdrop-blur-viewerVisionneuse d'images2px

Superpositions et visionneusesmodifier

TokenContrôlePar défaut
--media-overlayVoile sur les imagesrgba(0, 0, 0, 0.6)
--media-overlay-textTexte sur les images#fff
--media-overlay-borderBordure sur les imagesrgba(255, 255, 255, 0.1)
--viewer-overlayArrière-plan de la visionneusergba(0, 0, 0, 0.9)
--tutorial-overlayVoile du tutorielrgba(0, 0, 0, 0.5)
--tutorial-overlay-softVoile doux du tutorielrgba(0, 0, 0, 0.15)

Chargeurs de modsmodifier

TokenContrôlePar défaut
--clr-loader-vanillaVanilla#78909c
--clr-loader-fabricFabric#66bb6a
--clr-loader-forgeForge#ffa726
--clr-loader-quiltQuilt#ab47bc

Diversmodifier

TokenContrôlePar défaut
--icon-filterFiltre CSS pour les icônes raster dans certains contrôlesinvert(1)
--color-schemeSchéma natif (dark, light) : barres et contrôles du systèmenormal
Variables internes

--bg-image-loaded et --font-loaded sont écrites par le launcher pour coordonner les animations d'entrée. Ne les déclarez pas dans un thème : elles sont écrasées lors de l'application du thème et le résultat est imprévisible.

Icônesmodifier

Un thème peut remplacer des icônes en déclarant des clés au format groupe:nom dans [icons.groupe]. Voici les noms utilisés par l'interface :

GroupeNoms
uibell, interface, check, check-circle, chevron-down, chevron-left, chevron-right, close, copy, download, error, flag, lock, logout, performance, pin, play, refresh, resources, search, shaders, spinner, success, trash, unlock, upload
navcreate, edit, pencil, settings, sliders
instancebox, check-square, clock, code, database, external-link, folder, grid, image, market, multiplayer, puzzle, resources, screenshots, servers, shader, terminal, worlds
logarrow-down, chevron-down, chevron-up, clear, copy, logs, scroll-down, search, spinner, upload
brandcubic, curseforge, discord, fabric, forge, github, microsoft, modrinth, neoforged, optifine, quilt, vanilla

brand:curseforge, brand:fabric, brand:forge, brand:modrinth, brand:neoforged, brand:optifine et brand:vanilla sont des images raster dans le launcher d'origine ; lors de leur remplacement, il est conseillé d'utiliser des PNG avec un fond transparent.

En plus des groupes, [icons] preview définit l'image du thème dans le sélecteur.

Contraste minimalmodifier

Pour qu'un thème reste lisible sur n'importe quel écran :

  • Texte principal sur arrière-plan principal : 4.5:1 au minimum.
  • Texte secondaire et étiquettes : 3:1 au minimum.
  • Bordures et séparateurs : 1.5:1 par rapport à la surface.
  • Texte sur --accent : utilisez --accent-text, pas --text-primary.