Describe about color scheme policy

piroor · Mar 6, 2020 · 31178db · 31178db
1 parent aaf0f47
commit 31178db
Showing 1 changed file with 17 additions and 0 deletions.
diff --git a/webextensions/resources/ui-color.css b/webextensions/resources/ui-color.css
@@ -189,6 +189,23 @@ hr {
 }
 
 @media (prefers-color-scheme: dark) {
+  /*
+    We don't apply the dark color scheme, when the system
+    color mode is active.
+
+     * The system color mode of TST is enabled by default
+       only on Linux. Firefox's default theme on Linux uses
+       system colors, so we also need to use system colors
+       on addon. On this environment, CSS media query based
+       "dark mode" is not supported.
+     * The system color mode is disabled on Windows and macOS.
+       Firefox's default theme on these environments are
+       designed with Photon color scheme, and colors are
+       switched to dark colors when the dark color mode is
+       activated on the OS side. So, TST also does same thing
+       - applies light colors by default, and applies dark
+       colors on the dark color mode.
+   */
   :root#sidebar.apply-browser-theme:not([color-scheme="system-color"]),
   :root:not(#sidebar):not([color-scheme="system-color"]) {
     /* https://hg.mozilla.org/mozilla-central/raw-file/tip/toolkit/themes/shared/in-content/common.inc.css */