enhancement
major
minor
major
minor
major
#29528
Das UI-Design soll sich an die Systemeinstellung für „Dunkel“ bzw. „Hell“ anpassen
Ziel
Einem Nutzer, der noch nie ein Design ausgewählt hat, wird das konfigurierte Standarddesign zugewiesen, unabhängig davon, wie sein Betriebssystem eingestellt ist. Alle anderen Anwendungen auf seinem Desktop folgen dieser Einstellung; diese Anwendung jedoch nicht, und das Erste, was ein Nutzer im Dunkelmodus sieht, ist eine helle Seite.
Das Design sollte den Systemeinstellungen folgen, bis der Nutzer diese überschreibt, und eine solche Überschreibung sollte rückgängig gemacht werden können – ein Nutzer, der einmal ein Design ausgewählt hat, hat derzeit keine Möglichkeit, wieder zu den „Systemeinstellungen“ zurückzukehren.
Aktueller Stand
Die Grundlagen sind fast vorhanden, da die Designs bereits als bereichsbezogene Blöcke von benutzerdefinierten CSS-Eigenschaften ausgegeben werden:
- UIThemeService#writeThemeStyles schreibt einen [data-theme="<id>"] -Block pro konfiguriertem Design und bindet zusätzlich das Standarddesign an :root.
- ViewServlet versieht das Dokumentelement anhand von UIThemeService#getActiveThemeId() mit dem Attribut „data-theme “.
- ThemeCommands stellt einen Menüeintrag pro Design bereit und bietet das aktive Design als deaktiviert an; auf diese Weise zeigt das Menü an, welches Design gerade aktiv ist.
Nirgendwo wird „prefers-color-scheme“ ausgelesen.
Was benötigt wird
Ein Theme muss angeben, auf welche Systemeinstellung es reagiert. Dies lässt sich nicht ableiten: Eine Anwendung kann drei Themes konfigurieren, daher muss sie deklarieren, welches davon für die helle und welches für die dunkle Einstellung des Systems steht. Eine UITheme-Eigenschaft, bei der im einfachen Fall – ein helles, ein dunkles Theme – jeweils nicht mehr als eine Deklaration erforderlich ist.
„Keine Auswahl getroffen“ muss von „Standard“ unterscheidbar sein. getActiveThemeId() vermischt beides: Es gibt die gespeicherte Einstellung zurück oder, falls diese fehlt, die Standard-ID. Der Dienst muss daher die gespeicherte Auswahl als nicht vorhanden melden, und ViewServlet muss das Attribut in diesem Fall dem Client überlassen.
Das Menü benötigt einen Rückweg. Einen „System“-Eintrag, der die gespeicherte Einstellung löscht und als aktiv markiert ist – der deaktiviert angeboten wird, so wie es bereits bei den Design-Einträgen der Fall ist –, solange keine Auswahl gespeichert ist. Ohne diesen Eintrag ist die Funktion einseitig: Die erste explizite Auswahl ist dauerhaft.
Auch native Steuerelemente folgen dem Design nicht
Kein Design deklariert die CSS-Eigenschaft „color-scheme“, sodass alles, was der Browser selbst zeichnet, unter dem dunklen Design sein helles Erscheinungsbild behält: vor allem Bildlaufleisten, aber auch die inneren Elemente von Formularsteuerelementen, der Cursor, Unterstreichungen der Rechtschreibprüfung und die Standard-Hintergrundfarbe der Seite. Eine dunkle Seite mit hellgrauen Bildlaufleisten an den Seitenrändern ist das sichtbare Symptom.
„color-scheme“ gehört zum Theme und nicht zu einem Stylesheet, aus demselben Grund wie die Farben: Es ist eine Aussage darüber, wie dieses Theme aussieht. Pro Theme deklariert und neben den benutzerdefinierten Eigenschaften in den Theme-Block ausgegeben, sorgt es dafür, dass die browser-eigenen Elemente dem Theme folgen.
Lösung
Das tatsächlich verwendete Theme wird immer durch „data-theme“ benannt. Anstatt das Attribut wegzulassen und einen „prefers-color-scheme“-Medienblock entscheiden zu lassen (was dazu führen würde, dass jede Regel, die nach „data-theme“ auswählt – sowohl in Anwendungen als auch im Framework –, unter diesem Medienblock ein zweites Mal geschrieben werden müsste, wodurch fest codiert würde, welches Theme der dunklen Einstellung des Systems entspricht), versieht die Seite das Attribut auf dem Client mit einem Vermerk: Solange keine Auswahl gespeichert ist, setzt ein kleines Inline-Skript am Anfang von <head> „data-theme“ auf „matchMedia('(prefers-color-scheme: dark)‘) vor dem ersten Rendern und folgt fortan dem Betriebssystem, solange die Seite geöffnet ist, wobei die Seite inzwischen mit ` data-theme-mode="system" ` gekennzeichnet wird. Eine gespeicherte Auswahl wird wie bisher vom Server gesetzt. Bestehende [data-theme="…"] -Regeln und Client-Code, der das Attribut ausliest, funktionieren in beiden Modi unverändert weiter, und es gibt eine einzige Quelle der Wahrheit für das aktuell aktive Design. Das Skript stellt window.tlTheme.select(id) und window.tlTheme.followSystem() bereit, die von den Designbefehlen aufgerufen werden.
Themenkonfiguration. Ein UITheme deklariert sein Farbschema (hell oder dunkel, über „extends“ vererbt, hell an der Wurzel), das als Farbschema- Deklaration in seinen Block ausgegeben wird. Ein Theme mit der Markierung `system-default="true"` entspricht der vom Betriebssystem bevorzugten Farbpalette; ein zweites Theme, das für dieselbe Farbpalette markiert ist, stellt einen Konfigurationsfehler dar, und eine Farbpalette ohne markiertes Theme wird durch das Standard-Theme bedient. Der einfache Fall erfordert daher eine einzige Deklaration: Das mitgelieferte dunkle Theme trägt die Angaben color-scheme="dark" und system-default="true".
Dienste und Befehle. UIThemeService.getSelectedThemeId() gibt die gespeicherte Auswahl zurück, null, wenn keine gespeichert ist; setSelectedThemeId(null) löscht sie; getSystemTheme(ColorScheme) ermittelt das Theme für ein Farbschema und offersSystemThemes() gibt an, ob „hell“ und „dunkel“ zu unterschiedlichen Themes führen. ThemeCommands beginnt seine Einträge mit „System“, was die Auswahl löscht und als deaktiviert angezeigt wird, solange keine gespeichert ist; die Design-Einträge werden durch die gespeicherte Auswahl deaktiviert. Der Eintrag „System“ erscheint nur, wenn offersSystemThemes() wahr ist. SetThemeCommand ohne Angabe eines Designs wechselt zur Systemeinstellung.
Nicht im Geltungsbereich
Die Zuordnung von Sprachen zu Flaggen-Symbolen im selben Menü ist ein separates Projekt.
Migration
- Verhalten: Nutzer der React-Benutzeroberfläche, die noch nie ein Design ausgewählt haben, sehen nun das Design, das der Darstellungspräferenz ihres Betriebssystems entspricht, anstatt des konfigurierten Standarddesigns. Wenn dies unerwünscht ist, markieren Sie kein Design als Systemstandard: Beide Einstellungen führen dann zum Standarddesign, die Seite folgt keinem Design, und der Eintrag „System“ wird nicht angezeigt.
- Themenkonfiguration: Jedes Thema mit dunklem Erscheinungsbild sollte „color-scheme="dark"“ deklarieren (dies wird von Themen geerbt, die darauf aufbauen), andernfalls behalten Bildlaufleisten und Formularsteuerelemente ihr helles Erscheinungsbild. Das Design, das einem dunklen Betriebssystem entsprechen soll, erhält „system-default=“true““; ein helles Design, das nicht das Standarddesign ist und einem hellen Betriebssystem entsprechen soll, erhält dies ebenfalls.
- API: UIThemeService.getActiveThemeId() und setActiveThemeId(String) werden durch getSelectedThemeId() (gibt null zurück, wenn „keine Auswahl gespeichert“ ist, niemals den Standardwert) und setSelectedThemeId(String) (null löscht die Auswahl) ersetzt. Code, der das auf dem Client aktive Design benötigt, liest document.documentElement.dataset.theme.
- Für Anwendungs-Stylesheets ändert sich nichts: [data-theme="…"] -Regeln gelten weiterhin in beiden Modi.