mirror of
https://github.com/facebook/react-native.git
synced 2025-11-01 09:14:26 +00:00
Summary: Both Android and iOS allow you to set application specific user interface style, which is useful for applications that support both light and dark mode. With the newly added `Appearance.setColorScheme`, you can natively manage the application's user interface style rather than keeping that preference in JavaScript. The benefit is that native dialogs like alert, keyboard, action sheets and more will also be affected by this change. Implemented using Android X [AppCompatDelegate.setDefaultNightMode](https://developer.android.com/reference/androidx/appcompat/app/AppCompatDelegate#setDefaultNightMode(int)) and iOS 13+ [overrideUserInterfaceStyle](https://developer.apple.com/documentation/uikit/uiview/3238086-overrideuserinterfacestyle?language=objc) ```tsx // Lets assume a given device is set to **dark** mode. Appearance.getColorScheme(); // `dark` // Set the app's user interface to `light` Appearance.setColorScheme('light'); Appearance.getColorScheme(); // `light` // Set the app's user interface to `unspecified` Appearance.setColorScheme(null); Appearance.getColorScheme() // `dark` ``` ## Changelog [GENERAL] [ADDED] - Added `setColorScheme` to `Appearance` module Pull Request resolved: https://github.com/facebook/react-native/pull/36122 Test Plan: Added a RNTester for the feature in the Appearance section. Three buttons for toggling all set of modes. Reviewed By: lunaleaps Differential Revision: D43331405 Pulled By: NickGerleman fbshipit-source-id: 3b15f1ed0626d1ad7a8266ec026e903cd3ec46aa
251 lines
6.8 KiB
JavaScript
251 lines
6.8 KiB
JavaScript
/**
|
|
* Copyright (c) Meta Platforms, Inc. and affiliates.
|
|
*
|
|
* This source code is licensed under the MIT license found in the
|
|
* LICENSE file in the root directory of this source tree.
|
|
*
|
|
* @format
|
|
* @flow
|
|
*/
|
|
|
|
import * as React from 'react';
|
|
import {useState, useEffect} from 'react';
|
|
import {Appearance, Text, useColorScheme, View, Button} from 'react-native';
|
|
import type {
|
|
AppearancePreferences,
|
|
ColorSchemeName,
|
|
} from 'react-native/Libraries/Utilities/NativeAppearance';
|
|
import {RNTesterThemeContext, themes} from '../../components/RNTesterTheme';
|
|
|
|
function ColorSchemeSubscription() {
|
|
const [colorScheme, setScheme] = useState<?ColorSchemeName | string>(
|
|
Appearance.getColorScheme(),
|
|
);
|
|
|
|
useEffect(() => {
|
|
const subscription = Appearance.addChangeListener(
|
|
(preferences: AppearancePreferences) => {
|
|
const {colorScheme: scheme} = preferences;
|
|
setScheme(scheme);
|
|
},
|
|
);
|
|
|
|
return () => subscription?.remove();
|
|
}, [setScheme]);
|
|
|
|
return (
|
|
<RNTesterThemeContext.Consumer>
|
|
{theme => {
|
|
return (
|
|
<ThemedContainer>
|
|
<ThemedText>{colorScheme}</ThemedText>
|
|
</ThemedContainer>
|
|
);
|
|
}}
|
|
</RNTesterThemeContext.Consumer>
|
|
);
|
|
}
|
|
|
|
const ThemedContainer = (props: {children: React.Node}) => (
|
|
<RNTesterThemeContext.Consumer>
|
|
{theme => {
|
|
return (
|
|
<View
|
|
style={{
|
|
paddingHorizontal: 8,
|
|
paddingVertical: 16,
|
|
backgroundColor: theme.SystemBackgroundColor,
|
|
}}>
|
|
{props.children}
|
|
</View>
|
|
);
|
|
}}
|
|
</RNTesterThemeContext.Consumer>
|
|
);
|
|
|
|
const ThemedText = (props: {children: React.Node | string}) => (
|
|
<RNTesterThemeContext.Consumer>
|
|
{theme => {
|
|
return <Text style={{color: theme.LabelColor}}>{props.children}</Text>;
|
|
}}
|
|
</RNTesterThemeContext.Consumer>
|
|
);
|
|
|
|
const AppearanceViaHook = () => {
|
|
const colorScheme = useColorScheme();
|
|
return (
|
|
<RNTesterThemeContext.Provider
|
|
value={colorScheme === 'dark' ? themes.dark : themes.light}>
|
|
<ThemedContainer>
|
|
<ThemedText>useColorScheme(): {colorScheme}</ThemedText>
|
|
</ThemedContainer>
|
|
</RNTesterThemeContext.Provider>
|
|
);
|
|
};
|
|
|
|
const ColorShowcase = (props: {themeName: string}) => (
|
|
<RNTesterThemeContext.Consumer>
|
|
{theme => {
|
|
return (
|
|
<View
|
|
style={{
|
|
marginVertical: 20,
|
|
backgroundColor: theme.SystemBackgroundColor,
|
|
}}>
|
|
<Text style={{fontWeight: '700', color: theme.LabelColor}}>
|
|
{props.themeName}
|
|
</Text>
|
|
{Object.keys(theme).map(key => (
|
|
<View style={{flexDirection: 'row'}} key={key}>
|
|
<View
|
|
style={{
|
|
width: 50,
|
|
height: 50,
|
|
paddingHorizontal: 8,
|
|
paddingVertical: 2,
|
|
backgroundColor: theme[key],
|
|
}}
|
|
/>
|
|
<View>
|
|
<Text
|
|
style={{
|
|
paddingHorizontal: 16,
|
|
paddingVertical: 2,
|
|
color: theme.LabelColor,
|
|
fontWeight: '600',
|
|
}}>
|
|
{key}
|
|
</Text>
|
|
<Text
|
|
style={{
|
|
paddingHorizontal: 16,
|
|
paddingVertical: 2,
|
|
color: theme.LabelColor,
|
|
}}>
|
|
{typeof theme[key] === 'string'
|
|
? theme[key]
|
|
: JSON.stringify(theme[key])}
|
|
</Text>
|
|
</View>
|
|
</View>
|
|
))}
|
|
</View>
|
|
);
|
|
}}
|
|
</RNTesterThemeContext.Consumer>
|
|
);
|
|
|
|
const ToggleNativeAppearance = () => {
|
|
const [nativeColorScheme, setNativeColorScheme] =
|
|
useState<ColorSchemeName | null>(null);
|
|
const colorScheme = useColorScheme();
|
|
|
|
useEffect(() => {
|
|
Appearance.setColorScheme(nativeColorScheme);
|
|
}, [nativeColorScheme]);
|
|
|
|
return (
|
|
<View>
|
|
<Text>Native colorScheme: {nativeColorScheme}</Text>
|
|
<Text>Current colorScheme: {colorScheme}</Text>
|
|
<Button
|
|
title="Set to light"
|
|
onPress={() => setNativeColorScheme('light')}
|
|
/>
|
|
<Button
|
|
title="Set to dark"
|
|
onPress={() => setNativeColorScheme('dark')}
|
|
/>
|
|
<Button title="Unset" onPress={() => setNativeColorScheme(null)} />
|
|
</View>
|
|
);
|
|
};
|
|
|
|
exports.title = 'Appearance';
|
|
exports.category = 'UI';
|
|
exports.documentationURL = 'https://reactnative.dev/docs/appearance';
|
|
exports.description = 'Light and dark user interface examples.';
|
|
exports.examples = [
|
|
{
|
|
title: 'useColorScheme hook',
|
|
render(): React.Node {
|
|
return <AppearanceViaHook />;
|
|
},
|
|
},
|
|
{
|
|
title: 'Non-component `getColorScheme` API',
|
|
render(): React.Element<any> {
|
|
return <ColorSchemeSubscription />;
|
|
},
|
|
},
|
|
{
|
|
title: 'Consuming Context',
|
|
render(): React.Element<any> {
|
|
return (
|
|
<RNTesterThemeContext.Consumer>
|
|
{theme => {
|
|
return (
|
|
<ThemedContainer>
|
|
<ThemedText>
|
|
This block of text inherits its theme via Context.
|
|
</ThemedText>
|
|
</ThemedContainer>
|
|
);
|
|
}}
|
|
</RNTesterThemeContext.Consumer>
|
|
);
|
|
},
|
|
},
|
|
{
|
|
title: 'Context forced to light theme',
|
|
render(): React.Element<any> {
|
|
return (
|
|
<RNTesterThemeContext.Provider value={themes.light}>
|
|
<ThemedContainer>
|
|
<ThemedText>
|
|
This block of text will always render with a light theme.
|
|
</ThemedText>
|
|
</ThemedContainer>
|
|
</RNTesterThemeContext.Provider>
|
|
);
|
|
},
|
|
},
|
|
{
|
|
title: 'Context forced to dark theme',
|
|
render(): React.Element<any> {
|
|
return (
|
|
<RNTesterThemeContext.Provider value={themes.dark}>
|
|
<ThemedContainer>
|
|
<ThemedText>
|
|
This block of text will always render with a dark theme.
|
|
</ThemedText>
|
|
</ThemedContainer>
|
|
</RNTesterThemeContext.Provider>
|
|
);
|
|
},
|
|
},
|
|
{
|
|
title: 'RNTester App Colors',
|
|
description: 'A light and a dark theme based on standard iOS 13 colors.',
|
|
render(): React.Element<any> {
|
|
return (
|
|
<View>
|
|
<RNTesterThemeContext.Provider value={themes.light}>
|
|
<ColorShowcase themeName="Light Mode" />
|
|
</RNTesterThemeContext.Provider>
|
|
<RNTesterThemeContext.Provider value={themes.dark}>
|
|
<ColorShowcase themeName="Dark Mode" />
|
|
</RNTesterThemeContext.Provider>
|
|
</View>
|
|
);
|
|
},
|
|
},
|
|
{
|
|
title: 'Toggle native appearance',
|
|
description: 'Overwrite application-level appearance mode',
|
|
render(): React.Element<any> {
|
|
return <ToggleNativeAppearance />;
|
|
},
|
|
},
|
|
];
|