garlicjs-rails 1.0.2 → 1.0.3

data/README.md

@@ -20,7 +20,7 @@ Add the following directive to your Javascript manifest file (application.js):
 
 ## Versioning
 
-garlicjs-rails 1.0.2 == Garlic.js 1.0.2
+garlicjs-rails 1.0.3 == Garlic.js 1.0.3
 
 ## Contributing
 

data/lib/garlicjs-rails/version.rb

@@ -1,5 +1,5 @@
 module Garlicjs
   module Rails
-    VERSION = "1.0.2"
+    VERSION = "1.0.3"
   end
 end

data/vendor/assets/javascripts/garlic.js

@@ -115,6 +115,7 @@
     /* retrieve localStorage data / state and update elem accordingly */
     , retrieve: function () {
       if ( this.storage.has( this.path ) ) {
+        var storedValue = this.storage.get( this.path );
 
         // if conflictManager enabled, manage fields with already provided data, different from the one stored
         if ( this.options.conflictManager.enabled && this.detectConflict() ) {
@@ -125,11 +126,11 @@
         if ( this.$element.is( 'input[type=radio], input[type=checkbox]' ) ) {
 
           // for checkboxes and radios
-          if ( 'checked' === this.storage.get( this.path ) || this.storage.get( this.path ) === this.$element.val() ) {
+          if ( 'checked' === storedValue || this.$element.val() === storedValue ) {
             return this.$element.attr( 'checked', true );
 
           // only needed for checkboxes
-          } else if ( 'unchecked' === this.storage.get( this.path ) ) {
+          } else if ( 'unchecked' === storedValue ) {
             this.$element.attr( 'checked', false );
           }
 
@@ -137,7 +138,12 @@
         }
 
         // for input[type=text], select and textarea, just set val()
-        this.$element.val( this.storage.get( this.path ) );
+        this.$element.val( storedValue );
+
+        // trigger custom user function when data is retrieved
+        this.options.onRetrieve( this.$element, storedValue );
+
+        return;
       }
     }
 
@@ -178,7 +184,7 @@
     , conflictManager: function () {
 
       // user can define here a custom function that could stop Garlic default behavior, if returns false
-      if ( 'function' === typeof this.options.conflictManager.onConflictDetected 
+      if ( 'function' === typeof this.options.conflictManager.onConflictDetected
         && !this.options.conflictManager.onConflictDetected( this.$element, this.storage.get( this.path ) ) ) {
         return false;
       }
@@ -354,17 +360,18 @@
   $.fn.garlic.Constructor = Garlic;
 
   $.fn.garlic.defaults = {
-      destroy: true                                                                               // remove or not localstorage on submit & clear
+      destroy: true                                                                               // Remove or not localstorage on submit & clear
     , inputs: 'input, textarea, select'                                                           // Default supported inputs.
-    , events: [ 'DOMAttrModified', 'textInput', 'input', 'change', 'keypress', 'paste', 'focus' ] // events list that trigger a localStorage
-    , domain: false                                                                               // store et retrieve forms data accross all domain, not just on
+    , events: [ 'DOMAttrModified', 'textInput', 'input', 'change', 'keypress', 'paste', 'focus' ] // Events list that trigger a localStorage
+    , domain: false                                                                               // Store et retrieve forms data accross all domain, not just on
     , conflictManager: {
-        enabled: true                                                                             // manage default data and persisted data. If false, persisted data will always replace default ones
-      , garlicPriority: true                                                                      // if form have default data, garlic persisted data will be shown first 
-      , template: '<span class="garlic-swap"></span>'                                             // template used to swap between values if conflict detected
-      , message: 'This is your saved data. Click here to see default one'                         // default message for swapping data / state
+        enabled: true                                                                             // Manage default data and persisted data. If false, persisted data will always replace default ones
+      , garlicPriority: true                                                                      // If form have default data, garlic persisted data will be shown first
+      , template: '<span class="garlic-swap"></span>'                                             // Template used to swap between values if conflict detected
+      , message: 'This is your saved data. Click here to see default one'                         // Default message for swapping data / state
       , onConflictDetected: function ( item, storedVal ) { return true; }                         // This function will be triggered if a conflict is detected on an item. Return true if you want Garlic behavior, return false if you want to override it
     }
+   , onRetrieve: function ( item, storedVal ) {}                                                  // This function will be triggered each time Garlic find an retrieve a local stored data for a field
   }
 
   /* GARLIC DATA-API
@@ -376,4 +383,4 @@
   });
 
 // This plugin works with jQuery or Zepto (with data extension builded for Zepto. See changelog 0.0.6)
-}(window.jQuery || window.Zepto);
+}(window.jQuery || window.Zepto);

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: garlicjs-rails
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.0.3
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-12-04 00:00:00.000000000 Z
+date: 2012-12-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: railties
@@ -58,7 +58,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 1480325064676632536
+      hash: -2086385096376470105
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -67,7 +67,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 1480325064676632536
+      hash: -2086385096376470105
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.24