Added a dark mode property on App.

android/src/toga_android/app.py

@@ -257,6 +257,14 @@ def get_screens(self):
         screen_list = display_manager.getDisplays()
         return [ScreenImpl(self, screen) for screen in screen_list]
 
+    ######################################################################
+    # App state
+    ######################################################################
+
+    def get_dark_mode_state(self):
+        self.interface.factory.not_implemented("dark mode state")
+        return None
+
     ######################################################################
     # App capabilities
     ######################################################################

changes/2841.feature.txt

@@ -0,0 +1 @@
+Apps can now interrogate whether they are in dark mode on some platforms.

cocoa/src/toga_cocoa/app.py

@@ -312,6 +312,17 @@ def set_main_window(self, window):
     def get_screens(self):
         return [ScreenImpl(native=screen) for screen in NSScreen.screens]
 
+    ######################################################################
+    # App state
+    ######################################################################
+
+    def get_dark_mode_state(self):
+        appearance = self.native.effectiveAppearance
+        # Standard theme names in MacOS
+        # https://developer.apple.com/documentation/appkit/nsappearance/name-swift.struct?language=objc
+        in_dark_mode = "Dark" in str(appearance.name)
+        return in_dark_mode
+
     ######################################################################
     # App capabilities
     ######################################################################

core/src/toga/app.py

@@ -391,6 +391,15 @@ def home_page(self) -> str | None:
         menu items."""
         return self._home_page
 
+    @property
+    def dark_mode(self) -> bool | None:
+        """Whether the user has dark mode enabled in their environment (read-only).
+
+        :returns: A Boolean describing if the app is in dark mode; ``None`` if Toga
+        cannot determine if the app is in dark mode.
+        """
+        return self._impl.get_dark_mode_state()
+
     @property
     def icon(self) -> Icon:
         """The Icon for the app.

core/tests/app/test_app.py

@@ -796,6 +796,12 @@ async def on_running(self):
     assert running["called"]
 
 
+def test_dark_mode_state(app):
+    """Dark mode settings can be read through the dark_mode property."""
+    # The dummy backend is currently set to always be True
+    assert app.dark_mode
+
+
 def test_deprecated_id(event_loop):
     """The deprecated `id` constructor argument is ignored, and the property of the same
     name is redirected to `app_id`"""

dummy/src/toga_dummy/app.py

@@ -93,6 +93,13 @@ def get_screens(self):
     def set_icon(self, icon):
         self._action("set_icon", icon=icon)
 
+    ######################################################################
+    # App state
+    ######################################################################
+
+    def get_dark_mode_state(self):
+        return True
+
     ######################################################################
     # App capabilities
     ######################################################################

gtk/src/toga_gtk/app.py

@@ -188,6 +188,14 @@ def get_screens(self):
             ]
             return screen_list
 
+    ######################################################################
+    # App state
+    ######################################################################
+
+    def get_dark_mode_state(self):
+        self.interface.factory.not_implemented("dark mode state")
+        return None
+
     ######################################################################
     # App capabilities
     ######################################################################

iOS/src/toga_iOS/app.py

@@ -112,6 +112,14 @@ def set_main_window(self, window):
     def get_screens(self):
         return [ScreenImpl(UIScreen.mainScreen)]
 
+    ######################################################################
+    # App state
+    ######################################################################
+
+    def get_dark_mode_state(self):
+        self.interface.factory.not_implemented("dark mode state")
+        return None
+
     ######################################################################
     # App capabilities
     ######################################################################

iOS/src/toga_iOS/screens.py

@@ -9,6 +9,7 @@ class Screen:
     _instances = {}
 
     def __new__(cls, native):
+        # native is an instance of UIScreen
         if native in cls._instances:
             return cls._instances[native]
         else:

testbed/tests/app/test_app.py

@@ -1,3 +1,4 @@
+from types import NoneType
 from unittest.mock import Mock
 
 import toga
@@ -253,3 +254,7 @@ async def test_app_icon(app, app_probe):
     app.icon = toga.Icon.APP_ICON
     await app_probe.redraw("Revert app icon to default")
     app_probe.assert_app_icon(None)
+
+
+async def test_dark_mode_state_read(app):
+    assert isinstance(app.dark_mode, (NoneType, bool))

textual/src/toga_textual/app.py

@@ -74,6 +74,14 @@ def set_main_window(self, window):
     def get_screens(self):
         return [ScreenImpl(window._impl.native) for window in self.interface.windows]
 
+    ######################################################################
+    # App state
+    ######################################################################
+
+    def get_dark_mode_state(self):
+        self.interface.factory.not_implemented("dark mode state")
+        return None
+
     ######################################################################
     # App capabilities
     ######################################################################

web/src/toga_web/app.py

@@ -68,6 +68,14 @@ def set_main_window(self, window):
     def get_screens(self):
         return [ScreenImpl(js.document.documentElement)]
 
+    ######################################################################
+    # App state
+    ######################################################################
+
+    def get_dark_mode_state(self):
+        self.interface.factory.not_implemented("dark mode state")
+        return None
+
     ######################################################################
     # App capabilities
     ######################################################################

winforms/src/toga_winforms/app.py

@@ -206,6 +206,14 @@ def get_screens(self):
         ]
         return screen_list
 
+    ######################################################################
+    # App state
+    ######################################################################
+
+    def get_dark_mode_state(self):
+        self.interface.factory.not_implemented("dark mode state")
+        return None
+
     ######################################################################
     # App capabilities
     ######################################################################