Toast Utility Services

17 Feb 20226 minutes to read

The Toast component provides a built-in utility function to render the toast with minimal code. The utility function will render the toast without the need of rendering the container element in the DOM where the toast is appended. So that, the toast can now be rendered on the go. The following are the option to render the toast using the utility function.

Show Toast with predefined types

The Toast component support 4 types of predefined toast with essential colors for various situations which can be shown using the ToastUtility.show by just defining the type of the toast without defining any class names. The following options are used as an argument on calling the utility function for predefined types:

Options Description
content Specifies the content that can be displayed on the Toast.
type Specifies the type of the predefined Toasts. The 4 types of predefined toasts are Information, Success, Error, Warning
timeOut Specifies the Toast display time duration on the page in milliseconds. Once the time expires, Toast message will be removed. Setting 0 as a time out value displays the Toast on the page until the user closes it manually. 
<div class="control-section" style="width:400px;margin:0 auto;">
    <div class="row">
        <ejs-button id="info_toast" content="Info Toast" cssClass="e-btn e-control e-info"></ejs-button>
        <ejs-button id="success_toast" content="Success Toast" cssClass="e-btn e-control e-success"></ejs-button>
        <ejs-button id="warning_toast" content="Warning Toast" cssClass="e-btn e-control e-warning"></ejs-button>
        <ejs-button id="danger_toast" content="Danger Toast" cssClass="e-btn e-control e-danger"></ejs-button>
    </div>
    <br/>
    <div class="row" style="text-align: center;">
        <ejs-button id="hide_toast" content="Hide All" cssClass="e-btn"></ejs-button>
    </div>
</div>
<script type="text/javascript">
    var toastObj;
    document.getElementById("info_toast").addEventListener('click', function () {
        toastObj = ejs.notifications.ToastUtility.show('Please read the comments carefully', 'Information', 20000);
    });
    document.getElementById("success_toast").addEventListener('click', function () {
        toastObj = ejs.notifications.ToastUtility.show('Your message has been sent successfully', 'Success', 20000);
    });
    document.getElementById("warning_toast").addEventListener('click', function () {        
        toastObj = ejs.notifications.ToastUtility.show('There was a problem with your network connection', 'Warning', 20000);
    });
    document.getElementById("danger_toast").addEventListener('click', function () {
        toastObj = ejs.notifications.ToastUtility.show('A problem has been occurred while submitting the data', 'Error', 20000);
    });
    document.getElementById("hide_toast").addEventListener('click', function () {
        toastObj.hide('All');
    });
</script>
public class HomeController : Controller
{
    public ActionResult Index()
    {
        return View();
    }
}

Show Toast with ToastModel

The utility function can be called using the ToastModel as argument to show the toast where all the properties in the ToastModel like any events, position, close icon, action buttons, etc. can be used in the ToastUtility.show.

<div class="control-section" style="width:400px;margin:0 auto;">
    <ejs-button id="show_toast" content="Show Toast" cssClass="e-btn"></ejs-button>
</div>
<script type="text/javascript">
    var toastObj;
    document.getElementById("show_toast").addEventListener('click', function () {
        toastObj = ej.notifications.ToastUtility.show({
            title: 'Toast Title',
            content: 'Toast is shown using the utility function with ToastModel',
            timeOut: 20000,
            position: { X: 'Right', Y: 'Bottom' }
            showCloseButton: true,
            click: toastClick,
            buttons:  [{
                model: { content: 'Close' }, click: toastClose
            }]
        });
    });
    
    function toastClick() {
        console.log('Toast click event triggered');
    }

    function toastClose() {
        toastObj.hide();
    }
</script>
public class HomeController : Controller
{
    public ActionResult Index()
    {
        return View();
    }
}