1.3.1 • Published 3 years ago

react-native-paper-navigation-theme-context v1.3.1

Weekly downloads
-
License
ISC
Repository
github
Last release
3 years ago

react-native-paper-navigation-theme-context

Theme Context for react-native, to support Light, Dark and Default (your device) theme for your react-native-paper and your react-navigation components.


Travis (.com) David npm NPM npm GitHub top language

Dependencies

To make this module work, you have to be working in a react-native project. (If you want to use the built-in components to toggle the theme you have to need react-native-paper installed aswell).

So basically, these are the modules that you need to have installed.

  • react
  • react-native
  • react-native-paper (optional if you want to use the components)

Instalation

Just run in your console npm i react-native-paper-navigation-theme-context

Usage - Principal

In this example I'll provide a theme to react-native-paper and react-navigation, but if you want, you can add it to only one of them. (For example if your project doesn't use react-navigation and you want to theme the react-native-paper components)

Now, instead of the normal PaperTheme and NavigationTheme, you'll use a mix of the two named MixedTheme, note that initially, useMixedTheme() returns a MixedTheme based on your device's preferences (if you have the darkmode in you device, a DarkTheme will be returned).

import {ThemeProvider, useTheme} from 'react-native-paper-navigation-theme-context';
import { Provider as PaperProvider } from "react-native-paper";
import { NavigationContainer } from "@react-navigation/native";

// This is suposed to be your app
import Screen from './Screen';

const Providers = ({children}) => {
    // useTheme gives you the functions from ThemeProvider
    const { useMixedTheme } = useTheme();

    // useMixedTheme gives you the theme (can be a light or dark based on your device's preferences)
    const theme = useMixedTheme();

    return (
        <PaperProvider theme={theme}>
            <NavigationContainer theme={theme}>
                {children}
            </NavigationContainer>
        </PaperProvider>
    )
};

const App = () => {
    return (
        <ThemeProvider>
            <Providers>
                <Screen/>
            </Providers>
        </ThemeProvider>
    )
};

export default App;

Usage - Override Theme

Sometimes, we want to change the colors from the theme, for example, react-native-paper primary color is '#6200ee' (a purple), if we want to override that color to, for example '#dd0000' (a red), and the accent color from '#03dac4' (a cyan) to '#0000dd' (a blue), we can do this using the override property in <ThemeProvider>.

// ...
const App = () => {
    return (
        <ThemeProvider 
            override={{
                colors:{
                    primary: '#dd0000', 
                    accent: '#0000dd'
                }
            }}
        >
            <Providers>
                <Screen/>
            </Providers>
        </ThemeProvider>
    )
}

Now our component's primary color will be '#dd0000' and accent color will be '#0000dd'.

Usage - Toggle Theme

useTheme() also provides some functions to instantly change the theme of the App, and uses the AsyncStorage to store this in the device, so, the next time you enter in the app the theme will be saved. You can create your own Theme Toggler Component using the useTheme() functions (Provider values) or you can use the default components with the built-in functionality:

  • <ThemeToggler/>: 3 IconButtons, each one changes the theme to one value. <-- My personal favorite, easy and practical
  • <DarkmodeSwitch/>: A Switch to turn on the darkmode (can't return to default mode, only toggles between light and darkmode).
  • <ThemeButton/>: A Button that cycles the 3 themes (light, dark and default) with a different icon to each one.
// ...
const ConfigurationScreen = () => {
    // ...
    return (
        <View>
            <Text>Change App Theme</Text>
            <ThemeToggler/>
        </View>
    )
}

Provider Values

List of constants and functions that useTheme() provides:

  • updateThemeLight (function): Updates the theme of the app to lightmode and stores it in storage.
  • updateThemeDark (function): Updates the theme of the app to darkmode and stores it in storage.
  • updateThemeDefault (function): Updates the theme of the app to the device's default mode.
  • COLOR_SCHEME (object): Stores the value of the possible results of useLocalColorScheme(). Can be used if you want to compare the result with something like:
// ...
const App = () => {
    // ...
    return (
        <Text>{localColorScheme === COLOR_SCHEME.DEFAULT ? 'Using Device Theme' : 'Using Local Theme'}</Text>
    )
}
  • useLocalColorScheme (function): Returns the localColorScheme that is being used, can return: COLOR_SCHEME.LIGHT, COLOR_SCHEME.DARK or COLOR_SCHEME.DEFAULT.
  • useMixedTheme (function): Returns the theme that is being used. Can be used if you want to extract for example a color of the theme:
// ...
const CustomComponent = () => {
    // ...
    const theme = useMixedTheme()
    return (
        <View style={{backgroundColor: theme.dark ? theme.colors.surface : theme.colors.primary}}>
            <Text>{theme.dark ? 'Using Dark Theme' : 'Using Default Theme'}</Text>
        </View>
    )
}