Add bootstrap_fields form helper.

Author: donv

README.md

@@ -164,9 +164,10 @@ in `form_with`.
 
 `form_with` has some important differences compared to `form_for` and `form_tag`, and these differences apply to `bootstrap_form_with`. A good summary of the differences can be found at: https://m.patrikonrails.com/rails-5-1s-form-with-vs-old-form-helpers-3a5f72a8c78a, or in the [Rails documentation](api.rubyonrails.org).
 
-### bootstrap_fields_for
+### bootstrap_fields_for and bootstrap_fields
 
-Adding fields for a different object without nesting can be achieved using the `bootstrap_fields_for` helper in the same way it is done in Rails.
+Adding fields for a different object without nesting can be achieved using the `bootstrap_fields_for` and
+`bootstrap_fields` helpers in the same way it is done in Rails.
 
 ![Example 3](demo/doc/screenshots/bootstrap/readme/03_example.png "Example 3")
 ```erb
@@ -175,6 +176,9 @@ Adding fields for a different object without nesting can be achieved using the `
   <%= bootstrap_fields_for :parent do |pf| %>
     <%= pf.email_field :email, label: 'Parent email' %>
   <% end %>
+  <%= bootstrap_fields @user.address do |af| %>
+    <%= af.text_field :street_name %>
+  <% end %>
   <%= f.primary "Save" %>
 <% end %>
 ```
@@ -191,6 +195,10 @@ Generated HTML:
     <label class="form-label" for="parent_email">Parent email</label>
     <input class="form-control" id="parent_email" name="parent[email]" type="email">
   </div>
+  <div class="mb-3">
+    <label class="form-label" for="street_name">Street name</label>
+    <input class="form-control" id="street_name" name="street_name" type="text">
+  </div>
   <input class="btn btn-primary" data-disable-with="Save" name="commit" type="submit" value="Save">
 </form>
 ```

demo/doc/screenshots/bootstrap/readme/03_example.png

@@ -44,6 +44,11 @@ def bootstrap_fields_for(record_name, record_object=nil, options={}, &block)
         fields_for(record_name, record_object, options, &block)
       end
 
+      def bootstrap_fields(scope=nil, model: nil, **options, &block)
+        options[:builder] = BootstrapForm::FormBuilder
+        fields(scope, model: model, **options, &block)
+      end
+
       private
 
       def with_bootstrap_form_field_error_proc

lib/bootstrap_form/action_view_extensions/form_helper.rb

@@ -26,7 +26,7 @@ class BootstrapFieldsForTest < ActionView::TestCase
     assert_equivalent_html expected, output
   end
 
-  test "bootstrap_form_for helper works for serialized hash attributes" do
+  test "bootstrap_fields_for helper works for serialized hash attributes" do
     @user.preferences = { "favorite_color" => "cerulean" }
 
     output = bootstrap_form_for(@user) do |_f|
@@ -46,4 +46,46 @@ class BootstrapFieldsForTest < ActionView::TestCase
     HTML
     assert_equivalent_html expected, output
   end
+
+  test "bootstrap_fields helper works for associations" do
+    @user.address = Address.new(street: "123 Main Street")
+
+    output = bootstrap_form_for(@user) do |_f|
+      bootstrap_fields @user.address do |af|
+        af.text_field(:street)
+      end
+    end
+
+    expected = <<~HTML
+      <form accept-charset="UTF-8" action="/users" class="new_user" id="new_user" method="post">
+        #{'<input name="utf8" type="hidden" value="&#x2713;"/>' unless ::Rails::VERSION::STRING >= '6'}
+        <div class="mb-3">
+          <label class="form-label" for="address_street">Street</label>
+          <input class="form-control" id="address_street" name="address[street]" type="text" value="123 Main Street" />
+        </div>
+      </form>
+    HTML
+    assert_equivalent_html expected, output
+  end
+
+  test "bootstrap_fields helper works for serialized hash attributes" do
+    @user.preferences = { "favorite_color" => "cerulean" }
+
+    output = bootstrap_form_for(@user) do |_f|
+      bootstrap_fields :preferences do |builder|
+        builder.text_field :favorite_color, value: @user.preferences["favorite_color"]
+      end
+    end
+
+    expected = <<~HTML
+      <form accept-charset="UTF-8" action="/users" class="new_user" id="new_user" method="post">
+        #{'<input name="utf8" type="hidden" value="&#x2713;"/>' unless ::Rails::VERSION::STRING >= '6'}
+        <div class="mb-3">
+          <label class="form-label" for="preferences_favorite_color">Favorite color</label>
+          <input class="form-control" id="preferences_favorite_color" name="preferences[favorite_color]" type="text" value="cerulean" />
+        </div>
+      </form>
+    HTML
+    assert_equivalent_html expected, output
+  end
 end