awesome_nested_fields 0.3.2 → 0.4.0

data/README.md

@@ -114,6 +114,20 @@ To implement this on the basic example, do something like:
 
 And yeah, you need to mark it with the class `empty` or any other selector configured via javascript.
 
+#### render_template
+
+When `nested_fields_for` is called, it also includes a `<script>` tag with the html template of a new item, so the javascript code knows what to insert. But sometimes it is not possible to put the template just after the items. For example, you can be inside a table (tables cannot have script elements inside it) or have multi-level nested items (the templates would be recursively repeated). In these cases you need to render the template manually.
+
+To do this, just set the `render_template` option to `false` and use the `nested_fields_template` helper to put the templates anywhere on the page.
+  
+    <%= f.nested_fields_for :phones, render_template: false do |f| %>
+      <% nested field code %>
+    <% end %>
+    <!-- some lines after -->
+    <%= nested_fields_templates %>
+
+Keep in mind that you can call the templates only after `nested_fields_for` and inside the DOM element you apply the `nestedFields()` javascript, so it still can find the templates.
+
 ### Javascript Options
 
 #### Selectors
@@ -178,6 +192,36 @@ The code above inserts a new item and does not execute the `beforeInsert` callba
 These methods can be called from the element where nested fields are applied (e.g. a form) or from any element inside it (e.g. an input or the container itself).
 
 
+Multiples Nested Fields
+-----------------------
+
+It is easy to have multiple nested fields on the same page. Instead of applying `nestedFields()` on the form, put the elements (items, container, add, remove) inside a wrapper and apply nested fields to it.
+
+    <!-- ERB Code -->
+    <h2>Phones</h2>
+    <div id="phones">
+      <div class="container">
+        <%= f.nested_fields_for :phones do |f| %>
+          <% ... %>
+        <% end %>
+      </div>
+      <a href="#" class="add">add phone</a>
+    </div>
+    
+    <h2>Addresses</h2>
+    <div id="addresses">
+      <div class="container">
+        <%= f.nested_fields_for :addresses do |f| %>
+          <% ... %>
+        <% end %>
+      </div>
+      <a href="#" class="add">add address</a>
+    </div>
+    
+    // JS Code
+    $('#phones, #addresses').nestedFields();
+
+
 Demo
 ----
 

data/lib/awesome_nested_fields/version.rb

@@ -1,3 +1,3 @@
 module AwesomeNestedFields
-  VERSION = "0.3.2"
+  VERSION = "0.4.0"
 end

data/lib/rails/form_helper.rb

@@ -1,4 +1,5 @@
 ActionView::Helpers::FormBuilder.class_eval do
+  
   def nested_fields_for(association, options={}, &block)
     raise ArgumentError, 'Missing block to nested_fields_for' unless block_given?
     
@@ -7,6 +8,7 @@ ActionView::Helpers::FormBuilder.class_eval do
     options[:item_template_class] ||= ['template', 'item', association.to_s.singularize].join(' ')
     options[:empty_template_class] ||= ['template', 'empty', association.to_s.singularize].join(' ')
     options[:show_empty] ||= false
+    options[:render_template] = options.key?(:render_template) ? options[:render_template] : true
     
     output = @template.capture { fields_for(association, &block) }
     
@@ -14,13 +16,19 @@ ActionView::Helpers::FormBuilder.class_eval do
       output.safe_concat @template.capture { yield nil } 
     end
     
-    output.safe_concat nested_fields_templates(association, options, &block)
+    template = render_nested_fields_template(association, options, &block)
+    if options[:render_template]
+      output.safe_concat template
+    else
+      add_nested_fields_template(association, template)
+    end
     
     output
   end
 
-private
-  def nested_fields_templates(association, options, &block)
+protected
+  
+  def render_nested_fields_template(association, options, &block)
     templates = @template.content_tag(:script, type: 'text/html', class: options[:item_template_class]) do
       fields_for(association, options[:new_object], child_index: options[:new_item_index], &block)
     end
@@ -31,4 +39,21 @@ private
     
     templates
   end
+  
+  def add_nested_fields_template(association, template)
+    # It must be a hash, so we don't get repeated templates on deeply nested models
+    @template.instance_variable_set(:@nested_fields_template_cache, {}) unless @template.instance_variable_get(:@nested_fields_template_cache)
+    @template.instance_variable_get(:@nested_fields_template_cache)[association] = template
+    create_nested_fields_template_helper!
+  end
+  
+  def create_nested_fields_template_helper!
+    def @template.nested_fields_templates
+      @nested_fields_template_cache.reduce(ActiveSupport::SafeBuffer.new) do |buffer, entry|
+        association, template = entry
+        buffer.safe_concat template
+      end
+    end unless @template.respond_to?(:nested_fields_templates)
+  end
+  
 end

data/vendor/assets/javascripts/jquery.nested-fields.js

@@ -26,26 +26,26 @@
   // PUBLIC API
   var methods = {
     init: function(options) {
-      var $this = $(this);
-      if($(this).data('nested-fields.options')) {
-        console.log('Nested fields already defined for this element. If you want to redefine options, destroy it and init again.');
-        return $this;
-      } else if(getOptions($this)) {
-        console.log('You cannot nest nested fields. Who would say that, uh?');
-        return $this;
-      }
-      
-      options = $.extend({}, defaultSettings, options);
-      options.itemTemplate = $(options.itemTemplateSelector, $this);
-      options.emptyTemplate = $(options.emptyTemplateSelector, $this);
-      options.container = $(options.containerSelector, $this);
-      options.add = $(options.addSelector, $this);
-      $this.data('nested-fields.options', options); 
-      
-      bindInsertToAdd(options);
-      bindRemoveToItems(options);
-      
-      return $this;
+      return this.each(function() {        
+        var $this = $(this);
+        if($(this).data('nested-fields.options')) {
+          console.log('Nested fields already defined for this element. If you want to redefine options, destroy it and init again.');
+          return $this;
+        } else if(getOptions($this)) {
+          console.log('You cannot nest nested fields. Who would say that, uh?');
+          return $this;
+        }
+
+        options = $.extend({}, defaultSettings, options);
+        options.itemTemplate = $(options.itemTemplateSelector, $this);
+        options.emptyTemplate = $(options.emptyTemplateSelector, $this);
+        options.container = $(options.containerSelector, $this);
+        options.add = $(options.addSelector, $this);
+        $this.data('nested-fields.options', options); 
+
+        bindInsertToAdd(options);
+        bindRemoveToItems(options);
+      });
     },
     
     insert: function(callback, options) {

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: awesome_nested_fields
 version: !ruby/object:Gem::Version
-  version: 0.3.2
+  version: 0.4.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,12 +9,12 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-07-22 00:00:00.000000000 -03:00
+date: 2011-07-23 00:00:00.000000000 -03:00
 default_executable: 
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
-  requirement: &2161324400 !ruby/object:Gem::Requirement
+  requirement: &2156407920 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -22,10 +22,10 @@ dependencies:
         version: 1.0.0
   type: :development
   prerelease: false
-  version_requirements: *2161324400
+  version_requirements: *2156407920
 - !ruby/object:Gem::Dependency
   name: rails
-  requirement: &2161323780 !ruby/object:Gem::Requirement
+  requirement: &2156407420 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -33,7 +33,7 @@ dependencies:
         version: 3.0.0
   type: :runtime
   prerelease: false
-  version_requirements: *2161323780
+  version_requirements: *2156407420
 description: Awesome dynamic nested fields for Rails and jQuery
 email: lailson@guava.com.br
 executables: []