Tokens — gohud

Cada color y cada medida viven bajo el tipo GoHud dentro del Theme, y se direccionan por nombre. La regla es no escribir números: los nombres acompañan al tema cuando se cambia.

GoUi.color(GoTheme.ACCENT)             # color
GoUi.metric(GoTheme.GAP)               # medida (dp)
GoUi.font_size(GoTheme.ROLE_CAPTION)   # tamaño para un rol de texto
GoUi.box(GoTheme.BOX_CARD)             # una copia de un StyleBox

Colores

Nombre	Se usa para
`background`	El fondo de la pantalla
`surface` · `surface_soft` · `surface_high`	Tres capas de panel — panel, tarjeta, celda elevada
`border`	Bordes de tarjetas y botones
`text` · `secondary` · `muted`	Tres niveles de texto — cuerpo, apoyo, atenuado
`accent` · `on_accent`	El acento y el texto que se coloca sobre él
`success` · `warning` · `danger` · `info`	Colores de estado para texto
`*_fill`	Los mismos estados como relleno — barras y otras áreas grandes
`scrim` · `shadow` · `track`	El velo detrás de los emergentes, las sombras, el carril de la barra

Por qué existe *_fill. El mismo significado, requisitos opuestos. warning usado como texto debe ser lo bastante oscuro para leerse sobre un fondo claro; usado como relleno de una barra de experiencia debe ser lo bastante brillante para notarse. Un solo token no puede ser ambas cosas — la barra del tema claro salía marrón. Un tema sin la variante _fill recurre automáticamente al nombre base, así que los temas anteriores a estos tokens siguen funcionando.

Medidas (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

Opacidad del panel (%)

panel_alpha card_alpha hud_alpha notice_alpha popup_alpha — qué tan sólida es la cara de un contenedor. 80 de forma predeterminada, así el juego sigue visible detrás de un diálogo; popup_alpha es 100. Un tema sin estos tokens recurre a 100 y se dibuja exactamente igual que antes. Lee el valor resuelto como proporción con GoUi.surface_alpha(variant); la sección Opacidad — el juego detrás del panel tiene las reglas.

Roles de texto

micro · compact · caption · body · button · subtitle · title — un rol nombra un tamaño, no un propósito. "El texto más grande", no "el encabezado". Así la escala se mantiene aunque una pantalla lo use para otra cosa.

Variaciones de tipo

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