jqr-helpers 1.0.24 → 1.0.25

data/Readme.md

@@ -120,6 +120,19 @@ an ancestor of the button tag with the class of `my-parent`.
 
 Other Ajax options:
 
+* `:empty` (String) - the ID of an element which should be shown when the
+element you are appending/deleting from is empty. If you delete the last child
+from an element, that element will be hidden and the "empty" element will
+be shown. Conversely, when you add a child to a target with no children, the
+"empty" element will be hidden. Using `empty` without `container` implies that
+the target element's parent should be hidden when the last child is deleted.
+* `container` (String) - the selector (ID or class name for a parent) of the
+element which contains the target. For example, if you are appending to a
+`tbody` element, you may pass the `table` element's ID into this. This can be
+used in conjunction with `empty` to hide the entire table, including the header,
+when it is empty and instead show the `empty` element, and vice versa.
+You can skip using this option to indicate that the show/hide
+behavior should still happen but it should use the target element itself.
 * `:callback` (String) - the name of a JS function to call on completion.
 The function will be in the scope of the original element, and
 will be passed the result data of the Ajax request.

data/app/assets/javascripts/jqr-helpers.js

@@ -233,21 +233,50 @@
       callback.call(targetElement, data);
     }
     var selector = element.data('selector');
+    var empty = element.data('empty');
+    var container = element.data('container');
     var target = null;
     if (selector) {
       if (selector[0] == '#') target = $(selector);
       else target = $(targetElement).parents(selector);
+
+      if (container) {
+        if (container[0] == '#') container = $(container);
+        else container = targetElement.parents(container);
+      }
+
       switch (element.data('result-method')) {
         case 'update':
           target = $(data).replaceAll(target);
           target.trigger('jqr.load');
           break;
         case 'append':
+          if (empty && target.children().length == 0) {
+            $('#' + empty).hide();
+            if (container) {
+              container.show();
+            }
+            else {
+              target.show();
+            }
+          }
           target.append(data);
           target.trigger('jqr.load');
           break;
         case 'delete':
-          target.fadeOut(500, function() {$(this).remove()});
+          if (empty && target.parent().children().length == 1) {
+            if (container) {
+              container.hide();
+            }
+            else {
+              target.parent().hide();
+            }
+            $('#' + empty).show();
+            $(target).remove();
+          }
+          else {
+            target.fadeOut(500, function() {$(this).remove()});
+          }
           break;
       }
       target.effect('highlight');

data/jqr-helpers.gemspec

@@ -1,8 +1,8 @@
 Gem::Specification.new do |s|
   s.name         = 'jqr-helpers'
   s.require_paths = %w(. lib lib/jqr-helpers)
-  s.version      = '1.0.24'
-  s.date         = '2014-01-16'
+  s.version      = '1.0.25'
+  s.date         = '2014-01-17'
   s.summary      = 'Helpers to print unobtrusive jQuery-UI tags.'
   s.description  = <<-EOF
     This gem adds helper methods to create unobtrusive jQuery code. It outputs

data/lib/jqr-helpers/helpers.rb

@@ -462,6 +462,8 @@ module JqrHelpers
       new_options[:'data-redirect'] = true if options.delete(:redirect)
       new_options[:'data-scroll-to'] = true if options.delete(:scroll_to)
       new_options[:'data-throbber'] = options.delete(:throbber) || 'small'
+      new_options[:'data-empty'] = options.delete(:empty)
+      new_options[:'data-container'] = options.delete(:container)
 
       [:update, :append, :delete].each do |result_method|
         selector = options.delete(result_method)

data/lib/jqr-helpers/version.rb

@@ -1,5 +1,5 @@
 module JqrHelpers
   module Rails
-    VERSION = '1.0.24'
+    VERSION = '1.0.25'
   end
 end

metadata

@@ -2,14 +2,14 @@
 name: jqr-helpers
 version: !ruby/object:Gem::Version
   prerelease: 
-  version: 1.0.24
+  version: 1.0.25
 platform: ruby
 authors:
 - Daniel Orner
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-01-16 00:00:00.000000000 Z
+date: 2014-01-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails