217 lines
8.3 KiB
JavaScript
217 lines
8.3 KiB
JavaScript
/**
|
|
* Loading plugin for jQuery
|
|
* version: v1.0.6
|
|
*
|
|
* Small helper to give the user a visual feedback that something is happening
|
|
* when fetching/posting data
|
|
*
|
|
* USAGE:
|
|
* - global overlay: $.isLoading();
|
|
* - use javascript: $( selector ).isLoading();
|
|
* - On non-form elements: $("div").isLoading({ text: "Loading", position:'inside'});
|
|
* - remove the loading element: $( selector ).isLoading( "hide" );
|
|
*
|
|
* @author Laurent Blanes <laurent.blanes@gmail.com>
|
|
* ---
|
|
* Copyright 2013, Laurent Blanes ( https://github.com/hekigan/is-loading )
|
|
*
|
|
* The MIT License (MIT)
|
|
*
|
|
* Copyright (c) 2013 Laurent Blanes
|
|
*
|
|
* Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
* of this software and associated documentation files (the "Software"), to deal
|
|
* in the Software without restriction, including without limitation the rights
|
|
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
* copies of the Software, and to permit persons to whom the Software is
|
|
* furnished to do so, subject to the following conditions:
|
|
*
|
|
* The above copyright notice and this permission notice shall be included in
|
|
* all copies or substantial portions of the Software.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
|
* THE SOFTWARE.
|
|
*/
|
|
;(function ( $, window, document, undefined ) {
|
|
|
|
// Create the defaults once
|
|
var pluginName = "isLoading",
|
|
defaults = {
|
|
'position': "right", // right | inside | overlay
|
|
'text': "", // Text to display next to the loader
|
|
'class': "icon-refresh", // loader CSS class
|
|
'tpl': '<span class="isloading-wrapper %wrapper%">%text%<i class="%class% icon-spin"></i></span>', // loader base Tag
|
|
'disableSource': true, // true | false
|
|
'disableOthers': []
|
|
};
|
|
|
|
// The actual plugin constructor
|
|
function Plugin( element, options ) {
|
|
this.element = element;
|
|
|
|
// Merge user options with default ones
|
|
this.options = $.extend( {}, defaults, options );
|
|
|
|
this._defaults = defaults;
|
|
this._name = pluginName;
|
|
this._loader = null; // Contain the loading tag element
|
|
|
|
this.init();
|
|
}
|
|
|
|
// Contructor function for the plugin (only once on page load)
|
|
function contruct() {
|
|
|
|
if ( !$[pluginName] ) {
|
|
$.isLoading = function( opts ) {
|
|
$( "body" ).isLoading( opts );
|
|
};
|
|
}
|
|
}
|
|
|
|
Plugin.prototype = {
|
|
|
|
init: function() {
|
|
|
|
if( $( this.element ).is( "body") ) {
|
|
this.options.position = "overlay";
|
|
}
|
|
this.show();
|
|
},
|
|
|
|
show: function() {
|
|
|
|
var self = this,
|
|
tpl = self.options.tpl.replace( '%wrapper%', ' isloading-show ' + ' isloading-' + self.options.position );
|
|
tpl = tpl.replace( '%class%', self.options['class'] );
|
|
tpl = tpl.replace( '%text%', ( self.options.text !== "" ) ? self.options.text + ' ' : '' );
|
|
self._loader = $( tpl );
|
|
|
|
// Disable the element
|
|
if( $( self.element ).is( "input, textarea" ) && true === self.options.disableSource ) {
|
|
|
|
$( self.element ).attr( "disabled", "disabled" );
|
|
|
|
}
|
|
else if( true === self.options.disableSource ) {
|
|
|
|
$( self.element ).addClass( "disabled" );
|
|
|
|
}
|
|
|
|
// Set position
|
|
switch( self.options.position ) {
|
|
|
|
case "inside":
|
|
$( self.element ).html( self._loader );
|
|
break;
|
|
|
|
case "overlay":
|
|
var $wrapperTpl = null;
|
|
|
|
if( $( self.element ).is( "body") ) {
|
|
$wrapperTpl = $('<div class="isloading-overlay" style="position:fixed; left:0; top:0; z-index: 10000; background: rgba(0,0,0,0.5); width: 100%; height: ' + $(window).height() + 'px;" />');
|
|
$( "body" ).prepend( $wrapperTpl );
|
|
|
|
$( window ).on('resize', function() {
|
|
$wrapperTpl.height( $(window).height() + 'px' );
|
|
self._loader.css({top: ($(window).height()/2 - self._loader.outerHeight()/2) + 'px' });
|
|
});
|
|
} else {
|
|
var cssPosition = $( self.element ).css('position'),
|
|
pos = {},
|
|
height = $( self.element ).outerHeight() + 'px',
|
|
width = '100%'; // $( self.element ).outerWidth() + 'px;
|
|
|
|
if( 'relative' === cssPosition || 'absolute' === cssPosition ) {
|
|
pos = { 'top': 0, 'left': 0 };
|
|
} else {
|
|
pos = $( self.element ).position();
|
|
}
|
|
$wrapperTpl = $('<div class="isloading-overlay" style="position:absolute; top: ' + pos.top + 'px; left: ' + pos.left + 'px; z-index: 10000; background: rgba(0,0,0,0.5); width: ' + width + '; height: ' + height + ';" />');
|
|
$( self.element ).prepend( $wrapperTpl );
|
|
|
|
$( window ).on('resize', function() {
|
|
$wrapperTpl.height( $( self.element ).outerHeight() + 'px' );
|
|
self._loader.css({top: ($wrapperTpl.outerHeight()/2 - self._loader.outerHeight()/2) + 'px' });
|
|
});
|
|
}
|
|
|
|
$wrapperTpl.html( self._loader );
|
|
self._loader.css({top: ($wrapperTpl.outerHeight()/2 - self._loader.outerHeight()/2) + 'px' });
|
|
break;
|
|
|
|
default:
|
|
$( self.element ).after( self._loader );
|
|
break;
|
|
}
|
|
|
|
self.disableOthers();
|
|
},
|
|
|
|
hide: function() {
|
|
|
|
if( "overlay" === this.options.position ) {
|
|
|
|
$( this.element ).find( ".isloading-overlay" ).first().remove();
|
|
|
|
} else {
|
|
|
|
$( this._loader ).remove();
|
|
$( this.element ).text( $( this.element ).attr( "data-isloading-label" ) );
|
|
|
|
}
|
|
|
|
$( this.element ).removeAttr("disabled").removeClass("disabled");
|
|
|
|
this.enableOthers();
|
|
},
|
|
|
|
disableOthers: function() {
|
|
$.each(this.options.disableOthers, function( i, e ) {
|
|
var elt = $( e );
|
|
if( elt.is( "button, input, textarea" ) ) {
|
|
elt.attr( "disabled", "disabled" );
|
|
}
|
|
else {
|
|
elt.addClass( "disabled" );
|
|
}
|
|
});
|
|
},
|
|
|
|
enableOthers: function() {
|
|
$.each(this.options.disableOthers, function( i, e ) {
|
|
var elt = $( e );
|
|
if( elt.is( "button, input, textarea" ) ) {
|
|
elt.removeAttr( "disabled" );
|
|
}
|
|
else {
|
|
elt.removeClass( "disabled" );
|
|
}
|
|
});
|
|
}
|
|
};
|
|
|
|
// Constructor
|
|
$.fn[pluginName] = function ( options ) {
|
|
return this.each(function () {
|
|
if ( options && "hide" !== options || !$.data( this, "plugin_" + pluginName ) ) {
|
|
$.data( this, "plugin_" + pluginName, new Plugin( this, options ) );
|
|
} else {
|
|
var elt = $.data( this, "plugin_" + pluginName );
|
|
|
|
if( "hide" === options ) { elt.hide(); }
|
|
else { elt.show(); }
|
|
}
|
|
});
|
|
};
|
|
|
|
contruct();
|
|
|
|
})( jQuery, window, document );
|