Rails plugin to conveniently handle multiple models in a single form.
Ruby JavaScript
Switch branches/tags
Nothing to show
Pull request Compare This branch is 5 commits ahead, 2 commits behind madebydna:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.bundle
lib
spec
.gitignore
Gemfile
Gemfile.lock
LICENSE
README.rdoc
Rakefile
nested_form.gemspec

README.rdoc

Nested Form

A Rails gem to conveniently manage multiple nested models in a single form. It does so in an unobtrusive way through jQuery.

This has been updated. To learn more about how originally worked under the hood: blog.madebydna.com/dynamic-nested-forms-in-rails-3-with-the-nest

I have modified this to allow the use of nested_form as a table view. This has changed the the underlying implementation by:

  • storing the blueprint template for add more in a hidden textarea, instead of a div. to maintain artibrary html snippet without getting affected with DOM rendering (like Javascript Templates). this is convinient for storing a <tr> base tempalate.

  • The container <div class=“fields”> is no longer automatically generated. you are assumed to generate your own entry container with that proper class “fields”. as show in the updated usage section below.

Install

Add it to your Gemfile

gem "nested_form", :git => "git://github.com/modsaid/nested_form.git"

Run

bundle install

Run the generator

rails generate nested_form:install

Usage

Running the generator will add a file at public/javascripts/nested_form.js which should be included after jQuery.

<%= javascript_include_tag 'jquery', 'nested_form' %>

You can then generate a nested form using the nested_form_for helper method.

<%= nested_form_for @project do |f| %>

Use this form just like normal, including the fields_for helper method for nesting models. The benefit of this plugin comes from the link_to_add and link_to_remove helper methods on the form builder.

<table>
<%= f.fields_for :tasks do |task_form| %>
  <tr class="fields">
    <td><%= task_form.text_field :name %></td>
    <td><%= task_form.link_to_remove "Remove this task" %></td>
  <tr>
<% end %>
  <tr>
    <td><%= f.link_to_add "Add a task", :tasks %></td>
  </tr>
</table>

This generates links which dynamically add and remove fields.

Partials

It is often desirable to move the nested fields into a partial to keep things organized. If you don't supply a block to fields_for it will look for a partial and use that.

<%= f.fields_for :tasks %>

In this case it will look for a partial called “task_fields” and pass the form builder as an f variable to it.

Special Thanks

This gem is based on the plugin by Ryan Bates: github.com/ryanb/nested_form