nested_form_fields 0.0.1

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+.idea

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in nested_form_fields.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Nico Ritsche
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,66 @@
+# Nested Form Fields
+
+This gem helps creating forms for models with nested has_many associations.
+
+It uses jQuery to dynamically add and remove nested associations.
+
+- Works for arbitrarily deeply nested associations (tested up to 4 levels).
+- Works with form builders like simple_form.
+- Requires the Rails asset pipeline
+
+
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'nested_form_fields'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install nested_form_fields
+    
+In your application.js file add: 
+
+    //= require nested_form_fields
+
+## Usage
+
+Assume you have a user model with nested videos:
+
+    class User < ActiveRecord::Base
+      attr_accessible :name, :videos_attributes
+      has_many :videos
+      accepts_nested_attributes_for :videos, allow_destroy: true
+    end 
+
+Use the *nested_fields_for* helper inside your user form to add the video fields:
+
+    = form_for @user do |f|
+      = f.nested_fields_for :videos do |ff|
+        = ff.text_field :video_title
+        ..
+  
+Links to add and remove fields can be added using the *add_nested_fields_link* and *remove_nested_fields_link* helpers:
+
+    = form_for @user do |f|
+      = f.nested_fields_for :videos do |ff|
+        = ff.remove_nested_fields_link
+        = ff.text_field :video_title
+        ..
+      = f.add_nested_fields_link :videos
+      
+Note that *remove_nested_fields_link* needs to be called within the *nested_fields_for* call and *add_nested_fields_link* outside of it via the parent builder.
+
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,2 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"

data/lib/nested_form_fields/version.rb

@@ -0,0 +1,3 @@
+module NestedFormFields
+  VERSION = "0.0.1"
+end

data/lib/nested_form_fields.rb

@@ -0,0 +1,109 @@
+require "nested_form_fields/version"
+
+module NestedFormFields
+  module Rails
+    class Engine < ::Rails::Engine
+    end
+  end
+end
+
+module ActionView::Helpers
+
+  class FormBuilder
+
+    def nested_fields_for(record_name, record_object = nil, fields_options = {}, &block)
+      fields_options, record_object = record_object, nil if record_object.is_a?(Hash) && record_object.extractable_options?
+      fields_options[:builder] ||= options[:builder]
+      fields_options[:parent_builder] = self
+      fields_options[:namespace] = fields_options[:parent_builder].options[:namespace]
+
+      return fields_for_with_nested_attributes(record_name, record_object, fields_options, block)
+    end
+
+
+    def add_nested_fields_link association, text = nil
+      @template.link_to text || "Add #{association.to_s.singularize.humanize}", '',
+                        class: "add_nested_fields_link",
+                        data: { association_path: association_path(association.to_s) }
+    end
+
+    def remove_nested_fields_link text = nil
+      @template.link_to text || 'x', '',
+                        class: "remove_nested_fields_link",
+                        data: { delete_association_field_name: delete_association_field_name }
+    end
+
+
+    private
+
+    def fields_for_with_nested_attributes(association_name, association, options, block)
+      name = "#{object_name}[#{association_name}_attributes]"
+      association = convert_to_model(association)
+
+      if association.respond_to?(:persisted?)
+        association = [association] if @object.send(association_name).is_a?(Array)
+      elsif !association.respond_to?(:to_ary)
+        association = @object.send(association_name)
+      end
+
+      if association.respond_to?(:to_ary)
+        explicit_child_index = options[:child_index]
+        output = ActiveSupport::SafeBuffer.new
+        association.each do |child|
+          output << nested_fields_wrapper(association_name) do
+            fields_for_nested_model("#{name}[#{explicit_child_index || nested_child_index(name)}]", child, options, block)
+          end
+        end
+
+        templates = nested_model_template(name, association_name, options, block)
+        output << templates
+
+        output
+      elsif association
+        fields_for_nested_model(name, association, options, block)
+      end
+    end
+
+
+    def nested_model_template name, association_name, options, block
+      for_template = self.options[:for_template]
+      @template.content_tag( for_template ? :div : :script,
+                             type: for_template ? nil : 'text/html',
+                             id: template_id(association_name),
+                             class: for_template ? 'form_template' : nil,
+                             style: for_template ? 'display:none' : nil ) do
+        nested_fields_wrapper(association_name) do
+          fields_for_nested_model("#{name}[#{index_placeholder(association_name)}]",
+                                   association_name.to_s.classify.constantize.new,
+                                   options.merge(for_template: true), block)
+        end
+      end
+    end
+
+
+    def template_id association_name
+      "#{association_path(association_name)}_template"
+    end
+
+    def association_path association_name
+      "#{object_name.gsub('][','_').gsub(/_attributes/,'').sub('[','_').sub(']','')}_#{association_name}"
+    end
+
+    def index_placeholder association_name
+      "__#{association_path(association_name)}_index__"
+    end
+
+    def delete_association_field_name
+      "#{object_name}[_destroy]"
+    end
+
+
+    def nested_fields_wrapper association_name
+      @template.content_tag :div, class: "nested_fields nested_#{association_path(association_name)}" do
+        yield
+      end
+    end
+
+  end
+
+end

data/nested_form_fields.gemspec

@@ -0,0 +1,17 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/nested_form_fields/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Nico Ritsche"]
+  gem.email         = ["ncrdevmail@gmail.com"]
+  gem.description   = %q{Allows to dynamically add and remove nested has_many association fields in a form.}
+  gem.summary       = %q{Allows to dynamically add and remove nested has_many association fields in a form.}
+  gem.homepage      = ""
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "nested_form_fields"
+  gem.require_paths = ["lib"]
+  gem.version       = NestedFormFields::VERSION
+end

data/vendor/assets/javascripts/nested_form_fields.js.coffee

@@ -0,0 +1,31 @@
+jQuery ->
+
+  $('body').on 'click', '.add_nested_fields_link', ->
+    $link = $(this)
+    association_path = $link.data('association-path')
+    $template = $("##{association_path}_template")
+
+    template_html = $template.html()
+
+    # insert association indexes
+    index_placeholder = "__#{association_path}_index__"
+    template_html = template_html.replace(new RegExp(index_placeholder,"g"), $(".nested_#{association_path}").length)
+
+    # replace child template div tags with script tags to avoid form submission of templates
+    $parsed_template = $(template_html)
+    $child_templates = $parsed_template.children('.form_template')
+    $child_templates.each () ->
+      $child = $(this)
+      $child.replaceWith($("<script id='#{$child.attr('id')}' type='text/html' />").html($child.html()))
+
+    $link.before( $parsed_template )
+    false
+
+
+  $('body').on 'click', '.remove_nested_fields_link', ->
+    $link = $(this)
+    delete_association_field_name = $link.data('delete-association-field-name')
+    $nested_fields_container = $link.parents(".nested_fields").first()
+    $nested_fields_container.before "<input type='hidden' name='#{delete_association_field_name}' value='1' />"
+    $nested_fields_container.hide()
+    false

metadata

@@ -0,0 +1,57 @@
+--- !ruby/object:Gem::Specification
+name: nested_form_fields
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Nico Ritsche
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-05-20 00:00:00.000000000Z
+dependencies: []
+description: Allows to dynamically add and remove nested has_many association fields
+  in a form.
+email:
+- ncrdevmail@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/nested_form_fields.rb
+- lib/nested_form_fields/version.rb
+- nested_form_fields.gemspec
+- vendor/assets/javascripts/nested_form_fields.js.coffee
+homepage: ''
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.15
+signing_key: 
+specification_version: 3
+summary: Allows to dynamically add and remove nested has_many association fields in
+  a form.
+test_files: []
+has_rdoc: