2016-04-25 06:36:38 +00:00
|
|
|
# systemPreferences
|
|
|
|
|
|
|
|
> Get system preferences.
|
|
|
|
|
2016-06-19 15:53:34 +00:00
|
|
|
```javascript
|
|
|
|
const {systemPreferences} = require('electron');
|
|
|
|
console.log(systemPreferences.isDarkMode());
|
|
|
|
```
|
|
|
|
|
2016-04-25 06:36:38 +00:00
|
|
|
## Methods
|
|
|
|
|
2016-06-18 13:26:26 +00:00
|
|
|
### `systemPreferences.isDarkMode()` _macOS_
|
2016-04-25 06:36:38 +00:00
|
|
|
|
|
|
|
This method returns `true` if the system is in Dark Mode, and `false` otherwise.
|
|
|
|
|
2016-06-18 13:26:26 +00:00
|
|
|
### `systemPreferences.subscribeNotification(event, callback)` _macOS_
|
2016-04-25 06:36:38 +00:00
|
|
|
|
|
|
|
* `event` String
|
|
|
|
* `callback` Function
|
|
|
|
|
2016-06-18 13:26:26 +00:00
|
|
|
Subscribes to native notifications of macOS, `callback` will be called with
|
2016-05-18 05:40:19 +00:00
|
|
|
`callback(event, userInfo)` when the corresponding `event` happens. The
|
|
|
|
`userInfo` is an Object that contains the user information dictionary sent
|
|
|
|
along with the notification.
|
|
|
|
|
|
|
|
The `id` of the subscriber is returned, which can be used to unsubscribe the
|
|
|
|
`event`.
|
2016-04-25 06:36:38 +00:00
|
|
|
|
|
|
|
Under the hood this API subscribes to `NSDistributedNotificationCenter`,
|
2016-05-18 05:40:19 +00:00
|
|
|
example values of `event` are:
|
2016-04-25 06:36:38 +00:00
|
|
|
|
|
|
|
* `AppleInterfaceThemeChangedNotification`
|
|
|
|
* `AppleAquaColorVariantChanged`
|
|
|
|
* `AppleColorPreferencesChangedNotification`
|
|
|
|
* `AppleShowScrollBarsSettingChanged`
|
|
|
|
|
2016-06-18 13:26:26 +00:00
|
|
|
### `systemPreferences.unsubscribeNotification(id)` _macOS_
|
2016-04-25 06:36:38 +00:00
|
|
|
|
|
|
|
* `id` Integer
|
|
|
|
|
|
|
|
Removes the subscriber with `id`.
|
|
|
|
|
2016-06-18 13:26:26 +00:00
|
|
|
### `systemPreferences.getUserDefault(key, type)` _macOS_
|
2016-04-25 06:36:38 +00:00
|
|
|
|
|
|
|
* `key` String
|
|
|
|
* `type` String - Can be `string`, `boolean`, `integer`, `float`, `double`,
|
2016-06-02 02:21:17 +00:00
|
|
|
`url`, `array`, `dictionary`
|
2016-04-25 06:36:38 +00:00
|
|
|
|
|
|
|
Get the value of `key` in system preferences.
|
|
|
|
|
2016-06-18 13:26:26 +00:00
|
|
|
This API reads from `NSUserDefaults` on macOS, some popular `key` and `type`s
|
2016-04-25 06:36:38 +00:00
|
|
|
are:
|
|
|
|
|
|
|
|
* `AppleInterfaceStyle: string`
|
|
|
|
* `AppleAquaColorVariant: integer`
|
|
|
|
* `AppleHighlightColor: string`
|
|
|
|
* `AppleShowScrollBars: string`
|
2016-06-02 02:21:17 +00:00
|
|
|
* `NSNavRecentPlaces: array`
|
|
|
|
* `NSPreferredWebServices: dictionary`
|
|
|
|
* `NSUserDictionaryReplacementItems: array`
|
2016-04-25 06:36:38 +00:00
|
|
|
|
|
|
|
### `systemPreferences.isAeroGlassEnabled()` _Windows_
|
|
|
|
|
|
|
|
This method returns `true` if [DWM composition][dwm-composition] (Aero Glass) is
|
|
|
|
enabled, and `false` otherwise.
|
|
|
|
|
|
|
|
An example of using it to determine if you should create a transparent window or
|
|
|
|
not (transparent windows won't work correctly when DWM composition is disabled):
|
|
|
|
|
|
|
|
```javascript
|
2016-05-10 17:15:09 +00:00
|
|
|
let browserOptions = {width: 1000, height: 800};
|
2016-04-25 06:36:38 +00:00
|
|
|
|
|
|
|
// Make the window transparent only if the platform supports it.
|
2016-04-30 15:50:04 +00:00
|
|
|
if (process.platform !== 'win32' || systemPreferences.isAeroGlassEnabled()) {
|
2016-04-25 06:36:38 +00:00
|
|
|
browserOptions.transparent = true;
|
|
|
|
browserOptions.frame = false;
|
|
|
|
}
|
|
|
|
|
|
|
|
// Create the window.
|
|
|
|
let win = new BrowserWindow(browserOptions);
|
|
|
|
|
|
|
|
// Navigate.
|
|
|
|
if (browserOptions.transparent) {
|
|
|
|
win.loadURL('file://' + __dirname + '/index.html');
|
|
|
|
} else {
|
|
|
|
// No transparency, so we load a fallback that uses basic styles.
|
|
|
|
win.loadURL('file://' + __dirname + '/fallback.html');
|
|
|
|
}
|
|
|
|
```
|
|
|
|
|
|
|
|
[dwm-composition]:https://msdn.microsoft.com/en-us/library/windows/desktop/aa969540.aspx
|