capacitor-dark-mode
v2.0.2
Published
Handle dark mode changes on android and iOS
Downloads
164
Readme
Ionic Capacitor Dark Mode
For detailed tutorial on how to enable dark mode using this plugin visit: https://medium.com/@hinddeep.purohit007/supporting-dark-mode-in-ionic-capacitor-8e57fe9dbd47
Platforms Supported: Android, iOS, Electron and Web/PWA
This plugin can be used to monitor the changes made to system's dark mode.
Installation
npm install capacitor-dark-mode
Android Configuration:
- Open AndroidManifest.xml and find the activity tag.
- Inspect android:configChanges="..."
- If you find uiMode, please remove it. If it isn't present you can move on safely without doing anything.
Open MainActivity.java and add the following code inside this.init() registerPlugin(DarkMode.class); Adding the above mentioned line will add the following import statement: import com.bkon.capacitor.DarkMode.DarkMode; If you encounter errors, please add both the lines manually to MainActivity.java
iOS Configuration:
In the native ios project you will find two modules namely, 'App' and 'Pods'
- Select Pods
- Expand 'Development Pods'
- Expand 'Capacitor' and open 'CAPBridgeViewController.swift'
- Scroll to the very end of the class and paste the following method
public override func traitCollectionDidChange(\_ previousTraitCollection: UITraitCollection?) {
if #available(iOS 13.0, \*) {
if self.traitCollection.userInterfaceStyle.rawValue != previousTraitCollection?.userInterfaceStyle.rawValue
{
var darkmode = ["isDarkModeOn":false]
if self.traitCollection.userInterfaceStyle.rawValue == 2
{
darkmode = ["isDarkModeOn":true]
}
else
{
darkmode = ["isDarkModeOn":false]
}
NotificationCenter.default.post(name: NSNotification.Name(rawValue: "CAPDarkModeDidChange"), object: self, userInfo: darkmode )
}
else
{
// No Change
}
} else {
// Fallback on earlier versions.
}
}
Web Configuration
import { Plugins } from '@capacitor/core';
const { DarkMode } = Plugins;
import 'capacitor-dark-mode';
SPECIAL NOTE: Remove the import " import 'capacitor-dark-mode' " when building the app for Android and iOS. THe native plugin will not be invoked if you forget to remove the import statement before building for Android and iOS Platform.
If you wish to listen to system wide dark mode chamges on the web/PWA, add the following line to enable the listener:
if(!(platform.is("android") || platform.is("ios")))
{
DarkMode.registerDarkModeChangeListener()
}
Listen for changes to Dark Mode:
The event listener might run outside the zone of angular so we might have to trigger change detection ourselves. That is why changedetectorref.detectChanges() has been used.
DarkMode.addListener("darkModeStateChanged", (state: any) =>
if(state.isDarkModeOn)
{
// Dark mode is on. Apply dark theme to your app
changedetectorref.detectChanges()
}
else
{
// Dark mode is off. Apply light theme to your app
changedetectorref.detectChanges()
}
if(state.supported == false)
{
// Dark mode is not supported by the platform
changedetectorref.detectChanges()
}
});
Check if dark mode is enabled or not:
let darkmode = await DarkMode.isDarkModeOn();
console.log(darkmode.isDarkModeOn);