Skip to main content
Entwickler Themen
Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Back to homepage

Gemeinsame JavaFX-Themes

Der ThemeManager aus de.neitzel.fx.theme stellt die Themes light, dark und high-contrast bereit. Die Anwendung entscheidet, welche Szenen sie registriert, und speichert die gewählte ID in ihren Einstellungen. Der Wechsel ändert die Darstellung. Tabellenabfrage, Auswahl und Spaltenbreiten bleiben dabei erhalten.

Theme anwenden

Richte den Manager auf dem JavaFX Application Thread ein:

var themes = new ThemeManager();
var registration = themes.register(scene);
themes.selectSaved(savedThemeId);

Ein Menü kann später beispielsweise themes.select("dark") aufrufen. Registrierte Szenen und ihre zugeordneten Dialoge, Popups und herausgelösten Docking-Fenster übernehmen die Auswahl auch dann, wenn sie erst später erscheinen. Gib einem Dialog ein Besitzerfenster, damit er das Theme erbt. Beim Abbau einer explizit registrierten Szene schließt die Anwendung registration. Am Ende schließt sie den Manager mit themes.close().

Ist eine gespeicherte ID nicht verfügbar, fällt selectSaved auf light zurück. Über failureProperty() kann die Anwendung den Grund anzeigen. Scheitert die Installation eines neu gewählten Themes erkennbar, bleibt das bisherige Theme aktiv.

Anwendungseigene Farben

Die CSS-Reihenfolge beginnt bei den Voreinstellungen der Controls, gefolgt von der gemeinsamen Palette und den Stylesheets der Anwendung. Für eigene Controls stehen unter anderem -nl-text, -nl-surface, -nl-selection, -nl-selection-text und -nl-focus bereit. Nutze bei fachlichen Zuständen zusätzlich Text oder Symbole, damit die Bedeutung auch bei einem Wechsel der Palette erkennbar bleibt.

Die Theme-Galerie zeigt die drei Themes an Tabellen, Filterdialogen und weiteren Controls. Der englische Leitfaden beschreibt die CSS-Hooks, die Fensterzuordnung und die Grenzen der Kontrastmessungen.