GitHub
npm
expo-system-ui enables you to interact with UI elements that fall outside of the React tree. Specifically the root view background color, and locking the user interface style globally on Android.
| Android Device | Android Emulator | iOS Device | iOS Simulator | Web |
|---|---|---|---|---|
- npx expo install expo-system-uiIf you're installing this in a bare React Native app, you should also follow these additional installation instructions.
import * as SystemUI from 'expo-system-ui';
SystemUI.getBackgroundColorAsync()Gets the root view background color.
Example
const color = await SystemUI.getBackgroundColorAsync();
Returns
Promise<ColorValue | null>Current root view background color in hex format. Returns null if the background color is not set.
SystemUI.setBackgroundColorAsync(color)| Name | Type | Description |
|---|---|---|
| color | ColorValue | Any valid CSS 3 (SVG) color. |
Changes the root view background color.
Example
SystemUI.setBackgroundColorAsync("white");
Returns
Promise<void>