nested_fields 0.1.1 → 0.2.0

data/README.rdoc

@@ -1 +1,32 @@
-jQuery is required.
+= Nested Fields
+
+nested_fields is an Engine designed for generic, dynamic nested forms which may be N>=1 levels deep.
+
+Of what I could find, the existing solutions for dynamic nested forms in Rails are implemented with javascript rather through Controllers. It is my understanding that this is because FormBuilders cannot be passed as params to Controllers.
+
+It does rely on some {parsing behavior}[http://guides.rubyonrails.org/form_helpers.html] within Rails which may or may not be intended for use in this manner.
+
+== Requirements
+
+Designed for Rails 3 applications.
+
+jQuery is required. In the future, this requirement could be removed without much difficulty.
+
+== Install
+
+Add nested_fields to the Gemfile and bundle install.
+
+== Usage
+
+Include 'nested_fields.js' in the layout for the Add and Remove behaviors.
+
+Use the nested_fields_for helper method.
+  <%= nested_fields_for form_builder, :pluralized_association_name, 'path_to/inner_partial' %>
+
+The same type of the form builder argument (e.g. Formtastic, SimpleForm, etc.) will automatically be used for the nested fields.
+
+The <tt>nested_fields_ready</tt> custom event is fired after a nested fieldset is (dynamically or otherwise) added.
+
+== Credits
+
+Inspired by Ryan Bates' nested_form[https://github.com/ryanb/nested_form] which itself is based on Tim Riley's solution.

data/VERSION

@@ -1 +1 @@
-0.1.1
+0.2.0

data/app/controllers/nested_fields_controller.rb

@@ -1,13 +1,15 @@
 class NestedFieldsController < ActionController::Base
   def add_nested_fields
-    @parent_class = params[:parent_class].constantize
     @association = params[:association].to_sym
     @builder = params[:builder].constantize
-    @object = @parent_class.reflect_on_association(@association).klass.new
     @index = "#{Time.now.to_i}#{Time.now.usec}"
+    @nested_partial = params[:nested_partial]
+    @parent_form = params[:parent_form]
+
+    @object = params[:parent_class].constantize.reflect_on_association(@association).klass.new
 
     respond_to do |format|
-      format.js { render 'nested_fields/add_nested_fields' }
+      format.js { render :partial => 'nested_fields/add_nested_fields' }
     end
   end
 end

data/app/helpers/nested_fields_helper.rb

@@ -1,18 +1,34 @@
 module NestedFieldsHelper
-  def nested_fields_js
-    render 'nested_fields/js'
-  end
+  def nested_fields_for(f, association, nested_partial=nil)
+    reflection = f.object.class.reflect_on_association(association)
+    is_has_one = reflection.macro == :has_one
+    nested_partial ||= "#{is_has_one ? association.to_s.pluralize : association}/fields"
 
-  def nested_fields_for(f, association, nested_partial="#{association}/fields")
-    add = add_nested_fields_path :parent_class => f.object.class, :association => association, :builder => f.class
+    add = add_nested_fields_path :association => association,
+                                 :builder => f.class,
+                                 :nested_partial => nested_partial,
+                                 :parent_class => f.object.class,
+                                 :parent_form => f.object_name
 
-    render 'nested_fields/nested_fields', :add_url => add,
-                                          :association => association,
-                                          :f => f,
-                                          :nested_partial => nested_partial
-  end
 
-  def link_to_remove_fields(f, text='Remove')
-    link_to text, '#', :class => :remove_nested_fields
+    partial = "nested_fields/#{'singular_' if is_has_one}nested_fieldset"
+
+    locals = {:add_url => add,
+              :association => association,
+              :f => f,
+              :nested_partial => nested_partial}
+
+    if is_has_one
+      associate = f.object.send(association);
+
+      if associate.nil?
+        locals[:associate] = reflection.klass.new
+        locals[:has_zero] = true
+      else
+        locals[:associate] = associate
+      end
+    end
+
+    render partial, locals
   end
 end

data/app/views/nested_fields/_add_nested_fields.html.erb

@@ -0,0 +1,3 @@
+<%= fields_for "#@parent_form[#{@association}_attributes][#@index]", @object, :builder => @builder do |f| %>
+  <%= render 'nested_fields/block', :f => f, :nested_partial => @nested_partial %>
+<% end %>

data/app/views/nested_fields/_block.html.erb

@@ -0,0 +1,8 @@
+<div class="nested_fields">
+  <a href="#" class="remove_nested_fields">Remove</a>
+
+  <div class="nested_fields_inputs">
+    <%= render nested_partial, :f => f %>
+    <%= f.hidden_field :_destroy %>
+  </div>
+</div>

data/app/views/nested_fields/{_nested_fields.html.erb → _nested_fieldset.html.erb}

@@ -4,13 +4,6 @@
   <a href="#" class="add_nested_fields" data-url="<%= add_url %>">Add</a>
 
   <%= f.fields_for association, :builder => f.class do |nested_f| %>
-    <div class="nested_fields">
-      <%= link_to_remove_fields :nested_f %>
-
-      <div class="nested_fields_inputs">
-        <%= render nested_partial, :f => nested_f %>
-        <%= nested_f.input :_destroy, :as => :hidden %>
-      </div>
-    </div>
+    <%= render 'nested_fields/block', :f => nested_f, :nested_partial => nested_partial %>
   <% end %>
 </fieldset>

data/app/views/nested_fields/_singular_nested_fieldset.html.erb

@@ -0,0 +1,16 @@
+<fieldset id="<%= association %>" class="nested_fieldset">
+  <legend><%= association.to_s.titleize %></legend>
+
+  <%= f.fields_for association, associate, :builder => f.class do |nested_f| %>
+    <label class="nested_one_label">
+      <%= check_box_tag "has_#{association}", nil, !local_assigns[:has_zero], :class => :nested_fields_has_one %>
+      <%= "Has #{association.to_s.titleize}?" %>
+    </label>
+
+    <%= nested_f.hidden_field :_destroy, :class => :destroy_nested_one, :value => local_assigns[:has_zero] ? 'true' : 'false' %>
+
+    <%= content_tag :div, :class => :nested_one, :style => ('display:none' if local_assigns[:has_zero]) do %>
+      <%= render nested_partial, :f => nested_f %>
+    <% end %>
+  <% end %>
+</fieldset>

data/nested_fields.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{nested_fields}
-  s.version = "0.1.1"
+  s.version = "0.2.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Jason Murad"]
-  s.date = %q{2010-12-15}
+  s.date = %q{2010-12-21}
   s.description = %q{Unobtrusive dynamic nested forms}
   s.email = %q{jason@thriess.com}
   s.extra_rdoc_files = [
@@ -24,9 +24,10 @@ Gem::Specification.new do |s|
     "VERSION",
     "app/controllers/nested_fields_controller.rb",
     "app/helpers/nested_fields_helper.rb",
-    "app/views/nested_fields/_js.html.erb",
-    "app/views/nested_fields/_nested_fields.html.erb",
-    "app/views/nested_fields/add_nested_fields.html.erb",
+    "app/views/nested_fields/_add_nested_fields.html.erb",
+    "app/views/nested_fields/_block.html.erb",
+    "app/views/nested_fields/_nested_fieldset.html.erb",
+    "app/views/nested_fields/_singular_nested_fieldset.html.erb",
     "config/routes.rb",
     "lib/engine.rb",
     "lib/nested_fields.rb",

data/public/javascripts/nested_fields.js

@@ -1,18 +1,30 @@
-$(function() {
-  $('.add_nested_fields').live('click', function() {
-    link = this;
-
-    $.get(link.getAttribute('data-url'), function(content) {
-    $(link).after(content);
-    $(link).trigger('nested_fields_ready');
-    });
-
-    return false;
+$(document).ready(function() {
+  $('.nested_fieldset').each(function(i, nf) {
+    $(nf).trigger('nested_fields_ready');
   });
+});
 
-  $('.remove_nested_fields').live('click', function() {
-    $(this).closest('div.nested_fields').find('input[type=hidden]').val('1');
-    $(this).closest('div.nested_fields').hide();
-    return false;
+$('.add_nested_fields').live('click', function() {
+  $.ajax({
+    context: this,
+    url: this.getAttribute('data-url'),
+    success: function(content) {
+      $(this).after(content);
+      $(this).trigger('nested_fields_ready');
+    }
   });
+
+  return false;
+});
+
+$('.remove_nested_fields').live('click', function() {
+  $(this).closest('div.nested_fields').find('input[type=hidden]').val('1');
+  $(this).closest('div.nested_fields').hide();
+  return false;
+});
+
+$('.nested_fields_has_one').live('change', function() {
+  var hidden_field = $(this).closest('.nested_fieldset').find('.destroy_nested_one');
+  $(hidden_field).val($(hidden_field).val() == 'true' ? 'false' : 'true');
+  $(this).closest('.nested_fieldset').find('.nested_one').toggle();
 });

metadata

@@ -4,9 +4,9 @@ version: !ruby/object:Gem::Version
   prerelease: false
   segments: 
   - 0
-  - 1
-  - 1
-  version: 0.1.1
+  - 2
+  - 0
+  version: 0.2.0
 platform: ruby
 authors: 
 - Jason Murad
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-12-15 00:00:00 -05:00
+date: 2010-12-21 00:00:00 -05:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -90,9 +90,10 @@ files:
 - VERSION
 - app/controllers/nested_fields_controller.rb
 - app/helpers/nested_fields_helper.rb
-- app/views/nested_fields/_js.html.erb
-- app/views/nested_fields/_nested_fields.html.erb
-- app/views/nested_fields/add_nested_fields.html.erb
+- app/views/nested_fields/_add_nested_fields.html.erb
+- app/views/nested_fields/_block.html.erb
+- app/views/nested_fields/_nested_fieldset.html.erb
+- app/views/nested_fields/_singular_nested_fieldset.html.erb
 - config/routes.rb
 - lib/engine.rb
 - lib/nested_fields.rb
@@ -114,7 +115,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 3137776754752327024
+      hash: -1304071014241017198
       segments: 
       - 0
       version: "0"

data/app/views/nested_fields/_js.html.erb

@@ -1 +0,0 @@
-<%= javascript_include_tag 'nested_fields' %>

data/app/views/nested_fields/add_nested_fields.html.erb

@@ -1,11 +0,0 @@
-<%= fields_for "#{@parent_class.name.underscore}[#{@association}_attributes]",
-  @object, :builder => @builder, :index => @index do |f| %>
-    <div class="nested_fields">
-      <%= link_to_remove_fields :nested_f %>
-
-      <div class="nested_fields_inputs">
-        <%= render "#{@association}/fields", :f => f %>
-        <%= f.input :_destroy, :as => :hidden %>
-      </div>
-    </div>
-<% end %>