Skip to content

Fix: .rex-docs Dark-Mode-Hintergrund färbt in Doku-Seiten anderer Addons ab - #4

Open
VIEWSION wants to merge 1 commit into
mainfrom
fix/rex-docs-dark-mode-bleed
Open

Fix: .rex-docs Dark-Mode-Hintergrund färbt in Doku-Seiten anderer Addons ab#4
VIEWSION wants to merge 1 commit into
mainfrom
fix/rex-docs-dark-mode-bleed

Conversation

@VIEWSION

@VIEWSION VIEWSION commented Aug 19, 2026

Copy link
Copy Markdown
Member

Problem

boot.php lädt assets/styles.css auf jeder Backend-Seite, nicht nur auf den eigenen Seiten dieses Addons:

if (rex::isBackend() && rex::getUser()) {
    rex_view::addCssFile($addon->getAssetsUrl('styles.css'));
    ...
}

Diese Stylesheet-Datei enthält:

.rex-docs {
    background-color: #fff;
    padding: 20px;
}

.rex-docs ist aber REDAXOs generische Wrapper-Klasse, die core/page/docs.php für jede Markdown-Doku-/Hilfeseite eines Addons verwendet (subPath: README.md usw.) – nicht etwas, das speziell zu ai_platform gehört.

Der Core liefert für .rex-docs bereits korrektes Light-/Dark-Styling (siehe be_styles _docs.scss), inklusive heller Textfarbe im Dark Mode. Da diese Regel hier einen festen weißen Hintergrund ohne Dark-Mode-Variante erzwingt, überschreibt sie global das Hintergrund-Handling des Cores für .rex-docs im gesamten Backend – im Dark Mode landet dadurch die (korrekt) helle Textfarbe des Cores auf diesem erzwungenen weißen Hintergrund: unsichtbarer Text.

Reproduktion

Live mit aktiviertem Dark Mode bestätigt: Jede Doku-/Hilfeseite eines anderen Addons, die REDAXOs Standard-Markdown-Doku-Rendering nutzt, ist betroffen. Beispiel – die Unterseiten Hilfe / Entwickler / Lizenzen des CKEditor-5-Addons zeigen leere weiße Boxen, wo eigentlich Überschriften und Fließtext stehen sollten, weil die Textfarbe (durch den Dark-Mode-Override des Cores) weiß ist und der Hintergrund durch diese Regel auf weiß erzwungen wird.

Computed Style an der fehlerhaften Stelle:

.rex-docs → background-color: rgb(255, 255, 255)   (aus assets/addons/ai_platform/styles.css)
h3 innerhalb .rex-docs → color: rgba(255, 255, 255, 0.75)   (aus dem Core, korrekt Dark-Mode-fähig)

Fix

Die Regel entfernen. Das Core-Styling von .rex-docs deckt Light und Dark Mode bereits korrekt ab – auch für die eigene Doku-Seite dieses Addons (pages/docs.php, ?page=ai_platform/docs), das wurde geprüft: die Seite sieht ohne diese Regel unverändert korrekt aus (Light und Dark).

Testing

  • ai_platform/docs in Light und Dark Mode neu geladen – Darstellung identisch wie vorher, jetzt über das Core-eigene Light-/Dark-Styling von .rex-docs.
  • Die Seiten Hilfe / Entwickler / Lizenzen des CKEditor-5-Addons im Dark Mode neu geladen – Text ist jetzt sichtbar (vorher unsichtbar, weiß auf weiß).

@VIEWSION VIEWSION changed the title Fix: .rex-docs dark-mode background leaks into other addons' docs pages Fix: .rex-docs Dark-Mode-Hintergrund färbt in Doku-Seiten anderer Addons ab Aug 19, 2026
boot.php laedt assets/styles.css auf jeder Backend-Seite, nicht nur
auf den eigenen Seiten dieses Addons. Die Datei erzwang einen festen
weissen Hintergrund fuer .rex-docs ohne Dark-Mode-Variante.

.rex-docs ist REDAXOs generische Wrapper-Klasse fuer die Markdown-
Doku-Seite jedes Addons (core/page/docs.php), nicht spezifisch fuer
ai_platform. Der Core stylt .rex-docs bereits korrekt fuer Light und
Dark Mode, daher hat der erzwungene weisse Hintergrund hier nur die
Lesbarkeit auf anderen Addon-Doku-Seiten im Dark Mode kaputt gemacht:
der Core setzt dort helle Textfarbe, die auf dem erzwungenen weissen
Hintergrund unsichtbar wurde (reproduziert auf den Hilfe-/Entwickler-/
Lizenzen-Seiten des CKEditor-5-Addons).

Ungenutzten Override entfernt; das Core-Styling von .rex-docs deckt
die eigene Doku-Seite von ai_platform bereits korrekt in beiden
Themes ab.
@VIEWSION
VIEWSION force-pushed the fix/rex-docs-dark-mode-bleed branch from 8e03cef to a55dc24 Compare August 19, 2026 18:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant