Sotsera.Blazor.Toaster 0.10.1

Sotsera.Blazor.Toaster

A Blazor port of Toastr.js in pure .Net.

The transitions are implemented using System.Threading.Timer so this library should be used only by client side blazor (webassembly).

Razor components currently cannot reference static assets from component libraries. As a temporary workaround the css can be saved into the server project wwwroot and loaded by the index.html with something like <link href="toastr.min.css" rel="stylesheet"/>.

The sample project has been published here.

Changes

version 0.10.1

• fix for bootstrap version >= 4.2
• sample updated to boostrap v4.3.1 and fix for position initial value thanks to @peterblazejewicz

version 0.10.0

• update to 3.0.0-preview6.19307.2
• simplified transition management thanks to the @key binding in the toast container

See the RELEASE-NOTES for the previous versions.

Configuration

Installation

Install-Package Sotsera.Blazor.Toaster

Dependency injection configuration

services.AddToaster(config =>
{
    //example customizations
    config.PositionClass = Defaults.Classes.Position.TopRight;
    config.PreventDuplicates = true;
    config.NewestOnTop = false;
});

Main toaster component

The toast container must be added to the App.razor component or to another component always loaded in the application like MainLayout.razor. It is important to have exactly one instance of this component rendered in the application tree at any given time.

@using Sotsera.Blazor.Toaster
<ToastContainer />

Usage

In a component

@inject Sotsera.Blazor.Toaster.IToaster Toaster

In a class

[Inject] 
protected Sotsera.Blazor.Toaster.IToaster Toaster { get; set; }

then call one of the display methods:

Toaster.Info("toast body text");
Toaster.Success("toast body text");
Toaster.Warning("toast body text");
Toaster.Error("toast body text");

Each of these methods can accept a title and an action for the toast specific configuration

Toaster.Info("toast body text");
Toaster.Info("toast body text", "toast title");
Toaster.Info("toast body text", "toast title", options =>
{
    options.Clicked += toast => Console.WriteLine($"Toast '{toast.Message}' Clicked!");
});

Credits

This is a simple attempt to port Toastr.js to Blazor.

Currently the css styles used are literally COPIED from Toastr.js.

The logo has been made by Freepik from Flaticon and is licensed by CC 3.0 BY

License

Sotsera.Blazor.Toaster is licensed under MIT license