rondo_form 0.2.0 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6ee9d8f4d7737a47f8e756a02d3dab153a2f8e162b8b5141755976c381470114
-  data.tar.gz: 2d1b339d1a473c7336ecf5fe3182b23591ab409f5cffe580fabd62b1f0c3ed1b
+  metadata.gz: ad2d01fb9c206a3f7942241492eee9ba969f10483a9a3a2f30d53d8fad04186c
+  data.tar.gz: 81567ac3ffe29883945dcf5b34855796570d16be438cf21a39893a2882c4af55
 SHA512:
-  metadata.gz: 10b686a87cb7e4de4cd13616d9b85d875d36db630209989c5bb40ae19d23fa66ee0b6153b4220a42c6e4479289b0515f427917d0385ccea5a7f5c44741504d71
-  data.tar.gz: 76fcdce9be21925c0f1aba373fd19f996e7c9fbac7d4e3e952df969ebf4b3a6ed3eb232d47a8326161ad0f627f61267afbcc146c465f1e1dbbc2df6906e72e96
+  metadata.gz: 45b7754068730e619cba9d2d4433e3ab876e2c468d8176c324ad744ef1148efb76a723719819660cd0eebe8f03f9db575aa80785dd539805d8e94b590bab6f32
+  data.tar.gz: c2cbb54fa7d4a4d33ab66b78096df1e8b72dc10bea32374471b49abc71adf15b00720d5f04b8500558f5cbc6b49939f161b75e4c7962c1b5abe29af1ad777d50

data/README.md

@@ -1,6 +1,6 @@
 # RondoForm
 
-Handle nested forms, same as Cocoon, but using StimulusJS
+Handle dynamic nested forms, same as Cocoon, but using StimulusJS
 
 ## Installation
 
@@ -8,23 +8,64 @@ Install the gem and add to the application's Gemfile by executing:
 
     $ bundle add rondo_form
 
-If bundler is not being used to manage dependencies, install the gem by executing:
+Or inside the Gemfile add the following
 
-    $ gem install rondo_form
+    $ gem 'rondo_form', '~> 0.2.2'
 
 Run the installation task:
 
-    $ rails g rondo_form:install
+    $ rails g rondo_form:install 
 
 ## Usage
 
-
-
-## Development
-
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
-
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+For example, we have `Project` model, which has `has_many` relationship with `Task` model:
+```
+rails g scaffold Project name:string description:string
+rails g model Task description:string done:boolean project:belongs_to
+```
+
+### Sample with SimpleForm
+In your `projects/_form` partial:
+``` erb
+<%= simple_form_for(@project) do |f| %>
+
+  <div class="form-inputs">
+    <%= f.input :name %>
+    <%= f.input :description %>
+  </div>
+
+  <h3 class="text-xl mt-4">Tasks</h3>
+  <div class="my-2" data-controller="nested-rondo">
+    <div data-nested-rondo-target="fieldContain">
+      <%= f.simple_fields_for :tasks do |task| %>
+        <%= render "task_fields", f: task %>
+      <% end %>
+    </div>
+    <div class="links">
+      <%= link_to_add_association "Add Task", f, :tasks %>
+    </div>
+  </div>
+
+  <div class="form-actions mt-4">
+    <%= f.button :submit %>
+  </div>
+<% end %>
+
+```
+
+In your `_task_fields` partial:
+``` erb
+<div class="nested-fields">
+  <%= f.input :description %>
+  <%= f.input :done, as: :boolean %>
+  <%= link_to_remove_association "Remove Task", f %>
+</div>
+
+```
+
+_Note_:
+- Stimulus controller is `nested-rondo`, so you need to declare the element with `data-controller="nested-rondo"`.
+- You must add `data-nested-rondo-target="fieldContain"`  to an element, that wraps all nested fields, the new field will be prepended to this element.
 
 ## Contributing
 

data/lib/generators/rondo_form/install_generator.rb

@@ -5,10 +5,10 @@ module RondoForm
       desc "This generator installs the javascript needed for rondo_form"
 
       def copy_the_javascript
-        copy_file "cocoon_controller.js", "app/javascript/controllers/cocoon_controller.js", force: true
+        copy_file "nested_rondo_controller.js", "app/javascript/controllers/nested_rondo_controller.js", force: true
         if (Rails.root.join("app/javascript/controllers/index.js")).exist?
           append_to_file "app/javascript/controllers/index.js", 
-            %(import CocoonController from "./cocoon_controller"\napplication.register("cocoon", CocoonController)\n)
+            %(import NestedRondoController from "./nested_rondo_controller"\napplication.register("nested-rondo", NestedRondoController)\n)
         else
           say %(Couldn't find "app/javascript/controllers/index.js".), :red
         end

data/lib/generators/rondo_form/templates/{cocoon_controller.js → nested_rondo_controller.js}

@@ -1,15 +1,14 @@
 import { Controller } from "@hotwired/stimulus"
 
 export default class extends Controller {
-  static targets = ["template"]
+  static targets = ["template", "fieldContain"]
 
   addField(e) {
     e.preventDefault();
 
     let assoc = e.target.dataset.association;
     let newField = this.buildNewAssociation(assoc);
-    let insertionNode = this.templateTarget.parentElement;
-    insertionNode.insertAdjacentHTML("beforebegin", newField);
+    this.fieldContainTarget.insertAdjacentHTML("beforeend", newField);
   }
 
   removeField(e) {

data/lib/rondo_form/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RondoForm
-  VERSION = "0.2.0"
+  VERSION = "0.2.2"
 end

data/lib/rondo_form/view_helpers.rb

@@ -24,7 +24,7 @@ module RondoForm
 
         is_dynamic = f.object.new_record?
         html_options[:class] = [html_options[:class], "remove_fields #{is_dynamic ? 'dynamic' : 'existing'}"].compact.join(' ')
-        html_options[:'data-action'] = "click->cocoon#removeField"
+        html_options[:'data-action'] = "click->nested-rondo#removeField"
         f.hidden_field(:_destroy) + link_to(name, '', html_options)
       end
     end
@@ -48,11 +48,11 @@ module RondoForm
 
         html_options[:class] = [html_options[:class], "add_fields"].compact.join(' ')
         html_options[:'data-association'] = association.to_s.singularize
-        html_options[:'data-action'] = "click->cocoon#addField"
+        html_options[:'data-action'] = "click->nested-rondo#addField"
 
         new_object = f.object.class.reflect_on_association(association).klass.new
         model_name = new_object.class.name.underscore
-        hidden_div = content_tag("template", id: "#{model_name}_fields_template", data: {cocoon_target: 'template'}) do
+        hidden_div = content_tag("template", id: "#{model_name}_fields_template", data: {'nested-rondo_target': 'template'}) do
           render_association(association, f, new_object)
         end
       end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rondo_form
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.2
 platform: ruby
 authors:
 - hungle00
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2023-06-14 00:00:00.000000000 Z
+date: 2023-07-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: railties
@@ -78,7 +78,7 @@ files:
 - README.md
 - Rakefile
 - lib/generators/rondo_form/install_generator.rb
-- lib/generators/rondo_form/templates/cocoon_controller.js
+- lib/generators/rondo_form/templates/nested_rondo_controller.js
 - lib/rondo_form.rb
 - lib/rondo_form/version.rb
 - lib/rondo_form/view_helpers.rb