jqr-helpers 1.0.40 → 1.0.41

checksums.yaml

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    MzA1ZGQxZTIzZjdlMzVmYTg4ZDc5ZDc0MmZkMzBlMDdiNTExZDA1Zg==
+    MDg3YTU0MDE3OGNkNTUyNTllN2IwYmYyNGI5NmZmMjY2NDE5ZDE5Nw==
   data.tar.gz: !binary |-
-    MjAyZDQ0ZjgxNzcxODFlNDkxMGMzMjg5NWM2MjlmNzI3MDM4MTk1ZA==
+    NzY2OWUxNWJmYjY1MzAyNzU0ZjA2NTRkMGZmZmE0ZjY3MzNkOGYyZg==
 SHA512:
   metadata.gz: !binary |-
-    MjhjNzFjYmE1OTBhZTAxOWFhN2FjNjExMTQ0NWRlZTViM2FmMjgwOTA1NzQz
-    ZjdmZTZiMzBmYzJlYjVkNjhjNDE0NTE0ZTdjN2UzYjI5YWYyZWI2ZDg1OGM0
-    ZWIzM2Q2ZTRkZGQ3MmJkMGIzNjk2NjJlODFjYzU0Y2M1OTc2MzY=
+    MjgzZDljNjI5OTBiNWEzMmZhZGYxN2M4NjE5ZGEwNmZkMTZlM2FjYjNlOTAz
+    YTQyNDVmOTEyM2M2N2RhODM5NzI3MDc0MTE4NDg1YzAxN2Y3NGJkZmZlNWNj
+    ZjVmZTcyNDEzNzhjYTlmYzQ2ZWIzMzUzOTk3NjNlZjYyNDVmNmM=
   data.tar.gz: !binary |-
-    MzQ3ZTlhNjQxOWY2YmEzODM4ZjkyMTlhYjY5MmI3OGU3Nzg4MThhNjJjNGMw
-    ZTVhNzNlYzkzY2ZjMTllMjFlMmYxZmJhOThjNTBhMzI4MWY5NmUwNDQ2YzNk
-    NDFhYjViNzQyYTRjOGIyOWE1MjY5NWQ1NDNiZjgzYjVmOTI1NjA=
+    MWMyNTUzZWQ4ZTA0MTVkZjEyMDY4NDBkNGVmZGQ5Njg4YjRkNzBiOGY4NjFh
+    ZWIwNThhNzJiYjRmNWNlY2MxNmNjYTAxNDEyYjFjOGU3NjFhNWUxZDRkNWYx
+    MDc2ZTU3ODgxZWNlYzNhNTgwMjcyMWExYmVhN2MyMWY3NjdlNzg=

data/Readme.md

@@ -58,6 +58,8 @@ they load a heck of a lot faster when you have dozens or hundreds of them.
 * `button_to_external` - create a working `button_to` button inside an existing form (!)
 * `will_paginate_ajax` - create a `will_paginate` interface that uses Ajax to
 replace the paginated contents.
+* `ajax_change` - monitor any inputs inside the given block for changes
+and send to the Ajax URL when they happen.
 
 There are two sets of options that recur throughout the methods here:
 
@@ -127,6 +129,8 @@ an ancestor of the button tag with the class of `my-parent`.
 Other Ajax options:
 
 * `:return_type` (String) - the expected return type, e.g. 'text' or 'html'.
+* `:method` (String) - GET, POST, PUT, or DELETE, if the default is incorrect
+  (GET for links, POST for forms and buttons).
 * `: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
@@ -168,17 +172,25 @@ page).
 of the screen. `:small` would be a small inline throbber next to the button or
 link that called the dialog, and `:none` shows no throbber at all.
 
+## Monitoring Fields ##
+
+You can monitor a field for changes using the ``ajax_change`` method:
+
+    <%= ajax_change('/toggle_complete_url', :update => '.parent-row') do %>
+      <%= check_box_tag 'toggle_complete', 1, my_model.complete? %>
+    <% end %>
+
 ## Panel Renderers ##
 
 Tabs (and eventually accordion panes and menus) are rendered using a "panel renderer".
 This allows you to loop through the tabs in an intuitive and concise way.
 
-       <%= tab_container {:collapsible => true}, {:class => 'my-tabs}' do |r| %>
-         <% r.panel 'Tab 1' do %>
-           My tab content here
-         <% end %>
-         <% r.panel 'Tab 2', 'http://www.foobar.com/' %>
-       <% end %>
+    <%= tab_container {:collapsible => true}, {:class => 'my-tabs}' do |r| %>
+      <% r.panel 'Tab 1' do %>
+        My tab content here
+      <% end %>
+      <% r.panel 'Tab 2', 'http://www.foobar.com/' %>
+    <% end %>
 
 ## jQuery Events ##
 

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

@@ -1,5 +1,5 @@
 (function($) {
-  function showThrobber(element) {
+  function showThrobber(element, noDisable) {
     switch ($(element).data('throbber')) {
       case 'none':
         return;
@@ -9,7 +9,9 @@
       default: // small or not given
         $(element).after("<img src='/images/jqr-helpers/throbber.gif' class='throbber'/>");
     }
-    $(element).attr('disabled', 'disabled');
+    if (!noDisable) {
+      $(element).attr('disabled', 'disabled');
+    }
     // refresh disabled state
     $(element).attr('autocomplete', 'off');
   }
@@ -194,7 +196,11 @@
       else
         $(element).data('throbber', 'large');
     }
-    showThrobber(element);
+    // can't disable form fields because then they won't receive
+    // the success event
+    var name = element.prop('tagName').toUpperCase();
+    showThrobber(element,
+        (name == 'INPUT' || name == 'SELECT' || name == 'TEXTAREA'));
   }
 
   function ujsAjaxSuccess(evt, data, status, xhr) {
@@ -428,6 +434,24 @@
       $(this).tabs(options);
     });
 
+    // observe fields
+    $('.ujs-ajax-change').each(function() {
+      var dataAttrs = ['type', 'callback', 'refresh', 'redirect', 'scroll-to',
+        'throbber', 'empty', 'container', 'selector', 'result-method', 'url',
+        'method', 'params'];
+      var dataMap = {};
+      var element = $(this);
+      $.each(dataAttrs, function(index, val) {
+        dataMap[val] = element.data(val);
+        element.removeAttr('data-' + val);
+      });
+      element.removeClass('ujs-ajax');
+      // we have to set a data-remote attribute because Rails uses [data-remote]
+      // as a selector rather than checking the actual data in the element
+      $(this).find('input, select').data(dataMap).addClass('ujs-ajax').
+          attr('data-remote', 'true');
+    });
+
   }
 
   $(function() {

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.40'
-  s.date         = '2014-04-09'
+  s.version      = '1.0.41'
+  s.date         = '2014-05-16'
   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

@@ -385,6 +385,18 @@ module JqrHelpers
       content_tag(:button, content, options)
     end
 
+    # Observe a field for changes.
+    # On change, post to the Ajax URL and calculate callbacks.
+    # @param url [String] the URL to send to.
+    # @param options [Hash] Ajax options - see above.
+    # @return [String]
+    def ajax_change(url, options={}, &block)
+      options[:class] = 'ujs-ajax-change'
+      options = _process_ajax_options(options)
+      options['data-url'] = url
+      content_tag :span, options, &block
+    end
+
     # Generate a random string for IDs.
     # @return [String]
     # @private
@@ -536,6 +548,15 @@ module JqrHelpers
       new_options[:'data-throbber'] = options.delete(:throbber) || 'small'
       new_options[:'data-empty'] = options.delete(:empty)
       new_options[:'data-container'] = options.delete(:container)
+      method = options[:method]
+      if method
+        if method == 'put' || method == 'delete'
+          new_options[:'data-params'] = "_method=#{method}"
+          new_options[:'data-method'] = 'post'
+        else
+          new_options[:'data-method'] = method
+        end
+      end
 
       [:update, :append, :delete].each do |result_method|
         selector = options.delete(result_method)

data/lib/jqr-helpers/version.rb

@@ -1,6 +1,6 @@
 module JqrHelpers
   # @private
   module Rails
-    VERSION = '1.0.40'
+    VERSION = '1.0.41'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jqr-helpers
 version: !ruby/object:Gem::Version
-  version: 1.0.40
+  version: 1.0.41
 platform: ruby
 authors:
 - Daniel Orner
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-04-09 00:00:00.000000000 Z
+date: 2014-05-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   requirement: !ruby/object:Gem::Requirement