Tokens — gohud

Chaque couleur et chaque mesure vit sous le type GoHud du Theme, adressée par son nom. Ne pas écrire de chiffres est la règle : les noms suivent quand on change de thème.

GoUi.color(GoTheme.ACCENT)             # couleur
GoUi.metric(GoTheme.GAP)               # mesure (dp)
GoUi.font_size(GoTheme.ROLE_CAPTION)   # taille d'un rôle de texte
GoUi.box(GoTheme.BOX_CARD)             # une copie d'un StyleBox

Couleurs

Nom	Sert à
`background`	Le fond de l'écran
`surface` · `surface_soft` · `surface_high`	Trois couches de panneau — panneau, carte, cellule surélevée
`border`	Bordures des cartes et des boutons
`text` · `secondary` · `muted`	Trois niveaux de texte — courant, secondaire, atténué
`accent` · `on_accent`	L'accent et le texte posé dessus
`success` · `warning` · `danger` · `info`	Couleurs de texte des états
`*_fill`	Les mêmes états en remplissage — barres et autres grandes zones
`scrim` · `shadow` · `track`	Le voile derrière les fenêtres surgissantes, les ombres, la gouttière de la barre

Pourquoi *_fill existe. Même sens, exigences opposées. warning employé comme texte doit être assez sombre pour se lire sur un fond clair ; employé comme remplissage d'une barre d'expérience, il doit être assez vif pour se remarquer. Un seul token ne peut pas être les deux — la barre du thème clair virait au brun. Un thème dépourvu de la variante _fill retombe automatiquement sur le nom de base : les thèmes antérieurs à ces tokens continuent donc de fonctionner.

Mesures (dp)

touch button_height gap_tiny gap_small gap gap_large padding padding_compact compact_padding_x compact_padding_y radius_small radius radius_large screen_margin scroll_deadzone scroll_edge scrollbar_width list_glyph icon_size notice_duration_ms

Opacité des panneaux (%)

panel_alpha card_alpha hud_alpha notice_alpha popup_alpha — à quel point la face d'un conteneur est opaque. 80 par défaut, pour que le jeu reste visible derrière une boîte de dialogue ; popup_alpha vaut 100. Un thème dépourvu de ces tokens retombe sur 100 et se dessine exactement comme avant. Lisez la valeur résolue sous forme de ratio avec GoUi.surface_alpha(variant) ; la section L'opacité — le jeu derrière le panneau en donne les règles.

Rôles de texte

micro · compact · caption · body · button · subtitle · title — un rôle nomme une taille, pas un usage. « Le texte le plus grand », pas « le titre ». Ainsi l'échelle tient même quand un écran s'en sert pour autre chose.

Variations de type

GoPanel GoCard GoButton GoPrimaryButton GoDangerButton GoDangerSolidButton GoBareButton GoCompactButton GoIconButton GoListButton GoTitleLabel GoSubtitleLabel GoCaptionLabel GoCompactLabel GoMicroLabel