- Design-Tokens – CSS-Variablen für Farben, Schriften und Rundungen. Sie decken die meisten Wünsche ab und überstehen jedes Update.
data-ui-Haken – Attribute an Schlüsselstellen (Kopfleiste, Knöpfe, Karten …) für Gestaltung, die über Tokens hinausgeht.
Wie theme.css wirkt
Die Plattform bindettheme.css nach ihrem eigenen CSS ein. Das CSS der Anwendung liegt vollständig in CSS-Cascade-Layern, theme.css dagegen in keinem Layer – deshalb gewinnt theme.css immer, unabhängig von der Spezifität der Regeln der Anwendung. !important ist nie nötig. Spezifität spielt nur innerhalb von theme.css eine Rolle.
Im HTML stehen dafür:
theme.css (url('fonts/…')) erben sie.
data-theme ist die Wahl des Mitglieds; ohne eigene Wahl der defaultMode des Themes.
Design-Tokens
Ein Theme setzt die Tokens auf:root. Werte für hell und dunkel stehen mit light-dark(hell, dunkel) in einer Zeile.
Alle übrigen Farben – Texte, Ränder, graue Flächen, Statusfarben wie Rot, Grün und Gelb – stammen aus der eingebauten Farbpalette (Tailwind CSS:
--color-slate-50 … --color-slate-950, --color-red-… usw.). Im dunklen Modus spiegelt die Plattform diese Palette automatisch: Weiß wird zur Kartenfarbe, die Grautöne kehren sich um, helle Farbtöne (50–300) tauschen mit den dunklen (700–950). Die Standardwerte der Tokens verweisen auf die Palette und schalten deshalb von selbst mit.
Hell, dunkel und Systemeinstellung
Mitglieder wählen in der Kopfleiste hell, dunkel oder „wie das System“. Wer nichts gewählt hat, bekommt dendefaultMode aus theme.json. Im dunklen Modus (ausdrücklich gewählt oder vom System) setzt die Plattform color-scheme: dark; darauf reagiert light-dark(). Gedruckt wird immer hell.
Ist ein Theme immer dunkel (dunkle Flächen auch im hellen Modus, ohne light-dark()), setzt es selbst color-scheme: dark in @media not print { :root { … } }. Sonst zeigt der Browser Datumswähler, Bildlaufleisten und automatisch ausgefüllte Felder hell auf der dunklen Seite. Aufgeklappte Auswahllisten und den Knopf „Datei auswählen“ färbt die Plattform selbst mit --color-surface und --color-ink.
Farben je Modus – eine Zeile, beide Werte:
light-dark() funktioniert für alle Farbangaben, auch innerhalb von linear-gradient(…), box-shadow oder border, aber nur für Farben.
Alles andere je Modus (z. B. ein anderes Hintergrundbild) und Paletten-Farben (--color-slate-…, --color-white) brauchen beide Selektoren – sonst greift die Einstellung „wie das System“ nicht:
Schriften
Ohne Schriftdateien: Schriften, die auf praktisch jedem Gerät vorhanden sind, kosten keine Ladezeit und keine Lizenzprüfung. Das Beispiel-Theme setzt Überschriften so in einer Serifenschrift:-
Die Schrift als
.woff2ins Theme legen, z. B.fonts/inter-latin-400.woff2undfonts/inter-latin-700.woff2. Nur die benötigten Schnitte und Zeichensätze (meist „latin“) einbinden – jede Datei kostet Ladezeit. -
Die Lizenz prüfen und als Datei danebenlegen. Schriften unter der SIL Open Font License (OFL, z. B. viele Schriften von Google Fonts) dürfen selbst gehostet werden; die Datei
OFL.txtgehört dazu. Kommerzielle Schriften brauchen eine Lizenz für die Verwendung im Web („Webfont“). -
In
theme.csseinbinden – die Adresse ist relativ zur CSS-Datei: -
Den wichtigsten Schnitt (meist den normalen) in
theme.jsonunterfontsmitpreloadeintragen; die Plattform lädt ihn dann früh (<link rel="preload">) und der Text springt beim Laden nicht um:
font-family auf solchen Text (z. B. .prose blockquote), schreiben Sie font-family: var(--font-emoji), var(--font-display);, sonst bleiben Emoji dort in normaler Größe.
Logo, Favicon und App-Icons
- Logo (
logo, optionallogoDark): SVG, PNG oder WebP. Es wird in der Kopfleiste auf 2 rem (32 px) Höhe skaliert, die Breite ergibt sich aus dem Seitenverhältnis. Breite Logos mit Schriftzug funktionieren gut; dann"showName": false, damit der Plattformname nicht doppelt erscheint. Ein quadratisches Bildzeichen passt zu"showName": true. - Dunkler Modus: Ein Logo mit dunkler Schrift verschwindet auf dunklem Grund. Mit
logoDarkzeigt die Plattform im dunklen Modus eine zweite Fassung. - Favicon (
favicon): SVG oder PNG, quadratisch. - App-Icons (
icons): PNG in 192 × 192 und 512 × 512 Pixeln für die installierte App (PWA) und den Startbildschirm von iPhones. Motiv mit etwas Rand gestalten, Android schneidet Icons rund oder abgerundet zu. themeColor/backgroundColor: Farbe der Browserleiste auf Mobilgeräten und des Startbildschirms der installierten App – sinnvollerweise die Hauptfarbe bzw. die Seitenfarbe des Standardmodus.
<script>, keine Ereignis-Attribute wie onload, kein <foreignObject>, keine Verweise auf fremde Adressen, kein DOCTYPE) und liefert sie mit einer Sicherheitsrichtlinie aus, die auch beim direkten Aufruf jedes Skript unterbindet. Grafikprogramme speichern gelegentlich Metadaten oder Verweise mit; „Als optimiertes SVG speichern“ bzw. ein Werkzeug wie SVGO entfernt sie. SVG geht nur über ein Theme – im Plattform-Admin lassen sich als eigenes Logo nur PNG, WebP und JPEG hochladen (siehe Darstellung). Ein hochgeladenes Logo hat Vorrang vor dem Logo des Themes.
data-ui-Haken
Für Gestaltung über die Tokens hinaus tragen Schlüsselstellen eindata-ui-Attribut. Selektoren der Form [data-ui='header'] sind stabil.
Gestaltung über Haken gehört in
@media screen { … }, damit Zertifikate, Nachweise und andere Druckseiten sauber und hell drucken.
Rezepte
Alle Rezepte stehen auch auskommentiert im Beispiel-Theme.Primärfarbe ändern
--color-on-primary mitprüfen: Text auf der Hauptfarbe braucht in beiden Modi mindestens 4,5 : 1 Kontrast (siehe Kontrast). Helle Hauptfarben (Gelb, Türkis, Hellgrün) brauchen dunklen Text.
Rundungen und Pillen-Knöpfe
0.
Eigene Überschriften-Schrift
Gläserne Kopfleiste
Farbverlauf im Seitentitel
Dunkler Standard
Intheme.json startet das Theme dunkel; Mitglieder können trotzdem auf hell umschalten:
mitternacht ist ein vollständiges Beispiel.
Hintergrundbild im Kopfbereich öffentlicher Seiten
url('hero.webp')) oder als data:-Adresse. Die dunkle Überlagerung hält den Text lesbar; auf dem Bild selbst ist der Kontrast sonst nicht vorhersehbar.
Communities mit eigener Farbe und eigenem Logo
Owner und Admins einer Community können in ihren Einstellungen (Allgemein → Logo und Farbe) ein eigenes Logo hochladen (PNG, WebP oder JPEG bis 2 MB) und die Primärfarbe übersteuern – getrennt für hell und dunkel. Alles andere (Flächen, Text, Links, Fokus, Schriften, Rundungen, Haken-Gestaltung) bleibt beim Theme. Die Farbe gilt nur auf den Seiten dieser Community, Startseite, Verzeichnis, Konto und Plattform-Admin behalten die Farbe des Themes. So spielt das mit Ihrem Theme zusammen:- Die Plattform liefert für die Community eine eigene kleine CSS-Datei aus, die nach
theme.cssgeladen wird und nur--color-primary,--color-primary-hoverund--color-on-primarysetzt – mit dem Selektor:root[data-community][data-theme]. Damit gewinnt die Community-Farbe gegen die Primärfarbe des Themes. - Verwenden Sie in eigenen Regeln
var(--color-primary)statt eines festen Farbwerts (wie in den Rezepten oben). Dann folgen auch Ihre Haken-Gestaltungen – Schatten, Ränder, Verläufe – der Farbe der Community. - Setzen Sie die Primär-Tokens nicht mit noch spezifischeren Selektoren; sonst kann eine Community ihre Farbe nicht mehr durchsetzen.
- Die Plattform prüft die Community-Farbe beim Speichern gegen die Flächen- und Seitenfarbe des aktiven Themes (Beschriftung 4,5 : 1, Primärfarbe auf Fläche und Seite 3 : 1). Hover-Farbe und Beschriftung (Schwarz oder Weiß) leitet sie selbst ab. Grundlage sind die Farben aus dem Theme-Editor; bei Themes, die nicht mit dem Editor erstellt wurden, prüft sie gegen die Standardfarben.
- Das Community-Logo erscheint in der Kopfleiste neben dem Plattform-Logo (
[data-ui='community-logo']), auf Landingpage und „Über uns“ und auf den Karten des Verzeichnisses. Für Vorschaubilder in sozialen Netzwerken (og:image) setzt die Plattform das Logo auf die helle Seitenfarbe Ihres Themes.
Kontrast und Barrierefreiheit
Richtwert ist WCAG 2.2, Stufe AA:
Worauf Sie achten sollten:
- Paare in beiden Modi prüfen:
--color-on-primaryauf--color-primary,--color-linkauf--color-pageund--color-surface,--color-inkauf--color-page– jeweils hell und dunkel. - Fokus sichtbar halten:
--color-focusnie transparent oder in Hintergrundfarbe. Tastaturnutzer erkennen nur am Rahmen, wo sie sind. - Transparenz und Verläufe: Gläserne Flächen und Farbverläufe verändern den Kontrast je nach Untergrund. An der ungünstigsten Stelle messen.
- Nicht nur über Farbe: Eigene Gestaltung sollte Zustände nicht allein über Farbe unterscheiden und vorhandene Merkmale wie Unterstreichungen, Ränder oder Symbole nicht entfernen.
- Bewegung: Animationen nur in
@media (prefers-reduced-motion: no-preference) { … }. - Messen: Die Entwicklerwerkzeuge von Chrome, Edge und Firefox zeigen beim Untersuchen eines Elements das Kontrastverhältnis an; für Farbpaare eignen sich Kontrastrechner nach WCAG.
#0f766e mit weißer Schrift 5,5 : 1, Petrol auf dem Seitenhintergrund #f6f5f2 5,0 : 1; im dunklen Modus Türkis #2dd4bf mit Schrift #042f2e 7,8 : 1.
Sicherheitsregeln (CSP)
Die Content-Security-Policy der Plattform gilt auch für Themes. Was sie verletzt, blockiert der Browser – meist ohne sichtbare Fehlermeldung, nur in der Konsole:- Stylesheets, Schriften und Bilder nur vom eigenen Server: aus dem Theme-Verzeichnis (relativ, z. B.
url('fonts/inter.woff2')) oder alsdata:-Adresse für Bilder und Schriften. Keine Google Fonts, keine CDNs, kein@import. Das prüft schon der Upload und nennt Datei und Zeile. - Kein JavaScript – weder als Datei noch in SVG-Grafiken (SVG-Logos werden als Bild eingebunden, Skripte darin laufen nicht).
- Alles CSS in
theme.css; das Theme kann keinestyle-Attribute in Seiten einfügen.