semantic-ui-sass 0.19.3.1 → 1.7.0.0

data/app/assets/javascripts/semantic-ui/nag.js

@@ -1,9 +1,9 @@
 /*
  * # Semantic - Nag
- * http://github.com/jlukic/semantic-ui/
+ * http://github.com/semantic-org/semantic-ui/
  *
  *
- * Copyright 2014 Contributors
+ * Copyright 2014 Contributor
  * Released under the MIT license
  * http://opensource.org/licenses/MIT
  *
@@ -11,23 +11,27 @@
 
 ;(function ($, window, document, undefined) {
 
+"use strict";
+
 $.fn.nag = function(parameters) {
   var
-    $allModules     = $(this),
-    moduleSelector  = $allModules.selector || '',
+    $allModules    = $(this),
+    moduleSelector = $allModules.selector || '',
 
-    time            = new Date().getTime(),
-    performance     = [],
+    time           = new Date().getTime(),
+    performance    = [],
 
-    query           = arguments[0],
-    methodInvoked   = (typeof query == 'string'),
-    queryArguments  = [].slice.call(arguments, 1),
+    query          = arguments[0],
+    methodInvoked  = (typeof query == 'string'),
+    queryArguments = [].slice.call(arguments, 1),
     returnedValue
   ;
-  $(this)
+  $allModules
     .each(function() {
       var
-        settings        = $.extend(true, {}, $.fn.nag.settings, parameters),
+        settings          = ( $.isPlainObject(parameters) )
+          ? $.extend(true, {}, $.fn.nag.settings, parameters)
+          : $.extend({}, $.fn.nag.settings),
 
         className       = settings.className,
         selector        = settings.selector,
@@ -40,8 +44,9 @@ $.fn.nag = function(parameters) {
         $module         = $(this),
 
         $close          = $module.find(selector.close),
-        $context        = $(settings.context),
-
+        $context        = (settings.context)
+          ? $(settings.context)
+          : $('body'),
 
         element         = this,
         instance        = $module.data(moduleNamespace),
@@ -69,12 +74,6 @@ $.fn.nag = function(parameters) {
 
         initialize: function() {
           module.verbose('Initializing element');
-          // calculate module offset once
-          moduleOffset  = $module.offset();
-          moduleHeight  = $module.outerHeight();
-          contextWidth  = $context.outerWidth();
-          contextHeight = $context.outerHeight();
-          contextOffset = $context.offset();
 
           $module
             .data(moduleNamespace, module)
@@ -82,43 +81,18 @@ $.fn.nag = function(parameters) {
           $close
             .on('click' + eventNamespace, module.dismiss)
           ;
-          // lets avoid javascript if we dont need to reposition
-          if(settings.context == window && settings.position == 'fixed') {
+
+          if(settings.detachable && $module.parent()[0] !== $context[0]) {
             $module
-              .addClass(className.fixed)
+              .detach()
+              .prependTo($context)
             ;
           }
-          if(settings.sticky) {
-            module.verbose('Adding scroll events');
-            // retrigger on scroll for absolute
-            if(settings.position == 'absolute') {
-              $context
-                .on('scroll' + eventNamespace, module.event.scroll)
-                .on('resize' + eventNamespace, module.event.scroll)
-              ;
-            }
-            // fixed is always relative to window
-            else {
-              $(window)
-                .on('scroll' + eventNamespace, module.event.scroll)
-                .on('resize' + eventNamespace, module.event.scroll)
-              ;
-            }
-            // fire once to position on init
-            $.proxy(module.event.scroll, this)();
-          }
 
           if(settings.displayTime > 0) {
             setTimeout(module.hide, settings.displayTime);
           }
-          if(module.should.show()) {
-            if( !$module.is(':visible') ) {
-              module.show();
-            }
-          }
-          else {
-            module.hide();
-          }
+          module.show();
         },
 
         destroy: function() {
@@ -127,33 +101,21 @@ $.fn.nag = function(parameters) {
             .removeData(moduleNamespace)
             .off(eventNamespace)
           ;
-          if(settings.sticky) {
-            $context
-              .off(eventNamespace)
-            ;
-          }
-        },
-
-        refresh: function() {
-          module.debug('Refreshing cached calculations');
-          moduleOffset  = $module.offset();
-          moduleHeight  = $module.outerHeight();
-          contextWidth  = $context.outerWidth();
-          contextHeight = $context.outerHeight();
-          contextOffset = $context.offset();
         },
 
         show: function() {
-          module.debug('Showing nag', settings.animation.show);
-          if(settings.animation.show == 'fade') {
-            $module
-              .fadeIn(settings.duration, settings.easing)
-            ;
-          }
-          else {
-            $module
-              .slideDown(settings.duration, settings.easing)
-            ;
+          if( module.should.show() && !$module.is(':visible') ) {
+            module.debug('Showing nag', settings.animation.show);
+            if(settings.animation.show == 'fade') {
+              $module
+                .fadeIn(settings.duration, settings.easing)
+              ;
+            }
+            else {
+              $module
+                .slideDown(settings.duration, settings.easing)
+              ;
+            }
           }
         },
 
@@ -179,43 +141,9 @@ $.fn.nag = function(parameters) {
           }
         },
 
-        stick: function() {
-          module.refresh();
-
-          if(settings.position == 'fixed') {
-            var
-              windowScroll = $(window).prop('pageYOffset') || $(window).scrollTop(),
-              fixedOffset = ( $module.hasClass(className.bottom) )
-                ? contextOffset.top + (contextHeight - moduleHeight) - windowScroll
-                : contextOffset.top - windowScroll
-            ;
-            $module
-              .css({
-                position : 'fixed',
-                top      : fixedOffset,
-                left     : contextOffset.left,
-                width    : contextWidth - settings.scrollBarWidth
-              })
-            ;
-          }
-          else {
-            $module
-              .css({
-                top : yPosition
-              })
-            ;
-          }
-        },
-        unStick: function() {
-          $module
-            .css({
-              top : ''
-            })
-          ;
-        },
         dismiss: function(event) {
           if(settings.storageMethod) {
-            module.storage.set(settings.storedKey, settings.storedValue);
+            module.storage.set(settings.key, settings.value);
           }
           module.hide();
           event.stopImmediatePropagation();
@@ -228,77 +156,93 @@ $.fn.nag = function(parameters) {
               module.debug('Persistent nag is set, can show nag');
               return true;
             }
-            if(module.storage.get(settings.storedKey) != settings.storedValue) {
-              module.debug('Stored value is not set, can show nag', module.storage.get(settings.storedKey));
+            if( module.storage.get(settings.key) != settings.value.toString() ) {
+              module.debug('Stored value is not set, can show nag', module.storage.get(settings.key));
               return true;
             }
-            module.debug('Stored value is set, cannot show nag', module.storage.get(settings.storedKey));
+            module.debug('Stored value is set, cannot show nag', module.storage.get(settings.key));
             return false;
-          },
-          stick: function() {
-            yOffset   = $context.prop('pageYOffset') || $context.scrollTop();
-            yPosition = ( $module.hasClass(className.bottom) )
-              ? (contextHeight - $module.outerHeight() ) + yOffset
-              : yOffset
+          }
+        },
+
+        get: {
+          storageOptions: function() {
+            var
+              options = {}
             ;
-            // absolute position calculated when y offset met
-            if(yPosition > moduleOffset.top) {
-              return true;
+            if(settings.expires) {
+              options.expires = settings.expires;
             }
-            else if(settings.position == 'fixed') {
-              return true;
+            if(settings.domain) {
+              options.domain = settings.domain;
             }
-            return false;
+            if(settings.path) {
+              options.path = settings.path;
+            }
+            return options;
           }
         },
 
-        storage: {
+        clear: function() {
+          module.storage.remove(settings.key);
+        },
 
+        storage: {
           set: function(key, value) {
-            module.debug('Setting stored value', key, value, settings.storageMethod);
-            if(settings.storageMethod == 'local' && window.store !== undefined) {
-              window.store.set(key, value);
+            var
+              options = module.get.storageOptions()
+            ;
+            if(settings.storageMethod == 'localstorage' && window.localStorage !== undefined) {
+              window.localStorage.setItem(key, value);
+              module.debug('Value stored using local storage', key, value);
             }
-            // store by cookie
             else if($.cookie !== undefined) {
-              $.cookie(key, value);
+              $.cookie(key, value, options);
+              module.debug('Value stored using cookie', key, value, options);
             }
             else {
-              module.error(error.noStorage);
+              module.error(error.noCookieStorage);
+              return;
             }
           },
-          get: function(key) {
-            module.debug('Getting stored value', key, settings.storageMethod);
-            if(settings.storageMethod == 'local' && window.store !== undefined) {
-              return window.store.get(key);
+          get: function(key, value) {
+            var
+              storedValue
+            ;
+            if(settings.storageMethod == 'localstorage' && window.localStorage !== undefined) {
+              storedValue = window.localStorage.getItem(key);
             }
             // get by cookie
             else if($.cookie !== undefined) {
-              return $.cookie(key);
+              storedValue = $.cookie(key);
+            }
+            else {
+              module.error(error.noCookieStorage);
+            }
+            if(storedValue == 'undefined' || storedValue == 'null' || storedValue === undefined || storedValue === null) {
+              storedValue = undefined;
+            }
+            return storedValue;
+          },
+          remove: function(key) {
+            var
+              options = module.get.storageOptions()
+            ;
+            if(settings.storageMethod == 'local' && window.store !== undefined) {
+              window.localStorage.removeItem(key);
+            }
+            // store by cookie
+            else if($.cookie !== undefined) {
+              $.removeCookie(key, options);
             }
             else {
               module.error(error.noStorage);
             }
           }
-
         },
 
-        event: {
-          scroll: function() {
-            if(timer !== undefined) {
-              clearTimeout(timer);
-            }
-            timer = setTimeout(function() {
-              if(module.should.stick() ) {
-                requestAnimationFrame(module.stick);
-              }
-              else {
-                module.unStick();
-              }
-            }, settings.lag);
-          }
-        },
         setting: function(name, value) {
+          module.debug('Changing setting', name, value);
           if( $.isPlainObject(name) ) {
             $.extend(true, settings, name);
           }
@@ -310,14 +254,11 @@ $.fn.nag = function(parameters) {
           }
         },
         internal: function(name, value) {
-          module.debug('Changing internal', name, value);
-          if(value !== undefined) {
-            if( $.isPlainObject(name) ) {
-              $.extend(true, module, name);
-            }
-            else {
-              module[name] = value;
-            }
+          if( $.isPlainObject(name) ) {
+            $.extend(true, module, name);
+          }
+          else if(value !== undefined) {
+            module[name] = value;
           }
           else {
             return module[name];
@@ -362,9 +303,9 @@ $.fn.nag = function(parameters) {
               executionTime = currentTime - previousTime;
               time          = currentTime;
               performance.push({
-                'Element'        : element,
                 'Name'           : message[0],
                 'Arguments'      : [].slice.call(message, 1) || '',
+                'Element'        : element,
                 'Execution Time' : executionTime
               });
             }
@@ -385,9 +326,6 @@ $.fn.nag = function(parameters) {
             if(moduleSelector) {
               title += ' \'' + moduleSelector + '\'';
             }
-            if($allModules.size() > 1) {
-              title += ' ' + '(' + $allModules.size() + ')';
-            }
             if( (console.group !== undefined || console.table !== undefined) && performance.length > 0) {
               console.groupCollapsed(title);
               if(console.table) {
@@ -435,6 +373,7 @@ $.fn.nag = function(parameters) {
                 return false;
               }
               else {
+                module.error(error.method, query);
                 return false;
               }
             });
@@ -457,6 +396,7 @@ $.fn.nag = function(parameters) {
           return found;
         }
       };
+
       if(methodInvoked) {
         if(instance === undefined) {
           module.initialize();
@@ -469,9 +409,9 @@ $.fn.nag = function(parameters) {
         }
         module.initialize();
       }
-
     })
   ;
+
   return (returnedValue !== undefined)
     ? returnedValue
     : this
@@ -491,46 +431,40 @@ $.fn.nag.settings = {
   // allows cookie to be overriden
   persist     : false,
 
-  // set to zero to manually dismiss, otherwise hides on its own
+  // set to zero to require manually dismissal, otherwise hides on its own
   displayTime : 0,
 
   animation   : {
-    show: 'slide',
-    hide: 'slide'
+    show : 'slide',
+    hide : 'slide'
   },
 
-  // method of stickyness
-  position       : 'fixed',
-  scrollBarWidth : 18,
+  context       : false,
+  detachable    : false,
+
+  expires       : 30,
+  domain        : false,
+  path          : '/',
 
   // type of storage to use
-  storageMethod  : 'cookie',
+  storageMethod : 'cookie',
 
   // value to store in dismissed localstorage/cookie
-  storedKey      : 'nag',
-  storedValue    : 'dismiss',
-
-  // need to calculate stickyness on scroll
-  sticky         : false,
-
-  // how often to check scroll event
-  lag            : 0,
-
-  // context for scroll event
-  context        : window,
+  key           : 'nag',
+  value         : 'dismiss',
 
   error: {
-    noStorage  : 'Neither $.cookie or store is defined. A storage solution is required for storing state',
+    noStorage : 'Neither $.cookie or store is defined. A storage solution is required for storing state',
     method    : 'The method you called is not defined.'
   },
 
   className     : {
-    bottom      : 'bottom',
-    fixed       : 'fixed'
+    bottom : 'bottom',
+    fixed  : 'fixed'
   },
 
   selector      : {
-    close: '.icon.close'
+    close : '.close.icon'
   },
 
   speed         : 500,