yii2-simple-loading

Simple Loading widget for Yii framework 2.0 or later, _(*1)

Description

edwinhaq\simpleloading\SimpleLoading widget is a simple way to show a loading screen in your views., _(*2)

Requirements

Yii Version 2.0.0 or later

Installation

The preferred way to install this extension is through composer., _(*3)

Either run, _(*4)

php composer.phar require --prefer-dist edwinhaq/yii2-simple-loading "*"

or add, _(*5)

"edwinhaq/yii2-simple-loading": "*"

to the require section of your composer.json file., _(*6)

Usage

Once the extension is installed, simply use it in your PHP code:, _(*7)


    // ...
    use edwinhaq\simpleloading\SimpleLoading;
    // ...
    SimpleLoading::widget();
    // ...

In javascript call start and stop to control the loading widget, _(*8)


    /*
     * start(image type)
     * Allows to start the loading image and select the image to show
     * options: [box, clock, default, gears, hourglass, magnify, reload, ring-alt, ring, ripple, rolling]
     */
    SimpleLoading.start('gears');   // Load gears.gif
    SimpleLoading.start('default'); // Load default.gif
    SimpleLoading.start();          // Load default.gif

    /*
     *
     * Allows to stop the loading image
     */
    SimpleLoading.stop();


    // Example:

    $.ajax(
        {
            'type':'POST',
            'dataType':'json',
            'url':'index.php?r=controller/action',
            'beforeSend':function(json)
            {
                SimpleLoading.start('gears');
            },
            'success':function(json){/* ... */},
            'error':function(json,status,errorThrown ){/* ... */},
            'complete':function(json)
            {
                SimpleLoading.stop();
            },
            'cache':false,
            'data':jQuery(this).parents("form").serialize()
        }
    );