react-native-toast-notifications

Toast component for React Native, supports Android, IOS and Web

Features

• Fully Customizable
• Swipe to close support
• Smooth animation
• Fully typed with TypeScript

Demo

react-native-web Demo

Install

Open a Terminal in the project root and run:

yarn add react-native-toast-notifications

Modifications

Open a Terminal in the project root and run:

./prepare.sh

The script will take care of required dependencies and will track saves so no manual recompilation is required :D

On every modification, kerberos dev server has to be stopped, package has to be re-added with "yarn add <package_location>" and "yarn serve:dev" has to be invoked to recompile the entire thing, modify wisely!

Usage

Wrap your app in the ToastProvider, which provides context for the Toast hook.

import { ToastProvider } from 'react-native-toast-notifications'

export default function App() {
  return (
    <ToastProvider>
      <RestOfYourApp />
    <ToastProvider/>
  );
}

Then use hook like this everywhere in your app:

import { useToast } from "react-native-toast-notifications";

const Component = () => {
  const toast = useToast();

  useEffect(() => {
    toast.show("Hello World");
  }, []);
};

Methods

show()

toast.show("Task finished successfully", {
  type: "normal | success | warning | danger | custom",
  placement: "top | bottom",
  duration: 4000,
  offset: 30,
  animationType: "slide-in | zoom-in",
});

show() the Loxone way

toast.show("<MESSAGE>", {
  duration: number ?? null // Null will never disappear has to be either swiped/tapped or closed with the button,
  offset: number //from the bottom of the screen in px,
  animationType: "slide-in | zoom-in",
  onPress: Function,
  onClose: Function // executed after notification is closed and animation has ended,
  data: {
    title: string,
    time: string // fed through prettyPrintTime(),
    silent: boolean // will display just as connection notification disregarding other props,
    originMAC: string // required for proper handling of MS switching,
    originUUID: string // same as above
    originMSName: string // if not provided and MS is switched "REMOTE" will be printed instead    
  }
});

update()

let id = toast.show("Loading...");
toast.update(id, "Loading completed", {type: "success"});

hide()

let id = toast.show("Loading...");
toast.hide(id);
// or
toast.hideAll();

Customization

ToastProvider props

There are lots of props to customize your toast or your can use renderToast to implement your own component.

<ToastProvider
    placement="bottom | top"
    duration={5000}
    animationType='slide-in | zoom-in'
    animationDuration={250}
    successColor="green"
    dangerColor="red"
    dangerColor="red"
    warningColor="orange"
    normalColor="gray"
    icon={<Icon />}
    successIcon={<SuccessIcon />}
    dangerIcon={<DangerIcon />}
    warningIcon={<WarningIcon />}
    textStyle={{ fontSize: 20 }}
    offset={50} // offset for both top and bottom toasts
    offsetTop={30}
    offsetBottom={40}
    swipeEnabled={true}
    renderToast={(toastOptions) => JSX.Element} implement custom toast component.
>
...
</>

Custom toast types

You can implement your own custom types or overwrite the existing ones

<ToastProvider
    renderType={{
      custom_type: (toast) => (
        <View style={{padding: 15, backgroundColor: 'grey'}}>
          <Text>{toast.message}</Text>
        </View>
      )
    }}
>
...
</>

// You can pass other data to your custom toast using data property in show method.
toast.show("Show custom toast", {data: { title: 'Toast title' }})

FAQ

- How to call toast outside React components?

To call toasts everywhere (even outside of React components like in redux actions), After you wrapped your app in ToastProvider, You can use the Toast import to call toasts everywhre.

import {Toast} from "react-native-toast-notifications";

// you can call this everywhere
Toast.show('toast message')

- How to show toast inside a Modal?

The Modal component is a native view that sits on top of the rest of react-native application. The only way to put something above it is to put something in the modal itself, or alternately to use a JS only implementation of a Modal.

As a workaround you can put toast inside modal like this:

import Toast from "react-native-toast-notifications";

export Component = () => {
    const toastRef = useRef();
    return (
        <Modal>
            .....
            <Toast ref={toastRef} />
        </Modal>

}

Contributing

Pull request are welcome.

While developing, you can run the example app to test your changes.

Donation

If this project helped you reduce time to develop, you can buy me a cup of coffee :)

Hire

Looking for a React/React-Native Expert? Email at [email protected]

License

MIT