React Toast - Overview

The Toast is a UI component that displays pop-up notifications.

When you need to display a notification, call the notify(message, type, displayTime) method with values for the message, type, and displayTime properties passed as arguments.

DevExtreme Accessibility Compliance

DevExtreme component libraries meet a variety of WCAG and Section 508 compliance standards. To assess this demo's accessibility level, click the Run AXE^® Validation button to launch the AXE^® web accessibility evaluation tool.

All trademarks or registered trademarks are property of their respective owners. AXE^® Terms of Use

The overall accessibility level of your application depends on the Toast features used.

TS JS

Backend API

import React, { useCallback, useState } from 'react'; import { Toast } from 'devextreme-react/toast'; import { ProductItem } from './ProductItem.tsx'; import { products } from './data.ts'; function App() { const [toastConfig, setToastConfig] = useState({ isVisible: false, type: 'info', message: '', } as { isVisible: boolean, type: 'info' | 'error' | 'success', message: string, }); const checkAvailability = useCallback((e: { value: any; }, product: { Name: string | number; }) => { const type = e.value ? 'success' : 'error'; const message = product.Name + (e.value ? ' is available' : ' is not available'); setToastConfig({ ...toastConfig, isVisible: true, type, message, }); }, [toastConfig, setToastConfig]); const onHiding = useCallback(() => { setToastConfig({ ...toastConfig, isVisible: false, }); }, [toastConfig, setToastConfig]); const items = products.map((product) => ( <li key={product.ID}> <ProductItem product={product} checkAvailability={checkAvailability} /> </li> )); return ( <div id="product-list"> <div className="header">Product List</div> <ul>{items}</ul> <Toast visible={toastConfig.isVisible} message={toastConfig.message} type={toastConfig.type} onHiding={onHiding} displayTime={600} /> </div> ); } export default App;

import React, { useCallback, useState } from 'react'; import { Toast } from 'devextreme-react/toast'; import { ProductItem } from './ProductItem.js'; import { products } from './data.js'; function App() { const [toastConfig, setToastConfig] = useState({ isVisible: false, type: 'info', message: '', }); const checkAvailability = useCallback( (e, product) => { const type = e.value ? 'success' : 'error'; const message = product.Name + (e.value ? ' is available' : ' is not available'); setToastConfig({ ...toastConfig, isVisible: true, type, message, }); }, [toastConfig, setToastConfig], ); const onHiding = useCallback(() => { setToastConfig({ ...toastConfig, isVisible: false, }); }, [toastConfig, setToastConfig]); const items = products.map((product) => ( <li key={product.ID}> <ProductItem product={product} checkAvailability={checkAvailability} /> </li> )); return ( <div id="product-list"> <div className="header">Product List</div> <ul>{items}</ul> <Toast visible={toastConfig.isVisible} message={toastConfig.message} type={toastConfig.type} onHiding={onHiding} displayTime={600} /> </div> ); } export default App;

import React, { useCallback } from 'react'; import { CheckBox } from 'devextreme-react/check-box'; interface ProductItemProps { product: { ID: number; Name: string; Price: number; Current_Inventory: number; Backorder: number; Manufacturing: number; Category: string; ImageSrc: string; }; checkAvailability: any; } export function ProductItem(props: ProductItemProps) { const onValueChanged = useCallback((e) => { props.checkAvailability(e, props.product); }, [props]); return ( <React.Fragment> <img alt={props.product.Name} src={props.product.ImageSrc} /> <div>{props.product.Name}</div> <CheckBox text="Available" onValueChanged={onValueChanged} /> </React.Fragment> ); }

import React from 'react'; import ReactDOM from 'react-dom'; import App from './App.tsx'; ReactDOM.render( <App />, document.getElementById('app'), );

export const products = [{ ID: 4, Name: 'SuperLED 50', Price: 1600, Current_Inventory: 77, Backorder: 0, Manufacturing: 55, Category: 'Televisions', ImageSrc: '../../../../images/products/4.png', }, { ID: 5, Name: 'SuperLED 42', Price: 1450, Current_Inventory: 445, Backorder: 0, Manufacturing: 0, Category: 'Televisions', ImageSrc: '../../../../images/products/5.png', }, { ID: 6, Name: 'SuperLCD 55', Price: 1350, Current_Inventory: 345, Backorder: 0, Manufacturing: 5, Category: 'Televisions', ImageSrc: '../../../../images/products/6.png', }, { ID: 7, Name: 'SuperLCD 42', Price: 1200, Current_Inventory: 210, Backorder: 0, Manufacturing: 20, Category: 'Televisions', ImageSrc: '../../../../images/products/7.png', }];

import React, { useCallback } from 'react'; import { CheckBox } from 'devextreme-react/check-box'; export function ProductItem(props) { const onValueChanged = useCallback( (e) => { props.checkAvailability(e, props.product); }, [props], ); return ( <React.Fragment> <img alt={props.product.Name} src={props.product.ImageSrc} /> <div>{props.product.Name}</div> <CheckBox text="Available" onValueChanged={onValueChanged} /> </React.Fragment> ); }

import React from 'react'; import ReactDOM from 'react-dom'; import App from './App.js'; ReactDOM.render(<App />, document.getElementById('app'));

export const products = [ { ID: 4, Name: 'SuperLED 50', Price: 1600, Current_Inventory: 77, Backorder: 0, Manufacturing: 55, Category: 'Televisions', ImageSrc: '../../../../images/products/4.png', }, { ID: 5, Name: 'SuperLED 42', Price: 1450, Current_Inventory: 445, Backorder: 0, Manufacturing: 0, Category: 'Televisions', ImageSrc: '../../../../images/products/5.png', }, { ID: 6, Name: 'SuperLCD 55', Price: 1350, Current_Inventory: 345, Backorder: 0, Manufacturing: 5, Category: 'Televisions', ImageSrc: '../../../../images/products/6.png', }, { ID: 7, Name: 'SuperLCD 42', Price: 1200, Current_Inventory: 210, Backorder: 0, Manufacturing: 20, Category: 'Televisions', ImageSrc: '../../../../images/products/7.png', }, ];

<!DOCTYPE html> <html lang="en"> <head> <title>DevExtreme Demo</title> <meta http-equiv="X-UA-Compatible" content="IE=edge" /> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=5.0" /> <link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/25.1.6/css/dx.light.css" /> <link rel="stylesheet" type="text/css" href="styles.css" /> <script src="https://cdn.jsdelivr.net/npm/core-js@2.6.12/client/shim.min.js"></script> <script src="https://cdn.jsdelivr.net/npm/systemjs@0.21.3/dist/system.js"></script> <script type="text/javascript" src="config.js"></script> <script type="text/javascript"> System.import("./index.tsx"); </script> </head> <body class="dx-viewport"> <div class="demo-container"> <div id="app"></div> </div> </body> </html>

.header { font-size: 34px; text-align: center; } #product-list { padding: 10px; } #product-list ul { text-align: center; list-style-type: none; margin: 20px 0; } #product-list ul li { display: inline-block; width: 160px; margin: 10px; } #product-list ul li img { width: 100px; } .dx-toast-content { min-width: 300px; max-width: 400px; }

You can specify one of the four predefined types of notifications, depending on the mood of the message:

'info'
A blue toast with a message bubble icon.
'warning'
A yellow toast with an exclamation mark icon.
'error'
A red toast with an X icon.
'success'
A green toast with a check mark icon.

In this demo, toggle check boxes to see the 'success' and 'error' notification types.

You can also customize the Toast appearance. Set the type property to 'custom' and use a contentTemplate. Refer to the following topic for more information: Customize the Content.

If you need to specify other Toast properties in addition to type and displayTime, call the notify(options, type, displayTime) method and pass an object as the argument. In this object, you can set any Toast property, such as shading, position, width, height, and others.