izitoast 0.0.3

Elegant, responsive, flexible, and lightweight notification plugin.

IziToast

izitoast is an Elegant, responsive, flexible, and lightweight notification plugin with no dependencies.

Installation

Use the package manager pip to install izitoast.

Usage

Add 'izitoast' to your INSTALLED_APPS setting like this:

INSTALLED_APPS = [
     '...',
    'izitoast',
]

inside base template file at last position include a single line of code

...

{% include 'includes/izitoast.html' %}

...

Working

from izitoast.functions import izitoast

def func(request):
    ...
    message = {
        'raw': [
            {
                'tag': 'success',
                'item': "Success message"
            },
            {
                'tag': 'info',
                'item': "Information message!"
            },
            {
                'tag': 'warning',
                'item': "Warning message!"
            },
            {
                'tag': 'danger',
                'item': "Error message!"
            } 
        ],
        "position": "topRight",
        "transition_in": "flipInX",
        "transition_out": "flipOutX",
        "time_out": 9000,
    }

    izitoast(request=request, model="success", message=message)

    return render(request, 'template.html')

generate form.errors

from izitoast.functions import izitoast

def func(request):
    ...
    

    izitoast(request=request, model="danger", message=form.errors)

    return render(request, 'template.html')

Optionals

1. position:

Default izitoast shown place "topRight",

It can be: [bottomRight, bottomLeft, topRight, topLeft, topCenter, bottomCenter, center]

2. transition_in:

Default izitoast open animation. "flipInX",

It can be: [bounceInLeft, bounceInRight, bounceInUp, bounceInDown, fadeIn, fadeInDown, fadeInUp, fadeInLeft, fadeInRight, flipInX]

3. transition_out: Default izitoast close animation. "flipOutX",

It can be: [fadeOut, fadeOutUp, fadeOutDown, fadeOutLeft, fadeOutRight, flipOutX]

4. time_out: the default value is 3000.

Dependencies

It uses https://izitoast.marcelodolza.com/ izitoast v1.4.0 scripts and styles.

For message transferring uses messages

from django.contrib import messages

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

License

MIT