| 0,0 → 1,338 |
|---|
| /** |
| * jGrowl 1.2.6+jquery1.9fix+jquery3fix+bindfix |
| * |
| * Dual licensed under the MIT (http://www.opensource.org/licenses/mit-license.php) |
| * and GPL (http://www.opensource.org/licenses/gpl-license.php) licenses. |
| * |
| * Written by Stan Lemon <stosh1985@gmail.com> |
| * Last updated: 2011.03.27 |
| * |
| * jGrowl is a jQuery plugin implementing unobtrusive userland notifications. These |
| * notifications function similarly to the Growl Framework available for |
| * Mac OS X (http://growl.info). |
| * |
| * To Do: |
| * - Move library settings to containers and allow them to be changed per container |
| * |
| * Changes in 1.2.6 |
| * - Fixed js error when a notification is opening and closing at the same time |
| * |
| * Changes in 1.2.5 |
| * - Changed wrapper jGrowl's options usage to "o" instead of $.jGrowl.defaults |
| * - Added themeState option to control 'highlight' or 'error' for jQuery UI |
| * - Ammended some CSS to provide default positioning for nested usage. |
| * - Changed some CSS to be prefixed with jGrowl- to prevent namespacing issues |
| * - Added two new options - openDuration and closeDuration to allow |
| * better control of notification open and close speeds, respectively |
| * Patch contributed by Jesse Vincet. |
| * - Added afterOpen callback. Patch contributed by Russel Branca. |
| * |
| * Changes in 1.2.4 |
| * - Fixed IE bug with the close-all button |
| * - Fixed IE bug with the filter CSS attribute (special thanks to gotwic) |
| * - Update IE opacity CSS |
| * - Changed font sizes to use "em", and only set the base style |
| * |
| * Changes in 1.2.3 |
| * - The callbacks no longer use the container as context, instead they use the actual notification |
| * - The callbacks now receive the container as a parameter after the options parameter |
| * - beforeOpen and beforeClose now check the return value, if it's false - the notification does |
| * not continue. The open callback will also halt execution if it returns false. |
| * - Fixed bug where containers would get confused |
| * - Expanded the pause functionality to pause an entire container. |
| * |
| * Changes in 1.2.2 |
| * - Notification can now be theme rolled for jQuery UI, special thanks to Jeff Chan! |
| * |
| * Changes in 1.2.1 |
| * - Fixed instance where the interval would fire the close method multiple times. |
| * - Added CSS to hide from print media |
| * - Fixed issue with closer button when div { position: relative } is set |
| * - Fixed leaking issue with multiple containers. Special thanks to Matthew Hanlon! |
| * |
| * Changes in 1.2.0 |
| * - Added message pooling to limit the number of messages appearing at a given time. |
| * - Closing a notification is now bound to the notification object and triggered by the close button. |
| * |
| * Changes in 1.1.2 |
| * - Added iPhone styled example |
| * - Fixed possible IE7 bug when determining if the ie6 class shoudl be applied. |
| * - Added template for the close button, so that it's content could be customized. |
| * |
| * Changes in 1.1.1 |
| * - Fixed CSS styling bug for ie6 caused by a mispelling |
| * - Changes height restriction on default notifications to min-height |
| * - Added skinned examples using a variety of images |
| * - Added the ability to customize the content of the [close all] box |
| * - Added jTweet, an example of using jGrowl + Twitter |
| * |
| * Changes in 1.1.0 |
| * - Multiple container and instances. |
| * - Standard $.jGrowl() now wraps $.fn.jGrowl() by first establishing a generic jGrowl container. |
| * - Instance methods of a jGrowl container can be called by $.fn.jGrowl(methodName) |
| * - Added glue preferenced, which allows notifications to be inserted before or after nodes in the container |
| * - Added new log callback which is called before anything is done for the notification |
| * - Corner's attribute are now applied on an individual notification basis. |
| * |
| * Changes in 1.0.4 |
| * - Various CSS fixes so that jGrowl renders correctly in IE6. |
| * |
| * Changes in 1.0.3 |
| * - Fixed bug with options persisting across notifications |
| * - Fixed theme application bug |
| * - Simplified some selectors and manipulations. |
| * - Added beforeOpen and beforeClose callbacks |
| * - Reorganized some lines of code to be more readable |
| * - Removed unnecessary this.defaults context |
| * - If corners plugin is present, it's now customizable. |
| * - Customizable open animation. |
| * - Customizable close animation. |
| * - Customizable animation easing. |
| * - Added customizable positioning (top-left, top-right, bottom-left, bottom-right, center) |
| * |
| * Changes in 1.0.2 |
| * - All CSS styling is now external. |
| * - Added a theme parameter which specifies a secondary class for styling, such |
| * that notifications can be customized in appearance on a per message basis. |
| * - Notification life span is now customizable on a per message basis. |
| * - Added the ability to disable the global closer, enabled by default. |
| * - Added callbacks for when a notification is opened or closed. |
| * - Added callback for the global closer. |
| * - Customizable animation speed. |
| * - jGrowl now set itself up and tears itself down. |
| * |
| * Changes in 1.0.1: |
| * - Removed dependency on metadata plugin in favor of .data() |
| * - Namespaced all events |
| */ |
| (function($) { |
| |
| /** jGrowl Wrapper - Establish a base jGrowl Container for compatibility with older releases. **/ |
| $.jGrowl = function( m , o ) { |
| // To maintain compatibility with older version that only supported one instance we'll create the base container. |
| if ( $('#jGrowl').length == 0 ) |
| $('<div id="jGrowl"></div>').addClass( (o && o.position) ? o.position : $.jGrowl.defaults.position ).appendTo('body'); |
| |
| // Create a notification on the container. |
| $('#jGrowl').jGrowl(m,o); |
| }; |
| |
| |
| /** Raise jGrowl Notification on a jGrowl Container **/ |
| $.fn.jGrowl = function( m , o ) { |
| if ( $.isFunction(this.each) ) { |
| var args = arguments; |
| |
| return this.each(function() { |
| var self = this; |
| |
| /** Create a jGrowl Instance on the Container if it does not exist **/ |
| if ( $(this).data('jGrowl.instance') == undefined ) { |
| $(this).data('jGrowl.instance', $.extend( new $.fn.jGrowl(), { notifications: [], element: null, interval: null } )); |
| $(this).data('jGrowl.instance').startup( this ); |
| } |
| |
| /** Optionally call jGrowl instance methods, or just raise a normal notification **/ |
| if ( $.isFunction($(this).data('jGrowl.instance')[m]) ) { |
| $(this).data('jGrowl.instance')[m].apply( $(this).data('jGrowl.instance') , $.makeArray(args).slice(1) ); |
| } else { |
| $(this).data('jGrowl.instance').create( m , o ); |
| } |
| }); |
| }; |
| }; |
| |
| $.extend( $.fn.jGrowl.prototype , { |
| |
| /** Default JGrowl Settings **/ |
| defaults: { |
| pool: 0, |
| header: '', |
| group: '', |
| sticky: false, |
| position: 'top-right', |
| glue: 'after', |
| theme: 'default', |
| themeState: 'highlight', |
| corners: '10px', |
| check: 250, |
| life: 3000, |
| closeDuration: 'normal', |
| openDuration: 'normal', |
| easing: 'swing', |
| closer: true, |
| closeTemplate: '×', |
| closerTemplate: '<div>[ close all ]</div>', |
| log: function(e,m,o) {}, |
| beforeOpen: function(e,m,o) {}, |
| afterOpen: function(e,m,o) {}, |
| open: function(e,m,o) {}, |
| beforeClose: function(e,m,o) {}, |
| close: function(e,m,o) {}, |
| animateOpen: { |
| opacity: 'show' |
| }, |
| animateClose: { |
| opacity: 'hide' |
| } |
| }, |
| |
| notifications: [], |
| |
| /** jGrowl Container Node **/ |
| element: null, |
| |
| /** Interval Function **/ |
| interval: null, |
| |
| /** Create a Notification **/ |
| create: function( message , o ) { |
| var o = $.extend({}, this.defaults, o); |
| |
| /* To keep backward compatibility with 1.24 and earlier, honor 'speed' if the user has set it */ |
| if (typeof o.speed !== 'undefined') { |
| o.openDuration = o.speed; |
| o.closeDuration = o.speed; |
| } |
| |
| this.notifications.push({ message: message , options: o }); |
| |
| o.log.apply( this.element , [this.element,message,o] ); |
| }, |
| |
| render: function( notification ) { |
| var self = this; |
| var message = notification.message; |
| var o = notification.options; |
| |
| // Support for jQuery theme-states, if this is not used it displays a widget header |
| o.themeState = (o.themeState == '') ? '' : 'ui-state-' + o.themeState; |
| |
| var notification = $( |
| '<div class="jGrowl-notification ' + o.themeState + ' ui-corner-all' + |
| ((o.group != undefined && o.group != '') ? ' ' + o.group : '') + '">' + |
| '<div class="jGrowl-close">' + o.closeTemplate + '</div>' + |
| '<div class="jGrowl-header">' + o.header + '</div>' + |
| '<div class="jGrowl-message">' + message + '</div></div>' |
| ).data("jGrowl", o).addClass(o.theme).children('div.jGrowl-close').on("click.jGrowl", function() { |
| $(this).parent().trigger('jGrowl.close'); |
| }).parent(); |
| |
| |
| /** Notification Actions **/ |
| $(notification).on("mouseover.jGrowl", function() { |
| $('div.jGrowl-notification', self.element).data("jGrowl.pause", true); |
| }).on("mouseout.jGrowl", function() { |
| $('div.jGrowl-notification', self.element).data("jGrowl.pause", false); |
| }).on('jGrowl.beforeOpen', function() { |
| if ( o.beforeOpen.apply( notification , [notification,message,o,self.element] ) != false ) { |
| $(this).trigger('jGrowl.open'); |
| } |
| }).on('jGrowl.open', function() { |
| if ( o.open.apply( notification , [notification,message,o,self.element] ) != false ) { |
| if ( o.glue == 'after' ) { |
| $('div.jGrowl-notification:last', self.element).after(notification); |
| } else { |
| $('div.jGrowl-notification:first', self.element).before(notification); |
| } |
| |
| $(this).animate(o.animateOpen, o.openDuration, o.easing, function() { |
| // Fixes some anti-aliasing issues with IE filters. |
| if ((navigator.userAgent.match(/MSIE ([1-9])/) !== null) && (parseInt($(this).css('opacity'), 10) === 1 || parseInt($(this).css('opacity'), 10) === 0)) |
| this.style.removeAttribute('filter'); |
| |
| if ( $(this).data("jGrowl") != null ) // Happens when a notification is closing before it's open. |
| $(this).data("jGrowl").created = new Date(); |
| |
| $(this).trigger('jGrowl.afterOpen'); |
| }); |
| } |
| }).on('jGrowl.afterOpen', function() { |
| o.afterOpen.apply( notification , [notification,message,o,self.element] ); |
| }).on('jGrowl.beforeClose', function() { |
| if ( o.beforeClose.apply( notification , [notification,message,o,self.element] ) != false ) |
| $(this).trigger('jGrowl.close'); |
| }).on('jGrowl.close', function() { |
| // Pause the notification, lest during the course of animation another close event gets called. |
| $(this).data('jGrowl.pause', true); |
| $(this).animate(o.animateClose, o.closeDuration, o.easing, function() { |
| if ( $.isFunction(o.close) ) { |
| if ( o.close.apply( notification , [notification,message,o,self.element] ) !== false ) |
| $(this).remove(); |
| } else { |
| $(this).remove(); |
| } |
| }); |
| }).trigger('jGrowl.beforeOpen'); |
| |
| /** Optional Corners Plugin **/ |
| if ( o.corners != '' && $.fn.corner != undefined ) $(notification).corner( o.corners ); |
| |
| /** Add a Global Closer if more than one notification exists **/ |
| if ( $('div.jGrowl-notification:parent', self.element).length > 1 && |
| $('div.jGrowl-closer', self.element).length == 0 && this.defaults.closer != false ) { |
| $(this.defaults.closerTemplate).addClass('jGrowl-closer ' + this.defaults.themeState + ' ui-corner-all').addClass(this.defaults.theme) |
| .appendTo(self.element).animate(this.defaults.animateOpen, this.defaults.speed, this.defaults.easing) |
| .on("click.jGrowl", function() { |
| $(this).siblings().trigger("jGrowl.beforeClose"); |
| |
| if ( $.isFunction( self.defaults.closer ) ) { |
| self.defaults.closer.apply( $(this).parent()[0] , [$(this).parent()[0]] ); |
| } |
| }); |
| }; |
| }, |
| |
| /** Update the jGrowl Container, removing old jGrowl notifications **/ |
| update: function() { |
| $(this.element).find('div.jGrowl-notification:parent').each( function() { |
| if ( $(this).data("jGrowl") != undefined && $(this).data("jGrowl").created != undefined && |
| ($(this).data("jGrowl").created.getTime() + parseInt($(this).data("jGrowl").life)) < (new Date()).getTime() && |
| $(this).data("jGrowl").sticky != true && |
| ($(this).data("jGrowl.pause") == undefined || $(this).data("jGrowl.pause") != true) ) { |
| |
| // Pause the notification, lest during the course of animation another close event gets called. |
| $(this).trigger('jGrowl.beforeClose'); |
| } |
| }); |
| |
| if ( this.notifications.length > 0 && |
| (this.defaults.pool == 0 || $(this.element).find('div.jGrowl-notification:parent').length < this.defaults.pool) ) |
| this.render( this.notifications.shift() ); |
| |
| if ( $(this.element).find('div.jGrowl-notification:parent').length < 2 ) { |
| $(this.element).find('div.jGrowl-closer').animate(this.defaults.animateClose, this.defaults.speed, this.defaults.easing, function() { |
| $(this).remove(); |
| }); |
| } |
| }, |
| |
| /** Setup the jGrowl Notification Container **/ |
| startup: function(e) { |
| this.element = $(e).addClass('jGrowl').append('<div class="jGrowl-notification"></div>'); |
| this.interval = setInterval( function() { |
| $(e).data('jGrowl.instance').update(); |
| }, parseInt(this.defaults.check)); |
| |
| if ((navigator.userAgent.match(/MSIE ([2-6]\.)/) !== null) && !window["XMLHttpRequest"]) { |
| $(this.element).addClass('ie6'); |
| } |
| }, |
| |
| /** Shutdown jGrowl, removing it and clearing the interval **/ |
| shutdown: function() { |
| $(this.element).removeClass('jGrowl').find('div.jGrowl-notification').remove(); |
| clearInterval( this.interval ); |
| }, |
| |
| close: function() { |
| $(this.element).find('div.jGrowl-notification').each(function(){ |
| $(this).trigger('jGrowl.beforeClose'); |
| }); |
| } |
| }); |
| |
| /** Reference the Defaults Object for compatibility with older versions of jGrowl **/ |
| $.jGrowl.defaults = $.fn.jGrowl.prototype.defaults; |
| |
| })(jQuery); |