This branch is for Rails 2 and no longer maintained. Instead use the master branch with Rails 3.
A Rails plugin to conveniently manage multiple nested models in a single form. It does so in an unobtrusive way through jQuery.
This is in early development, so some of this documentation is not yet applicable.
This is currently only available as a plugin.
script/plugin install git://github.com/ryanb/nested_form.git -r rails2
When installing this plugin it 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.
<% f.fields_for :tasks do |task_form| %> <%= task_form.text_field :name %> <%= task_form.link_to_remove "Remove this task" %> <% end %> <%= f.link_to_add "Add a task", :tasks %>
This generates links which dynamically add and remove fields.
This plugin is based on the solution by Tim Riley in his complex-form-examples fork.
github.com/timriley/complex-form-examples/tree/unobtrusive-jquery-deep-fix2