io.github.dinamo541.corefx.ui

AlertUtil

Alert dialogs with fully self-contained, dependency-free theming. Plain JavaFX Alerts always render light, which clashes with dark or branded UIs. AlertUtil fixes this without shipping any CSS file: an AlertTheme is rendered to CSS in code and injected through a base64 data: URI, restyling background, text, header and buttons (including hover). Diálogos de alerta con theming totalmente autónomo y sin dependencias. Los Alert de JavaFX siempre se renderizan en claro, lo que choca con interfaces oscuras o de marca. AlertUtil lo resuelve sin enviar ningún archivo CSS: un AlertTheme se renderiza a CSS en código y se inyecta mediante un data: URI en base64, reestilizando fondo, texto, cabecera y botones (incluido el hover).

Three levels of customizationTres niveles de personalización

1. Built-in presets — AlertTheme.light() and AlertTheme.dark(), zero config.Presets integrados — AlertTheme.light() y AlertTheme.dark(), sin configuración.
2. Custom colors — AlertTheme.builder() sets any colors, font family and size with native Colors.Colores personalizados — AlertTheme.builder() fija cualquier color, familia y tamaño de fuente con Colors nativos.
3. Raw CSS — showStyled(...) takes an arbitrary stylesheet string for total control.CSS en crudo — showStyled(...) acepta una cadena de hoja de estilo arbitraria para control total.

Set a default once via setDefaultTheme(...) and every alert adopts it; per-call overloads still let you override for a single dialog. Fija un valor por defecto una vez con setDefaultTheme(...) y cada alerta lo adopta; las sobrecargas por llamada te siguen permitiendo sobreescribirlo para un solo diálogo.

Quick startInicio rápido

AlertUtil alerts = AlertUtil.getInstance();
alerts.setDefaultTheme(AlertUtil.AlertTheme.dark());   // whole app goes dark

alerts.show(AlertType.INFORMATION, "Saved", "Your changes were saved.");

boolean ok = alerts.showConfirmation("Delete?", owner, "This cannot be undone.");
if (ok) { /* proceed */ }

boolean yes = alerts.askYesNo("Quit", owner, "Exit the application?");

Default themeTema por defecto

MethodMétodo	PurposePropósito
setDefaultTheme(AlertTheme)	Theme applied to alerts shown without an explicit one (null → native look).Tema aplicado a las alertas mostradas sin uno explícito (null → aspecto nativo).
getDefaultTheme()	The current default, or null.El valor por defecto actual, o null.
clearDefaultTheme()	Reverts un-themed alerts to the native look.Revierte las alertas sin tema al aspecto nativo.

Non-blocking alertsAlertas no bloqueantes

Blocking (modal) alertsAlertas bloqueantes (modales)

Raw-CSS escape hatchVía de escape con CSS en crudo

Building a custom AlertThemeConstruir un AlertTheme personalizado

AlertUtil.AlertTheme is an immutable theme built with a fluent Builder. Every field defaults to the light theme, so you only set what you want to change. AlertUtil.AlertTheme es un tema inmutable construido con un Builder fluido. Cada campo usa por defecto el tema claro, así que solo defines lo que quieres cambiar.

AlertUtil.AlertTheme brand = AlertUtil.AlertTheme.builder()
        .background(Color.web("#1b1e2b"))
        .text(Color.web("#e6e6e6"))
        .buttonBackground(Color.web("#2370ed"))
        .buttonText(Color.WHITE)
        .buttonHover(Color.web("#1f9bcf"))
        .fontFamily("Segoe UI")
        .fontSize(14)
        .build();

alerts.show(AlertType.WARNING, "Heads up", "Low disk space.", brand);

Builder setterSetter del builder	AffectsAfecta a
background / border	Dialog pane fill and 1px border.Relleno del panel del diálogo y borde de 1px.
text	Content text color.Color del texto del contenido.
headerBackground / headerText	Header panel (when present).Panel de cabecera (cuando está presente).
buttonBackground / buttonText / buttonHover	Buttons and their hover state.Botones y su estado hover.
fontFamily (null/blank = inherit) · fontSize (> 0)	Typography.Tipografía.

RecommendationsRecomendaciones