realtime-validations 0.1.2 → 0.2.0

data/README.rdoc

@@ -60,7 +60,7 @@ Include the core javascript of the application:
   # app/assets/javascripts/application.js
   //= require realtime_validations
 
-For now it is necessary to include the stylesheet too, but it will be optional in next versions:
+If you want to use the default error messages, you need to include the stylesheet too:
 
   # app/assets/stylesheets/application.css
   *= require realtime_validations
@@ -73,3 +73,18 @@ Usage is very transparent from your project:
 
 You should use +form_validated_for+ instead of +form_for+ on your forms in order for them to
 automatically validate.
+
+=== Error messages
+
+You can write your own error messages handlers. There are two hooks in JQuery that will be executed
+in order to show and hide errors, and that can be found commented out on the JS file installed by
+the generator.
+
+  RealtimeValidations.showErrors = function(field, errors) {
+  }
+
+  RealtimeValidations.hideErrors = function(field) {
+  }
+
+There is a default implementation for both, and you can use that one if you want. If you need a more
+personalized error reporting or more sophisticated you will have to code your own. :)

data/lib/generators/realtime_validations/templates/realtime_validations.custom.js

@@ -1,3 +1,9 @@
-RealtimeValidations.customFields = function() {
-  return { };
-}
+// RealtimeValidations.customFields = function() {
+//   return { };
+// }
+
+// RealtimeValidations.showErrors = function(field, errors) {
+// }
+
+// RealtimeValidations.hideErrors = function(field) {
+// }

data/lib/realtime-validations.rb

@@ -60,7 +60,7 @@
 #   # app/assets/javascripts/application.js
 #   //= require realtime_validations
 #
-# For now it is necessary to include the stylesheet too, but it will be optional in next versions:
+# If you want to use the default error messages, you need to include the stylesheet too:
 #
 #   # app/assets/stylesheets/application.css
 #   *= require realtime_validations
@@ -73,6 +73,21 @@
 #
 # You should use +form_validated_for+ instead of +form_for+ on your forms in order for them to
 # automatically validate.
+#
+# === Error messages
+#
+# You can write your own error messages handlers. There are two hooks in JQuery that will be executed
+# in order to show and hide errors, and that can be found commented out on the JS file installed by
+# the generator.
+#
+#   RealtimeValidations.showErrors = function(field, errors) {
+#   }
+#
+#   RealtimeValidations.hideErrors = function(field) {
+#   }
+#
+# There is a default implementation for both, and you can use that one if you want. If you need a more
+# personalized error reporting or more sophisticated you will have to code your own. :)
 module RealtimeValidations
 
   # @private

data/lib/realtime-validations/version.rb

@@ -1,3 +1,3 @@
 module RealtimeValidations
-  VERSION = '0.1.2'
+  VERSION = '0.2.0'
 end

data/vendor/assets/javascripts/realtime_validations.js

@@ -64,6 +64,22 @@ var RealtimeValidations = {
     }
     field.attr('valid', false);
     field.attr('validation-errors', errors);
+    RealtimeValidations.showErrors(field, errors);
+  },
+
+  hide_warning_message : function(field) {
+    field.attr('valid', true);
+    field.attr('validation-errors', null);
+    RealtimeValidations.hideErrors(field);
+  },
+
+  // Public functions (meant to be overriden if necessary):
+
+  customFields : function() {
+    return { };
+  },
+
+  showErrors : function(field, errors) {
     if ($('#' + field.attr('id') + '_error').length) {
       $('#' + field.attr('id') + '_error').remove();
     }
@@ -75,16 +91,10 @@ var RealtimeValidations = {
     $('#' + field.attr('id') + '_error').fadeIn('slow');
   },
 
-  hide_warning_message : function(field) {
-    field.attr('valid', true);
-    field.attr('validation-errors', null);
+  hideErrors : function(field) {
     $('#' + field.attr('id') + '_error').fadeOut('slow', function() {
       $(this).remove();
     });
-  },
-
-  customFields : function() {
-    return { };
   }
 
 };

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: realtime-validations
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.2.0
   prerelease: 
 platform: ruby
 authors:
@@ -13,7 +13,7 @@ date: 2012-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
-  requirement: &25143660 !ruby/object:Gem::Requirement
+  requirement: &20223780 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,18 +21,18 @@ dependencies:
         version: 3.1.3
   type: :runtime
   prerelease: false
-  version_requirements: *25143660
+  version_requirements: *20223780
 - !ruby/object:Gem::Dependency
   name: jquery-rails
-  requirement: &25143160 !ruby/object:Gem::Requirement
+  requirement: &20223280 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
-        version: 2.0.0
+        version: 1.0.19
   type: :runtime
   prerelease: false
-  version_requirements: *25143160
+  version_requirements: *20223280
 description: Form real time validations for free on Rails applications
 email:
 - ereslibre@gmail.com